--- title: Run a Workers AI model --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [AI](https://developers.cloudflare.com/api/go/resources/ai) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Run a Workers AI model client.AI.Run(ctx, modelName, params) (\*[AIRunResponseUnion](), error) POST/accounts/{account\_id}/ai/run/{model\_name} Runs the Workers AI model specified in the URL path. Send the model’s inputs directly in the request body, without a model/input/options wrapper. Accepts model-specific JSON or binary input. The response format depends on the model and the requested output. See the [model catalog](https://developers.cloudflare.com/workers-ai/models/) for supported models and their input formats. ##### Security
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required) `Workers AI Write``Workers AI Read` ##### ParametersExpand Collapse modelName string Workers AI model identifier, including its namespace and model name. [Link to this property](<#(resource)%20ai%20%3E%20(method)%20run%20%3E%20(params)%20default%20%3E%20(param)%20model_name%20%3E%20(schema)>)
params AIRunParams AccountID param.Field\[string] Path param: Cloudflare account ID used for this AI model request. Link to this property Text param.Field\[string] Body param: The text that you want to classify minLength1 Link to this property
[Link to this property](<#(resource)%20ai%20%3E%20(method)%20run%20%3E%20(params)%200>) ##### ReturnsExpand Collapse
type AIRunResponseUnion interface{…} An array of classification results for the input text One of the following:
type AIRunResponseTextClassification \[]AIRunResponseTextClassificationItem An array of classification results for the input text Label stringOptional The classification label assigned to the text (e.g., ‘POSITIVE’ or ‘NEGATIVE’) Link to this property Score float64Optional Confidence score indicating the likelihood that the text belongs to the specified label Link to this property
Link to this property UnionString Link to this property
type AIRunResponseAudio struct{…} Audio stringOptional The generated audio in MP3 format, base64-encoded Link to this property
Link to this property UnionString Link to this property
type AIRunResponseTextEmbeddings struct{…} Data \[]\[]float64Optional Embeddings of the requested text values Link to this property Shape \[]float64Optional Link to this property
Link to this property
type AIRunResponseAutomaticSpeechRecognition struct{…} Text string The transcription Link to this property Vtt stringOptional Link to this property WordCount float64Optional Link to this property
Words \[]AIRunResponseAutomaticSpeechRecognitionWordOptional End float64Optional The ending second when the word completes Link to this property Start float64Optional The second this word begins in the recording Link to this property Word stringOptional Link to this property
Link to this property
Link to this property
type AIRunResponseImageClassification \[]AIRunResponseImageClassificationItem Label stringOptional The predicted category or class for the input image based on analysis Link to this property Score float64Optional 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
type AIRunResponseObjectDetection \[]AIRunResponseObjectDetectionItem An array of detected objects within the input image
Box AIRunResponseObjectDetectionBoxOptional Coordinates defining the bounding box around the detected object Xmax float64Optional The x-coordinate of the bottom-right corner of the bounding box Link to this property Xmin float64Optional The x-coordinate of the top-left corner of the bounding box Link to this property Ymax float64Optional The y-coordinate of the bottom-right corner of the bounding box Link to this property Ymin float64Optional The y-coordinate of the top-left corner of the bounding box Link to this property
Link to this property Label stringOptional The class label or name of the detected object Link to this property Score float64Optional Confidence score indicating the likelihood that the detection is correct Link to this property
Link to this property
type AIRunResponseObject struct{…} Response string The generated text response from the model Link to this property
ToolCalls \[]AIRunResponseObjectToolCallOptional An array of tool calls requests made during the response generation Arguments unknownOptional The arguments passed to be passed to the tool call request Link to this property Name stringOptional The name of the tool to be called Link to this property
Link to this property
Usage AIRunResponseObjectUsageOptional Usage statistics for the inference request CompletionTokens float64Optional Total number of tokens in output Link to this property PromptTokens float64Optional Total number of tokens in input Link to this property TotalTokens float64Optional Total number of input and output tokens Link to this property
Link to this property
Link to this property UnionString Link to this property
type AIRunResponseTranslation struct{…} TranslatedText stringOptional The translated text in the target language Link to this property
Link to this property
type AIRunResponseSummarization struct{…} Summary stringOptional The summarized version of the input text Link to this property
Link to this property
type AIRunResponseImageToText struct{…} Description stringOptional Link to this property
Link to this property
type AIRunResponseImageTextToText struct{…} Description stringOptional Link to this property
Link to this property
type AIRunResponseMultimodalEmbeddings struct{…} Data \[]\[]float64Optional Link to this property Shape \[]float64Optional Link to this property
Link to this property
[Link to this property](<#(resource)%20ai%20%3E%20(model)%20AIRunResponse%20%3E%20(schema)>) ### Run a Workers AI model Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/ai" "github.com/cloudflare/cloudflare-go/option" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) response, err := client.AI.Run( context.TODO(), "@cf/meta/llama-3.1-8b-instruct", ai.AIRunParams{ AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), }, ) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response) } ``` 200 example ``` { "result": [ { "label": "label", "score": 0 } ] } ``` ##### Returns Examples 200 example ``` { "result": [ { "label": "label", "score": 0 } ] } ```