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