gpt-image-2 API

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

Exemple de sortiegpt-image-2POST /v1/images/generations

Paramètres : size=1536x1024n=1

Prompt : A 24-hour laundromat at three in the morning, a whole wall of front-loaders turning. A young man in a silver metallic bomber jacket has just tipped a jar of coloured glass marbles into the nearest drum. The marbles are pouring upward out of the open door instead of sinking, already arcing across the room in a bright teal and amber bridge that rings against the ceiling lights. Cold cyan tubes overhead, a hard warm amber glow thrown out of the drum itself. Straight-on symmetrical camera, wide, hyper-real detail in the glass, film grain, no text.

Requête qui a produit cet échantillon

{
  "model": "gpt-image-2",
  "prompt": "A 24-hour laundromat at three in the morning, a whole wall of front-loaders turning. A young man in a silver metallic bomber jacket has just tipped a jar of coloured glass marbles into the nearest drum. The marbles are pouring upward out of the open door instead of sinking, already arcing across the room in a bright teal and amber bridge that rings against the ceiling lights. Cold cyan tubes overhead, a hard warm amber glow thrown out of the drum itself. Straight-on symmetrical camera, wide, hyper-real detail in the glass, film grain, 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",
    "prompt": "A white cat runs through a neon-lit street in the rain",
    "size": "1024x1024", "n": 1
  }'

Demander des notes

Les modèles d’images compatibles OpenAI utilisent prompt, n, size et quality ; n’utilisez l’édition que lorsque la page officielle le documente.

Paramètres de requête

GPT Image utilise l’API Images compatible OpenAI. La génération utilise JSON ; l’édition et l’édition guidée par masque utilisent le multipart. GPT Image 2 renvoie les données d’image Base64 dans data[].b64_json.

Champ	Obligatoire	Remarques
model	Oui	gpt-image-2
prompt	Oui	Instruction de génération ou d’édition
size	Non	auto ou personnalisé WIDTHxHEIGHT dans le cadre des règles de taille documentées
quality	Non	low / medium / high / 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
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

Les tailles personnalisées nécessitent que les deux bords soient des multiples de 16, un rapport hauteur/largeur de 1:3 à 3:1, un bord maximum de 3 840 pixels et un total de 655 360 à 8 294 400 pixels. L’édition accepte jusqu’à 16 images sources, chaque source et masque de moins de 50 Mo ; n’envoyez pas DALL·E uniquement response_format.

Modifier les images

GPT Image 2 modifications utilisent /v1/images/edits avec plusieurs parties image/image[] ; jusqu’à 16 images d’entrée sont acceptées et le masque doit correspondre au format et aux dimensions de la première image.

bash

curl https://modelflare.dev/v1/images/edits \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -F "model=gpt-image-2" \
  -F "image[]=@/path/to/product.png" \
  -F "mask=@/path/to/mask.png" \
  -F "prompt=保持主体不变，将背景替换为暖色摄影棚渐变" \
  -F "size=1536x1024" \
  -F "quality=high" \
  -F "output_format=png" \
  -F "n=1"

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.