API リファレンス上級者向け更新日
POST/v1/responses

API コンソール

POST/v1/responses
キーを確認

入力したキーで実際にリクエストを送信し、API の通常料金が適用されます。

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 があれば、キャッシュ済みの入力トークン数を示します。