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 spécifiques au modèle tels que background, output_compression, le streaming ou de futures options d’image GPT.
Utilisez la référence OpenAI Create image pour obtenir 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 comme output_format, quality ou background
Utilisez qwen-image lorsque vous avez besoin spécifiquement de ce fournisseur, mais gardez n à 1
Choisissez un model ID d’image actuel depuis la page Models

Première requête sûre

Commencez avec gpt-image-2
Gardez 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é spécifique tel que jpeg
Consultez le guide de génération d’images OpenAI avant d’ajouter background, output_compression ou le streaming
Utilisez un prompt et une image de sortie avant d’ajouter la génération par lot 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 puis interrogation plutôt que de maintenir une connexion HTTP ouverte. La requête de création renvoie data.task_id. Interrogez Retrieve an image generation task 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 de CometAPI renvoie des métadonnées de tâche JSON et utilise l’interrogation. Utilisez le mode tâche asynchrone avec ces model IDs 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 le 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 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 de requête spécifique 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 des contrôles propres à GPT comme output_format, quality, background et output_compression
Suivez le guide de génération d’images OpenAI pour les options les plus récentes spécifiques au modèle
qwen-image ne prend pas en charge n > 1

Les images générées doivent respecter les politiques d’utilisation du fournisseur. N’envoyez pas de prompts illégaux, violents, pornographiques ou enfreignant le 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. See the OpenAI image generation guide for the latest model-specific values.

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

API de génération et d’édition d’images

Récupérer une tâche de génération d’image

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 de requête spécifique au modèle

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 de requête spécifique au modèle

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 de requête spécifique au modèle