Menu docs

Docs / Panduan

Chat Completions vs Responses

Format OpenAI mana yang dipakai dengan Cent AI, cara kerja state percakapan, dan beda field usage.

Terakhir diperbarui


Jawaban singkat

Kedua format bekerja dengan API key yang sama, base URL yang sama https://api.cent-ai.dev/v1, dan harga yang sama. Pilih format yang sudah dipakai tool atau SDK Anda.

PakaiKapan
Chat Completions POST /v1/chat/completionsTool atau kode Anda sudah memakai messages. Sebagian besar tool dan SDK mendukungnya
Responses POST /v1/responsesTool atau kode Anda dibangun di atas Responses API, dengan input dan previous_response_id

Format tidak mengubah harga request. Biaya bergantung pada model dan jumlah token, lihat Harga.

Beda keduanya

HalChat CompletionsResponses
Field inputmessagesinput
Riwayat percakapanAnda mengirim seluruh riwayat di messages setiap giliranAnda mengirim seluruh riwayat, atau memakai previous_response_id
Objek responschat.completion dengan choices[]response dengan output[]
Akhir streamChunk terakhir, lalu data: [DONE]Event response.completed
Error setelah stream dimulaiFrame error, lalu data: [DONE]Event response.failed

Setiap field request, termasuk tools, reasoning, dan store, dikirim ke model apa adanya.

State percakapan

Cent AI tidak menyimpan state percakapan atau respons.

  • Chat Completions tidak punya state: setiap request membawa percakapan lengkap.
  • Responses: previous_response_id diteruskan ke model tanpa diubah, dan store diteruskan bila model mendukungnya. Apakah respons sebelumnya bisa ditemukan bergantung pada model, bukan pada Cent AI. Bila percakapan harus tetap utuh di model mana pun, kirim seluruh riwayat di input.

Percakapan di kedua format tetap diarahkan ke rute yang sama antar giliran, sehingga cache prompt model bisa terpakai. Anda tidak perlu menambah field untuk ini. Lihat Prompt caching.

Field usage

Kedua format menambahkan usage.cost, jumlah yang ditagih dalam USD. Nama field token-nya berbeda.

ArtiChat CompletionsResponses
Token inputusage.prompt_tokensusage.input_tokens
Bagian yang dibaca dari cacheusage.prompt_tokens_details.cached_tokensusage.input_tokens_details.cached_tokens
Token outputusage.completion_tokensusage.output_tokens
Bagian reasoning, bila dilaporkanusage.completion_tokens_details.reasoning_tokensusage.output_tokens_details.reasoning_tokens
Totalusage.total_tokensusage.total_tokens
Biaya dalam USDusage.costusage.cost
"usage": {
  "prompt_tokens": 10000,
  "prompt_tokens_details": {"cached_tokens": 9000},
  "completion_tokens": 800,
  "total_tokens": 10800,
  "cost": "0.000363000"
}

Usage di stream

FormatTempat usage muncul
Chat CompletionsDi chunk terakhir, hanya bila Anda mengirim stream_options.include_usage: true. Request tetap ditagih bila tidak
ResponsesDi objek response pada event response.completed

Request yang sama di dua format

curl https://api.cent-ai.dev/v1/chat/completions \
  -H "Authorization: Bearer $CENT_AI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-6-sol","messages":[{"role":"user","content":"Halo"}]}'

curl https://api.cent-ai.dev/v1/responses \
  -H "Authorization: Bearer $CENT_AI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-6-sol","input":"Halo"}'

Tool dan SDK Anthropic memakai format ketiga, Messages, di host yang sama.