Messages

Overview

The Anthropic-compatible Messages API — use the Anthropic SDK, or tools like Claude Code, unchanged except for the base URL and key.

Method

POST

Path

/v1/messages

Auth

Authorization: Bearer <KUMO_API_KEY>

Request

Base URL: https://api.kumo.cloud/v1

curl https://api.kumo.cloud/v1/messages \
  -H "Authorization: Bearer $KUMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{ "role": "user", "content": "Explain tokens in one line." }]
  }'

Response

The reply text is in content[0].text; exact token counts are in usage.input_tokens / usage.output_tokens.

{
  "id": "msg_8f2b7e10c9",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-6",
  "content": [{ "type": "text", "text": "..." }],
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 12, "output_tokens": 18 }
}