Docs / API
Responses
POST /v1/responses dalam format OpenAI Responses.
Terakhir diperbarui
Setup Anda
Mengisi YOUR_API_KEY di kode halaman ini. Key hanya ada di tab ini: tidak dikirim dan tidak disimpan.
Endpoint
POST https://api.cent-ai.dev/v1/responses
Authorization: Bearer cai_<secret>
Content-Type: application/json
Endpoint ini mengikuti format OpenAI Responses. Pakai base URL https://api.cent-ai.dev/v1.
Request
model, input, stream, tools, reasoning, dan previous_response_id dikirim ke model apa adanya, seperti parameter lain.
| Hal | Perilaku |
|---|---|
previous_response_id | Diteruskan tanpa diubah |
store | Diteruskan ke model bila model mendukungnya. Cent AI sendiri tidak menyimpan state respons |
| Usage | usage.input_tokens, usage.input_tokens_details.cached_tokens, dan usage.output_tokens, ditambah usage.cost |
Contoh
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"}'
Respons
{
"id": "resp_7a1",
"object": "response",
"model": "gpt-6-sol",
"status": "completed",
"output": [{"type": "message", "role": "assistant", "content": [{"type": "output_text", "text": "Halo!"}]}],
"usage": {
"input_tokens": 5200,
"input_tokens_details": {"cached_tokens": 4800},
"output_tokens": 310,
"total_tokens": 5510,
"cost": "0.000124000"
}
}
Streaming
Dengan stream: true Anda menerima event Responses standar: response.created, response.output_text.delta, dan response.completed. Objek response di dalam response.completed membawa usage.cost. Bila stream gagal setelah dimulai, Anda menerima response.failed dengan kode error-nya, lihat Stream timeout.
event: response.created
data: {"type":"response.created","sequence_number":0,"response":{"id":"resp_7a1","object":"response","created_at":1792051200,"status":"in_progress","model":"gpt-6-sol","output":[],"usage":null}}
event: response.output_text.delta
data: {"type":"response.output_text.delta","sequence_number":4,"item_id":"msg_7a1","output_index":0,"content_index":0,"delta":"Halo","logprobs":[]}
event: response.completed
data: {"type":"response.completed","sequence_number":7,"response":{"id":"resp_7a1","object":"response","created_at":1792051200,"status":"completed","model":"gpt-6-sol","output":[{"type":"message","id":"msg_7a1","role":"assistant","status":"completed","content":[{"type":"output_text","text":"Halo!","annotations":[]}]}],"usage":{"input_tokens":5200,"input_tokens_details":{"cached_tokens":4800},"output_tokens":310,"total_tokens":5510,"cost":"0.000124000"}}}
Contoh di atas diringkas: event standar lain, seperti response.output_item.added dan response.content_part.added, datang di antaranya dan ikut diteruskan.
Kontrak
POST/v1/responses
Responses (OpenAI format)
Autentikasi · Key API (Bearer atau x-api-key)
Body request
inputobjectwajibmodelstringwajibprevious_response_idstringopsionalstorebooleanopsionalstreambooleanopsional
Respons
- 200Response object, or an SSE stream of Responses events;
usage.costis on the response inresponse.completed. - 400Error in the OpenAI shape.
- 401Error in the OpenAI shape.
- 402Error in the OpenAI shape.
- 403Error in the OpenAI shape.
- 404Error in the OpenAI shape.
- 413Error in the OpenAI shape.
- 429Error in the OpenAI shape that may be retried after Retry-After.ulangi
- 500Error in the OpenAI shape.
- 503Error in the OpenAI shape that may be retried after Retry-After.ulangi
Header respons
Retry-Afterx-request-id
Dibuat dari kontrak OpenAPI.