Referensi API Lengkap
Base URL: https://api.anoman.io. Semua endpoint terautentikasi memerlukan header Authorization: Bearer anm-sk-....
Kompatibel OpenAI
/v1/ — Kompatibel OpenAI
| Method | Endpoint | Deskripsi |
|---|---|---|
POST | /v1/chat/completions | Endpoint utama. Mendukung stream:true (SSE) dan permintaan yang memenuhi syarat batch (mengembalikan 202 + poll_url). |
POST | /v1/completions | Passthrough text completions lawas. |
GET | /v1/models | Katalog model. Setiap model mencakup: tier, provider, batch_support, provider_multiplier, tier_multiplier. |
POST | /v1/embeddings | Passthrough embeddings ke provider. |
Kompatibel Anthropic
/anthropic/ — Anthropic Messages API
| Method | Endpoint | Deskripsi |
|---|---|---|
POST | /anthropic/v1/messages | Proxy penuh Anthropic Messages API. Streaming didukung. Setel ANTHROPIC_BASE_URL=https://api.anoman.io/anthropic. |
Publik (tanpa auth)
/public/v1/
| Method | Endpoint | Deskripsi |
|---|---|---|
GET | /public/v1/pricing | Harga model dengan markup 0%. Tanpa auth. ISR 1 jam. |
GET | /public/v1/status | Status sistem, kesehatan provider, insiden aktif. Tanpa auth. ISR 60 detik. |
GET | /public/v1/models | Katalog model publik (is_public=true). Tanpa auth. |
Native Anoman
Kunci API
| Method | Endpoint | Deskripsi |
|---|---|---|
POST | /anoman/v1/keys | Buat API key virtual. |
GET | /anoman/v1/keys | Daftar key untuk pelanggan terautentikasi. |
DELETE | /anoman/v1/keys/{id} | Cabut key. |
PATCH | /anoman/v1/keys/{id} | Perbarui nama key, budget, atau guardrail_overrides. |
Traces & Sesi Agen
| Method | Endpoint | Deskripsi |
|---|---|---|
GET | /anoman/v1/traces | Daftar traces dengan filter (model, date, routing_mode, cache_hit). |
GET | /anoman/v1/traces/{id} | Detail trace dengan spans. |
GET | /anoman/v1/sessions | Daftar sesi agen (dapat difilter berdasarkan agent_id, status). |
GET | /anoman/v1/sessions/{id}/actions | Linimasa aksi untuk sebuah sesi. |
Penggunaan & Tagihan
| Method | Endpoint | Deskripsi |
|---|---|---|
GET | /anoman/v1/usage | Statistik penggunaan (tokens, cost, requests) untuk periode saat ini. |
GET | /anoman/v1/usage/by-model | Rincian penggunaan per model. |
GET | /anoman/v1/usage/savings | Rincian penghematan cache dan penghematan batch. |
GET | /anoman/v1/usage/batch-economics | Rasio batch, penghematan, dan kepatuhan SLA. |
GET | /anoman/v1/usage/rate-limits | Penggunaan batas token per-pelanggan berdasarkan kelas tier model plus status burst-guard RPM/TPM. |
Batch Job
| Method | Endpoint | Deskripsi |
|---|---|---|
GET | /anoman/v1/batch/{job_id} | Poll batch job. Mengembalikan 202 (processing) atau 200 (complete) dengan hasil chat completion lengkap. |
GET | /anoman/v1/batch | Daftar semua batch job untuk API key. |
DELETE | /anoman/v1/batch/{job_id} | Batalkan job dalam antrean. |
Kredit Burst
| Method | Endpoint | Deskripsi |
|---|---|---|
POST | /anoman/v1/burst/activate | Beli peningkatan rate limit sementara (2x/5x/10x selama 1h/4h/24h). Dipotong dari saldo prabayar. |
GET | /anoman/v1/burst/status | Cek burst aktif untuk key saat ini. |
DELETE | /anoman/v1/burst/deactivate | Batalkan burst aktif (tanpa pengembalian dana). |
GET | /anoman/v1/burst/pricing | Opsi burst yang tersedia untuk tier saat ini. |
Kebijakan
| Method | Endpoint | Deskripsi |
|---|---|---|
POST | /anoman/v1/policies | Buat kebijakan agen. |
GET | /anoman/v1/policies | Daftar kebijakan. |
PUT | /anoman/v1/policies/{id} | Perbarui kebijakan (aturan tool, batas budget). |
DELETE | /anoman/v1/policies/{id} | Hapus kebijakan. |
Tata Kelola MCP
| Method | Endpoint | Deskripsi |
|---|---|---|
POST | /anoman/v1/mcp/servers | Daftarkan server MCP — menemukan tools via tools/list. |
GET | /anoman/v1/mcp/servers/{id}/tools | Daftar tools yang diekspos oleh server MCP. |
PATCH | /anoman/v1/mcp/tools/{tool_id} | Perbarui policy_mode tool (allow/deny/require_approval) dan rate_limit_per_min. |
GET | /anoman/v1/mcp/invocations | Log audit pemanggilan tool MCP. |
Anomali & Audit
| Method | Endpoint | Deskripsi |
|---|---|---|
GET | /anoman/v1/anomalies | Daftar anomali terdeteksi dengan severity dan detection_method. |
POST | /anoman/v1/anomalies/{id}/ack | Akui anomali. |
GET | /anoman/v1/audit/events | Log audit SOC2 — paginasi berbasis cursor, ekspor NDJSON tersedia. |
Umpan Langsung (SSE)
| Method | Endpoint | Deskripsi |
|---|---|---|
GET | /anoman/v1/events/stream | Stream SSE. Events: request, blocked, batch_enqueued, batch_completed, batch_escalated, anomaly, provider_issue. |
SSO (Enterprise)
| Method | Endpoint | Deskripsi |
|---|---|---|
POST | /anoman/v1/sso/connections | Daftarkan SAML IdP (Enterprise). Mengembalikan metadata_url untuk penyiapan IdP. |
GET | /anoman/v1/sso/connections | Daftar koneksi SSO. |
DELETE | /anoman/v1/sso/connections/{id} | Nonaktifkan koneksi SSO. |
Kode error
Respons error standar
| HTTP | Kode | Arti |
|---|---|---|
| 401 | auth_invalid | API key tidak valid atau tidak ada. |
| 402 | budget_exceeded | Budget bulanan habis. |
| 402 | token_quota_exceeded | Batas token mingguan atau bulanan tercapai untuk kelas tier model. |
| 403 | policy_violation | Panggilan tool diblokir oleh kebijakan. |
| 403 | guardrail_triggered | Konten diblokir oleh guardrail. |
| 429 | rate_limit_exceeded | Burst guard RPM atau TPM terpicu. |
| 429 | concurrent_limit_exceeded | Batas inflight per-key tercapai. |
| 503 | provider_unavailable | Semua provider gagal setelah percobaan ulang. |
Header respons
Header transparansi X-Anoman-*
| Header | Contoh nilai |
|---|---|
X-Anoman-Guardrail-Injection | pass score=0.12 |
X-Anoman-Guardrail-Pii | masked 3 entities |
X-Anoman-Guardrail-Content | pass |
X-Anoman-Cache | none | provider | semantic |
X-Anoman-Region | ID | SG |
X-Anoman-Tier | starter | pro | payg | enterprise |
X-Anoman-Burst-Active | true | false |
X-Anoman-Guardrail-Master | disabled (when all guardrails bypassed) |
X-Anoman-Inflight-Cap | 150 (on 429) |