FLUX 3 Image Klein

Kurzbeispiel

Sende eine Bildanfrage, speichere die zurückgegebene id und frage ab, bis die Aufgabe completed oder failed ist. Diese API nutzt asynchrone Aufgaben und URL-Ausgaben.

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"flux-3-image-klein","prompt":"An amber bottle on pale limestone in soft morning light","resolution":"1k","aspect_ratio":"3:2"}'

Endpunkt und Header

POST https://api.seedrouter.ai/v1/images/generations

Bewahre den Schlüssel auf deinem Server auf. Ein HTTP-Erfolg bestätigt eine Aufgabe, bedeutet aber nicht, dass das Bild fertig ist.

Parameter

Es werden 11 Felder akzeptiert. Nur model und prompt sind erforderlich. Lasse optionale Felder für ihre Standardwerte weg; null wird nicht akzeptiert.

Seitenverhältnisse: auto, 21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4, 1:1, 4:5, 3:4, 5:7, 2:3, 9:16, 1:2, 9:21.

Der Playground hat ein festes Modell und zehn Eingabefelder, einschließlich n, fest auf 1. Sicherheitswerte über 2 sind außer für Administratoren nur per API nutzbar.

Modi und Einschränkungen

Ohne Referenzen wird Text zu Bild erzeugt. Eine Referenz ermöglicht Bearbeitung, mehrere die Kombination mehrerer Bilder. Bei auto folgt die Bearbeitung dem Seitenverhältnis der ersten Referenz. Reine Textgenerierung wählt das Format aus dem Prompt und nutzt 1:1, wenn keines ermittelt wird. Die Standardauflösung ist in jedem Modus 1k.

Auflösungsstufen beschreiben ungefähre Bildgrößen: 768sq etwa 768 × 768; 1K etwa 1 MP; 1.5K etwa 2 MP; 2K etwa 4 MP; 4K etwa 16 MP. Die tatsächlichen Maße findest du in der zurückgegebenen Datei.

Dieser Endpunkt akzeptiert weder width, height, Pixelmaße in size, negative_prompt, guidance, grounding, prompt_upsampling, mask noch mask_url. Unbekannte Felder ergeben vor der Abrechnung HTTP 400. WebP-Ausgabe, base64-Eingabe, Streaming und Callbacks werden nicht angeboten.

Referenzbilder und Bearbeitung einzelner Bildbereiche

Lade Referenzen vor dem Absenden unter einer öffentlichen URL hoch. Der Anfrageinhalt enthält URLs, keine Dateibytes oder data-URLs.

{
  "model": "flux-3-image-klein",
  "prompt": "Use Image 1 as the subject and Image 2 as the setting; match the perspective and light",
  "image_urls": ["https://example.com/subject.png", "https://example.com/setting.png"],
  "aspect_ratio": "auto",
  "resolution": "2k",
  "seed": 0,
  "steps": 16,
  "output_format": "png"
}

Ersetze die Platzhalter-URLs durch eigene erreichbare Bilder. Referenzen sind geordnet: ref_image_0 ist die erste. Bounding-Box-Anweisungen gehören in den String prompt, nicht in ein separates Anfragefeld. Koordinaten nutzen [y1, x1, y2, x2], auf 0–1000 normiert. Ein Layoutobjekt kann id, bbox und desc enthalten; eine Bearbeitung kann id, from, src_bbox, tgt_bbox und desc nutzen. Kodiere die gesamte Anfrage als JSON, damit Anführungszeichen im Prompt korrekt maskiert werden.

Abrechnung

Eine erfolgreiche Anfrage ergibt ein Bild. Nur die gewählte Auflösung bestimmt den Preis; Schritte, Seed, Seitenverhältnis, Referenzanzahl und Format kosten nicht extra. Text-zu-Bild und Bearbeitung haben denselben Tarif. Fehlgeschlagene Anfragen werden nicht berechnet. Siehe aktuelle Preise.

Aufgabenantwort und Polling

Beim Absenden:

{"id":"task_example","model":"flux-3-image-klein","status":"processing"}

curl https://api.seedrouter.ai/v1/tasks/task_example \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

Abgeschlossene Aufgabe (beispielhafte URL):

{
  "id": "task_example",
  "model": "flux-3-image-klein",
  "status": "completed",
  "output": {"data": [{"url": "https://file.deepytb.com/generated/example.png"}]}
}

Lies output.data[0].url. Plane bis zu zehn Minuten für die Generierung ein, besonders bei 4K. Polling ist schreibgeschützt; ein Client-Timeout berechtigt nicht zum Absenden einer weiteren kostenpflichtigen Anfrage. Öffentliche Aufgabenantworten enthalten keine Kosten oder Kontostände.

Fehler

HTTP-Fehler nutzen {"error": {"code": integer, "message": string}}. Siehe das gemeinsame Fehlerverzeichnis. Eine fehlgeschlagene Aufgabe zeigt ihren Fehler neben status: "failed". Korrigiere ungültige Parameter vor erneutem Absenden und behalte die Aufgaben-ID zur Prüfung gesendeter Anfragen.

Tipps und verwandte Anleitungen

Beschreibe positiv und benenne Bereiche oder Details, die erhalten bleiben sollen. Weniger Schritte können die Qualität ändern, senken den Preis aber nicht. Vergleiche jeweils eine Änderung.

• FLUX 3 Image Klein Playground
• Download, Gewichte und ComfyUI-Anleitung
• Lebenszyklus einer Aufgabe