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.
| Hal | Perilaku |
|---|---|
anthropic-version | Diterima dan diteruskan |
anthropic-beta | Diteruskan bila ada |
cache_control | Diteruskan 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_tokensintegeropsionalmessagesobject[]wajibmodelstringwajibstreambooleanopsionalsystemobjectopsionalthinkingobjectopsionaltoolsobject[]opsional
Respons
- 200Message, or an SSE stream of Anthropic events;
usage.costis in the lastmessage_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_tokensintegeropsionalmessagesobject[]wajibmodelstringwajibstreambooleanopsionalsystemobjectopsionalthinkingobjectopsionaltoolsobject[]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.