POST
/
v1
/
agents
cURL
curl --request POST \
  --url https://api.z.ai/api/v1/agents \
  --header 'Accept-Language: <accept-language>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "agent_id": "general_translation",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "<string>"
        }
      ]
    }
  ]
}'
{
  "id": "<string>",
  "agent_id": "<string>",
  "choices": [
    {
      "index": 123,
      "finish_reason": "<string>",
      "messages": [
        {
          "role": "<string>",
          "content": {
            "text": "<string>",
            "type": "<string>"
          }
        }
      ]
    }
  ],
  "usage": {
    "prompt_tokens": 123,
    "completion_tokens": 123,
    "total_tokens": 123,
    "total_calls": 123
  }
}

Authorizations

​
Authorization
string
header
required

Use the following format for authentication: Bearer <your api key>

Headers

​
Accept-Language
enum<string>
default:en-US,en
required

It is an HTTP request header used to inform the server of the browser's preferred list of languages, so the server can return content in the language that best matches the user's preference.

Available options:
en-US,en

Body

application/json

Response

200
application/json

Business processing successful

The response is of type object.