API | Gemini 3.1 Pro Preview API – 1M-Token-Kontext

google/gemini-3.1-pro-preview/chat

Gemini 3.1 Pro Preview ist Googles Langkontext-Chat-Modell mit OpenAI-kompatibler API. Es liest bis zu 1.000.000 Token, antwortet mit bis zu 32.768 und bietet drei Reasoning-Stufen, bis zu 128 Tools, JSON-Ausgabe sowie Text- und Bildeingabe.

Eingabe $1.90Ausgabe $11.40je 1 Mio. TokenEingabe aus dem Cache $0.19Prompts über 200K TokenEingabe $3.80Ausgabe $17.10Offizieller Preis von Google$2~~$12~~

Modell ausführen API ansehen

Anfrage senden

Die Beispiele verwenden die öffentlichen Parameter des gewählten Endpunkts. Ersetzen Sie API-Schlüssel und Beispielmedien und senden Sie die Anfrage von Ihrem Server.

SDKs & Integrationen

POSThttps://api.spicyapi.ai/v1/chat/completions

API-Authentifizierung

Bewahren Sie den API-Schlüssel serverseitig in der Umgebungsvariablen SPICY_API_KEY auf. Verwenden Sie Bearer-Authentifizierung und für JSON-Anfragen 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-3.1-pro-preview/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'

Erzeugt aus dem Eingabeschema dieses Modells – genau dem, gegen das die API jede Anfrage prüft.

Behalten Sie für jede logische Anfrage denselben Idempotency-Key. Senden Sie nach einem Verbindungsabbruch nicht automatisch mit einem neuen Key erneut, sondern bewahren Sie die request_id auf, um die angenommene Anfrage zu prüfen. Ein früherer Chat-Stream wird dabei nicht noch einmal ausgeliefert.

Eingabeparameter

Die Modellparameter stehen direkt im JSON-Request-Body auf derselben Ebene wie model. Dieser Endpunkt verwendet kein input-Objekt.

messagesarray<object>Erforderlich

Geordnete Gesprächszüge. Der Inhalt ist ein String oder ein Array aus Text- und image_url-Teilen. Legen Sie Weltenbibel und Verlauf in eine User-Nachricht und die Weltregeln samt Anweisung für diesen Zug in die System-Nachricht.

Standardwert: Nicht festgelegt
Einschränkungen: minItems:1

messages[].rolestringIm Objekt erforderlich

Role of the message author.

Standardwert: Nicht festgelegt
Zulässige Werte: "system""developer""user""assistant""tool"

messages[].namestringOptional

Optional name identifying the speaker within its role.

Standardwert: Nicht festgelegt

messages[].contentstring | array | nullOptional

Message content, either plain text or a list of content parts.

Standardwert: Nicht festgelegt

{
  "type": [
    "string",
    "array",
    "null"
  ],
  "items": {
    "oneOf": [
      {
        "type": "object",
        "required": [
          "type",
          "text"
        ],
        "properties": {
          "text": {
            "type": "string"
          },
          "type": {
            "const": "text"
          }
        }
      },
      {
        "type": "object",
        "required": [
          "type",
          "image_url"
        ],
        "properties": {
          "type": {
            "const": "image_url"
          },
          "image_url": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "url": {
                "type": "string"
              }
            }
          }
        }
      }
    ]
  },
  "description": "Message content, either plain text or a list of content parts."
}

messages[].tool_callsarray<object>Optional

Tool calls the assistant requested in this message.

Standardwert: Nicht festgelegt

messages[].tool_call_idstringOptional

Identifier of the tool call this message answers. Required on tool messages.

Standardwert: Nicht festgelegt

messages[].reasoning_contentstringOptional

Reasoning text from a previous assistant reply, preserved when continuing a tool conversation.

Standardwert: Nicht festgelegt

