Créer une image

POST

images

generations

curl https://api.cometapi.com/v1/images/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A paper boat floating on calm water at sunrise.",
    "quality": "low",
    "size": "1024x1024",
    "output_format": "jpeg"
  }'

{
  "created": 1781075000,
  "background": "opaque",
  "output_format": "jpeg",
  "quality": "low",
  "size": "1024x1024",
  "usage": {
    "input_tokens": 13,
    "input_tokens_details": {
      "image_tokens": 0,
      "text_tokens": 13
    },
    "output_tokens": 196,
    "output_tokens_details": {
      "image_tokens": 196,
      "text_tokens": 0
    },
    "total_tokens": 209
  },
  "data": [
    {
      "b64_json": "/9j/4AAQSkZJRgABAQAAAQABAAD..."
    }
  ]
}

Utilisez cette route pour créer des images à partir de texte avec des formats de requête compatibles OpenAI sur CometAPI.

Référence officielle

Consultez le guide de génération d’images OpenAI avant de vous appuyer sur des contrôles propres au modèle tels que background, output_compression, Streaming ou de futures options d’image GPT.
Utilisez la référence OpenAI Create image pour consulter la liste actuelle des paramètres.

Choisissez d’abord un modèle

Utilisez un modèle d’image GPT tel que gpt-image-2 pour les requêtes de génération d’image à partir de texte avec des contrôles tels que output_format, quality ou background
Utilisez gpt-image-2.5-sunburst ou gpt-image-2.5-flare lorsque vous avez besoin d’arrière-plans transparents ou des niveaux de qualité xhigh et max
Utilisez qwen-image lorsque vous avez besoin de ce fournisseur en particulier, mais conservez n à 1
Choisissez un ID de modèle d’image actuel dans la page Modèles

Première requête sûre

Commencez avec gpt-image-2
Conservez size à 1024x1024
Les modèles d’image GPT renvoient des données d’image encodées en base64 dans b64_json ; décodez-les pour enregistrer le fichier image
Ajoutez output_format uniquement lorsque vous avez besoin d’un type d’image encodée spécifique, tel que jpeg
Utilisez un seul Prompt et une seule image de sortie avant d’ajouter la génération par lots ou l’ajustement du style

Exécuter une tâche d’image asynchrone

Utilisez async: true pour les tâches d’image de longue durée lorsque votre client préfère un flux de soumission et d’interrogation plutôt que de maintenir une connexion HTTP ouverte. La requête de création renvoie data.task_id. Interroger Récupérer une tâche de génération d’image jusqu’à ce que data.status soit success ou failure. Le champ async est une extension CometAPI pour cette route, et non un paramètre OpenAI. OpenAI documente stream et partial_images pour les modèles d’image GPT. Le mode de tâche asynchrone CometAPI renvoie des métadonnées de tâche JSON et utilise l’interrogation. Utilisez le mode de tâche asynchrone avec ces ID de modèle documentés : gpt-image-2 et doubao-seedream-4-0-250828. Pour les autres modèles d’image, utilisez la génération synchrone ou Streaming, sauf si la prise en charge des tâches asynchrones est documentée pour ce modèle. Lorsqu’une requête inclut à la fois async: true et stream: true, le mode de tâche asynchrone est prioritaire. La requête de création renvoie des métadonnées de tâche JSON au lieu d’un flux SSE.

Comportement des requêtes propre au modèle

response_format s’applique uniquement aux modèles DALL·E ; les modèles d’image GPT renvoient des données base64 et l’ignorent
Les modèles d’image GPT utilisent les contrôles GPT-only tels que output_format, quality, background et output_compression
quality accepte low, medium, high et auto sur les modèles d’image GPT ; gpt-image-2.5-sunburst et gpt-image-2.5-flare acceptent également xhigh et max
output_compression s’applique lorsque output_format est webp ou jpeg ; cela n’a aucun effet sur png
partial_images s’applique uniquement lorsque stream est true
Consultez le guide de génération d’images OpenAI pour connaître les dernières options propres au modèle
qwen-image ne prend pas en charge n > 1

Générer un arrière-plan transparent

Définissez background sur transparent pour générer un sujet isolé sans remplissage d’arrière-plan. Cette option est prise en charge par gpt-image-2.5-sunburst et gpt-image-2.5-flare. La transparence nécessite un format de sortie avec un canal alpha. Définissez output_format sur png ou webp. JPEG ne possède pas de canal alpha. Une requête transparente avec output_format: "jpeg" est donc rejetée. La réponse renvoie les données d’image encodées en base64 dans b64_json, avec un canal alpha. Décodez-les pour enregistrer le fichier :

import base64
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cometapi.com/v1",
    api_key=os.environ["COMETAPI_KEY"],
)

result = client.images.generate(
    model="gpt-image-2.5-sunburst",
    prompt="A single red apple, centered, isolated subject.",
    quality="low",
    size="1024x1024",
    background="transparent",
    output_format="png",
)

with open("apple.png", "wb") as f:
    f.write(base64.b64decode(result.data[0].b64_json))

