Een afbeelding maken

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 vanuit tekst te maken met OpenAI-compatibele aanvraagindelingen op CometAPI.

Officiële referentie

Lees de OpenAI-gids voor het genereren van afbeeldingen voordat je vertrouwt op modelspecifieke instellingen zoals background, output_compression, streaming of toekomstige GPT-afbeeldingsopties.
Gebruik de OpenAI-referentie voor Create image voor de actuele parameterlijst.

Kies eerst een model

Gebruik een GPT-afbeeldingsmodel zoals gpt-image-2 voor text-to-image-aanvragen met instellingen zoals output_format, quality of background
Gebruik gpt-image-2.5-sunburst of gpt-image-2.5-flare wanneer je transparante achtergronden of de kwaliteitsniveaus xhigh en max nodig hebt
Gebruik qwen-image wanneer je specifiek die provider nodig hebt, maar houd n op 1
Kies een actuele afbeeldingsmodel-ID op de pagina Modellen

Veilige eerste aanvraag

Begin met gpt-image-2
Houd size op 1024x1024
GPT-afbeeldingsmodellen retourneren base64-gecodeerde afbeeldingsgegevens in b64_json; decodeer deze om het afbeeldingsbestand op te slaan
Voeg output_format alleen toe wanneer je een specifiek gecodeerd afbeeldingstype nodig hebt, zoals jpeg
Gebruik één prompt en één uitvoerafbeelding voordat je batchgeneratie of stijlafstemming toevoegt

Een asynchrone afbeeldingstaak uitvoeren

Gebruik async: true voor langlopende afbeeldingstaken wanneer je client een verzend-en-poll-stroom verkiest boven het openhouden van één HTTP-verbinding. De aanmaakaanvraag retourneert data.task_id. Poll Een taak voor het genereren van afbeeldingen 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-afbeeldingsmodellen. De asynchrone taakmodus van CometAPI retourneert JSON-taakmetadata en gebruikt polling. Gebruik de asynchrone taakmodus met deze gedocumenteerde model-ID’s: gpt-image-2 en doubao-seedream-4-0-250828. Gebruik voor andere afbeeldingsmodellen synchrone generatie of streaming, tenzij ondersteuning voor asynchrone taken voor dat model is gedocumenteerd. Wanneer een aanvraag zowel async: true als stream: true bevat, heeft de asynchrone taakmodus voorrang. De aanmaakaanvraag retourneert JSON-taakmetadata in plaats van een SSE-stream.

Modelspecifiek aanvraaggedrag

response_format is alleen van toepassing op DALL·E-modellen; GPT-afbeeldingsmodellen retourneren base64-gegevens en negeren dit
GPT-afbeeldingsmodellen gebruiken GPT-only-instellingen zoals output_format, quality, background en output_compression
quality accepteert low, medium, high en auto voor GPT-afbeeldingsmodellen; gpt-image-2.5-sunburst en gpt-image-2.5-flare accepteren ook xhigh en max
output_compression is van toepassing wanneer output_format webp of jpeg is; het heeft geen effect op png
partial_images is alleen van toepassing wanneer stream true is
Volg de OpenAI-gids voor het genereren van afbeeldingen voor de nieuwste modelspecifieke opties
qwen-image ondersteunt n > 1 niet

Een transparante achtergrond genereren

Stel background in op transparent om een geïsoleerd onderwerp zonder achtergrondvulling te genereren. Dit wordt ondersteund op gpt-image-2.5-sunburst en gpt-image-2.5-flare. Transparantie vereist een uitvoerformaat met een alfakanaal. Stel output_format in op png of webp. JPEG heeft geen alfakanaal, dus een transparant verzoek met output_format: "jpeg" wordt afgewezen. De response retourneert base64-afbeeldingsgegevens in b64_json met een alfakanaal. Decodeer deze om het bestand op te slaan:

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))

Stel background in op opaque om een effen achtergrond af te dwingen, of op auto om het model te laten beslissen. De response geeft de toegepaste waarde terug in het background-veld op het hoogste niveau.

Gegenereerde afbeeldingen moeten voldoen aan het gebruiksbeleid van de provider. Verstuur geen illegale, gewelddadige, pornografische of auteursrechtelijk inbreukmakende 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. 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.

Voorbeeld:

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

Beschikbare opties:

transparent,

opaque,

auto

output_compression

integer

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

Vereist bereik: 0 <= x <= 100

moderation

enum<string>

standaard:auto

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

Beschikbare opties:

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.

Vereist bereik: 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.

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

Laatst gewijzigd op 11 september 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..."
    }
  ]
}

Contentmoderatie

API-sleutels

Officiële referentie

Kies eerst een model

Veilige eerste aanvraag

Een asynchrone afbeeldingstaak uitvoeren

Modelspecifiek aanvraaggedrag

Een transparante achtergrond genereren

Autorisaties

Body

Respons

​Officiële referentie

​Kies eerst een model

​Veilige eerste aanvraag

​Een asynchrone afbeeldingstaak uitvoeren

​Modelspecifiek aanvraaggedrag

​Een transparante achtergrond genereren

Autorisaties

Body

Respons

Officiële referentie

Kies eerst een model

Veilige eerste aanvraag

Een asynchrone afbeeldingstaak uitvoeren

Modelspecifiek aanvraaggedrag

Een transparante achtergrond genereren