Skip to main content
openai/gpt-4.1-nano の API リファレンスです。OpenAI から Comfy Router を通じて提供されます。

クイックスタート

Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(pip install comfy-sdknpm install @comfyorg/sdk)を使用しています。cURL のスニペットは同じ呼び出しを raw HTTP で行うものです。 モデル ID: openai/gpt-4.1-nano エンドポイント: POST https://api.comfy.org/v2/models/openai/gpt-4.1-nano

スキーマ

入力

string[]
モデルのレスポンスに含める追加の出力データ。
string | object[]
必須
モデルへのテキスト、画像、ファイル入力。レスポンスの生成に使用されます。このコントラクトにおいて Router が供給できない唯一のフィールドであり、以下の required に含まれる唯一の項目です。
string
モデルのコンテキストの先頭項目として、system(または developer)メッセージを挿入します。
integer
レスポンスとして生成されるトークン数の上限。可視出力トークンと reasoning トークンを含みます。reasoning ID ではこの上限は非表示の reasoning トークンと共有されるため、小さな値では可視テキストが生成される前に予算をすべて消費してしまいます。これが、reasoning のスモークケースが 1024 を送るのに対し、chat のケースが 16 を送る理由です。範囲: 1 から
string
OpenAI のモデル識別子。Comfy Router ではこのフィールドは任意(OPTIONAL)であり、Router が {model} パスセグメントから設定します。明示的な null も同様に置き換えられます。パスと一致しない値を送信すると拒否されます。
boolean
モデルがツール呼び出しを並列で実行することを許可するかどうか。
string
マルチターン会話用の、前のレスポンスの ID。
object
REASONING 層専用。reasoning モデル用の設定。例: {"effort": "medium"}。そのまま転送されます。受け付けられるキーについては OpenAI の reasoning ガイドを参照してください。chat 層の ID では無視されます。
boolean
OpenAI が生成されたレスポンスを後で取得できるように保存するかどうか。
boolean
送信した呼び出し元が拒否されないように宣言されていますが、このサーフェスでは無効(INERT)です。Router はディスパッチ前にこれを false に確定します。これはプロバイダーのレスポンスをキャプチャするのであって text/event-stream を中継するわけではないためです。openAiResponsesProxy の ModifyResponse はこれをデコードできないため、ストリーミング生成は OpenAI から課金されつつ、誰にも計測されません。ストリームが必要な場合は POST /proxy/openai/v1/responses を使用してください。
number
サンプリング温度。CHAT 層専用です。o シリーズの reasoning ID(o1o1-proo3o4-mini)は OpenAI 側でこのパラメータを拒否します。Router はそれらに対してこのパラメータを拒否しません(両層が 1 つのスキーマを共有する理由については、このコンポーネントの注記を参照してください)。そのため、これを送信する reasoning 呼び出しは OpenAI 自身のエラーとして返されます。範囲: 0 から 2
object
出力フォーマットの設定。例: Structured Outputs 用の {"format": {"type": "json_schema", ...}}。そのまま転送されます。
string | object
モデルが使用するツールをどのように選択するか。文字列モードか、ツールを名指しするオブジェクトのいずれかです。
object[]
モデルが呼び出せるツール定義。Router はツールの分類を絞り込みません。受け付けられる形については OpenAI の Responses API リファレンスを参照してください。
number
Nucleus サンプリングのカットオフ。CHAT 層専用で、temperature と同じ条件です。範囲: 0 から 1
string
コンテキストがモデルのウィンドウを超えた場合の切り捨て戦略。上述の 3 つの語彙とは異なり、ここでは enum が適用されます。これらの 2 つの値が OpenAI のドキュメントに記載された完全な集合であり、それ以降増えていないためです。明示的な null は、上記のフィールドと同じ条件で依然として受け付けられます。指定可能な値: autodisabled
object
トークン使用量のエンベロープ。v1 オペレーションがリクエストボディでこれを宣言しているため、このコントラクトに存在します。OpenAI がこれを設定するのはレスポンス側であるため、呼び出し元が送る理由はありません。
GET /v2/models/openai/gpt-4.1-nano/openapi.json で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する対象となる同一のドキュメントです。

