anoman
Referensi · Anthropic Messages

POST /anthropic/v1/messages

Anthropic Messages API, diterjemahkan ke jalur OpenAI secara internal dengan pipeline Anoman penuh. Arahkan klien Anthropic SDK mana pun — atau Claude Code — ke Anoman.

Ikhtisar

Endpoint kompatibel Anthropic

POST /anthropic/v1/messages menerima format Anthropic Messages dan menjalankannya melalui guardrail dan metering yang sama seperti request lainnya. Ini ada agar klien Anthropic SDK dan Claude Code dapat melewati Anoman tanpa perubahan kode.

Setel ANTHROPIC_BASE_URL=https://api.anoman.io/anthropic dan ANTHROPIC_API_KEY=anm-sk-.... Autentikasi memakai API key Anoman Anda (header x-api-key yang dikirim Anthropic SDK, atau token Bearer).

Request

Body request

Body mengikuti format Anthropic Messages:

curl https://api.anoman.io/anthropic/v1/messages \
  -H "x-api-key: anm-sk-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "system": "You are a concise assistant.",
    "messages": [
      {"role": "user", "content": "Explain data residency in one sentence."}
    ]
  }'
FieldDeskripsi
modelId model (mis. claude-sonnet-4-6). Wajib.
max_tokensToken maksimum yang dihasilkan. Wajib (konvensi Anthropic).
messagesPercakapan — array berisi giliran {role, content}.
systemSystem prompt tingkat atas yang opsional.
streamSetel true untuk streaming SSE dalam format event Anthropic.
temperatureTemperature sampling yang opsional.

Streaming & guardrail

Perilaku

  • Streaming: setel stream: true dan response berupa SSE dalam format event Anthropic (message_startcontent_block_deltamessage_stop). Lihat /docs/streaming untuk format wire.
  • Guardrail: seluruh pipeline pra-panggilan berlaku. Request yang diblokir mengembalikan 403 sebelum token apa pun mengalir.

Response

Body response

Response berbentuk pesan Anthropic — teks ada di content[].text dan jumlah token di usage.

{
  "id": "msg_01AbC...",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-6",
  "content": [
    {"type": "text", "text": "Data residency keeps a customer's data processed and stored within a specified jurisdiction."}
  ],
  "stop_reason": "end_turn",
  "usage": {"input_tokens": 24, "output_tokens": 19}
}

Claude Code

Arahkan Claude Code melalui Anoman

Setel dua variabel environment dan setiap request Claude Code mengalir melalui guardrail dan metering Anoman — tanpa file konfigurasi, tanpa perubahan kode:

# Route Claude Code (or any Anthropic SDK client) through Anoman
export ANTHROPIC_BASE_URL=https://api.anoman.io/anthropic
export ANTHROPIC_API_KEY=anm-sk-...

claude   # every request now passes through Anoman guardrails + metering

Dua env var yang sama bekerja untuk klien Anthropic SDK mana pun. Untuk panduan setup per-agen lihat /docs/agents.

Arahkan klien Anthropic Anda melalui Anoman.

Guardrail dan metering penuh pada Messages API yang sudah Anda pakai.