ドキュメントAPI リファレンスResponses API

Responses API

OpenAI 互換の Responses エンドポイント：リクエストフィールド、レスポンス形式、ストリーミング。

POST/v1/responses

OpenAI Responses API のリクエストボディと互換の対話エンドポイントで、Codex などのコーディングツールが実際に使用するインターフェースです。認証は Authorization: Bearer を使います。

リクエストボディ

フィールド	型	必須	説明
`model`	string	はい	モデル id。モデル一覧を参照。
`input`	string \| array	はい	ユーザー入力：プレーンテキスト、または複数ターン/マルチモーダルのメッセージ配列。
`instructions`	string	いいえ	システムプロンプト。
`max_output_tokens`	integer	いいえ	出力トークンの上限（16 以上）。
`stream`	boolean	いいえ	`true` の場合、SSE でストリーミング返却します。ストリーミング参照。
`temperature` / `tools` / …	—	いいえ	その他の公式フィールドはそのまま転送され、対応可否は対象モデルに依存します。

request.sh

curl https://api.soleapi.com/v1/responses \
  -H "Authorization: Bearer $SOLEAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-fable-5",
    "input": "Write a haiku about the sea",
    "max_output_tokens": 200
  }'

レスポンス

response.json

{
  "id": "resp_abc123",
  "object": "response",
  "model": "claude-fable-5",
  "status": "completed",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        { "type": "output_text", "text": "Waves fold into foam..." }
      ]
    }
  ],
  "usage": {
    "input_tokens": 14,
    "output_tokens": 23,
    "total_tokens": 37
  }
}

usage のトークン数がそのまま課金の根拠になります。公式 SDK では resp.output_text でプレーンテキストを取得できます。

リクエストボディ

レスポンス

関連エンドポイント