Maak een afbeelding

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..."
    }
  ]
}

Gebruik deze route om afbeeldingen uit tekst te maken met OpenAI-compatibele request-vormen op CometAPI.

Officiële referentie

Lees de OpenAI-gids voor image generation voordat je vertrouwt op modelspecifieke instellingen zoals background, output_compression, streaming of toekomstige GPT image-opties.
Gebruik de OpenAI Create image-referentie voor de huidige parameterlijst.

Kies eerst een model

Gebruik een GPT image-model zoals gpt-image-2 voor text-to-image-requests met instellingen zoals output_format, quality of background
Gebruik qwen-image wanneer je specifiek die provider nodig hebt, maar houd n op 1
Kies een huidige image model ID op de Models-pagina

Veilige eerste request

Begin met gpt-image-2
Houd size op 1024x1024
GPT image-modellen retourneren base64-gecodeerde afbeeldingsdata in b64_json; decodeer die om het afbeeldingsbestand op te slaan
Voeg output_format alleen toe wanneer je een specifiek gecodeerd afbeeldingstype nodig hebt, zoals jpeg
Controleer de OpenAI-gids voor image generation voordat je background, output_compression of streaming toevoegt
Gebruik één prompt en één output-afbeelding voordat je batch generation of stijlafstemming toevoegt

Voer een async afbeeldings-taak uit

Gebruik async: true voor langlopende afbeeldingstaken wanneer je client de voorkeur geeft aan een submit-and-poll-flow in plaats van één HTTP-verbinding open te houden. De create-request retourneert data.task_id. Poll Een afbeeldingsgeneratietaak ophalen totdat data.status success of failure is. Het veld async is een CometAPI-extensie voor deze route, geen OpenAI-parameter. OpenAI documenteert stream en partial_images voor GPT image-modellen. De asynchrone taakmodus van CometAPI retourneert JSON-taakmetadata en gebruikt polling. Gebruik async taakmodus met deze gedocumenteerde model IDs: gpt-image-2 en doubao-seedream-4-0-250828. Gebruik voor andere image-modellen synchrone generation of streaming, tenzij async taakondersteuning voor dat model is gedocumenteerd. Wanneer een request zowel async: true als stream: true bevat, heeft async taakmodus voorrang. De create-request retourneert JSON-taakmetadata in plaats van een SSE-stream.

Modelspecifiek request-gedrag

response_format is alleen van toepassing op DALL·E-modellen; GPT image-modellen retourneren base64-data en negeren dit
GPT image-modellen gebruiken alleen-GPT-instellingen zoals output_format, quality, background en output_compression
Volg de OpenAI-gids voor image generation voor de nieuwste modelspecifieke opties
qwen-image ondersteunt geen n > 1

Gegenereerde afbeeldingen moeten voldoen aan het gebruiksbeleid van de provider. Verstuur geen illegale, gewelddadige, pornografische of auteursrechtinbreuk makende prompts.

Autorisaties

Authorization

string

header

vereist

Bearer token authentication. Use your CometAPI key.

Body

application/json

model

string

standaard:gpt-image-2

vereist

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

prompt

string

vereist

Text description of the image you want to generate.

Voorbeeld:

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

integer

standaard: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.

Voorbeeld:

"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.

Beschikbare opties:

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.

Voorbeeld:

"jpeg"

stream

boolean

standaard: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

standaard: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.

Respons

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

vereist

Unix timestamp for the completed generation.

data

object[]

vereist

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's voor image generation en bewerken

Een taak voor het genereren van een afbeelding ophalen

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..."
    }
  ]
}

Contentmoderatie

API-sleutels

Officiële referentie

Kies eerst een model

Veilige eerste request

Voer een async afbeeldings-taak uit

Modelspecifiek request-gedrag

Autorisaties

Body

Respons

​Officiële referentie

​Kies eerst een model

​Veilige eerste request

​Voer een async afbeeldings-taak uit

​Modelspecifiek request-gedrag

Autorisaties

Body

Respons

Officiële referentie

Kies eerst een model

Veilige eerste request

Voer een async afbeeldings-taak uit

Modelspecifiek request-gedrag