Ein Bild erstellen

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

Verwenden Sie diese Route, um Bilder aus Text mit OpenAI-kompatiblen Request-Formaten auf CometAPI zu erstellen.

Offizielle Referenz

Lesen Sie den OpenAI-Leitfaden zur Bildgenerierung, bevor Sie sich auf modellspezifische Steuerungen wie background, output_compression, Streaming oder zukünftige GPT-Bildoptionen verlassen.
Verwenden Sie die OpenAI-Referenz für Create image für die aktuelle Parameterliste.

Wählen Sie zuerst ein Modell

Verwenden Sie ein GPT-Bildmodell wie gpt-image-2 für Text-zu-Bild-Anfragen mit Steuerungen wie output_format, quality oder background
Verwenden Sie qwen-image, wenn Sie diesen Anbieter speziell benötigen, aber lassen Sie n auf 1
Wählen Sie eine aktuelle Bild-model ID auf der Models-Seite

Sichere erste Anfrage

Beginnen Sie mit gpt-image-2
Belassen Sie size auf 1024x1024
GPT-Bildmodelle geben base64-kodierte Bilddaten in b64_json zurück; dekodieren Sie diese, um die Bilddatei zu speichern
Fügen Sie output_format nur hinzu, wenn Sie einen bestimmten kodierten Bildtyp wie jpeg benötigen
Prüfen Sie den OpenAI-Leitfaden zur Bildgenerierung, bevor Sie background, output_compression oder Streaming hinzufügen
Verwenden Sie einen Prompt und ein Ausgabebild, bevor Sie Batch-Generierung oder Stilabstimmung hinzufügen

Führen Sie eine asynchrone Bildaufgabe aus

Verwenden Sie async: true für lang laufende Bild-Jobs, wenn Ihr Client einen Submit-und-Poll-Ablauf bevorzugt, anstatt eine HTTP-Verbindung offen zu halten. Die Erstellungsanfrage gibt data.task_id zurück. Fragen Sie Eine Bildgenerierungsaufgabe abrufen ab, bis data.status success oder failure ist. Das Feld async ist eine CometAPI-Erweiterung für diese Route, kein OpenAI-Parameter. OpenAI dokumentiert stream und partial_images für GPT-Bildmodelle. Der asynchrone Aufgabenmodus von CometAPI gibt JSON-Aufgabenmetadaten zurück und verwendet Polling. Verwenden Sie den asynchronen Aufgabenmodus mit diesen dokumentierten model IDs: gpt-image-2 und doubao-seedream-4-0-250828. Für andere Bildmodelle verwenden Sie synchrone Generierung oder Streaming, sofern keine Unterstützung für asynchrone Aufgaben für dieses Modell dokumentiert ist. Wenn eine Anfrage sowohl async: true als auch stream: true enthält, hat der asynchrone Aufgabenmodus Vorrang. Die Erstellungsanfrage gibt JSON-Aufgabenmetadaten anstelle eines SSE-Streams zurück.

Modellspezifisches Anfrageverhalten

response_format gilt nur für DALL·E-Modelle; GPT-Bildmodelle geben base64-Daten zurück und ignorieren es
GPT-Bildmodelle verwenden GPT-spezifische Steuerungen wie output_format, quality, background und output_compression
Folgen Sie dem OpenAI-Leitfaden zur Bildgenerierung für die neuesten modellspezifischen Optionen
qwen-image unterstützt n > 1 nicht

Generierte Bilder müssen den Nutzungsrichtlinien des Anbieters entsprechen. Senden Sie keine illegalen, gewalttätigen, pornografischen oder urheberrechtsverletzenden Prompts.

Autorisierungen

Authorization

string

header

erforderlich

Bearer token authentication. Use your CometAPI key.

Body

application/json

model

string

Standard:gpt-image-2

erforderlich

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

prompt

string

erforderlich

Text description of the image you want to generate.

Beispiel:

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

Beispiel:

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

Verfügbare Optionen:

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.

Beispiel:

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

Antwort

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

erforderlich

Unix timestamp for the completed generation.

data

object[]

erforderlich

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

APIs zur Bildgenerierung und -bearbeitung

Zurück

Eine Bildgenerierungsaufgabe abrufen

Weiter

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

Inhaltsmoderation

API-Schlüssel

Offizielle Referenz

Wählen Sie zuerst ein Modell

Sichere erste Anfrage

Führen Sie eine asynchrone Bildaufgabe aus

Modellspezifisches Anfrageverhalten

Autorisierungen

Body

Antwort

​Offizielle Referenz

​Wählen Sie zuerst ein Modell

​Sichere erste Anfrage

​Führen Sie eine asynchrone Bildaufgabe aus

​Modellspezifisches Anfrageverhalten

Autorisierungen

Body

Antwort

Offizielle Referenz

Wählen Sie zuerst ein Modell

Sichere erste Anfrage

Führen Sie eine asynchrone Bildaufgabe aus

Modellspezifisches Anfrageverhalten