出力

string
システム(または開発者)メッセージを、モデルのコンテキストの先頭項目として挿入します。previous_response_id と併用する場合、前のレスポンスの instructions は次のレスポンスに引き継がれません。これにより、新しいレスポンスでシステム(または開発者)メッセージを簡単に差し替えられます。
integer
1 つのレスポンスで生成できるトークン数の上限。表示される出力トークンと推論トークンが含まれます。
string
レスポンスの生成に使用するモデル
number
デフォルト:"1"
レスポンスのランダム性を制御します範囲: 0 から 2
number
デフォルト:"1"
nucleus sampling によってレスポンスの多様性を制御します範囲: 0 から 1
string
デフォルト:"\"disabled\""
モデルのレスポンスに使用する切り詰め戦略。
  • auto: このレスポンスと以前のレスポンスのコンテキストが モデルのコンテキストウィンドウサイズを超える場合、モデルは会話の 途中の入力項目を削除してコンテキストウィンドウに収まるように レスポンスを切り詰めます。
  • disabled(デフォルト): モデルのレスポンスがモデルのコンテキストウィンドウ サイズを超える場合、リクエストは 400 エラーで失敗します。 指定可能な値: autodisabled
string
モデルに対する前のレスポンスの一意な ID。これを使用して マルチターンの会話を作成します。詳しくは 会話の状態をご覧ください。
object
o シリーズモデルのみ推論モデルの 設定オプション。
string
以降のターンでどの推論項目をモデルに返すかを制御します(例: autocurrent_turnall_turns)。
string
デフォルト:"\"medium\""
o シリーズモデルのみ推論モデルの 推論にかける労力を制約します。現在サポートされている値は lowmediumhigh です。 推論の労力を減らすと、レスポンスが速くなり、レスポンス内で推論に 使用されるトークン数が少なくなる場合があります。指定可能な値: lowmediumhigh
string
非推奨: 代わりに summary を使用してください。モデルが実行した推論の要約。これはモデルの推論プロセスの デバッグや理解に役立ちます。 autoconcisedetailed のいずれかです。指定可能な値: autoconcisedetailed
string
レスポンスに使用される推論モード。
string
モデルが実行した推論の要約。これはモデルの推論プロセスの デバッグや理解に役立ちます。 autoconcisedetailed のいずれかです。指定可能な値: autoconcisedetailed
object
object
モデルが出力しなければならない形式を指定するオブジェクト。{ "type": "json_schema" } を設定すると Structured Outputs が有効になり、 モデルが指定した JSON スキーマに一致することが保証されます。詳しくは Structured Outputs ガイドをご覧ください。デフォルトの形式は追加オプションなしの { "type": "text" } です。gpt-4o 以降のモデルには推奨されません:{ "type": "json_object" } を設定すると従来の JSON モードが有効になり、 モデルが生成するメッセージが有効な JSON であることが保証されます。 対応しているモデルでは json_schema の使用が推奨されます。
string
モデルのレスポンスの冗長性を制約します。lowmediumhigh のいずれかです。
`none`, `auto`, `required` | object
レスポンスを生成する際に、モデルがどのツール(または複数のツール)を 選択すべきか。モデルが呼び出せるツールの指定方法については、 tools パラメータを参照してください。
object[]
boolean
モデルのレスポンスをバックグラウンドで実行するかどうか。
object
レスポンスの課金情報。
string
レスポンスの支払いを担当する主体。
number
この Response が完了した日時の Unix タイムスタンプ(秒)。ステータスが completed の場合にのみ存在します。
number
この Response が作成された日時の Unix タイムスタンプ(秒)。
object
モデルが Response の生成に失敗したときに返されるエラーオブジェクト。
string
必須
レスポンスのエラーコード。指定可能な値: server_errorrate_limit_exceededinvalid_promptvector_store_timeoutinvalid_imageinvalid_image_formatinvalid_base64_imageinvalid_image_urlimage_too_largeimage_too_smallimage_parse_errorimage_content_policy_violationinvalid_image_modeimage_file_too_largeunsupported_image_media_typeempty_image_filefailed_to_download_imageimage_file_not_found
string
必須
エラーの人間が読める形式の説明。
number
これまでのテキスト内での出現頻度に基づいて新しいトークンにペナルティを与えます。
string
このレスポンスの一意の識別子。
object
レスポンスが不完全である理由の詳細。
string
レスポンスが不完全である理由。指定可能な値: max_output_tokenscontent_filter
integer
1 つのレスポンスで処理できる、組み込みツールへの総呼び出し回数の最大値。
object
レスポンスに添付できるキーと値のペアのセット。
object
モデレーション済みの補完が要求された場合の、レスポンスの入力と出力に対するモデレーション結果。
string
このリソースのオブジェクトタイプ。常に response に設定されます。指定可能な値: response
object[]
モデルによって生成されたコンテンツ項目の配列。
  • output 配列内の項目の長さと順序は、モデルのレスポンスによって異なります。
  • output 配列の最初の項目にアクセスして、それがモデルによって生成されたコンテンツを含む assistant メッセージであると仮定するよりも、SDK でサポートされている場合は output_text プロパティの使用を検討してください。
