Anthropic · Messages

POST /v1/messages

Auth: auth page. Claude Code: chapter. Base is the site root — see protocols.

http

x-api-key: sk-xxxx
anthropic-version: 2023-06-01
Content-Type: application/json

bash

curl https://api.daoxe.com/v1/messages \
  -H "x-api-key: sk-xxxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "copy from /v1/models",
    "max_tokens": 64,
    "messages": [{"role":"user","content":"ping"}]
  }'

max_tokens

Messages requests usually must include max_tokens.

Success response (structure)

json

{
  "id": "msg_xxx",
  "type": "message",
  "role": "assistant",
  "content": [{ "type": "text", "text": "..." }],
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 10, "output_tokens": 20 }
}

Error samples

json

{"type":"error","error":{"type":"invalid_request_error","message":"max_tokens: required"}}
{"error":{"message":"Invalid token","code":401}}