{
  "type": "array",
  "x-ui": {
    "order": 100,
    "widget": "chat-messages",
    "primary": true
  },
  "items": {
    "type": "object",
    "allOf": [
      {
        "if": {
          "required": [
            "reasoning_content"
          ]
        },
        "then": {
          "properties": {
            "role": {
              "const": "assistant"
            }
          }
        }
      }
    ],
    "required": [
      "role"
    ],
    "properties": {
      "name": {
        "type": "string",
        "description": "Optional name identifying the speaker within its role."
      },
      "role": {
        "enum": [
          "system",
          "developer",
          "user",
          "assistant",
          "tool"
        ],
        "type": "string",
        "description": "Role of the message author."
      },
      "content": {
        "type": [
          "string",
          "array",
          "null"
        ],
        "items": {
          "oneOf": [
            {
              "type": "object",
              "required": [
                "type",
                "text"
              ],
              "properties": {
                "text": {
                  "type": "string"
                },
                "type": {
                  "const": "text"
                }
              }
            },
            {
              "type": "object",
              "required": [
                "type",
                "image_url"
              ],
              "properties": {
                "type": {
                  "const": "image_url"
                },
                "image_url": {
                  "type": "object",
                  "required": [
                    "url"
                  ],
                  "properties": {
                    "url": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          ]
        },
        "description": "Message content, either plain text or a list of content parts."
      },
      "tool_calls": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Tool calls the assistant requested in this message."
      },
      "tool_call_id": {
        "type": "string",
        "description": "Identifier of the tool call this message answers. Required on tool messages."
      },
      "reasoning_content": {
        "type": "string",
        "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
      }
    },
    "additionalProperties": false
  },
  "minItems": 1,
  "description": "Ordered conversation turns. Text content only on this endpoint."
}

response_formatobjectOptional

Verlangen Sie ein JSON-Objekt und benennen Sie jeden Schlüssel in der System-Nachricht.

Standardwert: Nicht festgelegt

tool_choicestring | objectOptional

auto, none, required – oder ein Objekt, das eine Funktion benennt.

Standardwert: Nicht festgelegt

toolsarray<object>Optional

Bis zu 128 Funktionsdefinitionen pro Anfrage.

Standardwert: Nicht festgelegt
Einschränkungen: maxItems:128

top_pnumberOptional

0,01 bis 1. Verstellen Sie dies oder temperature, nie beides im selben Vergleich.

Standardwert: 1
Einschränkungen: minimum:0.01
maximum:1

temperaturenumberOptional

0 bis 2, Vorgabe 1. Google empfiehlt für Gemini-3-Modelle ausdrücklich, bei 1,0 zu bleiben – niedrigere Werte können zu Schleifen oder schwächerer Qualität führen. Formen Sie strukturierte Ausgaben stattdessen über response_format und die System-Nachricht.

Standardwert: 1
Einschränkungen: minimum:0
maximum:2

seedintegerOptional

Beliebige Ganzzahl. Derselbe Seed bei sonst gleicher Anfrage lässt Antworten eng übereinstimmen, sodass Sie jeweils nur eine Sache ändern und fair vergleichen können; identische Ausgaben garantiert er nicht. Kein Standardwert – jede Anfrage zieht neu. Kein Einfluss auf den Preis.

Standardwert: Nicht festgelegt

stopstring | arrayOptional

Bis zu 4 Sequenzen, als String oder Array. Die Antwort endet, sobald das Modell eine davon schreibt; der getroffene Text selbst wird nicht zurückgegeben. Kein Standardwert. Der Tarif ändert sich nicht – eine vorzeitig beendete Antwort wird nur nach den tatsächlich erzeugten Tokens abgerechnet.

Standardwert: Nicht festgelegt
Einschränkungen: minLength:1
minItems:1
maxItems:4

reasoning_effortstringOptional

minimal, low, medium oder high. Vorgabe ist medium: für Routinezüge auf low senken, zum Abgleichen des Verlaufs oder zur Suche nach Widersprüchen auf high anheben. Googles eigene Vorgabe für dieses Modell ist high; dieser Endpunkt steht auf medium, damit gewöhnliche Züge schnell bleiben.

Standardwert: "medium"
Zulässige Werte: "minimal""low""medium""high"

max_tokensintegerOptional

Deckelt die Antwort bei 32.768 – einem Dreißigstel des Lesefensters. Vorgabe 16.384. Reasoning-Tokens werden ebenfalls als Ausgabe berechnet – lass also Luft über der sichtbaren Antwort, die du erwartest.

Standardwert: 16384
Einschränkungen: minimum:1
maximum:32768

{
  "type": "object",
  "required": [
    "messages"
  ],
  "x-pricing": {
    "billingMode": "formula",
    "variantFields": []
  },
  "properties": {
    "seed": {
      "type": "integer",
      "x-ui": {
        "order": 55,
        "widget": "number",
        "affects_price": false
      },
      "description": "Seed for the sampler, so a repeated request comes back close to the same."
    },
    "stop": {
      "type": [
        "string",
        "array"
      ],
      "x-ui": {
        "order": 65,
        "widget": "text",
        "affects_price": false
      },
      "items": {
        "type": "string",
        "minLength": 1
      },
      "maxItems": 4,
      "minItems": 1,
      "minLength": 1,
      "description": "Sequences that end the reply as soon as the model writes one; the matched text is not returned."
    },
    "tools": {
      "type": "array",
      "x-ui": {
        "order": 35,
        "widget": "json"
      },
      "items": {
        "type": "object"
      },
      "maxItems": 128,
      "description": "Tool definitions the model may call."
    },
    "top_p": {
      "type": "number",
      "x-ui": {
        "step": 0.01,
        "order": 40,
        "widget": "slider"
      },
      "default": 1,
      "maximum": 1,
      "minimum": 0.01,
      "description": "Nucleus sampling threshold. Lower values keep only the most likely tokens."
    },
    "messages": {
      "type": "array",
      "x-ui": {
        "order": 100,
        "widget": "chat-messages",
        "primary": true
      },
      "items": {
        "type": "object",
        "allOf": [
          {
            "if": {
              "required": [
                "reasoning_content"
              ]
            },
            "then": {
              "properties": {
                "role": {
                  "const": "assistant"
                }
              }
            }
          }
        ],
        "required": [
          "role"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Optional name identifying the speaker within its role."
          },
          "role": {
            "enum": [
              "system",
              "developer",
              "user",
              "assistant",
              "tool"
            ],
            "type": "string",
            "description": "Role of the message author."
          },
          "content": {
            "type": [
              "string",
              "array",
              "null"
            ],
            "items": {
              "oneOf": [
                {
                  "type": "object",
                  "required": [
                    "type",
                    "text"
                  ],
                  "properties": {
                    "text": {
                      "type": "string"
                    },
                    "type": {
                      "const": "text"
                    }
                  }
                },
                {
                  "type": "object",
                  "required": [
                    "type",
                    "image_url"
                  ],
                  "properties": {
                    "type": {
                      "const": "image_url"
                    },
                    "image_url": {
                      "type": "object",
                      "required": [
                        "url"
                      ],
                      "properties": {
                        "url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              ]
            },
            "description": "Message content, either plain text or a list of content parts."
          },
          "tool_calls": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "Tool calls the assistant requested in this message."
          },
          "tool_call_id": {
            "type": "string",
            "description": "Identifier of the tool call this message answers. Required on tool messages."
          },
          "reasoning_content": {
            "type": "string",
            "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
          }
        },
        "additionalProperties": false
      },
      "minItems": 1,
      "description": "Ordered conversation turns. Text content only on this endpoint."
    },
    "max_tokens": {
      "type": "integer",
      "x-ui": {
        "unit": "tokens",
        "order": 80,
        "widget": "number",
        "advanced": false,
        "affects_price": false
      },
      "default": 16384,
      "maximum": 32768,
      "minimum": 1,
      "description": "Maximum number of tokens to generate in the reply."
    },
    "temperature": {
      "type": "number",
      "x-ui": {
        "order": 50,
        "widget": "slider"
      },
      "default": 1,
      "maximum": 2,
      "minimum": 0,
      "description": "Sampling temperature. Higher values make the output more varied."
    },
    "tool_choice": {
      "type": [
        "string",
        "object"
      ],
      "x-ui": {
        "order": 30,
        "widget": "json"
      },
      "description": "Controls whether and which tool the model may call."
    },
    "response_format": {
      "type": "object",
      "x-ui": {
        "order": 25,
        "widget": "json"
      },
      "description": "Requested reply format, such as plain text or a JSON object."
    },
    "reasoning_effort": {
      "enum": [
        "minimal",
        "low",
        "medium",
        "high"
      ],
      "type": "string",
      "x-ui": {
        "order": 70,
        "widget": "radio"
      },
      "default": "medium",
      "description": "How much the model works through the task before answering."
    }
  },
  "x-image-token-limit": 2000,
  "x-input-token-limit": 1000000,
  "additionalProperties": false,
  "x-max-tokens-includes-reasoning": true
}

Ergebnis auslesen

Mit stream: false liefert die Anfrage die vollständige Chat-Antwort direkt zurück. Lesen Sie choices[].message; ein Auftrag muss dafür nicht abgefragt werden. Für Clients mit Unterstützung für Server-Sent Events können Sie stream auf true setzen.

Beispiel einer fertigen Antwort

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1788652800,
  "model": "google/gemini-3.1-pro-preview/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
  }
}

Die Antwort dient als Strukturbeispiel. usage enthält Tokenzahlen; tatsächlicher Verbrauch und Kosten hängen von der Anfrage ab.

SDKs & Integrationen

Nutzen Sie SpicyAPI in Ihrer App, im Terminal, mit KI-Assistenten oder in visuellen Workflows. Wählen Sie die passende Anleitung.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Terminalbefehle und Automatisierungsskripte.

MCP

Claude Code · Cursor · Codex

Agent Skill

Wiederverwendbare Anweisungen für Ihren KI-Assistenten.

n8n

Community-Nodes für selbst gehostetes n8n und importierbare HTTP Request-Vorlagen für n8n Cloud.

ComfyUI

Bild-, Video- und Audio-Workflows auf einer Node-Oberfläche.

Weitere Integrationen

SillyTavern Telegram / Discord App proxy OpenAI SDK LangChain Vercel AI SDK

Fertige Workflows entdecken

Ein Chat-Modell: Es läuft überall dort, wo die Chat-API von OpenAI läuft. Client behalten, Base-URL austauschen, dieses Modell über seine ID auswählen.

Jeden OpenAI-kompatiblen Client hierher zeigen lassen

export OPENAI_BASE_URL="https://api.spicyapi.ai/v1"
export OPENAI_API_KEY="$SPICY_API_KEY"

aider --model openai/google/gemini-3.1-pro-preview/chat

Alles, was die OpenAI-Chat-API nutzt, funktioniert auf dieselbe Weise – SDKs, das Vercel AI SDK, LangChain, aider und Cline. Der MCP-Server und die spicyapi-CLI decken asynchrone Medienaufgaben ab. Die Einrichtung der einzelnen Tools finden Sie im Entwicklerbereich.

In SillyTavern und Rollenspiel-Apps nutzen

In SillyTavern, RisuAI, Agnai oder jeder App mit OpenAI-kompatibler Einstellung fügen Sie die Basis-URL unten und Ihren API-Schlüssel ein und wählen google/gemini-3.1-pro-preview/chat als Modell. Aufrufe direkt aus dem Browser sind erlaubt, und Regler, die dieses Modell nicht kennt, werden ignoriert statt abgelehnt.

Base URL: https://api.spicyapi.ai/v1
Model: google/gemini-3.1-pro-preview/chat

SillyTavern-Anleitung RisuAI, Agnai und mehr SillyTavern-Erweiterung

In ComfyUI nutzen

Installieren Sie die SpicyAPI-Nodes über den ComfyUI Manager oder mit dem Befehl unten und wählen Sie im SpicyAPI Chat-Node google/gemini-3.1-pro-preview/chat, um dieses Modell in einem ComfyUI-Graphen zu nutzen.

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

Workflow-Beispiele Einrichtungsanleitung Quellcode auf GitHub

Das eingebettete Panel liest dasselbe Schema wie diese Seite und kann daher nicht von der API abweichen. Soll der Inhalt in Ihrer Dokumentation durchsuchbar bleiben, holen Sie stattdessen das JSON unter /api/embed/models/ und rendern es selbst.

<iframe src="https://spicyapi.ai/embed/de/models/gemini-3-1-pro-preview/api?model=google%2Fgemini-3.1-pro-preview%2Fchat" width="100%" height="560" loading="lazy" title="Anfragebeispiel" style="border:1px solid rgba(0,0,0,.12)"></iframe>

Panel öffnen

Playground

Anfrage senden

API-Authentifizierung

Eingabeparameter

Ergebnis auslesen

SDKs & Integrationen

In SillyTavern und Rollenspiel-Apps nutzen

In ComfyUI nutzen