logo
RunComfy
  • ComfyUI
  • EntraîneurNouveau
  • Modèles
  • API
  • Tarification
discord logo
MODÈLES
Explorer
Tous les modèles
BIBLIOTHÈQUE
Générations
APIS DE MODÈLES
Documentation API
Clés API
COMPTE
Utilisation

FLUX 3 Image Edit : Édition d'images à références multiples jusqu'à 4K sur Models and API | RunComfy

blackforestlabs/flux-3/edit

FLUX 3 Image Edit transforme une à dix photos de référence et des instructions écrites en une nouvelle image fixe à 1K, 2K ou 4K.

Table des matières

1. Démarrage2. Authentification3. Référence APISoumettre une requêteStatut de la requêteRécupérer les résultatsAnnuler une requête4. Fichiers en entréeFichier hébergé (URL)5. SchémaSchéma d'entréeSchéma de sortie

1. Démarrage

Utilisez l'API RunComfy pour exécuter blackforestlabs/flux-3/edit. 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/edit \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "images": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7463/media-files/promo-input.webp"
    ],
    "prompt": "Turn image 1 into a furniture campaign advertisement. Keep the same ceramic table lamp: the round speckled white base and the oatmeal linen shade. Switch the lamp on so warm light glows through the shade. Place it on a low oak side table in a dim evening living room, with a soft pool of light on the wall and a blurred window showing blue dusk. Add the headline \"AFTER HOURS\" in cream serif at the upper left, and \"CERAMIC LAMP\" in small spaced capitals beneath it. Do not change the lamp's shape."
  }'

2. Authentification

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.

3. Référence API

Soumettre une requête

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/edit \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "images": [
      "https://playgrounds-storage-public.runcomfy.net/tools/7463/media-files/promo-input.webp"
    ],
    "prompt": "Turn image 1 into a furniture campaign advertisement. Keep the same ceramic table lamp: the round speckled white base and the oatmeal linen shade. Switch the lamp on so warm light glows through the shade. Place it on a low oak side table in a dim evening living room, with a soft pool of light on the wall and a blurred window showing blue dusk. Add the headline \"AFTER HOURS\" in cream serif at the upper left, and \"CERAMIC LAMP\" in small spaced capitals beneath it. Do not change the lamp's shape."
  }'

Statut de la requête

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érer les résultats

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

Annuler une requête

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

4. Fichiers en entrée

Fichier hébergé (URL)

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.

5. Schéma

Schéma d'entrée

{
  "type": "object",
  "title": "Schéma d'entrée",
  "required": [
    "images",
    "prompt"
  ],
  "properties": {
    "images": {
      "title": "Images",
      "description": "Une à dix images source, dans l'ordre où l'instruction les nomme. Chaque côté doit mesurer au moins 256 pixels, et chaque image ne doit pas dépasser 4 mégapixels.",
      "type": "array",
      "items": {
        "type": "string",
        "format": "image_uri"
      },
      "minItems": 1,
      "maxItems": 10,
      "default": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7463/media-files/promo-input.webp"
      ]
    },
    "prompt": {
      "title": "Prompt",
      "description": "Ce qui devrait changer et ce qui devrait rester. Nommez les fichiers téléchargés dans l'ordre, comme image 1 et image 2. Mettez exactement les mots présents sur l'image entre guillemets.",
      "type": "string",
      "default": "Turn image 1 into a furniture campaign advertisement. Keep the same ceramic table lamp: the round speckled white base and the oatmeal linen shade. Switch the lamp on so warm light glows through the shade. Place it on a low oak side table in a dim evening living room, with a soft pool of light on the wall and a blurred window showing blue dusk. Add the headline \"AFTER HOURS\" in cream serif at the upper left, and \"CERAMIC LAMP\" in small spaced capitals beneath it. Do not change the lamp's shape."
    },
    "aspect_ratio": {
      "title": "Format d'image",
      "description": "Cadre de sortie. auto suit la première image.",
      "type": "string",
      "enum": [
        "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"
      ],
      "default": "auto"
    },
    "resolution": {
      "title": "Résolution",
      "description": "Niveau de taille de sortie. C'est le seul paramètre qui modifie le prix.",
      "type": "string",
      "enum": [
        "1k",
        "2k",
        "4k"
      ],
      "default": "1k"
    },
    "enable_prompt_expansion": {
      "title": "Activer l'expansion du prompt",
      "description": "Développez une instruction courte tout en conservant l'édition prévue et le rôle de chaque image.",
      "type": "boolean",
      "default": false
    },
    "output_format": {
      "title": "Format de sortie",
      "description": "Type de fichier de l'image fixe retournée. png évite une compression JPEG supplémentaire.",
      "type": "string",
      "enum": [
        "jpeg",
        "png"
      ],
      "default": "jpeg"
    }
  }
}

Schéma de sortie

{
  "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"
        }
      }
    }
  }
}
Suivez-nous
  • LinkedIn
  • Facebook
  • Instagram
  • Twitter
Support
  • Discord
  • Email
  • État du système
  • affilié
Modèles vidéo
  • Wan 2.6 Flash
  • Wan 2.5
  • Wan 3.0
  • MiniMax H3 Max
  • Wan 3.0 Prime
  • MiniMax H3 Open Image to Video
  • Voir tous les modèles →
Modèles d'images
  • Wan 2.6 Image to Image
  • Seedream 5.0 Pro
  • Nano Banana Pro
  • Flux 2 Pro
  • Z Image Turbo LoRA
  • seedream 4.0
  • Voir tous les modèles →
Légal
  • Conditions d'utilisation
  • Politique de confidentialité
  • Politique relative aux cookies
RunComfy
Droits d'auteur 2026 RunComfy. Tous droits réservés.

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.