Utilisez l'API RunComfy pour exécuter blackforestlabs/flux-3-image-klein/text-to-image. Pour les entrées et sorties acceptées, voir le schéma.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-3-image-klein/text-to-image \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": ""
}'Définissez la variable d'environnement YOUR_API_TOKEN avec votre clé API (gestion dans Profil) et incluez à chaque requête un jeton Bearer dans l'en-tête Authorization : Authorization: Bearer $YOUR_API_TOKEN.
Soumettez une tâche de génération asynchrone et recevez immédiatement un request_id ainsi que des URLs pour le statut, les résultats et l'annulation.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-3-image-klein/text-to-image \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": ""
}'Récupère l'état actuel pour un request_id (« in_queue », « in_progress », « completed » ou « cancelled »).
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
--header "Authorization: Bearer <token>"Récupère les sorties finales et métadonnées pour le request_id ; si le travail n'est pas terminé, la réponse indique l'état actuel pour poursuivre le polling.
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
--header "Authorization: Bearer <token>"Annule un travail en file d'attente via request_id ; les travaux en cours ne peuvent pas être annulés.
curl --request POST \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
--header "Authorization: Bearer <token>"Fournissez une URL HTTPS accessible publiquement. L'hôte doit autoriser les récupérations côté serveur (sans login/cookies), sans limitation de débit ni blocage des bots. Recommandé : images ≤ 50 Mo (~4K), vidéos ≤ 100 Mo (~2–5 min en 720p). Préférez des URL stables ou pré-signées pour les actifs privés.
{
"type": "object",
"title": "Schéma d'entrée",
"required": [
"prompt"
],
"properties": {
"prompt": {
"title": "Prompt",
"description": "Décrivez le sujet, le lieu, la lumière et le style. Il n'y a pas de prompt négatif séparé.",
"type": "string",
"examples": [
"A candid photo of a young couple on a pale blue step-through bicycle on a quiet suburban street at golden hour. The man wears a grey ribbed sweater, white shorts, and white sneakers and pedals while smiling. The woman wears a white off-shoulder shirt, denim shorts, and white sneakers, sits on the rear rack, and laughs with an arm around him. Lush green hedges, palms, a white railing, and warm house lights behind them. Natural photograph, no lettering."
]
},
"aspect_ratio": {
"title": "Format",
"description": "Cadre de sortie. auto suit le prompt, puis revient à 1:1.",
"type": "string",
"enum": [
"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",
"auto"
],
"default": "1:1"
},
"resolution": {
"title": "Résolution",
"description": "Palier de taille. C'est le seul réglage qui change le prix. 1K est la valeur par défaut.",
"type": "string",
"enum": [
"768sq",
"1k",
"1.5k",
"2k",
"4k"
],
"default": "1k"
},
"output_format": {
"title": "Format de sortie",
"description": "Type de fichier de l'image. png évite une compression JPEG supplémentaire.",
"type": "string",
"enum": [
"jpeg",
"png"
],
"default": "jpeg"
},
"steps": {
"title": "Étapes",
"description": "Étapes d'échantillonnage, de 1 à 16. Moins d'étapes répondent plus tôt. Le prix ne change pas.",
"type": "integer",
"minimum": 1,
"maximum": 16,
"default": 16
},
"safety_tolerance": {
"title": "Tolérance de sécurité",
"description": "Sévérité du filtre de contenu. 0 est le plus strict et 4 le plus souple.",
"type": "integer",
"enum": [
0,
1,
2,
3,
4
],
"default": 2
},
"seed": {
"title": "Seed",
"description": "Laissez vide pour un nouveau résultat. La même seed et les mêmes réglages répètent un résultat.",
"type": "integer",
"minimum": 0,
"maximum": 4294967295
}
}
}{
"output": {
"type": "object",
"properties": {
"image": {
"type": "string",
"format": "uri",
"description": "URL d'une seule image"
},
"video": {
"type": "string",
"format": "uri",
"description": "URL d'une seule vidéo"
},
"images": {
"type": "array",
"description": "plusieurs URLs d'images",
"items": {
"type": "string",
"format": "uri"
}
},
"videos": {
"type": "array",
"description": "plusieurs URLs de vidéos",
"items": {
"type": "string",
"format": "uri"
}
}
}
}
}RunComfy est la première ComfyUI plateforme, offrant des ComfyUI en ligne environnement et services, ainsi que des workflows ComfyUI proposant des visuels époustouflants. RunComfy propose également AI Models, permettant aux artistes d'utiliser les derniers outils d'IA pour créer des œuvres d'art incroyables.