Skip to Content
ModèlesGPT ImageModifier et combiner des images

Modifier et combiner des images

Téléversez une ou plusieurs images et modifiez-les ou fusionnez-les au moyen d’une consigne.

Vous n’écrivez pas de code ? Consultez Générer des images dans vos propres outils.

POST/v1/images/editsParamètres communs

Avant de commencer

PrérequisDétails
Clé d’APICréez-en une dans la console OfoxAI  et remplacez YOUR_OFOX_API_KEY dans le code
EnvironnementcURL nécessite jq pour décoder l’image ; Python nécessite pip install openai ; Node.js 18 ou version ultérieure, sans dépendance
ImagesPlacez un fichier input.png dans le répertoire courant ; pour combiner des images, ajoutez également un input2.png. PNG ou JPEG, ≤ 15 Mo chacun
Délai d’attenteRéglez le délai d’attente du client sur 600 secondes. La haute qualité, les grandes tailles ou l’édition peuvent prendre plusieurs minutes
Valeurs utilisées dans le code
URL de l'APIhttps://api.ofox.io/v1
Identifiant de modèleopenai/gpt-image-2.5-sunburstLes exemples utilisent flare ; sunburst est recommandé pour l'édition
Clé d'APIRemplacez YOUR_OFOX_API_KEY dans le code par votre clé
Dépendances Pythonpip install openai

Modifier une image

Chacun des exemples ci-dessous a été exécuté tel quel. Le résultat est enregistré sous output.png dans le répertoire courant.

Terminal
curl -s https://api.ofox.io/v1/images/edits \ -H "Authorization: Bearer YOUR_OFOX_API_KEY" \ -F "model=openai/gpt-image-2.5-flare" \ -F "image=@input.png" \ -F "prompt=Replace the background with a wooden table, keep the subject unchanged" \ -F "quality=low" \ -o response.json jq -r '.data[0].b64_json' response.json | base64 --decode > output.png

Si vous omettez size, le modèle choisit la taille de sortie, qui peut différer de celle de l’original. Pour conserver la taille d’origine, indiquez-la explicitement, p. ex. size=1024x1024.

Rédiger la consigne

Exprimez clairement deux choses : ce qu’il faut modifier et ce qu’il faut conserver.

Cas d’usageExemple de consigne
Modifier une imageRemplacez l’arrière-plan par un plateau de table en bois et conservez le sujet tel quel
Combiner des imagesPlacez le sujet de la première image sur l’arrière-plan de la deuxième image

Avec plusieurs images, désignez-les selon leur ordre de téléversement : « la première image », « la deuxième image ». Pour ne modifier qu’une petite partie de l’image, l’Inpainting est plus fiable.

Combiner plusieurs images

Envoyez plusieurs images de référence en une seule fois. L’ordre de téléversement détermine ce que désignent « la première image » et « la deuxième image » dans votre consigne. Placez input.png et input2.png dans le répertoire courant.

Terminal
# Up to 16 images per request, ≤ 15 MB each curl -s https://api.ofox.io/v1/images/edits \ -H "Authorization: Bearer YOUR_OFOX_API_KEY" \ -F "model=openai/gpt-image-2.5-flare" \ -F "image[]=@input.png" \ -F "image[]=@input2.png" \ -F "prompt=Place the subject of the first image onto the background of the second" \ -F "quality=low" \ -o response.json jq -r '.data[0].b64_json' response.json | base64 --decode > output.png

Fournisseurs

Il n’est pas nécessaire d’épingler un fournisseur. Pour les trois modèles, Azure comme OpenAI servent l’endpoint d’édition, et la passerelle achemine les requêtes automatiquement.

Si vous avez des exigences de modération du contenu, vous pouvez sélectionner un fournisseur, mais l’endpoint d’édition n’accepte que l’en-tête X-OfoxAI-Provider-Type ; extra_body dans le formulaire est ignoré. Une fois un fournisseur sélectionné, les requêtes ne basculent pas vers un autre fournisseur s’il est indisponible. Voir Sélectionner un fournisseur.

Valeurs des paramètres

Paramètres propres à l’endpoint d’édition. model, n, output_format et les autres fonctionnent comme en texte vers image — voir Texte vers image · Valeurs des paramètres.

Obligatoires
imageobligatoirefileform

L’image à modifier. Pour plusieurs images, répétez le champ sous la forme image[] ; avec le SDK Python, passez une liste.

▸ Détails

Les images de référence sont elles aussi facturées en tokens : une image de référence de 1024×1024 a mesuré 1 024 tokens en entrée, ce qui explique que l’édition coûte plus cher que le texte vers image à taille égale.

▶Avancés · 1X-OfoxAI-Provider-TypeExpand
X-OfoxAI-Provider-Typestringheader· valeursazure_foundryopenai

Généralement inutile : la passerelle achemine automatiquement. À utiliser uniquement pour épingler un fournisseur précis.

Limites de téléversement

ÉlémentLimite
Chaque image de référence≤ 15 Mo
Requête complète≤ 50 Mo
Nombre d’imagesAucune limite côté passerelle ; restez à 16 ou moins
FormatPNG, JPEG

Le modèle redimensionne les images de référence à environ 1024 px. Les fichiers de plus de 5 Mo ne font que ralentir le téléversement ; ils n’améliorent pas le résultat.

Erreurs courantes

ErreurCauseSolution
Invalid image file or modeL’image téléversée n’est pas un PNG ou un JPEG standardRéexportez-la en PNG ou JPEG
Invalid file 'image[0]': unsupported mimetypeLe fichier téléversé n’est pas une imageTéléversez une image PNG, JPEG ou WebP
does not support the 'input_fidelity' parameterinput_fidelity a été envoyéSupprimez-le ; cette famille traite toujours les images de référence en haute fidélité
moderation_blockedLa consigne ou l’image de référence a été bloquée par le système de sécurité du fournisseur en amontModifiez la consigne ou l’image de référence puis réessayez
provider_type_unavailableLe fournisseur épinglé manuellement ne sert pas ce modèleSupprimez l’en-tête X-OfoxAI-Provider-Type
Invalid sizeLa taille indiquée enfreint l’une des quatre règlesVoir Taille
404 model_not_foundIdentifiant de modèle mal orthographié ou casse incorrecteCopiez l’identifiant de modèle depuis cette page

Pour les autres erreurs, consultez le tableau complet des erreurs.

Documentation officielle

La documentation d’OpenAI décrit le comportement lors d’un appel direct à OpenAI. Lorsque vous passez par OfoxAI, les résultats mesurés dans ces pages font foi. Par exemple, il n’est pas nécessaire d’épingler un fournisseur pour l’édition.

Last updated on