--- title: AI --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) 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/python/resources/ai/methods/run) ai.run(strmodel\_name, AIRunParams\*\*kwargs) -> [AIRunResponse]() POST/accounts/{account\_id}/ai/run/{model\_name} ##### ModelsExpand Collapse
AIRunResponse An array of classification results for the input text One of the following:
List\[TextClassification] An array of classification results for the input text label: Optional\[str] The classification label assigned to the text (e.g., ‘POSITIVE’ or ‘NEGATIVE’) Link to this property score: Optional\[float] Confidence score indicating the likelihood that the text belongs to the specified label Link to this property
Link to this property object The generated image in PNG format Link to this property
class Audio: … audio: Optional\[str] The generated audio in MP3 format, base64-encoded Link to this property
Link to this property object The generated audio in MP3 format Link to this property
class TextEmbeddings: … data: Optional\[List\[List\[float]]] Embeddings of the requested text values Link to this property shape: Optional\[List\[float]] Link to this property
Link to this property
class AutomaticSpeechRecognition: … text: str The transcription Link to this property vtt: Optional\[str] Link to this property word\_count: Optional\[float] Link to this property
words: Optional\[List\[AutomaticSpeechRecognitionWord]] end: Optional\[float] The ending second when the word completes Link to this property start: Optional\[float] The second this word begins in the recording Link to this property word: Optional\[str] Link to this property
Link to this property
Link to this property
List\[ImageClassification] label: Optional\[str] The predicted category or class for the input image based on analysis Link to this property score: Optional\[float] 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
List\[ObjectDetection] An array of detected objects within the input image
box: Optional\[ObjectDetectionBox] Coordinates defining the bounding box around the detected object xmax: Optional\[float] The x-coordinate of the bottom-right corner of the bounding box Link to this property xmin: Optional\[float] The x-coordinate of the top-left corner of the bounding box Link to this property ymax: Optional\[float] The y-coordinate of the bottom-right corner of the bounding box Link to this property ymin: Optional\[float] The y-coordinate of the top-left corner of the bounding box Link to this property
Link to this property label: Optional\[str] The class label or name of the detected object Link to this property score: Optional\[float] Confidence score indicating the likelihood that the detection is correct Link to this property
Link to this property
class UnionMember8: … response: str The generated text response from the model Link to this property
tool\_calls: Optional\[List\[UnionMember8ToolCall]] An array of tool calls requests made during the response generation arguments: Optional\[object] The arguments passed to be passed to the tool call request Link to this property name: Optional\[str] The name of the tool to be called Link to this property
Link to this property
usage: Optional\[UnionMember8Usage] Usage statistics for the inference request completion\_tokens: Optional\[float] Total number of tokens in output Link to this property prompt\_tokens: Optional\[float] Total number of tokens in input Link to this property total\_tokens: Optional\[float] Total number of input and output tokens Link to this property
Link to this property
Link to this property object Link to this property
class Translation: … translated\_text: Optional\[str] The translated text in the target language Link to this property
Link to this property
class Summarization: … summary: Optional\[str] The summarized version of the input text Link to this property
Link to this property
class ImageToText: … description: Optional\[str] Link to this property
Link to this property
class ImageTextToText: … description: Optional\[str] Link to this property
Link to this property
class MultimodalEmbeddings: … data: Optional\[List\[List\[float]]] Link to this property shape: Optional\[List\[float]] 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/python/resources/ai/subresources/finetunes/methods/list) ai.finetunes.list(FinetuneListParams\*\*kwargs) -> [FinetuneListResponse]() GET/accounts/{account\_id}/ai/finetunes ##### [Create a new Finetune](https://developers.cloudflare.com/api/python/resources/ai/subresources/finetunes/methods/create) ai.finetunes.create(FinetuneCreateParams\*\*kwargs) -> [FinetuneCreateResponse]() POST/accounts/{account\_id}/ai/finetunes ##### ModelsExpand Collapse
class FinetuneListResponse: … id: str formatuuid Link to this property created\_at: datetime formatdate-time Link to this property model: str Link to this property modified\_at: datetime formatdate-time Link to this property name: str Link to this property description: Optional\[str] Link to this property
[Link to this property](<#(resource)%20ai.finetunes%20%3E%20(model)%20finetune_list_response%20%3E%20(schema)>)
class FinetuneCreateResponse: … id: str formatuuid Link to this property created\_at: datetime formatdate-time Link to this property model: str Link to this property modified\_at: datetime formatdate-time Link to this property name: str Link to this property public: bool Link to this property description: Optional\[str] Link to this property
[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/python/resources/ai/subresources/finetunes/subresources/assets/methods/create) ai.finetunes.assets.create(strfinetune\_id, AssetCreateParams\*\*kwargs) -> [AssetCreateResponse]() POST/accounts/{account\_id}/ai/finetunes/{finetune\_id}/finetune-assets ##### ModelsExpand Collapse
class AssetCreateResponse: … success: bool 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/python/resources/ai/subresources/finetunes/subresources/public/methods/list) ai.finetunes.public.list(PublicListParams\*\*kwargs) -> SyncSinglePage\[[PublicListResponse]()] GET/accounts/{account\_id}/ai/finetunes/public ##### ModelsExpand Collapse
class PublicListResponse: … id: str formatuuid Link to this property created\_at: datetime formatdate-time Link to this property model: str Link to this property modified\_at: datetime formatdate-time Link to this property name: str Link to this property public: bool Link to this property description: Optional\[str] Link to this property
[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/python/resources/ai/subresources/authors/methods/list) ai.authors.list(AuthorListParams\*\*kwargs) -> SyncSinglePage\[object] GET/accounts/{account\_id}/ai/authors/search #### AITasks ##### [Task Search](https://developers.cloudflare.com/api/python/resources/ai/subresources/tasks/methods/list) ai.tasks.list(TaskListParams\*\*kwargs) -> SyncSinglePage\[object] GET/accounts/{account\_id}/ai/tasks/search #### AIModels ##### [Model Search](https://developers.cloudflare.com/api/python/resources/ai/subresources/models/methods/list) ai.models.list(ModelListParams\*\*kwargs) -> SyncV4PagePaginationArray\[object] GET/accounts/{account\_id}/ai/models/search #### AIModelsSchema ##### [Get an AI model's input and output schemas](https://developers.cloudflare.com/api/python/resources/ai/subresources/models/subresources/schema/methods/get) ai.models.schema.get(SchemaGetParams\*\*kwargs) -> [SchemaGetResponse]() GET/accounts/{account\_id}/ai/models/schema ##### ModelsExpand Collapse
class SchemaGetResponse: …
input: Input additional\_properties: bool Link to this property description: str Link to this property type: str Link to this property
Link to this property
output: Output additional\_properties: bool Link to this property description: str Link to this property type: str 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/python/resources/ai/subresources/to_markdown/methods/transform) ai.to\_markdown.transform(ToMarkdownTransformParams\*\*kwargs) -> SyncSinglePage\[[ToMarkdownTransformResponse]()] POST/accounts/{account\_id}/ai/tomarkdown ##### [List supported Markdown conversion formats](https://developers.cloudflare.com/api/python/resources/ai/subresources/to_markdown/methods/supported) ai.to\_markdown.supported(ToMarkdownSupportedParams\*\*kwargs) -> SyncSinglePage\[[ToMarkdownSupportedResponse]()] GET/accounts/{account\_id}/ai/tomarkdown/supported ##### ModelsExpand Collapse
class ToMarkdownTransformResponse: … data: str Link to this property format: str Link to this property mime\_type: str Link to this property name: str Link to this property tokens: str Link to this property
[Link to this property](<#(resource)%20ai.to_markdown%20%3E%20(model)%20to_markdown_transform_response%20%3E%20(schema)>)
class ToMarkdownSupportedResponse: … extension: str Link to this property mime\_type: str Link to this property
[Link to this property](<#(resource)%20ai.to_markdown%20%3E%20(model)%20to_markdown_supported_response%20%3E%20(schema)>)