string
output 配列内のすべての output_text 項目(存在する場合)からの集約されたテキスト出力を含む、SDK 専用の便利なプロパティです。Python SDK と JavaScript SDK でサポートされています。
boolean
デフォルト:"true"
モデルがツール呼び出しを並列で実行することを許可するかどうか。
number
これまでのテキスト内に出現しているかどうかに基づいて新しいトークンにペナルティを与えます。
string
キャッシュヒット率を最適化するために、類似したリクエストに対するレスポンスをキャッシュするために OpenAI によって使用されます。user フィールドを置き換えます。
string
プロンプトキャッシュの保持ポリシー(例: in_memory または 24h)。
string
OpenAI の利用ポリシーに違反している可能性のあるアプリケーションのユーザーを検出するために使用される安定した識別子。
string
リクエストを処理するために使用される処理階層(例: autodefaultflexscalepriority)。
string
レスポンス生成のステータス。completedfailedin_progresscancelledqueuedincomplete のいずれか。指定可能な値: completedfailedin_progresscancelledqueuedincomplete
boolean
レスポンスが後で API 経由で取得できるように保存されるかどうか。
object
組み込みツール別に分類したトークンとリクエストの使用量。
object
画像生成ツールのトークン使用量。
integer
object
integer
integer
integer
object
integer
integer
integer
Web 検索ツールの使用量。
integer
integer
各トークン位置で返す、最も可能性の高いトークンの最大数。それぞれに関連する対数確率が付きます。
object
入力トークン、出力トークン、出力トークンの内訳、使用された合計トークンを含むトークン使用量の詳細を表します。
integer
必須
入力トークンの数。
object
必須
入力トークンの詳細な内訳。
integer
キャッシュに書き込まれた入力トークンの数。
integer
必須
キャッシュから取得されたトークン数です。 プロンプトキャッシュの詳細
integer
必須
出力トークン数です。
object
必須
出力トークンの詳細な内訳です。
integer
必須
推論トークン数です。
integer
必須
使用されたトークンの合計数です。
string
エンドユーザーの非推奨の識別子です。safety_identifierprompt_cache_key に置き換えられました。

入力

出力

出荷前の確認

SDK は Idempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。 リクエストが失敗すると、Router は理由を示す X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。

ヘッダー

認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。

Router API の利用

モデルの検出、バリデーションエラー、リトライ、課金。

制限事項

Router が現在対応していないことと、代替手段。