> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Comfy Router で Google Gemini を使用する

> Comfy Router 経由で HTTP を使って Google Gemini のテキストモデルを呼び出すための Python、TypeScript、cURL スニペット、およびリクエストフィールドと結果の形状

Google Gemini の API リファレンス。Google Gemini は Google のマルチモーダルテキストモデル群で、Flash および Pro の各ティアにわたり、高速なドラフト作成から深い推論までをカバーします。

## クイックスタート

[あなたの Comfy ワークスペース](https://platform.comfy.org/profile/api-keys?onboarding=router) でキーを作成し、`COMFY_API_KEY` としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK (`pip install comfy-sdk` および `npm install @comfyorg/sdk`) を使用します。cURL スニペットは raw HTTP 経由で同じ呼び出しを行います。

呼び出すモデルを選択してください。以下のすべて（スニペットからスキーマ、例に至るまで）は、選択内容に従います。

> [tab] Gemini 3.1 Pro
>
> **モデル ID:** `vertexai/gemini-3.1-pro-preview`
>
> **エンドポイント:** `POST https://api.comfy.org/v2/models/vertexai/gemini-3.1-pro-preview`
>
> > [tab] 結果を待つ
> >
> > ```python Python theme={null}
> > import asyncio
> > from comfy_sdk import AsyncComfy
> >
> > # Reads COMFY_API_KEY from the environment.
> > # The SDK automatically creates an idempotency key and reuses it for automatic retries.
> > async def main():
> >     async with AsyncComfy() as client:
> >         result = await client.models.run(
> >             "vertexai/gemini-3.1-pro-preview",
> >             {
> >                 "contents": [
> >                     {
> >                         "role": "user",
> >                         "parts": [
> >                             {
> >                                 "text": "Describe a single red maple leaf on a white background in one sentence.",
> >                             },
> >                         ],
> >                     },
> >                 ],
> >                 "generationConfig": {
> >                     "temperature": 0.7,
> >                     "maxOutputTokens": 256,
> >                 },
> >             },
> >         )
> >
> >     print("text:", result["candidates"][0]["content"]["parts"][0]["text"])
> >
> > asyncio.run(main())
> > ```
> >
> > ```typescript TypeScript theme={null}
> > import { comfy } from "@comfyorg/sdk";
> >
> > // Reads COMFY_API_KEY from the environment.
> > // The SDK automatically creates an idempotency key and reuses it for automatic retries.
> > type Result = { candidates: { content: { parts: { text: string }[] } }[] };
> > const result = await comfy.models.run<Result>("vertexai/gemini-3.1-pro-preview", {
> >   contents: [
> >     {
> >       role: "user",
> >       parts: [
> >         {
> >           text: "Describe a single red maple leaf on a white background in one sentence.",
> >         },
> >       ],
> >     },
> >   ],
> >   generationConfig: {
> >     temperature: 0.7,
> >     maxOutputTokens: 256,
> >   },
> > });
> > if (result.kind !== "json") throw new Error("expected a JSON result");
> >
> > console.log("text:", result.data.candidates[0].content.parts[0].text);
> > ```
> >
> > ```bash cURL theme={null}
> > curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-pro-preview \
> >   -H "X-API-Key: $COMFY_API_KEY" \
> >   -H "Idempotency-Key: $(uuidgen)" \
> >   -H "Content-Type: application/json" \
> >   -d "{\"contents\": [{\"role\":\"user\",\"parts\":[{\"text\":\"Describe a single red maple leaf on a white background in one sentence.\"}]}], \"generationConfig\": {\"temperature\":0.7,\"maxOutputTokens\":256}}"
> > ```
>
> > [tab] キューに送信して後で収集する
> >
> > 同じ本文を `POST https://api.comfy.org/v2/models/vertexai/gemini-3.1-pro-preview/requests` に送信します。Router は実行が受け付けられるとすぐに `201` と `request_id` を返し、結果は準備が整い次第、このプロセスからでも別のプロセスからでも収集できます。[キュー配信](https://docs.comfy.org/ja/development/comfy-router/queue.md)では、ステータス、キャンセル、収集について順を追って説明します。
> >
> > ```python Python theme={null}
> > import asyncio
> > from comfy_sdk import AsyncComfy
> >
> > # Reads COMFY_API_KEY from the environment.
> > # Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
> > async def main():
> >     async with AsyncComfy() as client:
> >         handle = await client.models.submit(
> >             "vertexai/gemini-3.1-pro-preview",
> >             {
> >                 "contents": [
> >                     {
> >                         "role": "user",
> >                         "parts": [
> >                             {
> >                                 "text": "Describe a single red maple leaf on a white background in one sentence.",
> >                             },
> >                         ],
> >                     },
> >                 ],
> >                 "generationConfig": {
> >                     "temperature": 0.7,
> >                     "maxOutputTokens": 256,
> >                 },
> >             },
> >         )
> >         print("request_id:", handle.request_id)  # with the model ID, all another process needs
> >
> >         # Poll until the request completes, waiting the Retry-After the server names.
> >         async for update in handle.iter_events():
> >             print(update.status, update.queue_position)
> >
> >         # The provider's own payload, the same value models.run() returns.
> >         # A request that failed or was cancelled raises the typed Router error here.
> >         result = await handle.get()
> >
> >     print("text:", result["candidates"][0]["content"]["parts"][0]["text"])
> >
> > asyncio.run(main())
> > ```
> >
> > ```typescript TypeScript theme={null}
> > import { comfy } from "@comfyorg/sdk";
> >
> > // Reads COMFY_API_KEY from the environment.
> > // Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
> > type Result = { candidates: { content: { parts: { text: string }[] } }[] };
> > const handle = await comfy.models.submit<Result>("vertexai/gemini-3.1-pro-preview", {
> >   contents: [
> >     {
> >       role: "user",
> >       parts: [
> >         {
> >           text: "Describe a single red maple leaf on a white background in one sentence.",
> >         },
> >       ],
> >     },
> >   ],
> >   generationConfig: {
> >     temperature: 0.7,
> >     maxOutputTokens: 256,
> >   },
> > });
> > console.log("requestId:", handle.requestId); // with the model ID, all another process needs
> >
> > // Poll until the request completes, waiting the Retry-After the server names.
> > for await (const update of handle.events()) {
> >   console.log(update.status, update.queuePosition);
> > }
> >
> > // The same result models.run() returns. A request that failed or was cancelled rejects here.
> > const result = await handle.get();
> > if (result.kind !== "json") throw new Error("expected a JSON result");
> >
> > console.log("text:", result.data.candidates[0].content.parts[0].text);
> > ```
> >
> > ```bash cURL theme={null}
> > # 1. Submit. Router answers 201 with request_id, status_url, response_url and cancel_url.
> > curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-pro-preview/requests \
> >   -H "X-API-Key: $COMFY_API_KEY" \
> >   -H "Idempotency-Key: $(uuidgen)" \
> >   -H "Content-Type: application/json" \
> >   -d "{\"contents\": [{\"role\":\"user\",\"parts\":[{\"text\":\"Describe a single red maple leaf on a white background in one sentence.\"}]}], \"generationConfig\": {\"temperature\":0.7,\"maxOutputTokens\":256}}"
> >
> > # 2. Poll until status is COMPLETED, waiting the Retry-After seconds each response names.
> > REQUEST_ID="<request_id from the 201 body>"
> > curl -i https://api.comfy.org/v2/models/vertexai/gemini-3.1-pro-preview/requests/$REQUEST_ID/status \
> >   -H "X-API-Key: $COMFY_API_KEY"
> >
> > # 3. Collect. 200 with the model's native output, 202 with the status body while it is still running.
> > curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-pro-preview/requests/$REQUEST_ID \
> >   -H "X-API-Key: $COMFY_API_KEY"
> > ```
>
> ## スキーマ
>
> ### 入力
>
> **contents** `object[]` *required*
>
> モデルとの現在の会話のコンテンツ。単一ターンのクエリでは単一のインスタンスです。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドです。
>
> **contents\[].parts** `object[]` *required*
>
> **contents\[].parts\[].fileData** `object`
>
> URI ベースのデータ。
>
> **contents\[].parts\[].fileData.fileUri** `string`
>
> URI
>
> **contents\[].parts\[].fileData.mimeType** `string`
>
> data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。許容される値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル（音声なし）の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。
>
> 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm`
>
> **contents\[].parts\[].inlineData** `object`
>
> 生バイトのインラインデータ。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。
>
> **contents\[].parts\[].inlineData.data** `string (byte)`
>
> プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコーディング。メディアをインラインで含める場合は、データのメディアタイプ（mimeType）も指定する必要があります。サイズ制限: 20MB
>
> 形式: `byte`
>
> **contents\[].parts\[].inlineData.mimeType** `string`
>
> data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。許容される値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル（音声なし）の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。
>
> 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm`
>
> **contents\[].parts\[].mediaProcessing** `string`
>
> モデルがこのパートのビデオをどのように読み取るか。`"AGENTIC"` を設定すると、固定レートのフレームサンプリングではなく、モデルが検査するセグメントを判断します。省略すると、デフォルトの固定レートサンプリングになります。gemini-3.7-flash 以降の Flash モデルでサポートされています。
>
> **contents\[].parts\[].text** `string`
>
> テキストプロンプトまたはコードスニペット。
>
> **contents\[].parts\[].thought** `boolean`
>
> このパートがモデルからの思考/推論ステップであることを示します。
>
> **contents\[].role** `string`
>
> 指定可能な値: `user`, `model`
>
> **generationConfig** `object`
>
> 生成のサンプリング、長さ、出力の設定。すべてのフィールドは任意です。以下で `default` を宣言しているフィールドは省略時にその値が適用され、それ以外はモデル自身の動作にフォールバックします。
>
> **generationConfig.imageConfig** `object`
>
> 画像生成の設定
>
> **generationConfig.imageConfig.aspectRatio** `string`
>
> 生成された画像のアスペクト比
>
> **generationConfig.imageConfig.imageOutputOptions** `object`
>
> 任意。生成された画像の画像出力形式。
>
> **generationConfig.imageConfig.imageOutputOptions.compressionQuality** `integer`
>
> 任意。出力画像の圧縮品質。
>
> **generationConfig.imageConfig.imageOutputOptions.mimeType** `string`
>
> 任意。出力を保存する画像形式（Vertex AI のパス、つまり Comfy 独自の認証情報で処理されるリクエスト、および GCP サービスアカウントで認証された BYOK リクエストの場合）。そこで受け付けられる値は `image/png` と `image/jpeg` で、大文字小文字を区別せずに照合され、リクエストが転送される前に小文字に正規化されます。それ以外の値は、このフィールド名を示す 400 で拒否されます。省略時は `image/png` がデフォルトです。Google AI Studio の APIキーで認証された BYOK リクエストは例外です。そのアップストリームにはそのようなプロパティがなく、存在する場合は呼び出し全体を拒否するため、このフィールドは尊重も拒否もされずにリクエストから削除され、出力形式は AI Studio が選択したものになります。どのパスでも、送信した値を前提とせず、返されたレスポンスのパート（`inlineData.mimeType`、`uploadImagesToStorage` が設定されている場合は `fileData.mimeType`）からメディアタイプを読み取ってください。
>
> **generationConfig.imageConfig.imageSize** `string`
>
> 任意。生成された画像のサイズを指定します。サポートされる値は 1K、2K、4K です。指定しない場合、モデルはデフォルト値 1K を使用します。
>
> **generationConfig.maxOutputTokens** `integer`
>
> レスポンスで生成できるトークンの最大数。1 トークンは約 4 文字です。100 トークンはおおよそ 60～80 語に相当します。
>
> 範囲: `16` ～ `65536`
>
> **generationConfig.responseModalities** \`\`TEXT`, `IMAGE`[]`
>
> **generationConfig.seed** `integer`
>
> シードが特定の値に固定されている場合、モデルは繰り返しのリクエストに対して同じ応答を返すよう最善を尽くします。決定論的な出力は保証されません。また、temperature などのモデルやパラメータ設定を変更すると、同じシード値を使用していても応答にばらつきが生じることがあります。デフォルトでは、ランダムなシード値が使用されます。以下のモデルで利用可能です: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001
>
> **generationConfig.stopSequences** `string[]`
>
> **generationConfig.temperature** `number` (default: 1)
>
> temperature は応答生成中のサンプリングに使用されます。これは topP と topK が適用されるときに発生します。temperature はトークン選択におけるランダム性の度合いを制御します。低い temperature は、あまり自由奔放でない、あるいは創造的でない応答が求められるプロンプトに適しており、高い temperature はより多様または創造的な結果につながります。temperature が 0 の場合、常に最も確率の高いトークンが選択されます。この場合、特定のプロンプトに対する応答はほぼ決定論的になりますが、わずかなばらつきが生じる可能性はあります。モデルが返す応答が一般的すぎる場合、短すぎる場合、またはモデルがフォールバック応答を返す場合は、temperature を上げてみてください
>
> 範囲: `0` から `2`
>
> 形式: `float`
>
> **generationConfig.thinkingConfig** `object`
>
> オプション。thinking 機能の設定です。thinking とは、モデルが複雑なタスクをより小さなステップに分解して、より高品質な応答を生成するプロセスです。
>
> **generationConfig.thinkingConfig.includeThoughts** `boolean`
>
> オプション。true の場合、モデルは自身の思考を応答に含めます。
>
> **generationConfig.thinkingConfig.thinkingBudget** `integer`
>
> オプション。モデルの thinking プロセスに割り当てるトークン予算です。モデルはこの予算内に収まるよう最善を尽くします。
>
> **generationConfig.thinkingConfig.thinkingLevel** `string`
>
> オプション。モデルの thinking レベルです。
>
> 指定可能な値: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH`
>
> **generationConfig.topK** `integer` (default: 40)
>
> Top-K は、モデルが出力のためにトークンを選択する方法を変更します。top-K が 1 の場合、次に選択されるトークンは、モデルの語彙内のすべてのトークンの中で最も確率が高いものになります。top-K が 3 の場合、次に選択されるトークンは、temperature を使用して、最も確率の高い 3 個のトークンの中から選択されます。
>
> 範囲: `1` から `…`
>
> **generationConfig.topP** `number` (default: 0.95)
>
> 指定した場合、nucleus サンプリングが使用されます。
> Top-P は、モデルが出力のためにトークンを選択する方法を変更します。トークンは、その確率の合計が top-P の値と等しくなるまで、最も確率の高いもの（top-K を参照）から最も低いものへと選択されます。たとえば、トークン A、B、C の確率がそれぞれ 0.3、0.2、0.1 で、top-P の値が 0.5 の場合、モデルは temperature を使用して A または B のいずれかを次のトークンとして選択し、C は候補から除外されます。
> ランダム性の少ない応答には低い値を、ランダム性の多い応答には高い値を指定してください。
>
> 範囲: `0` から `1`
>
> 形式: `float`
>
> **safetySettings** `object[]`
>
> 安全でないコンテンツをブロックするためのリクエストごとの設定です。GenerateContentResponse.candidates に適用されます。
>
> **safetySettings\[].category** `string` *required*
>
> 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT`
>
> **safetySettings\[].threshold** `string` *required*
>
> 指定可能な値: `OFF`, `BLOCK_NONE`, `BLOCK_LOW_AND_ABOVE`, `BLOCK_MEDIUM_AND_ABOVE`, `BLOCK_ONLY_HIGH`
>
> **systemInstruction** `object`
>
> モデルをより良いパフォーマンスへと導くための指示です。たとえば、「できるだけ簡潔に答えてください」や「応答に専門用語を使わないでください」などです。テキスト文字列はトークン上限にカウントされます。systemInstruction の role フィールドは無視され、モデルのパフォーマンスには影響しません。注: parts にはテキストのみを使用し、各 part の content は別々の段落にしてください。
>
> **systemInstruction.parts** `object[]` *required*
>
> 1 つのメッセージを構成する、順序付けられた parts のリストです。part ごとに異なる IANA MIME タイプを持つ場合があります。最大トークン数や画像数など入力の制限については、Google のモデルページにあるモデル仕様を参照してください。
>
> **systemInstruction.parts\[].text** `string`
>
> テキストプロンプトまたはコードスニペット。
>
> **systemInstruction.role** `string`
>
> メッセージを作成するエンティティの識別情報です。以下の値がサポートされています。user: メッセージが実在の人物によって送信されたことを示します。通常はユーザーが生成したメッセージです。model: メッセージがモデルによって生成されたことを示します。model の値は、マルチターンの会話中にモデルからのメッセージを会話に挿入するために使用されます。マルチターンでない会話では、このフィールドは空白のままにするか、未設定にすることができます。
>
> 指定可能な値: `user`, `model`
>
> **tools** `object[]`
>
> システムが、モデルの知識や範囲外のアクションまたは一連のアクションを実行するために外部システムとやり取りできるようにするコードです。Function calling を参照してください。
>
> **tools\[].functionDeclarations** `object[]`
>
> **tools\[].functionDeclarations\[].description** `string`
>
> **tools\[].functionDeclarations\[].name** `string` *required*
>
> **tools\[].functionDeclarations\[].parameters** `object`
>
> 関数パラメータの JSON スキーマ
>
> **uploadImagesToStorage** `boolean`
>
> true の場合、生成済みの画像はクラウドストレージにアップロードされ、インラインの base64 データではなく署名付き URL として返されます。URL は 24 時間後に有効期限が切れます。
>
> **videoMetadata** `object`
>
> ビデオ入力の場合、ビデオの開始オフセットと終了オフセットを Duration 形式で指定します。たとえば、1:00 から始まる 10 秒のクリップを指定するには、"startOffset": \{ "seconds": 60 } および "endOffset": \{ "seconds": 70 } を設定します。メタデータは、ビデオデータが inlineData または fileData で提示されている場合にのみ指定してください。
>
> **videoMetadata.endOffset** `object`
>
> ビデオのタイムライン位置に対する再生時間のオフセットを表します。
>
> **videoMetadata.endOffset.nanos** `integer`
>
> ナノ秒解像度での符号付き秒の小数部。小数部を持つ負の秒の値であっても、nanos の値は非負でなければなりません。
>
> 範囲: `0` to `999999999`
>
> **videoMetadata.endOffset.seconds** `integer`
>
> 時間幅の符号付き秒。 -315,576,000,000 から +315,576,000,000 まで（両端を含む）の範囲でなければなりません。
>
> 範囲: `-315576000000` to `315576000000`
>
> **videoMetadata.startOffset** `object`
>
> ビデオのタイムライン位置に対する再生時間のオフセットを表します。
>
> **videoMetadata.startOffset.nanos** `integer`
>
> ナノ秒解像度での符号付き秒の小数部。小数部を持つ負の秒の値であっても、nanos の値は非負でなければなりません。
>
> 範囲: `0` to `999999999`
>
> **videoMetadata.startOffset.seconds** `integer`
>
> 時間幅の符号付き秒。 -315,576,000,000 から +315,576,000,000 まで（両端を含む）の範囲でなければなりません。
>
> 範囲: `-315576000000` to `315576000000`
>
> このドキュメントは、Router が `GET /v2/models/vertexai/gemini-3.1-pro-preview/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する対象となる、同じドキュメントです。
>
> ### 出力
>
> **candidates** `object[]`
>
> **candidates\[].citationMetadata** `object`
>
> **candidates\[].citationMetadata.citations** `object[]`
>
> **candidates\[].citationMetadata.citations\[].authors** `string[]`
>
> **candidates\[].citationMetadata.citations\[].endIndex** `integer`
>
> **candidates\[].citationMetadata.citations\[].license** `string`
>
> **candidates\[].citationMetadata.citations\[].publicationDate** `string (date)`
>
> 形式: `date`
>
> **candidates\[].citationMetadata.citations\[].startIndex** `integer`
>
> **candidates\[].citationMetadata.citations\[].title** `string`
>
> **candidates\[].citationMetadata.citations\[].uri** `string`
>
> **candidates\[].content** `object`
>
> モデルとの現在の会話のコンテンツです。単一ターンのクエリでは単一のインスタンスになります。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドになります。
>
> **candidates\[].content.parts** `object[]` *required*
>
> **candidates\[].content.parts\[].fileData** `object`
>
> URI ベースのデータ。
>
> **candidates\[].content.parts\[].fileData.fileUri** `string`
>
> URI
>
> **candidates\[].content.parts\[].fileData.mimeType** `string`
>
> data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。指定できる値は次のとおりです。gemini-2.0-flash-lite と gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル（オーディオなし）の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン上限にカウントされます。画像の解像度に制限はありません。
>
> 指定できる値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm`
>
> **candidates\[].content.parts\[].inlineData** `object`
>
> 生のバイトによるインラインデータ。gemini-2.0-flash-lite と gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。
>
> **candidates\[].content.parts\[].inlineData.data** `string (byte)`
>
> プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコーディングです。メディアをインラインで含める場合は、そのデータのメディアタイプ（mimeType）も指定する必要があります。サイズ制限: 20MB
>
> 形式: `byte`
>
> **candidates\[].content.parts\[].inlineData.mimeType** `string`
>
> data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。指定できる値は次のとおりです。gemini-2.0-flash-lite と gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル（オーディオなし）の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン上限にカウントされます。画像の解像度に制限はありません。
>
> 指定できる値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm`
>
> **candidates\[].content.parts\[].mediaProcessing** `string`
>
> モデルがこのパートのビデオをどのように読み取るかを指定します。固定レートのフレームサンプリングではなく、検査するセグメントをモデルに判断させるには "AGENTIC" を設定します。省略した場合は、デフォルトの固定レートサンプリングが使用されます。gemini-3.7-flash 以降の Flash モデルでサポートされています。
>
> **candidates\[].content.parts\[].text** `string`
>
> テキストプロンプトまたはコードスニペット。
>
> **candidates\[].content.parts\[].thought** `boolean`
>
> このパートがモデルによる思考/推論のステップであることを示します。
>
> **candidates\[].content.role** `string`
>
> 指定できる値: `user`, `model`
>
> **candidates\[].finishReason** `string`
>
> **candidates\[].safetyRatings** `object[]`
>
> **candidates\[].safetyRatings\[].category** `string`
>
> 指定できる値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT`
>
> **candidates\[].safetyRatings\[].probability** `string`
>
> コンテンツが指定された安全性カテゴリに違反している確率
>
> 指定できる値: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN`
>
> **createTime** `string`
>
> レスポンスが作成されたタイムスタンプ。
>
> **modelVersion** `string`
>
> レスポンスの生成に使用されたモデルのバージョン。
>
> **promptFeedback** `object`
>
> **promptFeedback.blockReason** `string`
>
> **promptFeedback.blockReasonMessage** `string`
>
> **promptFeedback.safetyRatings** `object[]`
>
> **promptFeedback.safetyRatings\[].category** `string`
>
> 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT`
>
> **promptFeedback.safetyRatings\[].probability** `string`
>
> コンテンツが指定された安全性カテゴリに違反する確率
>
> 指定可能な値: `NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN`
>
> **responseId** `string`
>
> 応答の一意の識別子。
>
> **usageMetadata** `object`
>
> **usageMetadata.cachedContentTokenCount** `integer`
>
> 出力専用。入力内のキャッシュされた部分（キャッシュされたコンテンツ）のトークン数。
>
> **usageMetadata.candidatesTokenCount** `integer`
>
> 応答内のトークン数。
>
> **usageMetadata.candidatesTokensDetails** `object[]`
>
> モダリティごとの候補トークンの内訳。
>
> **usageMetadata.candidatesTokensDetails\[].modality** `string`
>
> 入力または出力コンテンツのモダリティの種類。
>
> 指定可能な値: `MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT`
>
> **usageMetadata.candidatesTokensDetails\[].tokenCount** `integer`
>
> 指定されたモダリティのトークン数。
>
> **usageMetadata.promptTokenCount** `integer`
>
> リクエスト内のトークン数。cachedContent が設定されている場合でも、これは有効なプロンプトの合計サイズであり、キャッシュされたコンテンツ内のトークン数も含まれます。
>
> **usageMetadata.promptTokensDetails** `object[]`
>
> モダリティごとのプロンプトトークンの内訳。
>
> **usageMetadata.promptTokensDetails\[].modality** `string`
>
> 入力または出力コンテンツのモダリティの種類。
>
> 指定可能な値: `MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT`
>
> **usageMetadata.promptTokensDetails\[].tokenCount** `integer`
>
> 指定されたモダリティのトークン数。
>
> **usageMetadata.thoughtsTokenCount** `integer`
>
> thoughts 出力に含まれるトークン数。
>
> **usageMetadata.toolUsePromptTokenCount** `integer`
>
> ツール使用プロンプトに含まれるトークン数。
>
> **usageMetadata.toolUsePromptTokensDetails** `object[]`
>
> モダリティごとのツール使用プロンプトトークンの内訳。
>
> **usageMetadata.toolUsePromptTokensDetails\[].modality** `string`
>
> 入力または出力コンテンツのモダリティの種類。
>
> 指定可能な値: `MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT`
>
> **usageMetadata.toolUsePromptTokensDetails\[].tokenCount** `integer`
>
> 指定されたモダリティのトークン数。
>
> **usageMetadata.totalTokenCount** `integer`
>
> トークンの合計数（プロンプト + 候補）。
>
> **usageMetadata.trafficType** `string`
>
> リクエストに使用されたトラフィックタイプ（例: PROVISIONED\_THROUGHPUT）。
>
> ## 例
>
> ### 入力
>
> ```json theme={null}
> {
>   "contents": [
>     {
>       "role": "user",
>       "parts": [
>         {
>           "text": "Describe a single red maple leaf on a white background in one sentence."
>         }
>       ]
>     }
>   ],
>   "generationConfig": {
>     "temperature": 0.7,
>     "maxOutputTokens": 256
>   }
> }
> ```
>
> ### 出力
>
> ```json theme={null}
> {
>   "candidates": [
>     {
>       "content": {
>         "role": "model",
>         "parts": [
>           {
>             "text": "A single red maple leaf rests on a plain white background, its edges sharp and its color deep."
>           }
>         ]
>       },
>       "finishReason": "STOP"
>     }
>   ],
>   "usageMetadata": {
>     "promptTokenCount": 18,
>     "candidatesTokenCount": 24
>   }
> }
> ```

> [tab] Gemini 3.5 Flash
>
> **モデル ID:** `vertexai/gemini-3.5-flash`
>
> **エンドポイント:** `POST https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash`
>
> > [tab] 結果を待つ
> >
> > ```python Python theme={null}
> > import asyncio
> > from comfy_sdk import AsyncComfy
> >
> > # Reads COMFY_API_KEY from the environment.
> > # The SDK automatically creates an idempotency key and reuses it for automatic retries.
> > async def main():
> >     async with AsyncComfy() as client:
> >         result = await client.models.run(
> >             "vertexai/gemini-3.5-flash",
> >             {
> >                 "contents": [
> >                     {
> >                         "role": "user",
> >                         "parts": [
> >                             {
> >                                 "text": "Describe a single red maple leaf on a white background in one sentence.",
> >                             },
> >                         ],
> >                     },
> >                 ],
> >                 "generationConfig": {
> >                     "temperature": 0.7,
> >                     "maxOutputTokens": 256,
> >                 },
> >             },
> >         )
> >
> >     print("text:", result["candidates"][0]["content"]["parts"][0]["text"])
> >
> > asyncio.run(main())
> > ```
> >
> > ```typescript TypeScript theme={null}
> > import { comfy } from "@comfyorg/sdk";
> >
> > // Reads COMFY_API_KEY from the environment.
> > // The SDK automatically creates an idempotency key and reuses it for automatic retries.
> > type Result = { candidates: { content: { parts: { text: string }[] } }[] };
> > const result = await comfy.models.run<Result>("vertexai/gemini-3.5-flash", {
> >   contents: [
> >     {
> >       role: "user",
> >       parts: [
> >         {
> >           text: "Describe a single red maple leaf on a white background in one sentence.",
> >         },
> >       ],
> >     },
> >   ],
> >   generationConfig: {
> >     temperature: 0.7,
> >     maxOutputTokens: 256,
> >   },
> > });
> > if (result.kind !== "json") throw new Error("expected a JSON result");
> >
> > console.log("text:", result.data.candidates[0].content.parts[0].text);
> > ```
> >
> > ```bash cURL theme={null}
> > curl https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash \
> >   -H "X-API-Key: $COMFY_API_KEY" \
> >   -H "Idempotency-Key: $(uuidgen)" \
> >   -H "Content-Type: application/json" \
> >   -d "{\"contents\": [{\"role\":\"user\",\"parts\":[{\"text\":\"Describe a single red maple leaf on a white background in one sentence.\"}]}], \"generationConfig\": {\"temperature\":0.7,\"maxOutputTokens\":256}}"
> > ```
>
> > [tab] キューに送信して後で収集する
> >
> > 同じ本文を `POST https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests` に送信します。Router は実行が受け付けられるとすぐに `201` と `request_id` を返し、結果は準備が整い次第、このプロセスからでも別のプロセスからでも収集できます。[キュー配信](https://docs.comfy.org/ja/development/comfy-router/queue.md)では、ステータス、キャンセル、収集について順を追って説明します。
> >
> > ```python Python theme={null}
> > import asyncio
> > from comfy_sdk import AsyncComfy
> >
> > # Reads COMFY_API_KEY from the environment.
> > # Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
> > async def main():
> >     async with AsyncComfy() as client:
> >         handle = await client.models.submit(
> >             "vertexai/gemini-3.5-flash",
> >             {
> >                 "contents": [
> >                     {
> >                         "role": "user",
> >                         "parts": [
> >                             {
> >                                 "text": "Describe a single red maple leaf on a white background in one sentence.",
> >                             },
> >                         ],
> >                     },
> >                 ],
> >                 "generationConfig": {
> >                     "temperature": 0.7,
> >                     "maxOutputTokens": 256,
> >                 },
> >             },
> >         )
> >         print("request_id:", handle.request_id)  # with the model ID, all another process needs
> >
> >         # Poll until the request completes, waiting the Retry-After the server names.
> >         async for update in handle.iter_events():
> >             print(update.status, update.queue_position)
> >
> >         # The provider's own payload, the same value models.run() returns.
> >         # A request that failed or was cancelled raises the typed Router error here.
> >         result = await handle.get()
> >
> >     print("text:", result["candidates"][0]["content"]["parts"][0]["text"])
> >
> > asyncio.run(main())
> > ```
> >
> > ```typescript TypeScript theme={null}
> > import { comfy } from "@comfyorg/sdk";
> >
> > // Reads COMFY_API_KEY from the environment.
> > // Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
> > type Result = { candidates: { content: { parts: { text: string }[] } }[] };
> > const handle = await comfy.models.submit<Result>("vertexai/gemini-3.5-flash", {
> >   contents: [
> >     {
> >       role: "user",
> >       parts: [
> >         {
> >           text: "Describe a single red maple leaf on a white background in one sentence.",
> >         },
> >       ],
> >     },
> >   ],
> >   generationConfig: {
> >     temperature: 0.7,
> >     maxOutputTokens: 256,
> >   },
> > });
> > console.log("requestId:", handle.requestId); // with the model ID, all another process needs
> >
> > // Poll until the request completes, waiting the Retry-After the server names.
> > for await (const update of handle.events()) {
> >   console.log(update.status, update.queuePosition);
> > }
> >
> > // The same result models.run() returns. A request that failed or was cancelled rejects here.
> > const result = await handle.get();
> > if (result.kind !== "json") throw new Error("expected a JSON result");
> >
> > console.log("text:", result.data.candidates[0].content.parts[0].text);
> > ```
> >
> > ```bash cURL theme={null}
> > # 1. Submit. Router answers 201 with request_id, status_url, response_url and cancel_url.
> > curl https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests \
> >   -H "X-API-Key: $COMFY_API_KEY" \
> >   -H "Idempotency-Key: $(uuidgen)" \
> >   -H "Content-Type: application/json" \
> >   -d "{\"contents\": [{\"role\":\"user\",\"parts\":[{\"text\":\"Describe a single red maple leaf on a white background in one sentence.\"}]}], \"generationConfig\": {\"temperature\":0.7,\"maxOutputTokens\":256}}"
> >
> > # 2. Poll until status is COMPLETED, waiting the Retry-After seconds each response names.
> > REQUEST_ID="<request_id from the 201 body>"
> > curl -i https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests/$REQUEST_ID/status \
> >   -H "X-API-Key: $COMFY_API_KEY"
> >
> > # 3. Collect. 200 with the model's native output, 202 with the status body while it is still running.
> > curl https://api.comfy.org/v2/models/vertexai/gemini-3.5-flash/requests/$REQUEST_ID \
> >   -H "X-API-Key: $COMFY_API_KEY"
> > ```
>
> ## スキーマ
>
> ### 入力
>
> **contents** `object[]` *required*
>
> モデルとの現在の会話のコンテンツ。単一ターンのクエリでは単一のインスタンスです。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドです。
>
> **contents\[].parts** `object[]` *required*
>
> **contents\[].parts\[].fileData** `object`
>
> URI ベースのデータ。
>
> **contents\[].parts\[].fileData.fileUri** `string`
>
> URI
>
> **contents\[].parts\[].fileData.mimeType** `string`
>
> data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。許容される値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル（音声なし）の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。
>
> 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm`
>
> **contents\[].parts\[].inlineData** `object`
>
> 生バイトのインラインデータ。gemini-2.0-flash-lite および gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。
>
> **contents\[].parts\[].inlineData.data** `string (byte)`
>
> プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコーディング。メディアをインラインで含める場合は、データのメディアタイプ（mimeType）も指定する必要があります。サイズ制限: 20MB
>
> 形式: `byte`
>
> **contents\[].parts\[].inlineData.mimeType** `string`
>
> data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプ。許容される値は次のとおりです。gemini-2.0-flash-lite および gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル（音声なし）の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン制限にカウントされます。画像の解像度に制限はありません。
>
> 指定可能な値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm`
>
> **contents\[].parts\[].mediaProcessing** `string`
>
> モデルがこのパートのビデオをどのように読み取るか。`"AGENTIC"` を設定すると、固定レートのフレームサンプリングではなく、モデルが検査するセグメントを判断します。省略すると、デフォルトの固定レートサンプリングになります。gemini-3.7-flash 以降の Flash モデルでサポートされています。
>
> **contents\[].parts\[].text** `string`
>
> テキストプロンプトまたはコードスニペット。
>
> **contents\[].parts\[].thought** `boolean`
>
> このパートがモデルからの思考/推論ステップであることを示します。
>
> **contents\[].role** `string`
>
> 指定可能な値: `user`, `model`
>
> **generationConfig** `object`
>
> 生成のサンプリング、長さ、出力の設定。すべてのフィールドは任意です。以下で `default` を宣言しているフィールドは省略時にその値が適用され、それ以外はモデル自身の動作にフォールバックします。
>
> **generationConfig.imageConfig** `object`
>
> 画像生成の設定
>
> **generationConfig.imageConfig.aspectRatio** `string`
>
> 生成された画像のアスペクト比
>
> **generationConfig.imageConfig.imageOutputOptions** `object`
>
> 任意。生成された画像の画像出力形式。
>
> **generationConfig.imageConfig.imageOutputOptions.compressionQuality** `integer`
>
> 任意。出力画像の圧縮品質。
>
> **generationConfig.imageConfig.imageOutputOptions.mimeType** `string`
>
> 任意。出力を保存する画像形式（Vertex AI のパス、つまり Comfy 独自の認証情報で処理されるリクエスト、および GCP サービスアカウントで認証された BYOK リクエストの場合）。そこで受け付けられる値は `image/png` と `image/jpeg` で、大文字小文字を区別せずに照合され、リクエストが転送される前に小文字に正規化されます。それ以外の値は、このフィールド名を示す 400 で拒否されます。省略時は `image/png` がデフォルトです。Google AI Studio の APIキーで認証された BYOK リクエストは例外です。そのアップストリームにはそのようなプロパティがなく、存在する場合は呼び出し全体を拒否するため、このフィールドは尊重も拒否もされずにリクエストから削除され、出力形式は AI Studio が選択したものになります。どのパスでも、送信した値を前提とせず、返されたレスポンスのパート（`inlineData.mimeType`、`uploadImagesToStorage` が設定されている場合は `fileData.mimeType`）からメディアタイプを読み取ってください。
>
> **generationConfig.imageConfig.imageSize** `string`
>
> 任意。生成された画像のサイズを指定します。サポートされる値は 1K、2K、4K です。指定しない場合、モデルはデフォルト値 1K を使用します。
>
> **generationConfig.maxOutputTokens** `integer`
>
> レスポンスで生成できるトークンの最大数。1 トークンは約 4 文字です。100 トークンはおおよそ 60～80 語に相当します。
>
> 範囲: `16` ～ `65536`
>
> **generationConfig.responseModalities** \`\`TEXT`, `IMAGE`[]`
>
> **generationConfig.seed** `integer`
>
> シードが特定の値に固定されている場合、モデルは繰り返しのリクエストに対して同じ応答を返すよう最善を尽くします。決定論的な出力は保証されません。また、temperature などのモデルやパラメータ設定を変更すると、同じシード値を使用していても応答にばらつきが生じることがあります。デフォルトでは、ランダムなシード値が使用されます。以下のモデルで利用可能です: gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001
>
> **generationConfig.stopSequences** `string[]`
>
> **generationConfig.temperature** `number` (default: 1)
>
> temperature は応答生成中のサンプリングに使用されます。これは topP と topK が適用されるときに発生します。temperature はトークン選択におけるランダム性の度合いを制御します。低い temperature は、あまり自由奔放でない、あるいは創造的でない応答が求められるプロンプトに適しており、高い temperature はより多様または創造的な結果につながります。temperature が 0 の場合、常に最も確率の高いトークンが選択されます。この場合、特定のプロンプトに対する応答はほぼ決定論的になりますが、わずかなばらつきが生じる可能性はあります。モデルが返す応答が一般的すぎる場合、短すぎる場合、またはモデルがフォールバック応答を返す場合は、temperature を上げてみてください
>
> 範囲: `0` から `2`
>
> 形式: `float`
>
> **generationConfig.thinkingConfig** `object`
>
> オプション。thinking 機能の設定です。thinking とは、モデルが複雑なタスクをより小さなステップに分解して、より高品質な応答を生成するプロセスです。
>
> **generationConfig.thinkingConfig.includeThoughts** `boolean`
>
> オプション。true の場合、モデルは自身の思考を応答に含めます。
>
> **generationConfig.thinkingConfig.thinkingBudget** `integer`
>
> オプション。モデルの thinking プロセスに割り当てるトークン予算です。モデルはこの予算内に収まるよう最善を尽くします。
>
> **generationConfig.thinkingConfig.thinkingLevel** `string`
>
> オプション。モデルの thinking レベルです。
>
> 指定可能な値: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`, `XHIGH`
>
> **generationConfig.topK** `integer` (default: 40)
>
> Top-K は、モデルが出力のためにトークンを選択する方法を変更します。top-K が 1 の場合、次に選択されるトークンは、モデルの語彙内のすべてのトークンの中で最も確率が高いものになります。top-K が 3 の場合、次に選択されるトークンは、temperature を使用して、最も確率の高い 3 個のトークンの中から選択されます。
>
> 範囲: `1` から `…`
>
> **generationConfig.topP** `number` (default: 0.95)
>
> 指定した場合、nucleus サンプリングが使用されます。
> Top-P は、モデルが出力のためにトークンを選択する方法を変更します。トークンは、その確率の合計が top-P の値と等しくなるまで、最も確率の高いもの（top-K を参照）から最も低いものへと選択されます。たとえば、トークン A、B、C の確率がそれぞれ 0.3、0.2、0.1 で、top-P の値が 0.5 の場合、モデルは temperature を使用して A または B のいずれかを次のトークンとして選択し、C は候補から除外されます。
> ランダム性の少ない応答には低い値を、ランダム性の多い応答には高い値を指定してください。
>
> 範囲: `0` から `1`
>
> 形式: `float`
>
> **safetySettings** `object[]`
>
> 安全でないコンテンツをブロックするためのリクエストごとの設定です。GenerateContentResponse.candidates に適用されます。
>
> **safetySettings\[].category** `string` *required*
>
> 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT`
>
> **safetySettings\[].threshold** `string` *required*
>
> 指定可能な値: `OFF`, `BLOCK_NONE`, `BLOCK_LOW_AND_ABOVE`, `BLOCK_MEDIUM_AND_ABOVE`, `BLOCK_ONLY_HIGH`
>
> **systemInstruction** `object`
>
> モデルをより良いパフォーマンスへと導くための指示です。たとえば、「できるだけ簡潔に答えてください」や「応答に専門用語を使わないでください」などです。テキスト文字列はトークン上限にカウントされます。systemInstruction の role フィールドは無視され、モデルのパフォーマンスには影響しません。注: parts にはテキストのみを使用し、各 part の content は別々の段落にしてください。
>
> **systemInstruction.parts** `object[]` *required*
>
> 1 つのメッセージを構成する、順序付けられた parts のリストです。part ごとに異なる IANA MIME タイプを持つ場合があります。最大トークン数や画像数など入力の制限については、Google のモデルページにあるモデル仕様を参照してください。
>
> **systemInstruction.parts\[].text** `string`
>
> テキストプロンプトまたはコードスニペット。
>
> **systemInstruction.role** `string`
>
> メッセージを作成するエンティティの識別情報です。以下の値がサポートされています。user: メッセージが実在の人物によって送信されたことを示します。通常はユーザーが生成したメッセージです。model: メッセージがモデルによって生成されたことを示します。model の値は、マルチターンの会話中にモデルからのメッセージを会話に挿入するために使用されます。マルチターンでない会話では、このフィールドは空白のままにするか、未設定にすることができます。
>
> 指定可能な値: `user`, `model`
>
> **tools** `object[]`
>
> システムが、モデルの知識や範囲外のアクションまたは一連のアクションを実行するために外部システムとやり取りできるようにするコードです。Function calling を参照してください。
>
> **tools\[].functionDeclarations** `object[]`
>
> **tools\[].functionDeclarations\[].description** `string`
>
> **tools\[].functionDeclarations\[].name** `string` *required*
>
> **tools\[].functionDeclarations\[].parameters** `object`
>
> 関数パラメータの JSON スキーマ
>
> **uploadImagesToStorage** `boolean`
>
> true の場合、生成済みの画像はクラウドストレージにアップロードされ、インラインの base64 データではなく署名付き URL として返されます。URL は 24 時間後に有効期限が切れます。
>
> **videoMetadata** `object`
>
> ビデオ入力の場合、ビデオの開始オフセットと終了オフセットを Duration 形式で指定します。たとえば、1:00 から始まる 10 秒のクリップを指定するには、"startOffset": \{ "seconds": 60 } および "endOffset": \{ "seconds": 70 } を設定します。メタデータは、ビデオデータが inlineData または fileData で提示されている場合にのみ指定してください。
>
> **videoMetadata.endOffset** `object`
>
> ビデオのタイムライン位置に対する再生時間のオフセットを表します。
>
> **videoMetadata.endOffset.nanos** `integer`
>
> ナノ秒解像度での符号付き秒の小数部。小数部を持つ負の秒の値であっても、nanos の値は非負でなければなりません。
>
> 範囲: `0` to `999999999`
>
> **videoMetadata.endOffset.seconds** `integer`
>
> 時間幅の符号付き秒。 -315,576,000,000 から +315,576,000,000 まで（両端を含む）の範囲でなければなりません。
>
> 範囲: `-315576000000` to `315576000000`
>
> **videoMetadata.startOffset** `object`
>
> ビデオのタイムライン位置に対する再生時間のオフセットを表します。
>
> **videoMetadata.startOffset.nanos** `integer`
>
> ナノ秒解像度での符号付き秒の小数部。小数部を持つ負の秒の値であっても、nanos の値は非負でなければなりません。
>
> 範囲: `0` to `999999999`
>
> **videoMetadata.startOffset.seconds** `integer`
>
> 時間幅の符号付き秒。 -315,576,000,000 から +315,576,000,000 まで（両端を含む）の範囲でなければなりません。
>
> 範囲: `-315576000000` to `315576000000`
>
> このドキュメントは、Router が `GET /v2/models/vertexai/gemini-3.5-flash/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する対象となる、同じドキュメントです。
>
> ### 出力
>
> **candidates** `object[]`
>
> **candidates\[].citationMetadata** `object`
>
> **candidates\[].citationMetadata.citations** `object[]`
>
> **candidates\[].citationMetadata.citations\[].authors** `string[]`
>
> **candidates\[].citationMetadata.citations\[].endIndex** `integer`
>
> **candidates\[].citationMetadata.citations\[].license** `string`
>
> **candidates\[].citationMetadata.citations\[].publicationDate** `string (date)`
>
> 形式: `date`
>
> **candidates\[].citationMetadata.citations\[].startIndex** `integer`
>
> **candidates\[].citationMetadata.citations\[].title** `string`
>
> **candidates\[].citationMetadata.citations\[].uri** `string`
>
> **candidates\[].content** `object`
>
> モデルとの現在の会話のコンテンツです。単一ターンのクエリでは単一のインスタンスになります。マルチターンのクエリでは、会話履歴と最新のリクエストを含む繰り返しフィールドになります。
>
> **candidates\[].content.parts** `object[]` *required*
>
> **candidates\[].content.parts\[].fileData** `object`
>
> URI ベースのデータ。
>
> **candidates\[].content.parts\[].fileData.fileUri** `string`
>
> URI
>
> **candidates\[].content.parts\[].fileData.mimeType** `string`
>
> data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。指定できる値は次のとおりです。gemini-2.0-flash-lite と gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル（オーディオなし）の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン上限にカウントされます。画像の解像度に制限はありません。
>
> 指定できる値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm`
>
> **candidates\[].content.parts\[].inlineData** `object`
>
> 生のバイトによるインラインデータ。gemini-2.0-flash-lite と gemini-2.0-flash では、inlineData を使用して最大 3000 枚の画像を指定できます。
>
> **candidates\[].content.parts\[].inlineData.data** `string (byte)`
>
> プロンプトにインラインで含める画像、PDF、またはビデオの base64 エンコーディングです。メディアをインラインで含める場合は、そのデータのメディアタイプ（mimeType）も指定する必要があります。サイズ制限: 20MB
>
> 形式: `byte`
>
> **candidates\[].content.parts\[].inlineData.mimeType** `string`
>
> data フィールドまたは fileUri フィールドで指定されたファイルのメディアタイプです。指定できる値は次のとおりです。gemini-2.0-flash-lite と gemini-2.0-flash では、オーディオファイルの最大長は 8.4 時間、ビデオファイル（オーディオなし）の最大長は 1 時間です。詳細については、Gemini のオーディオとビデオの要件を参照してください。テキストファイルは UTF-8 でエンコードされている必要があります。テキストファイルの内容はトークン上限にカウントされます。画像の解像度に制限はありません。
>
> 指定できる値: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm`
>
> **candidates\[].content.parts\[].mediaProcessing** `string`
>
> モデルがこのパートのビデオをどのように読み取るかを指定します。固定レートのフレームサンプリングではなく、検査するセグメントをモデルに判断させるには "AGENTIC" を設定します。省略した場合は、デフォルトの固定レートサンプリングが使用されます。gemini-3.7-flash 以降の Flash モデルでサポートされています。
>
> **candidates\[].content.parts\[].text** `string`
>
> テキストプロンプトまたはコードスニペット。
>
> **candidates\[].content.parts\[].thought** `boolean`
>
> このパートがモデルによる思考/推論のステップであることを示します。
>
> **candidates\[].content.role** `string`
>
> 指定できる値: `user`, `model`
>
> **candidates\[].finishReason** `string`
>
> **candidates\[].safetyRatings** `object[]`
>
> **candidates\[].safetyRatings\[].category** `string`
>
> 指定できる値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT`
>
> **candidates\[].safetyRatings\[].probability** `string`
>
> コンテンツが指定された安全性カテゴリに違反している確率
>
> 指定できる値: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN`
>
> **createTime** `string`
>
> レスポンスが作成されたタイムスタンプ。
>
> **modelVersion** `string`
>
> レスポンスの生成に使用されたモデルのバージョン。
>
> **promptFeedback** `object`
>
> **promptFeedback.blockReason** `string`
>
> **promptFeedback.blockReasonMessage** `string`
>
> **promptFeedback.safetyRatings** `object[]`
>
> **promptFeedback.safetyRatings\[].category** `string`
>
> 指定可能な値: `HARM_CATEGORY_SEXUALLY_EXPLICIT`、`HARM_CATEGORY_HATE_SPEECH`、`HARM_CATEGORY_HARASSMENT`、`HARM_CATEGORY_DANGEROUS_CONTENT`
>
> **promptFeedback.safetyRatings\[].probability** `string`
>
> コンテンツが指定された安全性カテゴリに違反する確率
>
> 指定可能な値: `NEGLIGIBLE`、`LOW`、`MEDIUM`、`HIGH`、`UNKNOWN`
>
> **responseId** `string`
>
> 応答の一意の識別子。
>
> **usageMetadata** `object`
>
> **usageMetadata.cachedContentTokenCount** `integer`
>
> 出力専用。入力内のキャッシュされた部分（キャッシュされたコンテンツ）のトークン数。
>
> **usageMetadata.candidatesTokenCount** `integer`
>
> 応答内のトークン数。
>
> **usageMetadata.candidatesTokensDetails** `object[]`
>
> モダリティごとの候補トークンの内訳。
>
> **usageMetadata.candidatesTokensDetails\[].modality** `string`
>
> 入力または出力コンテンツのモダリティの種類。
>
> 指定可能な値: `MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT`
>
> **usageMetadata.candidatesTokensDetails\[].tokenCount** `integer`
>
> 指定されたモダリティのトークン数。
>
> **usageMetadata.promptTokenCount** `integer`
>
> リクエスト内のトークン数。cachedContent が設定されている場合でも、これは有効なプロンプトの合計サイズであり、キャッシュされたコンテンツ内のトークン数も含まれます。
>
> **usageMetadata.promptTokensDetails** `object[]`
>
> モダリティごとのプロンプトトークンの内訳。
>
> **usageMetadata.promptTokensDetails\[].modality** `string`
>
> 入力または出力コンテンツのモダリティの種類。
>
> 指定可能な値: `MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT`
>
> **usageMetadata.promptTokensDetails\[].tokenCount** `integer`
>
> 指定されたモダリティのトークン数。
>
> **usageMetadata.thoughtsTokenCount** `integer`
>
> thoughts 出力に含まれるトークン数。
>
> **usageMetadata.toolUsePromptTokenCount** `integer`
>
> ツール使用プロンプトに含まれるトークン数。
>
> **usageMetadata.toolUsePromptTokensDetails** `object[]`
>
> モダリティごとのツール使用プロンプトトークンの内訳。
>
> **usageMetadata.toolUsePromptTokensDetails\[].modality** `string`
>
> 入力または出力コンテンツのモダリティの種類。
>
> 指定可能な値: `MODALITY_UNSPECIFIED`、`TEXT`、`IMAGE`、`VIDEO`、`AUDIO`、`DOCUMENT`
>
> **usageMetadata.toolUsePromptTokensDetails\[].tokenCount** `integer`
>
> 指定されたモダリティのトークン数。
>
> **usageMetadata.totalTokenCount** `integer`
>
> トークンの合計数（プロンプト + 候補）。
>
> **usageMetadata.trafficType** `string`
>
> リクエストに使用されたトラフィックタイプ（例: PROVISIONED\_THROUGHPUT）。
>
> ## 例
>
> ### 入力
>
> ```json theme={null}
> {
>   "contents": [
>     {
>       "role": "user",
>       "parts": [
>         {
>           "text": "Describe a single red maple leaf on a white background in one sentence."
>         }
>       ]
>     }
>   ],
>   "generationConfig": {
>     "temperature": 0.7,
>     "maxOutputTokens": 256
>   }
> }
> ```
>
> ### 出力
>
> ```json theme={null}
> {
>   "candidates": [
>     {
>       "content": {
>         "role": "model",
>         "parts": [
>           {
>             "text": "A single red maple leaf rests on a plain white background, its edges sharp and its color deep."
>           }
>         ]
>       },
>       "finishReason": "STOP"
>     }
>   ],
>   "usageMetadata": {
>     "promptTokenCount": 18,
>     "candidatesTokenCount": 24
>   }
> }
> ```

> [tab] Gemini 2.5 Pro
>
> **モデル ID:** `vertexai/gemini-2.5-pro`
>
> **エンドポイント:** `POST https://api.comfy.org/v2/models/vertexai/gemini-2.5-pro`
>
> > [tab] 結果を待つ
> >
> > ```python Python theme={null}
> > import asyncio
> > from comfy_sdk import AsyncComfy
> >
> > # Reads COMFY_API_KEY from the environment.
> > # The SDK automatically creates an idempotency key and reuses it for automatic retries.
> > async def main():
> >     async with AsyncComfy() as client:
> >         result = await client.models.run(
> >             "vertexai/gemini-2.5-pro",
> >             {
> >                 "contents": [
> >                     {
> >                         "role": "user",
> >                         "parts": [
> >                             {
> >                                 "text": "Describe a single red maple leaf on a white background in one sentence.",
> >                             },
> >                         ],
> >                     },
> >                 ],
> >                 "generationConfig": {
> >                     "temperature": 0.7,
> >                     "maxOutputTokens": 256,
> >                 },
> >             },
> >         )
> >
> >     print("text:", result["candidates"][0]["content"]["parts"][0]["text"])
> >
> > asyncio.run(main())
> > ```
> >
> > ```typescript TypeScript theme={null}
> > import { comfy } from "@comfyorg/sdk";
> >
> > // Reads COMFY_API_KEY from the environment.
> > // The SDK automatically creates an idempotency key and reuses it for automatic retries.
> > type Result = { candidates: { content: { parts: { text: string }[] } }[] };
> > const result = await comfy.models.run<Result>("vertexai/gemini-2.5-pro", {
> >   contents: [
> >     {
> >       role: "user",
> >       parts: [
> >         {
> >           text: "Describe a single red maple leaf on a white background in one sentence.",
> >         },
> >       ],
> >     },
> >   ],
> >   generationConfig: {
> >     temperature: 0.7,
> >     maxOutputTokens: 256,
> >   },
> > });
> > if (result.kind !== "json") throw new Error("expected a JSON result");
> >
> > console.log("text:", result.data.candidates[0].content.parts[0].text);
> > ```
> >
> > ```bash cURL theme={null}
> > curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-pro \
> >   -H "X-API-Key: $COMFY_API_KEY" \
> >   -H "Idempotency-Key: $(uuidgen)" \
> >   -H "Content-Type: application/json" \
> >   -d "{\"contents\": [{\"role\":\"user\",\"parts\":[{\"text\":\"Describe a single red maple leaf on a white background in one sentence.\"}]}], \"generationConfig\": {\"temperature\":0.7,\"maxOutputTokens\":256}}"
> > ```
>
> > [tab] キューに送信して後で収集する
> >
> > 同じ本文を `POST https://api.comfy.org/v2/models/vertexai/gemini-2.5-pro/requests` に送信します。Router は実行が受け付けられるとすぐに `201` と `request_id` を返し、結果は準備が整い次第、このプロセスからでも別のプロセスからでも収集できます。[キュー配信](https://docs.comfy.org/ja/development/comfy-router/queue.md)では、ステータス、キャンセル、収集について順を追って説明します。
> >
> > ```python Python theme={null}
> > import asyncio
> > from comfy_sdk import AsyncComfy
> >
> > # Reads COMFY_API_KEY from the environment.
> > # Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
> > async def main():
> >     async with AsyncComfy() as client:
> >         handle = await client.models.submit(
> >             "vertexai/gemini-2.5-pro",
> >             {
> >                 "contents": [
> >                     {
> >                         "role": "user",
> >                         "parts": [
> >                             {
> >                                 "text": "Describe a single red maple leaf on a white background in one sentence.",
> >                             },
> >                         ],
> >                     },
> >                 ],
> >                 "generationConfig": {
> >                     "temperature": 0.7,
> >                     "maxOutputTokens": 256,
> >                 },
> >             },
> >         )
> >         print("request_id:", handle.request_id)  # with the model ID, all another process needs
> >
> >         # Poll until the request completes, waiting the Retry-After the server names.
> >         async for update in handle.iter_events():
> >             print(update.status, update.queue_position)
> >
> >         # The provider's own payload, the same value models.run() returns.
> >         # A request that failed or was cancelled raises the typed Router error here.
> >         result = await handle.get()
> >
> >     print("text:", result["candidates"][0]["content"]["parts"][0]["text"])
> >
> > asyncio.run(main())
> > ```
> >
> > ```typescript TypeScript theme={null}
> > import { comfy } from "@comfyorg/sdk";
> >
> > // Reads COMFY_API_KEY from the environment.
> > // Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
> > type Result = { candidates: { content: { parts: { text: string }[] } }[] };
> > const handle = await comfy.models.submit<Result>("vertexai/gemini-2.5-pro", {
> >   contents: [
> >     {
> >       role: "user",
> >       parts: [
> >         {
> >           text: "Describe a single red maple leaf on a white background in one sentence.",
> >         },
> >       ],
> >     },
> >   ],
> >   generationConfig: {
> >     temperature: 0.7,
> >     maxOutputTokens: 256,
> >   },
> > });
> > console.log("requestId:", handle.requestId); // with the model ID, all another process needs
> >
> > // Poll until the request completes, waiting the Retry-After the server names.
> > for await (const update of handle.events()) {
> >   console.log(update.status, update.queuePosition);
> > }
> >
> > // The same result models.run() returns. A request that failed or was cancelled rejects here.
> > const result = await handle.get();
> > if (result.kind !== "json") throw new Error("expected a JSON result");
> >
> > console.log("text:", result.data.candidates[0].content.parts[0].text);
> > ```
> >
> > ```bash cURL theme={null}
> > # 1. Submit. Router answers 201 with request_id, status_url, response_url and cancel_url.
> > curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-pro/requests \
> >   -H "X-API-Key: $COMFY_API_KEY" \
> >   -H "Idempotency-Key: $(uuidgen)" \
> >   -H "Content-Type: application/json" \
> >   -d "{\"contents\": [{\"role\":\"user\",\"parts\":[{\"text\":\"Describe a single red maple leaf on a white background in one sentence.\"}]}], \"generationConfig\": {\"temperature\":0.7,\"maxOutputTokens\":256}}"
> >
> > # 2. Poll until status is COMPLETED, waiting the Retry-After seconds each response names.
> > REQUEST_ID="<request_id from the 201 body>"
> > curl -i https://api.comfy.org/v2/models/vertexai/gemini-2.5-pro/requests/$REQUEST_ID/status \
> >   -H "X-API-Key: $COMFY_API_KEY"
> >
> > # 3. Collect. 200 with the model's native output, 202 with the status body while it is still running.
> > curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-pro/requests/$REQUEST_ID \
> >   -H "X-API-Key: $COMFY_API_KEY"
> > ```
>
> ## スキーマ
>
> ### 入力
>
> *フィールドは Google が公開している API 仕様に従っており、CI でその仕様と照合されます。このモデルに対する Router 独自のスキーマはまだ公開されていないため、リクエストは検証されずにプロバイダーへ転送されます。*
>
> **contents** `object[]` *required*
>
> これまでの会話。古い順に並びます。パートは `text`、またはプロンプトと一緒に画像、オーディオ、ビデオを送信するための `inlineData` です。
>
> **contents\[].role** `string` *required*
>
> そのターンを誰が作成したか。
>
> 指定可能な値: `user`, `model`
>
> **contents\[].parts** `object[]` *required*
>
> ターンのコンテンツパート。
>
> **contents\[].parts\[].text** `string`
>
> テキストパート。
>
> **contents\[].parts\[].inlineData** `object`
>
> インラインメディアパート。
>
> **contents\[].parts\[].inlineData.mimeType** `string`
>
> メディアタイプ。例: `image/png`
>
> **contents\[].parts\[].inlineData.data** `string`
>
> Base64 でエンコードされたメディアのバイト列。
>
> **systemInstruction** `object`
>
> 会話全体に適用されるシステムプロンプト。
>
> **systemInstruction.parts** `object[]`
>
> **systemInstruction.parts\[].text** `string`
>
> **generationConfig** `object`
>
> サンプリングと長さの設定。
>
> **generationConfig.temperature** `number`
>
> サンプリングのランダム性。デフォルト値はモデル固有です。
>
> 範囲: `0` から `2`
>
> **generationConfig.topP** `number`
>
> 核サンプリングのしきい値。デフォルト値はモデル固有です。
>
> **generationConfig.topK** `integer`
>
> top-k サンプリングのカットオフ。デフォルト値はモデル固有です。
>
> **generationConfig.maxOutputTokens** `integer`
>
> 生成トークン数の上限。
>
> **generationConfig.seed** `integer`
>
> 再現可能なサンプリングのためのシード。
>
> **generationConfig.stopSequences** `string[]`
>
> 生成された時点で生成を終了させる文字列。
>
> **generationConfig.thinkingConfig** `object`
>
> 対応モデルでの推論強度の制御。
>
> **generationConfig.thinkingConfig.thinkingLevel** `string`
>
> 指定可能な値: `MINIMAL`, `LOW`, `MEDIUM`, `HIGH`
>
> **generationConfig.thinkingConfig.includeThoughts** `boolean`
>
> 回答と合わせてモデルの推論を返します。
>
> **tools** `object[]`
>
> モデルが呼び出せる関数宣言。
>
> **tools\[].functionDeclarations** `object[]`
>
> **tools\[].functionDeclarations\[].name** `string`
>
> **tools\[].functionDeclarations\[].description** `string`
>
> **tools\[].functionDeclarations\[].parameters** `object`
>
> 関数の引数の JSON Schema。
>
> ### 出力
>
> Router は Google のネイティブなレスポンスを変更せずに返します。テキストは `candidates[0].content.parts[0].text` にあります。
>
> **candidates** `object[]`
>
> 生成された候補。複数を要求しない限り 1 つです。
>
> **candidates\[].content** `object`
>
> **candidates\[].content.role** `string`
>
> 指定可能な値: `model`
>
> **candidates\[].content.parts** `object[]`
>
> **candidates\[].content.parts\[].text** `string`
>
> 生成されたテキスト。
>
> **candidates\[].content.parts\[].functionCall** `object`
>
> モデルが `tools` のいずれかを呼び出すことを選択した場合に存在します。
>
> **candidates\[].content.parts\[].functionCall.name** `string`
>
> **candidates\[].content.parts\[].functionCall.args** `object`
>
> **candidates\[].finishReason** `string`
>
> 生成が停止した理由: `STOP`、`MAX_TOKENS`、`SAFETY` など
>
> **usageMetadata** `object`
>
> 呼び出しのトークン数の内訳。
>
> **usageMetadata.promptTokenCount** `integer`
>
> プロンプト内のトークン数。
>
> **usageMetadata.candidatesTokenCount** `integer`
>
> 生成された候補内のトークン数。
>
> **promptFeedback** `object`
>
> プロンプト自体がブロックされた場合に存在します。結果を読み取る前に `candidates` が存在するか確認してください。`usageMetadata` もブロックされたレスポンスに含まれることがあります。
>
> **promptFeedback.blockReason** `string`
>
> プロンプトがブロックされた理由。候補は返されないため、プロンプトを言い換えて再試行してください。
>
> 指定可能な値: `SAFETY`, `OTHER`, `BLOCKLIST`, `PROHIBITED_CONTENT`, `IMAGE_SAFETY`
>
> ## 例
>
> ### 入力
>
> ```json theme={null}
> {
>   "contents": [
>     {
>       "role": "user",
>       "parts": [
>         {
>           "text": "Describe a single red maple leaf on a white background in one sentence."
>         }
>       ]
>     }
>   ],
>   "generationConfig": {
>     "temperature": 0.7,
>     "maxOutputTokens": 256
>   }
> }
> ```
>
> ### 出力
>
> ```json theme={null}
> {
>   "candidates": [
>     {
>       "content": {
>         "role": "model",
>         "parts": [
>           {
>             "text": "A single red maple leaf rests on a plain white background, its edges sharp and its color deep."
>           }
>         ]
>       },
>       "finishReason": "STOP"
>     }
>   ],
>   "usageMetadata": {
>     "promptTokenCount": 18,
>     "candidatesTokenCount": 24
>   }
> }
> ```

> [tab] Gemini 2.5 Flash
>
> **モデル ID:** `vertexai/gemini-2.5-flash`
>
> **エンドポイント:** `POST https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash`
>
> > [tab] 結果を待つ
> >
> > ```python Python theme={null}
> > import asyncio
> > from comfy_sdk import AsyncComfy
> >
> > # Reads COMFY_API_KEY from the environment.
> > # The SDK automatically creates an idempotency key and reuses it for automatic retries.
> > async def main():
> >     async with AsyncComfy() as client:
> >         result = await client.models.run(
> >             "vertexai/gemini-2.5-flash",
> >             {
> >                 "contents": [
> >                     {
> >                         "role": "user",
> >                         "parts": [
> >                             {
> >                                 "text": "Describe a single red maple leaf on a white background in one sentence.",
> >                             },
> >                         ],
> >                     },
> >                 ],
> >                 "generationConfig": {
> >                     "temperature": 0.7,
> >                     "maxOutputTokens": 256,
> >                 },
> >             },
> >         )
> >
> >     print("text:", result["candidates"][0]["content"]["parts"][0]["text"])
> >
> > asyncio.run(main())
> > ```
> >
> > ```typescript TypeScript theme={null}
> > import { comfy } from "@comfyorg/sdk";
> >
> > // Reads COMFY_API_KEY from the environment.
> > // The SDK automatically creates an idempotency key and reuses it for automatic retries.
> > type Result = { candidates: { content: { parts: { text: string }[] } }[] };
> > const result = await comfy.models.run<Result>("vertexai/gemini-2.5-flash", {
> >   contents: [
> >     {
> >       role: "user",
> >       parts: [
> >         {
> >           text: "Describe a single red maple leaf on a white background in one sentence.",
> >         },
> >       ],
> >     },
> >   ],
> >   generationConfig: {
> >     temperature: 0.7,
> >     maxOutputTokens: 256,
> >   },
> > });
> > if (result.kind !== "json") throw new Error("expected a JSON result");
> >
> > console.log("text:", result.data.candidates[0].content.parts[0].text);
> > ```
> >
> > ```bash cURL theme={null}
> > curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash \
> >   -H "X-API-Key: $COMFY_API_KEY" \
> >   -H "Idempotency-Key: $(uuidgen)" \
> >   -H "Content-Type: application/json" \
> >   -d "{\"contents\": [{\"role\":\"user\",\"parts\":[{\"text\":\"Describe a single red maple leaf on a white background in one sentence.\"}]}], \"generationConfig\": {\"temperature\":0.7,\"maxOutputTokens\":256}}"
> > ```
>
> > [tab] キューに送信して後で収集する
> >
> > 同じ本文を `POST https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash/requests` に送信します。Router は実行が受け付けられるとすぐに `201` と `request_id` を返し、結果は準備が整い次第、このプロセスからでも別のプロセスからでも収集できます。[キュー配信](https://docs.comfy.org/ja/development/comfy-router/queue.md)では、ステータス、キャンセル、収集について順を追って説明します。
> >
> > ```python Python theme={null}
> > import asyncio
> > from comfy_sdk import AsyncComfy
> >
> > # Reads COMFY_API_KEY from the environment.
> > # Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
> > async def main():
> >     async with AsyncComfy() as client:
> >         handle = await client.models.submit(
> >             "vertexai/gemini-2.5-flash",
> >             {
> >                 "contents": [
> >                     {
> >                         "role": "user",
> >                         "parts": [
> >                             {
> >                                 "text": "Describe a single red maple leaf on a white background in one sentence.",
> >                             },
> >                         ],
> >                     },
> >                 ],
> >                 "generationConfig": {
> >                     "temperature": 0.7,
> >                     "maxOutputTokens": 256,
> >                 },
> >             },
> >         )
> >         print("request_id:", handle.request_id)  # with the model ID, all another process needs
> >
> >         # Poll until the request completes, waiting the Retry-After the server names.
> >         async for update in handle.iter_events():
> >             print(update.status, update.queue_position)
> >
> >         # The provider's own payload, the same value models.run() returns.
> >         # A request that failed or was cancelled raises the typed Router error here.
> >         result = await handle.get()
> >
> >     print("text:", result["candidates"][0]["content"]["parts"][0]["text"])
> >
> > asyncio.run(main())
> > ```
> >
> > ```typescript TypeScript theme={null}
> > import { comfy } from "@comfyorg/sdk";
> >
> > // Reads COMFY_API_KEY from the environment.
> > // Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
> > type Result = { candidates: { content: { parts: { text: string }[] } }[] };
> > const handle = await comfy.models.submit<Result>("vertexai/gemini-2.5-flash", {
> >   contents: [
> >     {
> >       role: "user",
> >       parts: [
> >         {
> >           text: "Describe a single red maple leaf on a white background in one sentence.",
> >         },
> >       ],
> >     },
> >   ],
> >   generationConfig: {
> >     temperature: 0.7,
> >     maxOutputTokens: 256,
> >   },
> > });
> > console.log("requestId:", handle.requestId); // with the model ID, all another process needs
> >
> > // Poll until the request completes, waiting the Retry-After the server names.
> > for await (const update of handle.events()) {
> >   console.log(update.status, update.queuePosition);
> > }
> >
> > // The same result models.run() returns. A request that failed or was cancelled rejects here.
> > const result = await handle.get();
> > if (result.kind !== "json") throw new Error("expected a JSON result");
> >
> > console.log("text:", result.data.candidates[0].content.parts[0].text);
> > ```
> >
> > ```bash cURL theme={null}
> > # 1. Submit. Router answers 201 with request_id, status_url, response_url and cancel_url.
> > curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash/requests \
> >   -H "X-API-Key: $COMFY_API_KEY" \
> >   -H "Idempotency-Key: $(uuidgen)" \
> >   -H "Content-Type: application/json" \
> >   -d "{\"contents\": [{\"role\":\"user\",\"parts\":[{\"text\":\"Describe a single red maple leaf on a white background in one sentence.\"}]}], \"generationConfig\": {\"temperature\":0.7,\"maxOutputTokens\":256}}"
> >
> > # 2. Poll until status is COMPLETED, waiting the Retry-After seconds each response names.
> > REQUEST_ID="<request_id from the 201 body>"
> > curl -i https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash/requests/$REQUEST_ID/status \
> >   -H "X-API-Key: $COMFY_API_KEY"
> >
> > # 3. Collect. 200 with the model's native output, 202 with the status body while it is still running.
> > curl https://api.comfy.org/v2/models/vertexai/gemini-2.5-flash/requests/$REQUEST_ID \
> >   -H "X-API-Key: $COMFY_API_KEY"
> > ```
>
> ## スキーマ
>
> ### 入力
>
> *フィールドは Google が公開している API 仕様に従っており、CI でその仕様と照合されます。このモデルに対する Router 独自のスキーマはまだ公開されていないため、リクエストは検証されずにプロバイダーへ転送されます。*
>
> **contents** `object[]` *required*
>
> これまでの会話。古い順に並びます。パートは `text`、またはプロンプトと一緒に画像、オーディオ、ビデオを送信するための `inlineData` です。
>
> **contents\[].role** `string` *required*
>
> そのターンを誰が作成したか。
>
> 指定可能な値: `user`, `model`
>
> **contents\[].parts** `object[]` *required*
>
> ターンのコンテンツパート。
>
> **contents\[].parts\[].text** `string`
>
> テキストパート。
>
> **contents\[].parts\[].inlineData** `object`
>
> インラインメディアパート。
>
> **contents\[].parts\[].inlineData.mimeType** `string`
>
> メディアタイプ。例: `image/png`
>
> **contents\[].parts\[].inlineData.data** `string`
>
> Base64 でエンコードされたメディアのバイト列。
>
> **systemInstruction** `object`
>
> 会話全体に適用されるシステムプロンプト。
>
> **systemInstruction.parts** `object[]`
>
> **systemInstruction.parts\[].text** `string`
>
> **generationConfig** `object`
>
> サンプリングと長さの設定。
>
> **generationConfig.temperature** `number`
>
> サンプリングのランダム性。デフォルト値はモデル固有です。
>
> 範囲: `0` から `2`
>
> **generationConfig.topP** `number`
>
> 核サンプリングのしきい値。デフォルト値はモデル固有です。
>
> **generationConfig.topK** `integer`
>
> top-k サンプリングのカットオフ。デフォルト値はモデル固有です。
>
> **generationConfig.maxOutputTokens** `integer`
>
> 生成トークン数の上限。
>
> **generationConfig.seed** `integer`
>
> 再現可能なサンプリングのためのシード。
>
> **generationConfig.stopSequences** `string[]`
>
> 生成された時点で生成を終了させる文字列。
>
> **generationConfig.thinkingConfig** `object`
>
> 対応モデルでの推論強度の制御。
>
> **generationConfig.thinkingConfig.thinkingLevel** `string`
>
> 指定可能な値: `MINIMAL`, `LOW`, `MEDIUM`, `HIGH`
>
> **generationConfig.thinkingConfig.includeThoughts** `boolean`
>
> 回答と合わせてモデルの推論を返します。
>
> **tools** `object[]`
>
> モデルが呼び出せる関数宣言。
>
> **tools\[].functionDeclarations** `object[]`
>
> **tools\[].functionDeclarations\[].name** `string`
>
> **tools\[].functionDeclarations\[].description** `string`
>
> **tools\[].functionDeclarations\[].parameters** `object`
>
> 関数の引数の JSON Schema。
>
> ### 出力
>
> Router は Google のネイティブなレスポンスを変更せずに返します。テキストは `candidates[0].content.parts[0].text` にあります。
>
> **candidates** `object[]`
>
> 生成された候補。複数を要求しない限り 1 つです。
>
> **candidates\[].content** `object`
>
> **candidates\[].content.role** `string`
>
> 指定可能な値: `model`
>
> **candidates\[].content.parts** `object[]`
>
> **candidates\[].content.parts\[].text** `string`
>
> 生成されたテキスト。
>
> **candidates\[].content.parts\[].functionCall** `object`
>
> モデルが `tools` のいずれかを呼び出すことを選択した場合に存在します。
>
> **candidates\[].content.parts\[].functionCall.name** `string`
>
> **candidates\[].content.parts\[].functionCall.args** `object`
>
> **candidates\[].finishReason** `string`
>
> 生成が停止した理由: `STOP`、`MAX_TOKENS`、`SAFETY` など
>
> **usageMetadata** `object`
>
> 呼び出しのトークン数の内訳。
>
> **usageMetadata.promptTokenCount** `integer`
>
> プロンプト内のトークン数。
>
> **usageMetadata.candidatesTokenCount** `integer`
>
> 生成された候補内のトークン数。
>
> **promptFeedback** `object`
>
> プロンプト自体がブロックされた場合に存在します。結果を読み取る前に `candidates` が存在するか確認してください。`usageMetadata` もブロックされたレスポンスに含まれることがあります。
>
> **promptFeedback.blockReason** `string`
>
> プロンプトがブロックされた理由。候補は返されないため、プロンプトを言い換えて再試行してください。
>
> 指定可能な値: `SAFETY`, `OTHER`, `BLOCKLIST`, `PROHIBITED_CONTENT`, `IMAGE_SAFETY`
>
> ## 例
>
> ### 入力
>
> ```json theme={null}
> {
>   "contents": [
>     {
>       "role": "user",
>       "parts": [
>         {
>           "text": "Describe a single red maple leaf on a white background in one sentence."
>         }
>       ]
>     }
>   ],
>   "generationConfig": {
>     "temperature": 0.7,
>     "maxOutputTokens": 256
>   }
> }
> ```
>
> ### 出力
>
> ```json theme={null}
> {
>   "candidates": [
>     {
>       "content": {
>         "role": "model",
>         "parts": [
>           {
>             "text": "A single red maple leaf rests on a plain white background, its edges sharp and its color deep."
>           }
>         ]
>       },
>       "finishReason": "STOP"
>     }
>   ],
>   "usageMetadata": {
>     "promptTokenCount": 18,
>     "candidatesTokenCount": 24
>   }
> }
> ```

## 出荷前の確認

SDK は `Idempotency-Key` を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。

リクエストが失敗すると、Router は理由を説明する `X-Comfy-Error-Type` レスポンスヘッダーを送信します。`422` は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味し、`413` はリクエスト本文が Router の受け入れ可能なサイズを超えていたことを意味します。生成されたアセットは [結果 URL の有効期限](https://docs.comfy.org/ja/development/comfy-router/reference.md#結果アセット) があるため、早めにダウンロードしてください。

上記のフィールド説明に記載されているサイズ制限は、プロバイダーの仕様から引用した、そのフィールドに対するプロバイダー自身の上限です。Router はリクエスト本文全体に対して別の上限を適用し、base64 エンコードされたメディアもこれにカウントされます。[リクエスト本文のサイズ](https://docs.comfy.org/ja/development/comfy-router/limitations.md) を参照してください。

このページは、Comfy Router 経由で呼び出す 1 つのパートナーモデルについて説明しています。同じ `comfy-sdk` / `@comfyorg/sdk` パッケージには、Comfy Cloud 上で ComfyUI のワークフローグラフ全体を実行するための 2 つ目のクライアントも含まれています: `Comfy(api_key=...)` / `new Comfy({ apiKey })`、および `client.workflows`、`client.assets`、`client.jobs`。[Comfy SDKs](https://docs.comfy.org/ja/development/api-development/sdks.md) を参照してください。

> [card] [ヘッダー](https://docs.comfy.org/ja/development/comfy-router/headers.md)
>
> 認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。

> [card] [Router API の利用](https://docs.comfy.org/ja/development/comfy-router/api.md)
>
> モデルの検出、バリデーションエラー、リトライ、課金。

> [card] [制限事項](https://docs.comfy.org/ja/development/comfy-router/limitations.md)
>
> Router が現在対応していないことと、代替手段。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.