Ana içeriğe atla
POST
/
v1
/
images
/
generations
curl --request POST \ --url https://api.cometapi.com/v1/images/generations \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "model": "gpt-image-2", "prompt": "A paper boat floating on calm water at sunrise." } '
{
  "created": 1776841943,
  "background": "opaque",
  "output_format": "jpeg",
  "quality": "low",
  "size": "1024x1024",
  "usage": {
    "input_tokens": 16,
    "input_tokens_details": {
      "image_tokens": 0,
      "text_tokens": 16
    },
    "output_tokens": 208,
    "total_tokens": 224
  },
  "data": [
    {
      "b64_json": "<base64-image-data>"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

CometAPI üzerinde OpenAI uyumlu istek yapılarıyla metinden görsel oluşturmak için bu rotayı kullanın.

​
Resmi referans

​
Önce bir model seçin

  • response_format ile basit bir ilk istek istediğinizde dall-e-3 kullanın
  • output_format, quality veya background gibi yalnızca GPT’ye özgü kontrollere ihtiyaç duyduğunuzda bir GPT görsel modeli 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
  • GPT görsel modeli parametrelerine ihtiyacınız varsa API referansındaki doğrulanmış GPT istek örneğini kullanın
  • jpeg gibi belirli bir kodlanmış görsel türüne ihtiyaç duyduğunuzda yalnızca output_format ekleyin
  • background, output_compression veya streaming eklemeden önce OpenAI görsel oluşturma kılavuzunu kontrol edin
  • Toplu oluşturma veya stil ayarı eklemeden önce tek bir prompt ve tek bir çıktı görseli kullanın

​
Modele özgü istek davranışı

  • response_format, dall-e-2 ve dall-e-3 için geçerlidir
  • GPT görsel modelleri output_format, quality, background ve output_compression gibi yalnızca GPT’ye özgü kontroller kullanır
  • En güncel modele özgü seçenekler için OpenAI görsel oluşturma kılavuzunu izleyin
  • qwen-image, n > 1 desteği sunmaz
Oluşturulan görseller sağlayıcının kullanım politikalarına uymalı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.

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

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

Yanıt

200 - application/json

Image generation result.

​
created
integer
gerekli

Unix timestamp for the completed generation.

​
usage
object
gerekli
​
data
object[]
gerekli
​
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.