Skip to main content
POST
GPT Responses(全モデル、完全なパラメータ)
BaseURL:デフォルトの BaseURL は https://direct.evolink.ai で、テキストモデルへの対応が優れており、長時間接続をサポートします。https://api.evolink.ai はマルチモーダルの主力エンドポイントで、テキストモデルに対しては代替アドレスとして使用されます。
サーバーサイドツールweb_searchcode_interpreterfile_searchmcp)はサーバー側で実行されるためクライアントが結果を返す必要はなく、この API でのみ提供されます。Chat Completions エンドポイントは通常の function ツール呼び出しのみに対応します。
注意 この API は同期モードとストリーミングモードのみに対応しています。background: true によるバックグラウンド非同期モードには対応しておらず、レスポンス ID による取得・キャンセル・削除のエンドポイントも提供していません。長時間の生成が必要な場合は stream: true を使って接続を維持してください。image_generation ツールは本シリーズのモデルでは利用できません。画像生成には画像シリーズのモデル API をご利用ください。
複数ターンの会話:前のターンで返された id を次のターンの previous_response_id に指定すれば、コンテキストを引き継げます。レスポンスには保持期限があり、期限が切れるとその ID は無効になり、リクエストは新しい会話として処理されます。コンテキストの正確性が強く求められる場面では、input の履歴全体をご自身で管理することを推奨します。

承認

Authorization
string
header
必須

##すべてのAPIにBearer Token認証が必要です##

APIキーの取得:

APIキー管理ページにアクセスしてAPIキーを取得してください

リクエストヘッダーに追加:

ボディ

application/json
model
enum<string>
必須

呼び出すモデル:

利用可能なオプション:
gpt-5.6-sol,
gpt-5.6-terra,
gpt-5.6-luna,
gpt-5.5,
gpt-5.4,
gpt-5.2,
gpt-5.1
:

"gpt-5.6-sol"

input
必須

モデル入力:単なる文字列、または入力項目の配列。

入力項目の contentinput_text(テキスト)と input_image(画像)の 2 種類のブロックに対応しています:

画像

  • image_url に画像の公開 URL を渡します
  • image_url は必ず文字列で指定します。{ "url": "..." } と書くと 400 が返されます
  • detailimage_url と同じ階層に置きます(その中に入れ子にはしません)。auto(デフォルト)/ low / high / original
  • 画像は正常にダウンロードできる必要があり、できない場合は 400 が返されます

ツール結果

  • 配列には前のターンの function_call_output などのツール結果項目を差し戻すこともできます

注意 この API のブロックの種類は Chat Completions API とは異なります(Chat は text / image_url を使用)。両者は混在させられず、誤って指定すると 400 が返されます。

:

"Search for AI news from the past week and summarize it in three sentences."

instructions
string

システムレベルの指示。input の先頭にシステムメッセージを 1 件挿入するのと同等です。previous_response_id で会話を継続する場合、このパラメータは前のターンから引き継がれないため、毎ターン渡す必要があります。

:

"You are a concise assistant. Answer in no more than three sentences."

stream
boolean
デフォルト:false

ストリーミングでレスポンスを返すかどうか(SSE イベント。response.completed で終了)。デフォルトは false

:

false

max_output_tokens
integer

生成する最大 token 数(推論 token を含む)。上限に達した場合、statusincomplete になります。

:

2048

reasoning
object

推論の制御。

effort(推論の深さ)の指定可能な値はモデルによって異なります:

summary(推論サマリー)auto / concise / detailed。全シリーズで利用できます。有効にすると outputreasoning 項目が現れます。

mode(推論モード)standard / progpt-5.6 ファミリーのみ対応。

context(推論のコンテキスト範囲)auto / current_turn / all_turnsgpt-5.6 ファミリーのみ対応。

推論 token は出力 token として課金され、usage.output_tokens_details.reasoning_tokens に計上されます。

text
object

出力テキストの制御:

  • format{"type": "text"}(デフォルト)、{"type": "json_object"}、または構造化結果を出力する {"type": "json_schema", "name": "...", "schema": {...}, "strict": true}
  • verbositylow / medium / high。回答の詳しさを制御します
tools
object[]

ツールの宣言。サーバーサイドツールはサーバー側で実行されるため、クライアントが結果を返す必要はありません:

通常の function ツール(クライアント側の関数呼び出し)にも対応しています。

注意 image_generation は本シリーズのモデルでは利用できません。画像シリーズのモデル API をご利用ください。

:
tool_choice

ツールの選択を制御します:"auto"(デフォルト)/ "none" / "required"、または特定のツールを指定するオブジェクト(例:{"type": "web_search"})。

利用可能なオプション:
none,
auto,
required
max_tool_calls
integer

このレスポンスで許可されるツール呼び出しの合計回数の上限。

:

5

parallel_tool_calls
boolean
デフォルト:true

1 ターン内でモデルが複数のツールを並列に呼び出せるかどうか。デフォルトは true

注意 false に設定できるのは gpt-5.6 ファミリーと gpt-5.5 のみです。gpt-5.4 / gpt-5.2 / gpt-5.1 ではこのパラメータは無効で、常に true として動作します。

:

true

previous_response_id
string

前のレスポンスの id。複数ターンの会話をつなげるために使用し、履歴メッセージを再送信する必要がなくなります。

注意 store: true(デフォルト値)と併用する必要があります。レスポンスには保持期限があり、期限が切れるとその ID は無効になります。この場合、リクエストは新しい会話として処理され、コンテキストは引き継がれません。コンテキストの正確性が強く求められる場面では、input の履歴全体をご自身で管理することを推奨します。

