v1

latestOpenAPI 3.1.02026-07-2611077199.5 KB

post/v1/messages

Request body

modelstring required

Models supported by TTAPI, see Claude Supported Models

max_tokensnumber required

Maximum tokens to generate before stopping. Minimum: 1

streamboolean

Whether to use server-sent events for progressive response transmission

Example request

{
  "messages": [
    {
      "role": "user",
      "content": "Hello!"
    }
  ],
  "model": "claude-sonnet-4-5"
}

Response

Successful response

idstring

Unique message identifier

typestring

Response type

rolestring

Role identifier

modelstring

Model version used

stop_reasonstring nullable

Stop reason

Example response

{
  "id": "msg_018zZJf8ZJf8ZJf8ZJf8ZJf8ZJf8",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": " Hello! My name is Claude."
    }
  ],
  "model": "claude-2.0",
  "stop_reason": "stop_sequence",
  "usage": {
    "input_tokens": 15,
    "output_tokens": 22
  }
}