gemini-3.1-flash-lite-image API

Verwenden Sie die genaue Modell-ID gemini-3.1-flash-lite-image. Das Modellfeld muss genau mit dieser Seite übereinstimmen.

Beispielausgabegemini-3.1-flash-lite-imagePOST /v1beta/models/gemini-3.1-flash-lite-image:generateContent

Parameter: ratio=16:9

Prompt: A late-night noodle counter, six stools and a steel pass, rain on the window behind. A cook in an orange quilted jacket has just lifted the lid off a stock pot. The steam is not dispersing: it has gathered into solid braided ribbons of coral and ultraviolet that rope up past her face and press flat along the ceiling. One hard tungsten bulb directly overhead, the street outside cold and blue. Wide camera at counter height, real density in the steam, film grain, slight vignette, no text.

Anfrage, die dieses Beispiel erstellt hat

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "A late-night noodle counter, six stools and a steel pass, rain on the window behind. A cook in an orange quilted jacket has just lifted the lid off a stock pot. The steam is not dispersing: it has gathered into solid braided ribbons of coral and ultraviolet that rope up past her face and press flat along the ceiling. One hard tungsten bulb directly overhead, the street outside cold and blue. Wide camera at counter height, real density in the steam, film grain, slight vignette, no text."
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "IMAGE"
    ],
    "imageConfig": {
      "aspectRatio": "16:9"
    }
  }
}

Authentifizierung und Endpunkt

Verwenden Sie einen Modelflare-API-Schlüssel mit https://modelflare.dev. Der Gateway-Einstiegspunkt ist POST /v1/models/{model}:generateContent.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Erzeugen Sie ein Bild

bash

curl "https://modelflare.dev/v1/models/gemini-3.1-flash-lite-image:generateContent" \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [{"text": "A white cat runs through a neon-lit street in the rain"}]}],
    "generationConfig": {"responseModalities": ["TEXT", "IMAGE"], "imageConfig": {"aspectRatio": "16:9", "imageSize": "1K"}}
  }'

Notizen anfordern

Gemini-Bildmodelle verwenden natives contents und generationConfig; Bearbeitungen senden die Textanweisung und inline_data im selben parts[].

Parameter anfordern

Gemini-Bildmodelle verwenden natives Gemini generateContent. Platzieren Sie Text und Referenzbilder im selben contents[].parts[]; Bilder verwenden inline_data. Senden Sie diese Modelle nicht an /v1/images/generations, /v1/images/edits oder OpenAI /v1/responses. Die imageSize-Enumeration ist modellspezifisch und wird unten angezeigt.

Feld	Erforderlich	Notizen
contents[].parts[].text	Ja	Textaufforderung oder Bearbeitungsanweisung
contents[].parts[].inline_data	Nein	Base64-Bilddaten und MIME-Typ
contents[].parts[].inline_data.mime_type	Nein	image/jpeg / image/png / image/webp
contents[].parts[].inline_data.data	Nein	Base64-codierter Referenzbildinhalt
generationConfig.responseModalities	Ja	["IMAGE"] oder ["TEXT", "IMAGE"]
generationConfig.imageConfig.aspectRatio	Nein	1:1 / 3:2 / 2:3 / 3:4 / 4:3 / 4:5 / 5:4 / 9:16 / 16:9 / 21:9
generationConfig.imageConfig.imageSize	Nein	1K

Reaktions- und Eingabegrenzen

Lite unterstützt nur 1K mit 1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 und 21:9. Die offizielle Dokumentation veröffentlicht keine Obergrenze für die Anzahl der Referenzbilder, daher fügt das Gateway keine lokale Obergrenze hinzu und gibt den Dienstfehler zurück, wenn das Dienstlimit überschritten wird.

Beispiel für die Bildbearbeitung

Platzieren Sie die Bearbeitungsanweisung und das Referenzbild im selben contents[].parts[]. inline_data.data ist der Base64-Bildinhalt; Senden Sie keine Gemini-Bildmodelle an die OpenAI-Images- oder Responses-Endpunkte.

bash

curl "https://modelflare.dev/v1/models/gemini-3.1-flash-lite-image:generateContent" \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [
      {"text": "Keep the subject and lighting, but replace the background with a misty pine forest."},
      {"inline_data": {"mime_type": "image/jpeg", "data": "BASE64_IMAGE_DATA"}}
    ]}],
    "generationConfig": {"responseModalities": ["TEXT", "IMAGE"], "imageConfig": {"aspectRatio": "1:1", "imageSize": "1K"}}
  }'

Antwortform

Lesen candidates[].content.parts[]; Gehen Sie nicht davon aus, dass es sich bei jedem Teil um ein Bild handelt, da die Antwort möglicherweise Text- und Bildteile zusammen enthält.

Feld	Notizen
candidates[].content.parts[].inline_data	Generierter Bild-MIME-Typ und Base64-Daten
candidates[].content.parts[].text	Textbeschriftung wurde zurückgegeben, als TEXT angefordert wurde
candidates[].finishReason	Abschluss oder Sicherheitsgrund
usageMetadata	Verwendung des Eingabe-/Ausgabe-Tokens bei Rückgabe durch den Dienst

Modelflare behält die native Gemini-Antwortform für gemini-3.1-flash-lite-image bei und behält verwendbare Bildteile bei.

Fehler und fehlgeschlagene Aufgaben

Feldfehler, Größen-/Verhältnisbeschränkungen und Sicherheitsverweigerungen aus der nativen Gemini-Anfrage bleiben Gemini-kompatible Fehlerantworten. Das Gateway schreibt sie nicht als OpenAI Images-Antworten um.

Unterstützter Bereich

Auf dieser Seite werden Modelflare-Modellgenerierungs- und -bearbeitungsaufrufe behandelt. Such- oder Kartenanreicherung, Sprachverwaltung und Elementbibliotheksverwaltung sind Ressourcen-APIs außerhalb dieser öffentlichen Modellaufrufoberfläche und keine erforderlichen Anforderungsfelder.

Preise und Abrechnung

Dieses Modell verwendet eine tokenbasierte Abrechnung. Den aktuellen Kundenpreis, den Referenzlistenpreis und die vollständige Spezifikation finden Sie auf der Modellpreisseite.

Hinweis

Diese Seite dokumentiert die öffentliche Schnittstelle von Modelflare. Bei den hier dargestellten Feldern und Grenzen handelt es sich um den aktuellen Vertrag.