Görüntü oluşturun

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

CometAPI üzerinde OpenAI uyumlu istek biçimleriyle metinden görüntü oluşturmak için bu rotayı kullanın.

Resmî referans

Şunu okuyun: OpenAI görüntü oluşturma kılavuzu background, output_compression, streaming veya gelecekteki GPT görüntü seçenekleri gibi modele özgü denetimlere güvenmeden önce.
Güncel parametre listesi için OpenAI Create image referansını kullanın.

Önce bir model seçin

gpt-image-2 gibi bir GPT görüntü modelini, output_format, quality veya background gibi denetimlerle metinden görüntü istekleri için kullanın
Şeffaf arka planlara ya da gpt-image-2.5-sunburst ve gpt-image-2.5-flare kalite düzeylerine ihtiyacınız olduğunda xhigh veya max kullanın
Özellikle o sağlayıcıya ihtiyacınız olduğunda qwen-image kullanın, ancak n değerini 1 olarak tutun
Şuradan güncel bir görüntü modeli kimliği seçin: Models sayfası

Güvenli ilk istek

gpt-image-2 ile başlayın
size değerini 1024x1024 olarak tutun
GPT görüntü modelleri, base64 ile kodlanmış görüntü verilerini b64_json içinde döndürür; görüntü dosyasını kaydetmek için kodunu çözün
Yalnızca output_format gibi belirli bir kodlanmış görüntü türüne ihtiyacınız olduğunda jpeg ekleyin
Toplu oluşturma veya stil ayarlaması eklemeden önce tek bir Prompt ve tek bir çıktı görüntüsü kullanın

Eşzamansız bir görüntü görevi çalıştırın

İstemciniz tek bir HTTP bağlantısını açık tutmak yerine gönderip yoklama akışını tercih ettiğinde, uzun süren görüntü işleri için async: true kullanın. Oluşturma isteği data.task_id döndürür. Yoklayın Bir görüntü oluşturma görevini alın data.status, success veya failure olana kadar. async alanı, OpenAI parametresi değil, bu rota için bir CometAPI uzantısıdır. OpenAI, GPT görüntü modelleri için stream ve partial_images belgelerini sağlar. CometAPI eşzamansız görev modu JSON görev meta verileri döndürür ve yoklama kullanır. Belgelendirilmiş şu model kimlikleriyle eşzamansız görev modunu kullanın: gpt-image-2 ve doubao-seedream-4-0-250828. Diğer görüntü modelleri için, o model için eşzamansız görev desteği belgelenmedikçe eşzamanlı oluşturma veya streaming kullanın. Bir istek hem async: true hem de stream: true içerdiğinde, eşzamansız görev modu önceliklidir. Oluşturma isteği SSE akışı yerine JSON görev meta verileri döndürür.

Modele özgü istek davranışı

response_format yalnızca DALL·E modelleri için geçerlidir; GPT görüntü modelleri base64 verisi döndürür ve bunu yoksayar
GPT görüntü modelleri GPT-only denetimlerini kullanır; bunlara output_format, quality, background ve output_compression dahildir
quality GPT görüntü modellerinde low, medium, high ve auto kabul eder; gpt-image-2.5-sunburst ve gpt-image-2.5-flare ayrıca xhigh ve max değerlerini de kabul eder
output_compression output_format, webp veya jpeg olduğunda geçerlidir; png üzerinde etkisi yoktur
partial_images yalnızca stream, true olduğunda geçerlidir
En güncel modele özgü seçenekler için OpenAI görüntü oluşturma kılavuzunu izleyin
qwen-image n > 1 desteklemez

Şeffaf arka plan oluşturma

Arka plan dolgusu olmayan, yalıtılmış bir konu oluşturmak için background değerini transparent olarak ayarlayın. Bu, gpt-image-2.5-sunburst ve gpt-image-2.5-flare üzerinde desteklenir. Şeffaflık için alfa kanalı içeren bir çıktı biçimi gerekir. output_format değerini png veya webp olarak ayarlayın. JPEG’de alfa kanalı yoktur; bu nedenle output_format: "jpeg" ile yapılan şeffaflık isteği reddedilir. Yanıt, alfa kanalıyla birlikte b64_json içinde base64 görüntü verisi döndürür. Dosyayı kaydetmek için kodunu çözün:

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

Düz renkli bir arka planı zorlamak için background değerini opaque olarak ayarlayın veya modelin karar vermesine izin vermek için auto olarak ayarlayın. Yanıt, uygulanan değeri üst düzey background alanında tekrarlar.

Oluşturulan görüntüler sağlayıcının kullanım politikalarına uygun olmalıdır. Yasa dışı, şiddet içeren, pornografik veya telif hakkını ihlal eden Prompt’lar göndermeyin.

Yetkilendirmeler

Authorization

string

header

gerekli

Bearer token authentication. Use your CometAPI key.

Gövde

application/json

model

string

varsayılan:gpt-image-2

gerekli

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

prompt

string

gerekli

Text description of the image you want to generate.

Örnek:

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

integer

varsayılan: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.

Örnek:

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

Mevcut seçenekler:

transparent,

opaque,

auto

output_compression

integer

varsayılan: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.

Gerekli aralık: 0 <= x <= 100

moderation

enum<string>

varsayılan:auto

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

Mevcut seçenekler:

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.

Gerekli aralık: 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.

Örnek:

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

Mevcut seçenekler:

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.

Örnek:

"jpeg"

stream

boolean

varsayılan: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

varsayılan: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.

Yanıt

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

gerekli

Unix timestamp for the completed generation.

data

object[]

gerekli

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

Son değiştirilme tarihi 11 Eylül 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..."
    }
  ]
}

İçerik moderasyonu

API anahtarları

Resmî referans

Önce bir model seçin

Güvenli ilk istek

Eşzamansız bir görüntü görevi çalıştırın

Modele özgü istek davranışı

Şeffaf arka plan oluşturma

Yetkilendirmeler

Gövde

Yanıt

​Resmî referans

​Önce bir model seçin

​Güvenli ilk istek

​Eşzamansız bir görüntü görevi çalıştırın

​Modele özgü istek davranışı

​Şeffaf arka plan oluşturma

Yetkilendirmeler

Gövde

Yanıt

Resmî referans

Önce bir model seçin

Güvenli ilk istek

Eşzamansız bir görüntü görevi çalıştırın

Modele özgü istek davranışı

Şeffaf arka plan oluşturma