Menu docs

Docs / API

Messages

POST /v1/messages dalam format Anthropic, untuk SDK dan tool Anthropic seperti Claude Code.

Terakhir diperbarui


Setup Anda

Mengisi YOUR_API_KEY di kode halaman ini. Key hanya ada di tab ini: tidak dikirim dan tidak disimpan.

Endpoint

POST https://api.cent-ai.dev/v1/messages
x-api-key: cai_<secret>
anthropic-version: 2023-06-01
Content-Type: application/json

Endpoint ini mengikuti format Anthropic Messages. SDK Anthropic menambahkan /v1/messages sendiri, jadi base URL-nya https://api.cent-ai.dev, tanpa /v1. Authorization: Bearer sama berfungsinya dengan x-api-key.

Request

model, messages, system, max_tokens (wajib menurut formatnya), stream, tools, dan thinking dikirim ke model apa adanya.

HalPerilaku
anthropic-versionDiterima dan diteruskan
anthropic-betaDiteruskan bila ada
cache_controlDiteruskan tanpa diubah, lihat Prompt caching

Contoh

curl https://api.cent-ai.dev/v1/messages \
  -H "x-api-key: $CENT_AI_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-opus-5","max_tokens":1024,"messages":[{"role":"user","content":"Halo"}]}'

Tool yang membaca variabel lingkungan Anthropic memakai dua nilai yang sama:

export ANTHROPIC_BASE_URL=https://api.cent-ai.dev
export ANTHROPIC_API_KEY="YOUR_API_KEY"

Respons

{
  "id": "msg_01Xyz",
  "type": "message",
  "role": "assistant",
  "model": "claude-opus-5",
  "content": [{"type": "text", "text": "Halo!"}],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 1200,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 8800,
    "output_tokens": 410,
    "cost": "0.003210000"
  }
}

Di format ini input_tokens tidak termasuk token cache. cache_read_input_tokens ditagih dengan tarif cache read dan cache_creation_input_tokens dengan tarif cache write. Bila model melaporkan cache write per masa berlaku (cache_creation.ephemeral_5m_input_tokens, cache_creation.ephemeral_1h_input_tokens), keduanya ditagih dengan tarif input.

Streaming

Dengan "stream": true Anda menerima event Anthropic standar. message_delta terakhir membawa usage.cost:

event: message_start
data: {"type":"message_start","message":{"id":"msg_01Xyz","type":"message","role":"assistant","model":"claude-opus-5","content":[],"usage":{"input_tokens":1200,"cache_read_input_tokens":8800,"output_tokens":1}}}

event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":"Halo"}}

event: message_delta
data: {"type":"message_delta","delta":{"stop_reason":"end_turn"},"usage":{"output_tokens":410,"cost":"0.003210000"}}

event: message_stop
data: {"type":"message_stop"}

Error di format ini

Error di /v1/messages memakai bentuk Anthropic:

{"type": "error", "error": {"type": "authentication_error", "message": "Invalid API key. Check the key or create a new one in the dashboard."}}

type mengikuti status: 400 dan 402 invalid_request_error, 401 authentication_error, 403 permission_error, 404 not_found_error, 413 request_too_large, 429 rate_limit_error, upstream_timeout timeout_error, 5xx lain api_error. Lihat Error.

Menghitung token

POST /v1/messages/count_tokens mengembalikan {"input_tokens": N} dan tidak ditagih. Bila model tidak bisa menghitung, Cent AI memperkirakannya dengan tokenizer. Endpoint ini dihitung dalam rate limit key.

Kontrak


POST/v1/messages

Messages (Anthropic format)

Autentikasi · Key API (Bearer atau x-api-key)

Body request

  • max_tokensintegeropsional

  • messagesobject[]wajib

  • modelstringwajib

  • streambooleanopsional

  • systemobjectopsional

  • thinkingobjectopsional

  • toolsobject[]opsional

Respons

  • 200Message, or an SSE stream of Anthropic events; usage.cost is in the last message_delta.
  • 400Error in the Anthropic shape.
  • 401Error in the Anthropic shape.
  • 402Error in the Anthropic shape.
  • 403Error in the Anthropic shape.
  • 404Error in the Anthropic shape.
  • 413Error in the Anthropic shape.
  • 429Error in the Anthropic shape.
  • 500Error in the Anthropic shape.
  • 503Error in the Anthropic shape.

Header respons

x-request-id

POST/v1/messages/count_tokens

Count input tokens (not billed)

Autentikasi · Key API (Bearer atau x-api-key)

Body request

  • max_tokensintegeropsional

  • messagesobject[]wajib

  • modelstringwajib

  • streambooleanopsional

  • systemobjectopsional

  • thinkingobjectopsional

  • toolsobject[]opsional

Respons

  • 200Token count.
  • 401Error in the Anthropic shape.
  • 404Error in the Anthropic shape.
  • 429Error in the Anthropic shape.

Header respons

x-request-id

Dibuat dari kontrak OpenAPI.