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

Параметры конвертации

По умолчанию toMarkdown извлекает текстовое содержимое из ваших файлов. Чтобы расширить возможности процесса преобразования, вы можете передать сервису параметры, управляющие тем, как преобразуются определенные типы файлов.

Опции сгруппированы по типу файла и все являются необязательными.

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

• format: определяет формат преобразованного контента. По умолчанию используется markdown. Установите значение text чтобы получить обычный текст без разметки Markdown.

Когда format это text, format поле ConversionResult также имеет значение text.

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

• descriptionLanguage: определяет язык описаний изображений, сгенерированных ИИ.

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

• hostname: строка, используемая в качестве хоста при разрешении относительных ссылок внутри HTML.

• cssSelector: строка с CSS-селектором для выбора определённых элементов вашего HTML. См. как обрабатывается HTML для дополнительных сведений.

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

• metadata: раньше все преобразованные PDF-файлы всегда содержали метаданные. Этот параметр позволяет отказаться от такого поведения.

Чтобы настроить пользовательские параметры, передайте conversionOptions объект внутри второго аргумента вызова привязки, например:

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

Так как REST API использует загрузку файлов, у запроса Content-Type будет multipart/form-data. Поэтому добавьте новое поле формы со строковым представлением вашего объекта в качестве значения:

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