ngodingdocs

API Reference

Chat Completions

POST /v1/chat/completions — format OpenAI Chat, streaming, tool calling.

Chat Completions

POST /v1/chat/completions — format OpenAI Chat Completions. Semua model (termasuk yang upstream-nya Anthropic) bisa dipanggil lewat endpoint ini; terjemahan ke format upstream terjadi otomatis.

Contoh

curl <API>/v1/chat/completions \
  -H "Authorization: Bearer $NGODING_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "messages": [
      {"role": "system", "content": "Jawab singkat."},
      {"role": "user", "content": "Apa ibu kota Indonesia?"}
    ],
    "max_tokens": 128
  }'

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

Streaming

Kirim "stream": true untuk SSE (text/event-stream). Chunk memakai format OpenAI standar; nama model di setiap chunk sudah ditulis ulang ke id publik (mis. claude-opus-5-5, bukan nama upstream). Bila klien tidak meminta usage, chunk khusus-usage dibuang otomatis.

Stream yang terputus (klien disconnect atau upstream putus) tetap ditagih dari usage yang sudah terlihat; komponen yang belum terlihat diestimasi. Jangan mengandalkan disconnect untuk menghindari tagihan.

Tool calling

Tool fungsi didukung di semua jalur (tools[].function + pesan role: "tool" untuk hasilnya). Web search lewat web_search_options dijalankan Ngoding sendiri; sumbernya muncul sebagai anotasi url_citation di message.annotations (lihat Server tools). Tool server lain (file_search, code_interpreter, mcp, …) ditolak 400 unsupported_tool di semua jalur, termasuk passthrough. Detail lengkap: Kompatibilitas.

Batas parameter

  • max_tokens yang melebihi batas keluaran model dipotong ke batas itu, bukan error.
  • n > 1 di jalur terjemah → 400. Minta satu completion per request.
  • response_format (termasuk JSON schema) diterjemahkan ke format output masing-masing upstream bila didukung.

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.