ngodingdocs

API Reference

Messages

POST /v1/messages & count_tokens — format Anthropic untuk Claude Code & SDK Anthropic.

Messages

POST /v1/messages — format Anthropic Messages. Dipakai Claude Code dan SDK anthropic apa adanya.

Header wajib

x-api-key: sk-ngd-xxxx
anthropic-version: 2023-06-01
Content-Type: application/json

anthropic-version mengikuti konvensi Anthropic (nilai dari klien dipakai bila ada, else 2023-06-01). Header anthropic-beta diteruskan ke upstream.

Contoh

curl <API>/v1/messages \
  -H "x-api-key: $NGODING_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 256,
    "system": "Jawab singkat.",
    "messages": [{"role": "user", "content": "Apa ibu kota Indonesia?"}]
  }'

Ganti <API> dengan https://api.ngoding.in.

Thinking & effort

  • thinking: {type: "enabled"} (klien lama) dipetakan ke effort medium.
  • Encode ke upstream memakai thinking: {type: "adaptive"} + output_config: {effort} — tanpa budget_tokens (ditolak model 4.7+).
  • Thinking dari Anthropic dikembalikan ke klien OpenAI sebagai reasoning_content (Chat) / item reasoning (Responses).

Server tool

Web search, web fetch, dan X search (ekstensi Ngoding) dijalankan Ngoding sendiri, lalu muncul sebagai blok standar server_tool_use, web_search_tool_result, dan web_fetch_tool_result, lengkap dengan usage.server_tool_use dan stop_reason: "pause_turn". Cara pakai, harga, dan batasnya: Server tools.

Menghitung token gratis

POST /v1/messages/count_tokens — butuh kunci valid, tidak memotong credit:

  • Route model yang mendukung count_tokens → diteruskan ke upstream (model di-patch ke nama upstream).
  • Selain itu → estimasi lokal dari teks request.

Daftar model

GET /v1/models mengembalikan daftar OpenAI; bila header anthropic-version disertakan, format daftar Anthropic. GET /v1/models/:id untuk satu model.


Coba langsung: referensi interaktif + try-it di OpenAPI — request dikirim dari browser ke https://api.ngoding.in, kuncimu hanya disimpan di sessionStorage tab ini (hilang saat tab ditutup) dan tidak pernah dicatat.