--- title: AI --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # AI ##### [Run a Workers AI model](https://developers.cloudflare.com/api/resources/ai/methods/run) POST/accounts/{account\_id}/ai/run/{model\_name} ##### ModelsExpand Collapse

AIRunResponse = array of object {label, score } or stringor object {audio } or 12 more An array of classification results for the input text

One of the following:

TextClassification = array of object {label, score } An array of classification results for the input text

label: optional string The classification label assigned to the text (e.g., ‘POSITIVE’ or ‘NEGATIVE’) Link to this property score: optional number Confidence score indicating the likelihood that the text belongs to the specified label Link to this property

Link to this property TextToImage = string The generated image in PNG format Link to this property

Audio object {audio }

audio: optional string The generated audio in MP3 format, base64-encoded Link to this property

Link to this property string The generated audio in MP3 format Link to this property

TextEmbeddings object {data, shape }

data: optional array of array of number Embeddings of the requested text values Link to this property shape: optional array of number Link to this property

Link to this property

AutomaticSpeechRecognition object {text, vtt, word\_count, words }

text: string The transcription Link to this property vtt: optional string Link to this property word\_count: optional number Link to this property

words: optional array of object {end, start, word }

end: optional number The ending second when the word completes Link to this property start: optional number The second this word begins in the recording Link to this property word: optional string Link to this property

Link to this property

ImageClassification = array of object {label, score }

label: optional string The predicted category or class for the input image based on analysis Link to this property score: optional number A confidence value, between 0 and 1, indicating how certain the model is about the predicted label Link to this property

Link to this property

ObjectDetection = array of object {box, label, score } An array of detected objects within the input image

box: optional object {xmax, xmin, ymax, ymin } Coordinates defining the bounding box around the detected object

xmax: optional number The x-coordinate of the bottom-right corner of the bounding box Link to this property xmin: optional number The x-coordinate of the top-left corner of the bounding box Link to this property ymax: optional number The y-coordinate of the bottom-right corner of the bounding box Link to this property ymin: optional number The y-coordinate of the top-left corner of the bounding box Link to this property

Link to this property label: optional string The class label or name of the detected object Link to this property score: optional number Confidence score indicating the likelihood that the detection is correct Link to this property

Link to this property

object {response, tool\_calls, usage }

response: string The generated text response from the model Link to this property

tool\_calls: optional array of object {arguments, name } An array of tool calls requests made during the response generation

arguments: optional unknown The arguments passed to be passed to the tool call request Link to this property name: optional string The name of the tool to be called Link to this property

Link to this property

usage: optional object {completion\_tokens, prompt\_tokens, total\_tokens } Usage statistics for the inference request

completion\_tokens: optional number Total number of tokens in output Link to this property prompt\_tokens: optional number Total number of tokens in input Link to this property total\_tokens: optional number Total number of input and output tokens Link to this property

Link to this property

Link to this property string Link to this property

Translation object {translated\_text }

translated\_text: optional string The translated text in the target language Link to this property

Link to this property

Summarization object {summary }

summary: optional string The summarized version of the input text Link to this property

Link to this property

ImageToText object {description }

description: optional string Link to this property

Link to this property

ImageTextToText object {description }

description: optional string Link to this property

Link to this property

MultimodalEmbeddings object {data, shape }

data: optional array of array of number Link to this property shape: optional array of number Link to this property

Link to this property

