Ana içeriğe atla
POST
/
v1
/
images
/
generations
Create images
curl --request POST \
  --url https://api.cometapi.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "dall-e-3",
  "prompt": "A paper boat floating on calm water at sunrise."
}
'
{
  "created": 1773311889,
  "data": [
    {
      "revised_prompt": "A paper boat floating on calm water at sunrise, with soft golden light reflecting off the water's surface.",
      "url": "https://filesystem.site/cdn/20260312/1d6826050921c07a13ff173310c640.webp"
    }
  ]
}
CometAPI üzerinde OpenAI uyumlu istek biçimleriyle metinden görsel oluşturmak için bu rotayı kullanın.

Önce bir model seçin

  • Basit bir URL tabanlı smoke test istediğinizde dall-e-3 kullanın
  • Daha yeni GPT görsel modellerini istediğinizde ve base64 yanıtlarını işleyebildiğinizde gpt-image-1, gpt-image-1-mini veya gpt-image-1.5 kullanın
  • Özellikle o sağlayıcıya ihtiyaç duyduğunuzda qwen-image kullanın, ancak n değerini 1 olarak tutun

Güvenli ilk istek

  • dall-e-3 ile başlayın
  • size değerini 1024x1024 olarak tutun
  • Küçük bir JSON yanıtı ve geçici bir indirme URL’si istiyorsanız response_format: "url" ayarlayın
  • Toplu üretim veya stil ayarlama eklemeden önce tek bir prompt ve tek bir görsel kullanın

Modele özel yanıt davranışı

  • dall-e-2 ve dall-e-3, URL yanıtlarını ve base64 yanıtlarını destekler
  • gpt-image-1, gpt-image-1-mini ve gpt-image-1.5, base64 öncelikli rotalar olarak değerlendirilmelidir
  • qwen-image, n > 1 desteği sunmaz
2026-03-12 tarihinde canlı doğrulama sırasında, response_format: "url" içeren bir dall-e-3 isteği normal bir created zaman damgası, bir revised_prompt ve geçici bir görsel URL’si döndürdü.
Oluşturulan görseller 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:dall-e-3
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."

n
integer
varsayılan:1

Number of images to generate. Keep this at 1 for the broadest compatibility.

size
string

Requested output size. Supported values depend on the selected model.

Örnek:

"1024x1024"

response_format
enum<string>

Requested output encoding for models that support it.

Mevcut seçenekler:
url,
b64_json

Yanıt

200 - application/json

Image generation result.

created
integer
gerekli

Unix timestamp for the completed generation.

data
object[]
gerekli