anoman
Referensi API

Referensi API Lengkap

Base URL: https://api.anoman.io — Semua endpoint terautentikasi memerlukan Authorization: Bearer anm-sk-...

Kompatibel OpenAI

/v1/ — Kompatibel OpenAI

  • POST
    /v1/chat/completionsEndpoint utama. Mendukung stream:true (SSE) dan permintaan yang memenuhi syarat batch (mengembalikan 202 + poll_url).
  • POST
    /v1/completionsPassthrough text completions lawas.
  • GET
    /v1/modelsKatalog model. Setiap model mencakup: tier, provider, batch_support, provider_multiplier, tier_multiplier.
  • POST
    /v1/embeddingsPassthrough embeddings ke provider.

Kompatibel Anthropic

/anthropic/ — Anthropic Messages API

  • POST
    /anthropic/v1/messagesProxy penuh Anthropic Messages API. Streaming didukung. Setel ANTHROPIC_BASE_URL=https://api.anoman.io/anthropic.

Publik (tanpa auth)

/public/v1/

  • GET
    /public/v1/pricingHarga model dengan markup 0%. Tanpa auth. ISR 1 jam.
  • GET
    /public/v1/statusStatus sistem, kesehatan provider, insiden aktif. Tanpa auth. ISR 60 detik.
  • GET
    /public/v1/modelsKatalog model publik (is_public=true). Tanpa auth.

Native Anoman

Kunci API

  • POST
    /anoman/v1/keysBuat API key virtual.
  • GET
    /anoman/v1/keysDaftar 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

  • GET
    /anoman/v1/tracesDaftar traces dengan filter (model, date, routing_mode, cache_hit).
  • GET
    /anoman/v1/traces/{id}Detail trace dengan spans.
  • GET
    /anoman/v1/sessionsDaftar sesi agen (dapat difilter berdasarkan agent_id, status).
  • GET
    /anoman/v1/sessions/{id}/actionsLinimasa aksi untuk sebuah sesi.

Penggunaan & Tagihan

  • GET
    /anoman/v1/usageStatistik penggunaan (tokens, cost, requests) untuk periode saat ini.
  • GET
    /anoman/v1/usage/by-modelRincian penggunaan per model.
  • GET
    /anoman/v1/usage/savingsRincian penghematan cache dan penghematan batch.
  • GET
    /anoman/v1/usage/batch-economicsRasio batch, penghematan, dan kepatuhan SLA.
  • GET
    /anoman/v1/usage/rate-limitsPenggunaan batas token per-pelanggan berdasarkan kelas tier model plus status burst-guard RPM/TPM.

Batch Job

  • GET
    /anoman/v1/batch/{job_id}Poll batch job. Mengembalikan 202 (processing) atau 200 (complete) dengan hasil chat completion lengkap.
  • GET
    /anoman/v1/batchDaftar semua batch job untuk API key.
  • DELETE
    /anoman/v1/batch/{job_id}Batalkan job dalam antrean.

Kredit Burst

  • POST
    /anoman/v1/burst/activateBeli peningkatan rate limit sementara (2x/5x/10x selama 1h/4h/24h). Dipotong dari saldo prabayar.
  • GET
    /anoman/v1/burst/statusCek burst aktif untuk key saat ini.
  • DELETE
    /anoman/v1/burst/deactivateBatalkan burst aktif (tanpa pengembalian dana).
  • GET
    /anoman/v1/burst/pricingOpsi burst yang tersedia untuk tier saat ini.

Kebijakan

  • POST
    /anoman/v1/policiesBuat kebijakan agen.
  • GET
    /anoman/v1/policiesDaftar kebijakan.
  • PUT
    /anoman/v1/policies/{id}Perbarui kebijakan (aturan tool, batas budget).
  • DELETE
    /anoman/v1/policies/{id}Hapus kebijakan.

Tata Kelola MCP

  • POST
    /anoman/v1/mcp/serversDaftarkan server MCP — menemukan tools via tools/list.
  • GET
    /anoman/v1/mcp/servers/{id}/toolsDaftar 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/invocationsLog audit pemanggilan tool MCP.

Anomali & Audit

  • GET
    /anoman/v1/anomaliesDaftar anomali terdeteksi dengan severity dan detection_method.
  • POST
    /anoman/v1/anomalies/{id}/ackAkui anomali.
  • GET
    /anoman/v1/audit/eventsLog audit SOC2 — paginasi berbasis cursor, ekspor NDJSON tersedia.

Umpan Langsung (SSE)

  • GET
    /anoman/v1/events/streamStream SSE. Events: request, blocked, batch_enqueued, batch_completed, batch_escalated, anomaly, provider_issue.

SSO (Enterprise)

  • POST
    /anoman/v1/sso/connectionsDaftarkan SAML IdP (Enterprise). Mengembalikan metadata_url untuk penyiapan IdP.
  • GET
    /anoman/v1/sso/connectionsDaftar koneksi SSO.
  • DELETE
    /anoman/v1/sso/connections/{id}Nonaktifkan koneksi SSO.

Kode error

Respons error standar

HTTPKodeArti
401auth_invalidAPI key tidak valid atau tidak ada.
402budget_exceededBudget bulanan habis.
402token_quota_exceededBatas token mingguan atau bulanan tercapai untuk kelas tier model.
403policy_violationPanggilan tool diblokir oleh kebijakan.
403guardrail_triggeredKonten diblokir oleh guardrail.
429rate_limit_exceededBurst guard RPM atau TPM terpicu.
429concurrent_limit_exceededBatas inflight per-key tercapai.
503provider_unavailableSemua provider gagal setelah percobaan ulang.

Header respons

Header transparansi X-Anoman-*

HeaderContoh nilai
X-Anoman-Guardrail-Injectionpass score=0.12
X-Anoman-Guardrail-Piimasked 3 entities
X-Anoman-Guardrail-Contentpass
X-Anoman-Cachenone | provider | semantic
X-Anoman-RegionID | SG
X-Anoman-Tierstarter | pro | payg | enterprise
X-Anoman-Burst-Activetrue | false
X-Anoman-Guardrail-Masterdisabled (when all guardrails bypassed)
X-Anoman-Inflight-Cap25 (on 429)