[Link to this property](<#(resource)%20ai%20%3E%20(model)%20ai_run_response%20%3E%20(schema)>) #### AIFinetunes ##### [List Finetunes](https://developers.cloudflare.com/api/resources/ai/subresources/finetunes/methods/list) GET/accounts/{account\_id}/ai/finetunes ##### [Create a new Finetune](https://developers.cloudflare.com/api/resources/ai/subresources/finetunes/methods/create) POST/accounts/{account\_id}/ai/finetunes ##### ModelsExpand Collapse

FinetuneListResponse object {id, created\_at, model, 3 more }

id: string formatuuid Link to this property created\_at: string formatdate-time Link to this property model: string Link to this property modified\_at: string formatdate-time Link to this property name: string Link to this property description: optional string Link to this property

[Link to this property](<#(resource)%20ai.finetunes%20%3E%20(model)%20finetune_list_response%20%3E%20(schema)>)

FinetuneCreateResponse object {id, created\_at, model, 4 more }

[Link to this property](<#(resource)%20ai.finetunes%20%3E%20(model)%20finetune_create_response%20%3E%20(schema)>) #### AIFinetunesAssets ##### [Upload a Finetune Asset](https://developers.cloudflare.com/api/resources/ai/subresources/finetunes/subresources/assets/methods/create) POST/accounts/{account\_id}/ai/finetunes/{finetune\_id}/finetune-assets ##### ModelsExpand Collapse

AssetCreateResponse object {success }

success: boolean Link to this property

[Link to this property](<#(resource)%20ai.finetunes.assets%20%3E%20(model)%20asset_create_response%20%3E%20(schema)>) #### AIFinetunesPublic ##### [List Public Finetunes](https://developers.cloudflare.com/api/resources/ai/subresources/finetunes/subresources/public/methods/list) GET/accounts/{account\_id}/ai/finetunes/public ##### ModelsExpand Collapse

PublicListResponse object {id, created\_at, model, 4 more }

[Link to this property](<#(resource)%20ai.finetunes.public%20%3E%20(model)%20public_list_response%20%3E%20(schema)>) #### AIAuthors ##### [Author Search](https://developers.cloudflare.com/api/resources/ai/subresources/authors/methods/list) GET/accounts/{account\_id}/ai/authors/search ##### ModelsExpand Collapse AuthorListResponse = unknown [Link to this property](<#(resource)%20ai.authors%20%3E%20(model)%20author_list_response%20%3E%20(schema)>) #### AITasks ##### [Task Search](https://developers.cloudflare.com/api/resources/ai/subresources/tasks/methods/list) GET/accounts/{account\_id}/ai/tasks/search ##### ModelsExpand Collapse TaskListResponse = unknown [Link to this property](<#(resource)%20ai.tasks%20%3E%20(model)%20task_list_response%20%3E%20(schema)>) #### AIModels ##### [Model Search](https://developers.cloudflare.com/api/resources/ai/subresources/models/methods/list) GET/accounts/{account\_id}/ai/models/search ##### ModelsExpand Collapse ModelListResponse = unknown [Link to this property](<#(resource)%20ai.models%20%3E%20(model)%20model_list_response%20%3E%20(schema)>) #### AIModelsSchema ##### [Get an AI model's input and output schemas](https://developers.cloudflare.com/api/resources/ai/subresources/models/subresources/schema/methods/get) GET/accounts/{account\_id}/ai/models/schema ##### ModelsExpand Collapse

SchemaGetResponse object {input, output }

input: object {additionalProperties, description, type }

additionalProperties: boolean Link to this property description: string Link to this property type: string Link to this property

Link to this property

output: object {additionalProperties, description, type }

additionalProperties: boolean Link to this property description: string Link to this property type: string Link to this property

Link to this property

[Link to this property](<#(resource)%20ai.models.schema%20%3E%20(model)%20schema_get_response%20%3E%20(schema)>) #### AITo Markdown ##### [Convert uploaded files to Markdown](https://developers.cloudflare.com/api/resources/ai/subresources/to_markdown/methods/transform) POST/accounts/{account\_id}/ai/tomarkdown ##### [List supported Markdown conversion formats](https://developers.cloudflare.com/api/resources/ai/subresources/to_markdown/methods/supported) GET/accounts/{account\_id}/ai/tomarkdown/supported ##### ModelsExpand Collapse

ToMarkdownTransformResponse object {data, format, mimeType, 2 more }

data: string Link to this property format: string Link to this property mimeType: string Link to this property name: string Link to this property tokens: string Link to this property

[Link to this property](<#(resource)%20ai.to_markdown%20%3E%20(model)%20to_markdown_transform_response%20%3E%20(schema)>)

ToMarkdownSupportedResponse object {extension, mimeType }

extension: string Link to this property mimeType: string Link to this property

[Link to this property](<#(resource)%20ai.to_markdown%20%3E%20(model)%20to_markdown_supported_response%20%3E%20(schema)>)