API リファレンス上級者向け更新日
POST/v1/responses
OpenAI Responses
OpenAI Responses 形式で入力を送信します。例は HTTP ストリーミングです。Codex の設定は関連記事を参照してください。
事前準備
クイックスタートに沿って API Key を取得し、HTTP で直接呼び出せるエンドポイントを選びます。例では ICODEEASY_API_KEY を Bearer トークンとして送信します。YOUR_MODEL_ID をエンドポイントで利用できるモデル ID に置き換えます。
リクエスト例
model と input を指定し、stream: true で SSE を有効にします。
bash
curl -N -sS https://api.icodeeasy.cc/v1/responses \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
--data '{
"model": "YOUR_MODEL_ID",
"input": "Say hello.",
"stream": true
}'
レスポンスの読み取り
response.output_text.delta の delta を連結します。response.completed は成功、response.incomplete は未完了です。理由は response.incomplete_details にあります。HTTP 200 の後でも response.failed または error は失敗です。
text
event: response.output_text.delta
data: {"type":"response.output_text.delta","delta":"Hello!"}
event: response.completed
data: {"type":"response.completed","response":{"id":"resp_example","status":"completed","usage":{"input_tokens":10,"output_tokens":4,"total_tokens":14}}}
終了イベントの response.usage から input_tokens と output_tokens を読みます。input_tokens_details.cached_tokens があれば、キャッシュ済みの入力トークン数を示します。