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

Možnosti převodu

Ve výchozím nastavení toMarkdown služba extrahuje textový obsah z vašich souborů. Pokud chcete možnosti převodu dále rozšířit, můžete službě předat volby, kterými určíte, jak se mají jednotlivé typy souborů převádět.

Možnosti jsou uspořádané podle typu souboru a všechny jsou volitelné.

{
  output?: {
    format?: 'markdown' | 'text';
  }
}

• format: určuje formát převedeného obsahu. Výchozí hodnota je markdown. Nastavte na text a získáte tak čistý text bez syntaxe Markdown.

Když format je text, format pole ConversionResult je také nastavena na text.

{
  image?: {
    descriptionLanguage?: 'en' | 'it' | 'de' | 'es' | 'fr' | 'pt';
  }
}

• descriptionLanguage: určuje jazyk popisů obrázků generovaných pomocí AI.

{
  html?: {
    hostname?: string;
    cssSelector?: string;
  }
}

• hostname: řetězec použitý jako hostitel při překladu relativních odkazů uvnitř HTML.

• cssSelector: řetězec obsahující vzor CSS selektoru pro výběr konkrétních prvků z vašeho HTML. Viz jak se zpracovává HTML pro další podrobnosti.

{
  pdf?: {
    metadata?: boolean;
  }
}

• metadata: Dříve všechny převedené soubory PDF vždy obsahovaly metadata. Tato možnost vám umožňuje toto chování vypnout.

Chcete-li nakonfigurovat vlastní možnosti, předejte conversionOptions objekt uvnitř druhého argumentu volání bindingu, například takto:

await env.AI.toMarkdown(..., {
  conversionOptions: {
    html: { ... },
    pdf: { ... },
    ...
   }
})

Jelikož REST API využívá nahrávání souborů, požadavku Content-Type bude multipart/form-data. Proto přidejte nové pole formuláře s hodnotou obsahující váš objekt převedený na řetězec:

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