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.
Avant de commencer
https://api.ofox.io/v1openai/gpt-image-2.5-sunburstLes exemples utilisent flare ; sunburst est recommandé pour l'éditionpip install openaiModifier 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.
cURL
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.pngSi 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.
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.
cURL
# 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.pngFournisseurs
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.
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
Généralement inutile : la passerelle achemine automatiquement. À utiliser uniquement pour épingler un fournisseur précis.
Limites de téléversement
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
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.