Opprett et bilde

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

Bruk denne ruten til å opprette bilder fra tekst med OpenAI-kompatible forespørselsformater på CometAPI.

Offisiell referanse

Les OpenAIs veiledning for bildegenerering før du tar i bruk modellspesifikke kontroller som background, output_compression, streaming eller fremtidige GPT-bildealternativer.
Bruk OpenAI-referansen for å opprette bilder for den gjeldende parameterlisten.

Velg først en modell

Bruk en GPT-bildemodell som gpt-image-2 for tekst-til-bilde-forespørsler med kontroller som output_format, quality eller background
Bruk gpt-image-2.5-sunburst eller gpt-image-2.5-flare når du trenger gjennomsiktige bakgrunner eller kvalitetsnivåene xhigh og max
Bruk qwen-image når du spesifikt trenger den leverandøren, men behold n på 1
Velg en gjeldende bilde-ID fra Models-siden

Trygg første forespørsel

Start med gpt-image-2
Behold size på 1024x1024
GPT-bildemodeller returnerer base64-kodede bildedata i b64_json; dekod dem for å lagre bildefilen
Legg til output_format bare når du trenger en bestemt kodet bildetype, for eksempel jpeg
Bruk én Prompt og ett utdata-bilde før du legger til batchgenerering eller stiljustering

Kjør en asynkron bildeoppgave

Bruk async: true for langvarige bildejobber når klienten din foretrekker en send-og-poll-flyt fremfor å holde én HTTP-tilkobling åpen. Opprettelsesforespørselen returnerer data.task_id. Poll Hent en bildegenereringsoppgave til data.status er success eller failure. Feltet async er en CometAPI-utvidelse for denne ruten, ikke en OpenAI-parameter. OpenAI dokumenterer stream og partial_images for GPT-bildemodeller. CometAPI-modus for asynkrone oppgaver returnerer JSON-oppgavemetadata og bruker polling. Bruk modus for asynkrone oppgaver med disse dokumenterte modell-ID-ene: gpt-image-2 og doubao-seedream-4-0-250828. For andre bildemodeller bruker du synkron generering eller streaming med mindre støtte for asynkrone oppgaver er dokumentert for den modellen. Når en forespørsel inkluderer både async: true og stream: true, har modus for asynkrone oppgaver forrang. Opprettelsesforespørselen returnerer JSON-oppgavemetadata i stedet for en SSE-strøm.

Modellspesifikk forespørselsatferd

response_format gjelder bare DALL·E-modeller; GPT-bildemodeller returnerer base64-data og ignorerer den
GPT-bildemodeller bruker GPT-only-kontroller som output_format, quality, background og output_compression
quality godtar low, medium, high og auto for GPT-bildemodeller; gpt-image-2.5-sunburst og gpt-image-2.5-flare godtar også xhigh og max
output_compression gjelder når output_format er webp eller jpeg; den har ingen effekt på png
partial_images gjelder bare når stream er true
Følg OpenAIs veiledning for bildegenerering for de nyeste modellspesifikke alternativene
qwen-image støtter ikke n > 1

Generer en gjennomsiktig bakgrunn

Angi background til transparent for å generere et isolert motiv uten bakgrunnsfyll. Dette støttes av gpt-image-2.5-sunburst og gpt-image-2.5-flare. Gjennomsiktighet krever et utdataformat med en alfakanal. Angi output_format til png eller webp. JPEG har ingen alfakanal, så en forespørsel om gjennomsiktighet med output_format: "jpeg" avvises. Svaret returnerer base64-bildedata i b64_json med en alfakanal. Dekod dem for å lagre filen:

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

Angi background til opaque for å tvinge frem en ensfarget bakgrunn, eller auto for å la modellen avgjøre. Svaret gjengir den anvendte verdien i feltet background på toppnivå.

Genererte bilder må overholde leverandørens retningslinjer for bruk. Ikke send ulovlige, voldelige, pornografiske eller opphavsrettskrenkende Prompts.

Autorisasjoner

Authorization

string

header

påkrevd

Bearer token authentication. Use your CometAPI key.

Kropp

application/json

model

string

standard:gpt-image-2

påkrevd

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

prompt

string

påkrevd

Text description of the image you want to generate.

Eksempel:

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

integer

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

Eksempel:

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

Tilgjengelige alternativer:

transparent,

opaque,

auto

output_compression

integer

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

Nødvendig område: 0 <= x <= 100

moderation

enum<string>

standard:auto

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

Tilgjengelige alternativer:

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.

Nødvendig område: 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.

Eksempel:

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

Tilgjengelige alternativer:

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.

Eksempel:

"jpeg"

stream

boolean

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

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

Svar

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

påkrevd

Unix timestamp for the completed generation.

data

object[]

påkrevd

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

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

Innholdsmoderering

API-nøkler

Offisiell referanse

Velg først en modell

Trygg første forespørsel

Kjør en asynkron bildeoppgave

Modellspesifikk forespørselsatferd

Generer en gjennomsiktig bakgrunn

Autorisasjoner

Kropp

Svar

​Offisiell referanse

​Velg først en modell

​Trygg første forespørsel

​Kjør en asynkron bildeoppgave

​Modellspesifikk forespørselsatferd

​Generer en gjennomsiktig bakgrunn

Autorisasjoner

Kropp

Svar

Offisiell referanse

Velg først en modell

Trygg første forespørsel

Kjør en asynkron bildeoppgave

Modellspesifikk forespørselsatferd

Generer en gjennomsiktig bakgrunn