Définissez background sur opaque pour imposer un arrière-plan uni, ou sur auto pour laisser le modèle décider. La réponse reprend la valeur appliquée dans le champ background de niveau supérieur.

Les images générées doivent respecter les politiques d’utilisation du fournisseur. N’envoyez pas de prompts illégaux, violents, pornographiques ou portant atteinte au droit d’auteur.

Autorisations

Authorization

string

header

requis

Bearer token authentication. Use your CometAPI key.

Corps

application/json

model

string

défaut:gpt-image-2

requis

The image generation model to use. Choose a current model from the Models page.

prompt

string

requis

Text description of the image you want to generate.

Exemple:

"A paper boat floating on calm water at sunrise."

integer

défaut:1

Number of images to generate. Keep this at 1 for the broadest compatibility.

quality

string

Quality setting for models that support it. GPT image models accept low, medium, high, and auto. gpt-image-2.5-sunburst and gpt-image-2.5-flare also accept xhigh and max. dall-e-3 accepts standard and hd. See the OpenAI image generation guide for the latest model-specific values.

Exemple:

"low"

background

enum<string>

Background mode for the generated image. Set transparent to generate an isolated subject with no background fill; this requires output_format set to png or webp, and returns an error with jpeg. Set opaque for a solid background, or auto to let the model decide. Supported on gpt-image-2.5-sunburst and gpt-image-2.5-flare.

Options disponibles:

transparent,

opaque,

auto

output_compression

integer

défaut:100

Compression level for the output image, from 0 to 100. Applies when output_format is webp or jpeg. Lower values produce smaller files with more compression artifacts.

Plage requise: 0 <= x <= 100

moderation

enum<string>

défaut:auto

Content moderation level for GPT image models. low is less restrictive; auto is the default.

Options disponibles:

low,

auto

partial_images

integer

Number of partial images to emit while a streaming response is in progress, from 0 to 3. Each partial image arrives as an image_generation.partial_image event before the final image_generation.completed event. Applies when stream is true.

Plage requise: 0 <= x <= 3

size

string

Requested output size. Supported values depend on the selected model. See the OpenAI image generation guide for the latest model-specific ranges.

Exemple:

"1024x1024"

response_format

enum<string>

The response container for dall-e-2 and dall-e-3. This parameter is not supported for GPT image models, which return base64-encoded image data.

Options disponibles:

url,

b64_json

output_format

string

The encoded image type for GPT image model results, such as png, jpeg, or webp. See the OpenAI image generation guide for current GPT image output controls.

Exemple:

"jpeg"

stream

boolean

défaut:false

Set this to true to receive server-sent image generation events instead of waiting for the completed JSON response. Streaming responses use text/event-stream and can include final events such as image_generation.completed. When stream and async are both true, async task mode takes precedence and the create request returns JSON instead of a streaming image response.

async

boolean

défaut:false

CometAPI asynchronous task mode. Set this to true to return immediately with data.task_id, then poll GET /v1/images/generations/{task_id} for the final image data. Documented model IDs for this mode: gpt-image-2 and doubao-seedream-4-0-250828. This is a CometAPI extension, not an OpenAI parameter. When async and stream are both true, async takes precedence and returns JSON task metadata instead of an SSE stream.

Réponse

Image generation result. Synchronous requests return completed image data. Async requests return a task response with data.task_id.

Completed image response
Async task response

created

integer

requis

Unix timestamp for the completed generation.

data

object[]

requis

Show child attributes

background

string

Background mode returned by models that expose it.

output_format

string

Encoded image type returned by GPT image models.

quality

string

Quality level returned by models that expose it.

size

string

Output size returned by models that expose it.

usage

object

Token usage details when returned by the selected model.

Show child attributes

Dernière modification le 11 septembre 2026

curl https://api.cometapi.com/v1/images/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A paper boat floating on calm water at sunrise.",
    "quality": "low",
    "size": "1024x1024",
    "output_format": "jpeg"
  }'

{
  "created": 1781075000,
  "background": "opaque",
  "output_format": "jpeg",
  "quality": "low",
  "size": "1024x1024",
  "usage": {
    "input_tokens": 13,
    "input_tokens_details": {
      "image_tokens": 0,
      "text_tokens": 13
    },
    "output_tokens": 196,
    "output_tokens_details": {
      "image_tokens": 196,
      "text_tokens": 0
    },
    "total_tokens": 209
  },
  "data": [
    {
      "b64_json": "/9j/4AAQSkZJRgABAQAAAQABAAD..."
    }
  ]
}

Modération de contenu

Clés API

Référence officielle

Choisissez d’abord un modèle

Première requête sûre

Exécuter une tâche d’image asynchrone

Comportement des requêtes propre au modèle

Générer un arrière-plan transparent

Autorisations

Corps

Réponse

​Référence officielle

​Choisissez d’abord un modèle

​Première requête sûre

​Exécuter une tâche d’image asynchrone

​Comportement des requêtes propre au modèle

​Générer un arrière-plan transparent

Autorisations

Corps

Réponse

Référence officielle

Choisissez d’abord un modèle

Première requête sûre

Exécuter une tâche d’image asynchrone

Comportement des requêtes propre au modèle

Générer un arrière-plan transparent