logo
RunComfy
  • ComfyUI
  • TrainerNeu
  • Modelle
  • API
  • Preise
discord logo
MODELLE
Erkunden
Alle Modelle
BIBLIOTHEK
Generierungen
MODELL-APIS
API-Dokumentation
API-Schlüssel
KONTO
Nutzung

Gemini 3 Pro Text-to-Image: Konfigurierbare Bildgenerierung | RunComfy

google/gemini-3-pro-image-preview/text-to-image

Erzeugen Sie anhand eines Pflicht-Prompts 1 bis 4 Bilder. Zur Auswahl stehen 10 Seitenverhältnisse, 1K-, 2K- oder 4K-Auflösung, drei Dateiformate und eine optionale synchrone Rückgabe.

Inhaltsverzeichnis

1. Erste Schritte2. Authentifizierung3. API-ReferenzAnfrage sendenAnfragestatus abrufenErgebnisse abrufenAnfrage abbrechen4. DateieingabenGehostete Datei (URL)5. SchemaEingabeschemaAusgabeschema

1. Erste Schritte

Nutzen Sie die RunComfy-API, um google/gemini-3-pro-image-preview/text-to-image auszuführen. Zulässige Ein- und Ausgaben finden Sie im Schema.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/google/gemini-3-pro-image-preview/text-to-image \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A pair of mannequin legs dressed in sparkling glitter socks protrudes boldly from a voluminous mountain of cotton candy, its delicate, spun sugar texture softly aglow under a focused studio spotlight. Wisps of ethereal fog swirl gently around the scene, diffusing the bright, cool light and lending a dreamlike haze that contrasts with the sharp shine on the socks' glistening threads. The smooth, featureless plastic of the legs reflects the light with subtle sheen, emphasizing their artificial stillness amid the sweet, fluffy chaos surrounding them. The composition centers tightly on this surreal juxtaposition, capturing the fine details of the glitter's shimmer and the airy cotton candy's spun texture in crisp, tactile clarity, bathed in cool white and pale pink hues that meld into a softly blurred background."
  }'

2. Authentifizierung

Weisen Sie der Umgebungsvariable YOUR_API_TOKEN Ihren API-Schlüssel zu (Verwaltung unter Profil). Senden Sie bei jeder Anfrage im Header Authorization einen Bearer-Token: Authorization: Bearer $YOUR_API_TOKEN.

3. API-Referenz

Anfrage senden

Senden Sie einen asynchronen Generierungsauftrag und erhalten Sie sofort eine request_id sowie URLs für Status, Ergebnisse und Abbruch.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/google/gemini-3-pro-image-preview/text-to-image \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A pair of mannequin legs dressed in sparkling glitter socks protrudes boldly from a voluminous mountain of cotton candy, its delicate, spun sugar texture softly aglow under a focused studio spotlight. Wisps of ethereal fog swirl gently around the scene, diffusing the bright, cool light and lending a dreamlike haze that contrasts with the sharp shine on the socks' glistening threads. The smooth, featureless plastic of the legs reflects the light with subtle sheen, emphasizing their artificial stillness amid the sweet, fluffy chaos surrounding them. The composition centers tightly on this surreal juxtaposition, capturing the fine details of the glitter's shimmer and the airy cotton candy's spun texture in crisp, tactile clarity, bathed in cool white and pale pink hues that meld into a softly blurred background."
  }'

Anfragestatus abrufen

Ruft den aktuellen Status für eine request_id ab („in_queue“, „in_progress“, „completed“ oder „cancelled“).

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

Ergebnisse abrufen

Ruft die endgültigen Ausgaben und Metadaten für die angegebene request_id ab; ist der Auftrag noch nicht fertig, liefert die Antwort den aktuellen Status zum Weiterpollen.

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

Anfrage abbrechen

Bricht einen wartenden Auftrag per request_id ab; laufende Aufträge können nicht abgebrochen werden.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. Dateieingaben

Gehostete Datei (URL)

Geben Sie eine öffentlich erreichbare HTTPS-URL an. Der Host muss serverseitige Abrufe erlauben (ohne Login/Cookies), nicht drosseln oder Bots blockieren. Empfohlen: Bilder ≤ 50 MB (~4K), Videos ≤ 100 MB (~2–5 Min. bei 720p). Für private Assets stabile oder vorab signierte URLs verwenden.

