Menu docs

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.

HalPerilaku
previous_response_idDiteruskan tanpa diubah
storeDiteruskan ke model bila model mendukungnya. Cent AI sendiri tidak menyimpan state respons
Usageusage.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

  • inputobjectwajib

  • modelstringwajib

  • previous_response_idstringopsional

  • storebooleanopsional

  • streambooleanopsional

Respons

  • 200Response object, or an SSE stream of Responses events; usage.cost is on the response in response.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.