FLUX 3 Image Klein

Exemple rapide

Envoyez une requête pour une image, enregistrez l’id renvoyé et interrogez la tâche jusqu’à completed ou failed. Cette API utilise des tâches asynchrones et des sorties URL.

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"}'

Point de terminaison et en-têtes

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

Conservez la clé sur votre serveur. Un succès HTTP confirme une tâche ; il ne signifie pas que son image est prête.

Paramètres

11 champs sont acceptés. Seuls model et prompt sont obligatoires. Omettez les champs facultatifs pour utiliser leurs valeurs par défaut ; null n’est pas accepté.

Ratios : 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.

Le Playground utilise un modèle fixe et dix contrôles, dont n fixé à 1. Les valeurs de sécurité supérieures à 2 sont réservées à l’API, sauf pour les administrateurs.

Modes et contraintes

Sans référence, le modèle génère depuis du texte. Une référence permet la retouche ; plusieurs permettent une composition multi-image. Avec auto, les retouches suivent le ratio de la première référence. Le texte seul sert à choisir le format, avec repli sur 1:1 si aucun n’est déterminé. La résolution par défaut est 1k dans tous les modes.

Les paliers indiquent une échelle approximative : 768sq correspond à environ 768 × 768 ; 1K à 1 MP ; 1.5K à 2 MP ; 2K à 4 MP ; 4K à 16 MP. Consultez le fichier renvoyé pour ses dimensions réelles.

Ce point de terminaison n’accepte pas width, height, des dimensions en pixels dans size, negative_prompt, guidance, grounding, prompt_upsampling, mask ou mask_url. Les champs inconnus renvoient HTTP 400 avant facturation. Sortie WebP, entrée base64, streaming et callbacks ne sont pas proposés.

Images de référence et retouches par zone

Importez les références vers une URL publique avant l’envoi. Le corps contient des URL, jamais des octets de fichier ou des data URL.

{
  "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"
}

Remplacez ces URL d’exemple par vos images accessibles. Les références sont ordonnées : ref_image_0 est la première. Les consignes de boîte englobante appartiennent à la chaîne prompt, pas à un champ distinct. Les coordonnées utilisent [y1, x1, y2, x2] normalisé sur 0–1000. Un objet de mise en page peut contenir id, bbox et desc ; une retouche peut utiliser id, from, src_bbox, tgt_bbox et desc. Encodez toute la requête en JSON pour échapper correctement les guillemets du prompt.

Facturation

Une requête réussie produit une image. Seule la résolution choisie fixe le prix ; étapes, seed, ratio, nombre de références et format n’ajoutent aucun frais. Génération depuis du texte et retouche ont le même tarif. Les requêtes échouées ne sont pas facturées. Consultez les tarifs en direct.

Réponse de tâche et interrogation

Envoi :

{"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"

Tâche terminée (URL illustrative) :

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

Lisez output.data[0].url. Prévoyez jusqu’à dix minutes pour générer, surtout en 4K. L’interrogation est en lecture seule ; un délai dépassé côté client n’autorise pas une autre requête payante. Les réponses publiques ne contiennent ni coûts ni solde du compte.

Erreurs

Les erreurs HTTP utilisent {"error": {"code": integer, "message": string}}. Consultez le répertoire commun des erreurs. Une tâche échouée expose son erreur avec status: "failed". Corrigez les paramètres invalides avant un nouvel envoi ; conservez l’ID pour vérifier une requête déjà envoyée.

Conseils et guides associés

Utilisez des descriptions positives et nommez les zones ou détails à préserver. Réduire les étapes peut modifier la qualité sans réduire le prix. Comparez un seul changement à la fois.

• FLUX 3 Image Klein Playground
• Téléchargement, poids et guide ComfyUI
• Cycle de vie des tâches