本文へスキップ

google/gemini-4-carbon/chat

Google の Gemini 4 Carbon チャットエンドポイントは、最も強力な推論モデルをテキストと画像で実行します。関数呼び出しと JSON 出力に対応し、共有コンテキストは 1,048,576 トークンです。

入力 $2出力 $10100 万トークンあたりキャッシュ入力 $0.10

プレイグラウンド

リクエストを送信

クイックスタート

例は、選択中のエンドポイントの公開パラメーター定義から作っています。API キーとサンプル素材を差し替えて、ご自身のサーバーから送信してください。

SDK・連携
POSThttps://api.spicyapi.ai/v1/chat/completions

API 認証

API キーはサーバーの環境変数 SPICY_API_KEY に保存します。Bearer 認証を使用し、JSON リクエストには Content-Type: application/json を指定してください。

Authorization: Bearer $SPICY_API_KEY
curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "google/gemini-4-carbon/chat",
  "messages": [
    {
      "role": "user",
      "content": "Summarise the following release notes into three bullet points."
    }
  ],
  "stream": true
}' \
  | jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'

このモデルの入力スキーマから生成した例です。API はどのリクエストも、同じスキーマで検証します。

同じ論理リクエストには同じ Idempotency-Key を使い続けてください。通信が切れた場合は新しいキーで自動再送せず、受理済みリクエストを追跡できるよう request_id を保存します。冪等性は、過去のチャットストリームを再生するものではありません。

入力パラメーター

モデルのパラメーターは、JSON リクエスト本文の model と同じ階層に指定します。このエンドポイントでは input でラップしません。

messagesarray<object>必須

Carbon との会話を古い順に並べます。user メッセージではテキストパートと image_url パートを組み合わせられます。

デフォルト値
指定なし
制約
minItems:1
maxItems:256
response_formatobject任意

Carbon に JSON オブジェクト、または指定した json_schema に沿った JSON を要求します。アプリケーションで使う前に結果を検証してください。

デフォルト値
指定なし
tool_choicestring | object任意

Carbon の次の動作を auto、none、required、または特定の関数の指定で制御します。

デフォルト値
指定なし
parallel_tool_callsboolean任意

既定で有効なため、Carbon は 1 ターンで複数の関数を要求できます。1 件ずつ受け取る場合は false を指定してください。

デフォルト値
true
toolsarray<object>任意

Carbon が呼び出しを要求できる関数を最大 128 件定義します。引数の検証と関数の実行はアプリケーションが行い、結果を tool メッセージで返します。

デフォルト値
指定なし
制約
maxItems:128
top_pnumber任意

OpenAI 形式のクライアントが動作し続けるよう、0.01 から 1 までの値を受け付けます。Google のドキュメントによると Carbon はこの設定も無視します。

デフォルト値
指定なし
制約
minimum:0.01
maximum:1
temperaturenumber任意

OpenAI 形式のクライアントが動作し続けるよう、0 から 2 までの値を受け付けます。Google のドキュメントによると Carbon はこの設定を無視するため、応答は変わりません。

デフォルト値
指定なし
制約
minimum:0
maximum:2
stopstring | array任意

停止文字列を 1 件から 4 件まで、各 32 文字以内で指定します。Carbon の応答は最初の一致の直前で終わり、一致した文字列は返されません。

デフォルト値
指定なし
制約
minLength:1
minItems:1
maxItems:4
reasoning_effortstring任意

Carbon の思考の深さで、low、medium、high から選びます(既定は medium)。思考はオフにできず、high が最も多くのトークンを使います。

デフォルト値
"medium"
使用可能な値
"low""medium""high"
max_tokensinteger任意

Carbon の応答枠で、1 から 65536 まで指定できます(既定は 4096)。推論もここに含まれ、長い入力に上限 400 で試すと 397 トークンが推論に使われ、本文は返りませんでした。

デフォルト値
4096
制約
minimum:1
maximum:65536

結果を取得

stream が false の場合、完成したチャット応答が直接返ります。choices[].message を読み取ってください。タスクのポーリングは不要です。Server-Sent Events 対応のクライアントでは stream を true にできます。

完了レスポンスの例
{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1788652800,
  "model": "google/gemini-4-carbon/chat",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Here is a concise summary of the release notes."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 14,
    "total_tokens": 46
  }
}

レスポンス例は構造を示すためのものです。usage はトークン数を示し、実際のトークン数と料金はリクエスト内容によって変わります。

SDK・連携

アプリ、ターミナル、AI アシスタント、ビジュアルワークフローで SpicyAPI を活用。接続ガイドを選んでください。

SillyTavern やロールプレイアプリで使う

SillyTavern、RisuAI、Agnai など OpenAI 互換の設定があるアプリに、下のベース URL と API キーを貼り付け、モデルに google/gemini-4-carbon/chat を選んでください。ブラウザーからの呼び出しにも対応しており、このモデルが受け付けないスライダーはエラーにならず無視されます。

Base URL: https://api.spicyapi.ai/v1
Model: google/gemini-4-carbon/chat

ComfyUI で使う

ComfyUI Manager か下のコマンドで SpicyAPI ノードをインストールしたら、SpicyAPI Chat ノードで google/gemini-4-carbon/chat を選ぶと、ComfyUI のグラフの中でこのモデルを使えます。

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi