テキストモデル上級者向け更新日
POST/v1/responses
GPT-6 Astra
リクエスト ID gpt-6-astra
プロトコル
POST /v1/responses· OpenAI Responsesの例POST /v1/responses/compact· Responses Compactの例POST /v1/chat/completions· Chat Completionsの例
認証
リクエストには API キー管理 の API キーが必要です。JSON リクエストには Content-Type: application/json を設定します。
Authorization: Bearer YOUR_API_KEY
リクエストパラメータ
POST /v1/responses
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | 必須 | モデル ID に gpt-6-astra を指定します。 |
input | string / object[] | 必須 | 入力テキスト、または入力項目の順序付き配列。メッセージ項目には role と content を指定します。 |
input[].content[] | object | 条件付き | 画像は type: input_image のコンテンツブロックを使います。対応形式は接続先によって異なります。 |
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 | 条件付き | ツールの選択を制御します。ツールの強制や名前指定は対応する接続先でのみ使えます。 |
POST /v1/responses/compact
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | 必須 | モデル ID に gpt-6-astra を指定します。 |
input | string / object[] | 必須 | 圧縮対象のコンテキストです。テキストまたは元の順序の会話入力項目を送信します。対応形式は接続先によって異なります。 |
POST /v1/chat/completions
| 項目 | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | 必須 | モデル ID に gpt-6-astra を指定します。 |
messages | object[] | 必須 | 会話順に送信します。各メッセージに role と content を指定します。 |
messages[].content | string / object[] | 条件付き | メッセージ本文。プレーンテキストまたはプロトコルで定義されたコンテンツブロックの配列を使います。 |
messages[].content[] | object | 条件付き | 画像は type: image_url のコンテンツブロックを使います。対応形式は接続先によって異なります。 |
stream | boolean | 任意 | true は SSE ストリーム、false は通常の JSON 応答を要求します。利用できるモードは接続先によって異なります。 |
max_completion_tokens | integer | 条件付き | 推論トークンを含む生成トークン数を制限します。この項目に対応する接続先で使います。 |
max_tokens | integer | 条件付き | 出力トークン上限の互換項目です。接続先の要件に応じて、この項目か max_completion_tokens の一方を指定します。 |
temperature | number | 条件付き | サンプリングのランダム性を調整します。指定可能な値と有効性はモデルと接続先によって異なります。 |
top_p | number | 条件付き | 累積確率でサンプリング候補を絞ります。対応するモデルと接続先で使います。 |
response_format | object | 条件付き | 構造化出力には type: json_object を使います。JSON Schema に対応する接続先では type: json_schema と json_schema を指定できます。 |
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-astra",
"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
}'
Responses Compact
bash
curl -sS 'https://api.icodeeasy.cc/v1/responses/compact' \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
--data '{
"model": "gpt-6-astra",
"input": "Explain how a rainbow forms in one sentence."
}'
Chat Completions
bash
curl -sS 'https://api.icodeeasy.cc/v1/chat/completions' \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
--data '{
"model": "gpt-6-astra",
"messages": [
{
"role": "user",
"content": "Explain how a rainbow forms in one sentence."
}
],
"stream": false
}'
レスポンスの読み取り
- OpenAI Responses · ストリーミングでは
response.output_text.deltaイベントのdeltaを連結し、完了・失敗イベントも処理します。 SSE - Chat Completions ·
choices[].message.contentからテキストを取得します。SSE ではchoices[].deltaから差分を読み取ります。 JSON · SSE
機能と制限
streaming· 対応tool_calling· 対応image_input· 条件付き対応 — 互換エンドポイントとリクエスト形式によって異なりますvideo_input· 非対応