gpt-image-2.5-sunburst API

Utilisez l’ID de modèle exact gpt-image-2.5-sunburst. Le champ modèle doit correspondre exactement à cette page.

Exemple de sortiegpt-image-2.5-sunburstPOST /v1/images/generations

Paramètres : size=1536x1024n=1

Prompt : The open top deck of a car park at dusk, wet asphalt still throwing back the sky. A woman in a cobalt-blue structured trench coat has just thrown a stack of contact sheets and film strips out of her hands. The strips are not falling: they have started to unwind and climb around her in a slow rotating ribbon, every frame lit a different neon colour, magenta and acid green and amber running through the coil. One hard magenta light rakes across the deck from behind her, the city beyond still cold blue. Wide low camera, 35mm, real weight in the paper, film grain, slight vignette, no text.

Requête qui a produit cet échantillon

{
  "model": "gpt-image-2.5-sunburst",
  "prompt": "The open top deck of a car park at dusk, wet asphalt still throwing back the sky. A woman in a cobalt-blue structured trench coat has just thrown a stack of contact sheets and film strips out of her hands. The strips are not falling: they have started to unwind and climb around her in a slow rotating ribbon, every frame lit a different neon colour, magenta and acid green and amber running through the coil. One hard magenta light rakes across the deck from behind her, the city beyond still cold blue. Wide low camera, 35mm, real weight in the paper, film grain, slight vignette, no text.",
  "n": 1,
  "size": "1536x1024"
}

Authentification et point de terminaison

Utilisez une clé API Modelflare avec https://modelflare.dev/v1. Le point d’entrée de la passerelle est POST /v1/images/generations.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Générer une image

bash

curl https://modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-sunburst",
    "prompt": "A white cat runs through a neon-lit street in the rain",
    "size": "1536x1024", "quality": "xhigh", "background": "opaque", "output_format": "jpeg",
    "output_compression": 85, "moderation": "auto", "n": 1
  }'

Demander des notes

GPT Image 2.5 Sunburst cible une création et une édition plus fidèles et avec un contrôle plus élevé ; conserver images[], image[], mask, xhigh/max et les contrôles de sortie pour les deux opérations.

Paramètres de requête

GPT Image 2.5 utilise l’API Images compatible OpenAI. La génération utilise JSON ; l’édition accepte les références d’images JSON ou les fichiers en plusieurs parties ; les réponses renvoient des données d’image Base64 dans data[].b64_json.

Champ	Obligatoire	Remarques
model	Oui	gpt-image-2.5-sunburst
prompt	Oui	Instruction de génération ou d’édition, 1 à 32 000 caractères
images[]	Conditionnel	Pour les modifications JSON, jusqu’à 16 objets file_id ou image_url
images[].file_id	Conditionnel	ID API du fichier téléchargé
images[].image_url	Conditionnel	URL d’image ou URL de données Base64 ; les URL de données sont limitées à 20 971 520 caractères
image	Conditionnel	Un fichier source en plusieurs parties ; utilisez image[] pour plusieurs fichiers
image[]	Conditionnel	Pour les modifications en plusieurs parties, jusqu’à 16 fichiers source
mask	Non	Masque alpha correspondant au premier format/taille source et inférieur à 50 Mo
size	Non	auto ou personnalisé WIDTHxHEIGHT ; Multiples de 16 pixels, rapport hauteur/largeur de 1:3 à 3:1, bord maximum de 3 840 px et 655 360 à 8 294 400 pixels au total
quality	Non	low / medium / high / xhigh / max / auto ; par défaut auto
background	Non	auto / opaque / transparent ; les arrière-plans transparents nécessitent une sortie PNG ou WebP
output_format	Non	png / jpeg / webp ; par défaut png
output_compression	Non	0–100 pour JPEG/WebP, 100 par défaut ; ignoré pour PNG
moderation	Non	auto / low ; par défaut auto
n	Non	1 à 10 sorties ; par défaut 1

Limites de réponse et d’entrée

GPT Image 2.5 Flare et Sunburst prennent en charge jusqu’à 16 entrées d’édition. Les modifications JSON utilisent images[] avec file_id ou image_url ; les modifications en plusieurs parties utilisent image/image[], avec chaque image source et masque inférieur à 50 Mo. Les invites comportent de 1 à 32 000 caractères ; la qualité prend en charge low/medium/high/xhigh/max/auto ; les règles de taille sont des multiples de 16 pixels, un rapport hauteur/largeur de 1:3 à 3:1, un bord maximum de 3 840 px et un total de 655 360 à 8 294 400 pixels. Les arrière-plans transparents nécessitent PNG ou WebP ; la compression s’applique uniquement au JPEG/WebP et est ignorée pour le PNG. Les résolutions supérieures à 2560x1440 sont expérimentales. Lire data[].b64_json ; n’envoyez pas de DALL·E uniquement response_format. Flare est la solution par défaut rapide et de haute qualité pour la génération et l’édition quotidiennes ; Sunburst est destiné à un travail de plus haute fidélité et avec un contrôle plus élevé.

Modifier les images

GPT Image 2.5 prend en charge les références d’images JSON et les téléchargements de fichiers en plusieurs parties via /v1/images/edits. JSON accepte jusqu’à 16 objets en utilisant file_id ou image_url ; multipart accepte jusqu’à 16 fichiers sources. Ne mélangez pas images avec image/image[] dans une seule requête.

bash

curl https://modelflare.dev/v1/images/edits \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-sunburst",
    "images": [{"file_id": "file-example123"}, {"image_url": "https://example.com/reference.png"}],
    "prompt": "Keep the product unchanged and replace the background with a warm studio gradient",
    "size": "1536x1024", "quality": "xhigh", "background": "opaque", "output_format": "png", "n": 1
  }'

bash

curl https://modelflare.dev/v1/images/edits \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -F "model=gpt-image-2.5-sunburst" \
  -F "image[]=@/path/to/product.png" \
  -F "mask=@/path/to/mask.png" \
  -F "prompt=Keep the product unchanged and replace the background with a warm studio gradient" \
  -F "size=1536x1024" \
  -F "quality=xhigh" \
  -F "background=opaque" \
  -F "output_format=png" \
  -F "n=1"

Forme de réponse

Lire les résultats générés et modifiés à partir de data[]. GPT Image 2.5 renvoie des données d’image Base64 ; ne traitez pas la réponse comme une sortie URL.

Champ	Remarques
created	Heure de création sous forme d’horodatage Unix en secondes
data	Résultats d’images générés ou modifiés
data[].b64_json	Données d’image codées en base64
background	Mode arrière-plan final : opaque ou transparent
output_format	Format d’image renvoyé : png, jpeg ou webp
quality	Niveau de qualité utilisé
size	Dimensions finales en LARGEURxHAUTEUR

Erreurs et tâches ayant échoué

Les paramètres de modèle invalides renvoient un 4xx avec un ID de demande ; utiliser les champs de réponse et le message d’erreur définis par le contrat modèle sélectionné.

Portée prise en charge

Cette page couvre la génération et l’édition de modèles Modelflare. L’enrichissement de la recherche ou de la carte, la gestion de la voix et la gestion de la bibliothèque d’éléments sont des API de ressources en dehors de cette surface d’appel de modèle publique et ne sont pas des champs de requête obligatoires.

Tarification et facturation

Ce modèle utilise une facturation basée sur des jetons. Consultez la page de tarification du modèle pour connaître le prix client actuel, le prix catalogue de référence et les spécifications complètes.

Note

Cette page documente l’interface publique de Modelflare ; les champs et limites indiqués ici sont le contrat en cours.