:

"resp_0f5c2b2c20c39e8a006a7ef545443081979e478b10927984b5"

store
boolean
デフォルト:true

このレスポンスをサーバー側に保持するかどうか。保持されたレスポンスのみ previous_response_id から参照できます。デフォルトは true

注意 false に設定できるのは gpt-5.6 ファミリーと gpt-5.5 のみです。gpt-5.4 / gpt-5.2 / gpt-5.1 ではこのパラメータは無効で、常に true として動作します。保持を望まない場合は、無効化に対応したモデルをお選びください。

:

true

include
string[]

レスポンスに追加で返すよう要求する内容。指定可能な値:

  • reasoning.encrypted_content
  • message.output_text.logprobs
  • web_search_call.results
  • web_search_call.action.sources
  • file_search_call.results
  • code_interpreter_call.outputs
  • message.input_image.image_url
  • computer_call_output.output.image_url
:
temperature
number

サンプリング温度。値の範囲は 0 ~ 2。値が低いほど出力が決定的になります。

注意 gpt-5.4 / gpt-5.2 / gpt-5.1 では値 0 は無効です(渡さなかった場合と同じ扱いになり、デフォルト値 1 が適用されます)。より決定的な出力が必要な場合は 0.01 など 0 より大きい値をご利用ください。

必須範囲: 0 <= x <= 2
:

0.7

top_p
number

Nucleus サンプリングのパラメータ。値の範囲は 0 ~ 1。temperature と同時に調整しないことを推奨します。

必須範囲: 0 <= x <= 1
:

0.9

top_logprobs
integer

各位置で返される候補 token の数。値の範囲は 0 ~ 20。include: ["message.output_text.logprobs"] と併用する必要があります。

注意 gpt-5.6 ファミリーと gpt-5.5 のみ対応。その他のモデルはこのパラメータに対応していません。

必須範囲: 0 <= x <= 20
:

2

frequency_penalty
number

Frequency ペナルティ。値の範囲は -2 ~ 2。内容の繰り返しが起きる確率を下げます。

注意 gpt-5.6 ファミリーのみ対応。その他のモデルはこのパラメータに対応していません。

必須範囲: -2 <= x <= 2
:

0.5

presence_penalty
number

Presence ペナルティ。値の範囲は -2 ~ 2。モデルが新しい話題に触れることを促します。

注意 gpt-5.6 ファミリーのみ対応。その他のモデルはこのパラメータに対応していません。

必須範囲: -2 <= x <= 2
:

0.5

truncation
enum<string>
デフォルト:disabled

コンテキストがウィンドウを超えた場合の処理方法:disabled(デフォルト。そのままエラーを返す)または auto(中間部分を自動的に切り詰める)。

利用可能なオプション:
auto,
disabled
:

"auto"

context_management
object[]

長い会話の自動圧縮設定。例:[{"type": "compaction", "compact_threshold": 100000}]。コンテキストがしきい値を超えると履歴が自動的に圧縮されます。

注意 gpt-5.6 ファミリーのみ対応。その他のモデルはこのパラメータに対応していません。

prompt_cache_key
string

キャッシュのグループ化キー。同じプレフィックスを持つリクエストに同じ値を渡すと、Prompt キャッシュのヒット率が向上します。

:

"app-agent-v1"

prompt_cache_retention
enum<string>

Prompt キャッシュの保持ポリシー:in_memory(デフォルト)または 24h(キャッシュの保持期間を延長)。

利用可能なオプション:
in_memory,
24h
:

"in_memory"

prompt
object

作成済みの Prompt テンプレートを参照します。形式は {"id": "pmpt_xxx", "version": "1", "variables": {...}}

metadata
object

カスタムのキーと値のペア。レスポンスにそのまま返されるため、業務側でのタグ付けに便利です。キーと値はいずれも文字列です。

:
safety_identifier
string

エンドユーザーの安定した識別子。不正利用の追跡に使用します。

注意 gpt-5.6 ファミリーのみ対応。その他のモデルはこのパラメータに対応していません。

:

"user-1024"

user
string

エンドユーザー識別子。呼び出し元を区別するために使用します。

:

"user-1024"

レスポンス

レスポンス生成成功(JSON オブジェクト、または stream=true の場合は response.completed で終わる SSE イベントストリーム)

id
string

このレスポンスの一意の ID。次のターンの previous_response_id として使用できます

:

"resp_0f5c2b2c20c39e8a006a7ef545443081979e478b10927984b5"

object
enum<string>

レスポンスタイプ

利用可能なオプション:
response
:

"response"

status
enum<string>

レスポンスのステータス:completed は正常終了、incompletemax_output_tokens への到達などの理由で完了しなかった状態、failed は生成失敗

利用可能なオプション:
completed,
incomplete,
failed
:

"completed"

model
string

実際に使用されたモデル名

:

"gpt-5.6-sol"

created_at
integer

作成タイムスタンプ

:

1786705221

output
object[]

生成順に並んだ出力項目:reasoning 項目(推論サマリー / 暗号化された推論内容)、ツール呼び出し項目(web_search_callcode_interpreter_call など)、そして最後に output_text の内容を含む message 項目。

incomplete_details
object

statusincomplete の場合にその理由を示します

usage
object

Token 使用量の統計。Prompt キャッシュは自動的に有効となり、キャッシュにヒットした入力 token はより安いキャッシュ料金で課金されます。

metadata
object

リクエストで渡したカスタムのキーと値のペア。そのまま返されます