← Cloudflare Workers AI / workers-ai / features / markdown-conversion / usage

REST API

Ke konverzi dokumentů do Markdownu můžete použít také Markdown Conversion REST API.

Předpoklad: Získejte token API Workers AI

Chcete-li používat službu Markdown Conversion přes REST API, potřebujete API token s oprávněním pro Workers AI REST API. Další informace najdete v Začínáme s REST API Workers AI s pokyny, jak získat API token se správnými oprávněními.

Transformace

Tento endpoint umožňuje převést libovolný poskytnutý soubor do Markdownu.

curl https://api.cloudflare.com/client/v4/accounts/{ACCOUNT_ID}/ai/tomarkdown \
  -X POST \
  -H 'Authorization: Bearer {API_TOKEN}' \
  -F "[email protected]" \
  -F "[email protected]" \
  -F 'conversionOptions={ ... }'

Parametry

files File[] povinné

Soubory, které chcete převést.

conversionOptions ConversionOptions volitelné

Možnosti, pomocí kterých můžete ovlivnit způsob převodu souborů. Další podrobnosti najdete v části Možnosti převodu pro další podrobnosti.

Odpověď

{
	"success": true,
	"result": [
		{
			"id": "...",
			"name": "good.html",
			"mimeType": "text/html",
			"format": "markdown",
			"tokens": 49,
			"data": "# Image Embedded with a Data URI\n\nThis _image_ is directly encoded in the HTML:\n\n\n\nAn image description\n\n \n\nIt's a tiny 5x5 pixel PNG, scaled up to 50x50px.\n\n"
		},
		{
			"id": "...",
			"name": "bad.pdf",
			"mimeType": "application/pdf",
			"format": "error",
			"error": "Some error that prevented this image from being converted"
		}
	]
}

Podporováno

Tento endpoint umožňuje programově získat úplný seznam bohatých formátů podporovaných pro převod.

curl https://api.cloudflare.com/client/v4/accounts/{ACCOUNT_ID}/ai/tomarkdown/supported \
  -H 'Authorization: Bearer {API_TOKEN}'

Odpověď

{
  "success": true,
  "result": [
    {
      "extension": ".html",
      "mimeType": "text/html"
    },
    {
      "extension": ".pdf",
      "mimeType": "application/pdf"
    },
    ...
  ]
}