5. Schema

Eingabeschema

{
  "type": "object",
  "title": "Eingabeschema",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "title": "Prompt",
      "description": "Textbeschreibung des Bildes oder der Bilder, die generiert werden sollen.",
      "type": "string",
      "default": "A pair of mannequin legs dressed in sparkling glitter socks protrudes boldly from a voluminous mountain of cotton candy, its delicate, spun sugar texture softly aglow under a focused studio spotlight. Wisps of ethereal fog swirl gently around the scene, diffusing the bright, cool light and lending a dreamlike haze that contrasts with the sharp shine on the socks' glistening threads. The smooth, featureless plastic of the legs reflects the light with subtle sheen, emphasizing their artificial stillness amid the sweet, fluffy chaos surrounding them. The composition centers tightly on this surreal juxtaposition, capturing the fine details of the glitter's shimmer and the airy cotton candy's spun texture in crisp, tactile clarity, bathed in cool white and pale pink hues that meld into a softly blurred background."
    },
    "aspect_ratio": {
      "title": "Seitenverhältnis (B:H)",
      "description": "Seitenverhältnis der generierten Bilder. Wählen Sie einen der 10 aufgelisteten Werte.",
      "type": "string",
      "enum": [
        "21:9",
        "16:9",
        "3:2",
        "4:3",
        "5:4",
        "1:1",
        "4:5",
        "3:4",
        "2:3",
        "9:16"
      ],
      "default": "16:9"
    },
    "resolution": {
      "title": "Auflösung",
      "description": "Ausgabeauflösung. Zulässige Werte: `1K`, `2K` und `4K`.",
      "type": "string",
      "enum": [
        "1K",
        "2K",
        "4K"
      ],
      "default": "1K"
    },
    "output_format": {
      "title": "Ausgabeformat",
      "description": "Ausgabebildformat. Zulässige Werte: `jpeg`, `png` und `webp`; Standard: `png`.",
      "type": "string",
      "enum": [
        "jpeg",
        "png",
        "webp"
      ],
      "default": "png"
    },
    "num_images": {
      "title": "Anzahl der Bilder",
      "description": "Anzahl der zu generierenden Bilder. Zulässiger Bereich: 1 bis 4; Standard: 1.",
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "maximum": 4
    },
    "sync_mode": {
      "title": "Synchronmodus",
      "description": "Bei `true` wird das Medium als Daten-URI zurückgegeben und seine Ausgabedaten werden nicht im Anforderungsverlauf gespeichert. Der Standardwert ist `false`.",
      "type": "boolean",
      "default": false
    }
  }
}

Ausgabeschema

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "Einzelbild-URL"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "Einzelvideo-URL"
      },
      "images": {
        "type": "array",
        "description": "mehrere Bild-URLs",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "mehrere Video-URLs",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}
Folge uns
  • LinkedIn
  • Facebook
  • Instagram
  • Twitter
Support
  • Discord
  • E-Mail
  • Systemstatus
  • Partner
Videomodelle
  • MiniMax H3 Open
  • FLUX 3 Image to Video
  • MiniMax H3 Open Image to Video
  • Wan 2.6 Flash
  • Happy Horse 1.1 reference to video
  • Seedance 1.5 Pro Text to Video
  • Alle Modelle anzeigen →
Bildmodelle
  • Seedream 5.0 Pro Image Edit
  • Flux 2 Flash Edit
  • Nano Banana Pro
  • seedream 4.0
  • GPT Image 2
  • Qwen Image Edit 2511 LoRA
  • Alle Modelle anzeigen →
Rechtliches
  • Nutzungsbedingungen
  • Datenschutzrichtlinie
  • Cookie-Richtlinie
RunComfy
Urheberrecht 2026 RunComfy. Alle Rechte vorbehalten.

RunComfy ist die führende ComfyUI Plattform, die ComfyUI online Umgebung und Services bietet, zusammen mit ComfyUI Workflows mit atemberaubenden Visualisierungen. RunComfy bietet auch AI Models, Künstlern ermöglichen, die neuesten AI-Tools zu nutzen, um unglaubliche Kunst zu schaffen.