API | Gemini 2.5 Flash API – 1M Kontext, stabil

google/gemini-2.5-flash/chat

Gemini 2.5 Flash ist Googles hybrides Reasoning-Modell als OpenAI-kompatibler Chat-Endpunkt. Es liest bis zu 1.048.576 Token, antwortet mit bis zu 65.535 und bietet drei Reasoning-Stufen, bis zu 128 Tools sowie Text-, Bild-, Video- und Audioeingabe.

Eingabe $0.285Ausgabe $2.375je 1 Mio. TokenEingabe aus dem Cache $0.0285Offizieller Preis von Google~~$0.30$2.50~~

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-2.5-flash/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 Züge, das älteste zuerst. Der Inhalt ist ein String oder ein Array aus Teilen vom Typ text, image_url, video_url, audio_url und input_audio. Hochgeladenes Video und Audio dürfen pro Anfrage zusammen 14 MB ergeben. Dauerhaft geltende Anweisungen gehören in die System-Nachricht, danach hängen Sie je Zug eine Runde an.

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"
              }
            }
          }
        }
      },
      {
        "type": "object",
        "required": [
          "type",
          "video_url"
        ],
        "properties": {
          "type": {
            "const": "video_url"
          },
          "video_url": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "url": {
                "type": "string"
              }
            }
          }
        }
      },
      {
        "type": "object",
        "required": [
          "type",
          "audio_url"
        ],
        "properties": {
          "type": {
            "const": "audio_url"
          },
          "audio_url": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "url": {
                "type": "string"
              }
            }
          }
        }
      },
      {
        "type": "object",
        "required": [
          "type",
          "input_audio"
        ],
        "properties": {
          "type": {
            "const": "input_audio"
          },
          "input_audio": {
            "type": "object",
            "required": [
              "data",
              "format"
            ],
            "properties": {
              "data": {
                "type": "string"
              },
              "format": {
                "enum": [
                  "wav",
                  "mp3"
                ],
                "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"
                    }
                  }
                }
              }
            },
            {
              "type": "object",
              "required": [
                "type",
                "video_url"
              ],
              "properties": {
                "type": {
                  "const": "video_url"
                },
                "video_url": {
                  "type": "object",
                  "required": [
                    "url"
                  ],
                  "properties": {
                    "url": {
                      "type": "string"
                    }
                  }
                }
              }
            },
            {
              "type": "object",
              "required": [
                "type",
                "audio_url"
              ],
              "properties": {
                "type": {
                  "const": "audio_url"
                },
                "audio_url": {
                  "type": "object",
                  "required": [
                    "url"
                  ],
                  "properties": {
                    "url": {
                      "type": "string"
                    }
                  }
                }
              }
            },
            {
              "type": "object",
              "required": [
                "type",
                "input_audio"
              ],
              "properties": {
                "type": {
                  "const": "input_audio"
                },
                "input_audio": {
                  "type": "object",
                  "required": [
                    "data",
                    "format"
                  ],
                  "properties": {
                    "data": {
                      "type": "string"
                    },
                    "format": {
                      "enum": [
                        "wav",
                        "mp3"
                      ],
                      "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 – so kommt die Antwort parsbar zurück.

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 je 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. Richtung 0 schieben, wenn die Antwort von Code gelesen wird, anheben, wenn der Text lockerer klingen soll.

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

low, medium oder high; medium ist die Vorgabe. Routinearbeit läuft gut auf low, und die eine Anfrage, die sitzen muss, lässt sich einzeln auf high heben. Wie viele Denk-Token je Stufe anfallen, ist nicht veröffentlicht – deshalb nennen wir auch keine Zahl.

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

max_tokensintegerOptional

Deckelt die Antwort bei 65.535, die Vorgabe ist 16.384. Senken Sie den Wert, wenn aus einer langen Vorlage eine kurze Antwort werden soll – die Obergrenze ist eine Grenze, kein Ziel. Reasoning-Tokens werden ebenfalls als Ausgabe berechnet – lass also Luft über der sichtbaren Antwort, die du erwartest.

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

{
  "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"
                        }
                      }
                    }
                  }
                },
                {
                  "type": "object",
                  "required": [
                    "type",
                    "video_url"
                  ],
                  "properties": {
                    "type": {
                      "const": "video_url"
                    },
                    "video_url": {
                      "type": "object",
                      "required": [
                        "url"
                      ],
                      "properties": {
                        "url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                {
                  "type": "object",
                  "required": [
                    "type",
                    "audio_url"
                  ],
                  "properties": {
                    "type": {
                      "const": "audio_url"
                    },
                    "audio_url": {
                      "type": "object",
                      "required": [
                        "url"
                      ],
                      "properties": {
                        "url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                {
                  "type": "object",
                  "required": [
                    "type",
                    "input_audio"
                  ],
                  "properties": {
                    "type": {
                      "const": "input_audio"
                    },
                    "input_audio": {
                      "type": "object",
                      "required": [
                        "data",
                        "format"
                      ],
                      "properties": {
                        "data": {
                          "type": "string"
                        },
                        "format": {
                          "enum": [
                            "wav",
                            "mp3"
                          ],
                          "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": 65535,
      "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": [
        "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": 4500,
  "x-input-token-limit": 1048576,
  "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-2.5-flash/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-2.5-flash/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-2.5-flash/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-2.5-flash/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-2.5-flash/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-2-5-flash/api?model=google%2Fgemini-2.5-flash%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