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.
| Pakai | Kapan |
|---|---|
Chat Completions POST /v1/chat/completions | Tool atau kode Anda sudah memakai messages. Sebagian besar tool dan SDK mendukungnya |
Responses POST /v1/responses | Tool 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
| Hal | Chat Completions | Responses |
|---|---|---|
| Field input | messages | input |
| Riwayat percakapan | Anda mengirim seluruh riwayat di messages setiap giliran | Anda mengirim seluruh riwayat, atau memakai previous_response_id |
| Objek respons | chat.completion dengan choices[] | response dengan output[] |
| Akhir stream | Chunk terakhir, lalu data: [DONE] | Event response.completed |
| Error setelah stream dimulai | Frame 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_idditeruskan ke model tanpa diubah, danstorediteruskan 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 diinput.
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.
| Arti | Chat Completions | Responses |
|---|---|---|
| Token input | usage.prompt_tokens | usage.input_tokens |
| Bagian yang dibaca dari cache | usage.prompt_tokens_details.cached_tokens | usage.input_tokens_details.cached_tokens |
| Token output | usage.completion_tokens | usage.output_tokens |
| Bagian reasoning, bila dilaporkan | usage.completion_tokens_details.reasoning_tokens | usage.output_tokens_details.reasoning_tokens |
| Total | usage.total_tokens | usage.total_tokens |
| Biaya dalam USD | usage.cost | usage.cost |
"usage": {
"prompt_tokens": 10000,
"prompt_tokens_details": {"cached_tokens": 9000},
"completion_tokens": 800,
"total_tokens": 10800,
"cost": "0.000363000"
}
Usage di stream
| Format | Tempat usage muncul |
|---|---|
| Chat Completions | Di chunk terakhir, hanya bila Anda mengirim stream_options.include_usage: true. Request tetap ditagih bila tidak |
| Responses | Di 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.