テキストモデル上級者向け更新日
POST/v1/responses
GPT-6.1 Terra
リクエスト ID gpt-6.1-terra
プロトコル
POST /v1/responses· OpenAI Responsesの例
認証
リクエストには API キー管理 の API キーが必要です。JSON リクエストには Content-Type: application/json を設定します。
Authorization: Bearer YOUR_API_KEY
リクエストパラメータ
POST /v1/responses
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | 必須 | モデル ID に gpt-6.1-terra を指定します。 |
input | string / object[] | 必須 | 入力テキスト、または入力項目の順序付き配列。メッセージ項目には role と content を指定します。 |
instructions | string | 任意 | タスクと出力の要件を指定するモデル向けの指示です。 |
max_output_tokens | integer | 任意 | 出力トークン数の上限です。設定可能な上限はモデルと接続先によって異なります。 |
stream | boolean | 任意 | true は SSE ストリーム、false は通常の JSON 応答を要求します。利用できるモードは接続先によって異なります。 |
store | boolean | 条件付き | この項目に対応する場合、false は後から取得するための応答保存を無効にするよう要求します。 |
text.format | object | 条件付き | 構造化出力は text.format に指定します。例は type: json_schema です。その形式に対応する接続先で使います。 |
temperature | number | 条件付き | サンプリングのランダム性を調整します。指定可能な値と有効性はモデルと接続先によって異なります。 |
top_p | number | 条件付き | 累積確率でサンプリング候補を絞ります。対応するモデルと接続先で使います。 |
reasoning.effort | string | 条件付き | 推論の強度です。選べる強度と推論を無効にできるかはモデルと接続先によって異なります。 |
tools | object[] | 条件付き | モデルが呼び出せるツールの定義。ツールの種類とパラメータ形式はプロトコルと接続先によって異なります。 |
tool_choice | string / object | 条件付き | ツールの選択を制御します。ツールの強制や名前指定は対応する接続先でのみ使えます。 |
リクエスト例
API Key をローカルの環境変数 ICODEEASY_API_KEY に設定し、直接 HTTP 呼び出しに対応するエンドポイントを選択します。指定クライアントが必要な場合は設定ガイドに従ってください。
OpenAI Responses
bash
curl -N -sS 'https://api.icodeeasy.cc/v1/responses' \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
--data '{
"model": "gpt-6.1-terra",
"instructions": "You are a helpful assistant.",
"input": [
{
"type": "message",
"role": "user",
"content": [
{
"type": "input_text",
"text": "Explain how a rainbow forms in one sentence."
}
]
}
],
"stream": true,
"store": false
}'
レスポンスの読み取り
- OpenAI Responses · ストリーミングでは
response.output_text.deltaイベントのdeltaを連結し、完了・失敗イベントも処理します。 SSE
機能と制限
streaming· 対応tool_calling· 対応image_input· 未公開video_input· 非対応