Ana içeriğe atla
POST
/
v1
/
images
/
generations
curl -s https://api.cometapi.com/v1/images/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0-260128",
    "prompt": "a cat wearing a scarf sitting by the window watching rain, illustration style",
    "size": "2K",
    "response_format": "url",
    "watermark": false
  }' | jq -r '.data[].url'
{
  "created": 123,
  "data": [
    {
      "url": "<string>",
      "b64_json": "<string>",
      "size": "<string>"
    }
  ],
  "usage": {
    "generated_images": 123,
    "output_tokens": 123,
    "total_tokens": 123
  },
  "model": "<string>"
}

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.

​
Genel bakış

Standart OpenAI uyumlu /v1/images/generations endpoint’i üzerinden ByteDance’in Seedream modellerini kullanarak görseller oluşturun. Hem metinden görsel hem de görselden görsel oluşturmayı destekler. Tam model listesi için Models sayfasına bakın. Sağlayıcının ayrıntılı parametre dokümantasyonu için VolcEngine dokümantasyonuna bakın.
Sıralı (çoklu görsel) oluşturma kullanırken, sequential_image_generation değerini auto olarak ayarlayın ve çıktı görsellerinin sayısını sınırlamak için isteğe bağlı olarak sequential_image_generation_options.max_images yapılandırın. Referans görsellerin toplam sayısı ile oluşturulan görsellerin toplamı ≤ 15 olmalıdır.

​
Görselden görsel

Bir metin prompt’u ile birlikte image parametresi üzerinden bir veya daha fazla referans görsel gönderin (URL dizisi veya base64 veri URI’leri). En fazla 14 referans görsel desteklenir.

​
Döndürülen URL AccessDenied veriyor mu?

Döndürülen url, & ve diğer özel karakterleri içeren imzalı bir nesne depolama bağlantısıdır.
Ham JSON’u kopyalayıp doğrudan bir tarayıcıya veya script’e yapıştırırsanız, shell escaping veya terminal kısaltması imza parametrelerini çıkarabilir ve şu sonuca yol açabilir:
\{"Code":"AccessDenied","Message":"Access Denied","EC":"0003-00000015"\}
Nasıl düzeltilir:
  • curl: URL’yi temiz bir şekilde çıkarmak için | jq -r '.data[].url' üzerinden pipe edin.
  • Python: result.data[0].url veya image["url"] kullanın — string zaten eksiksizdir; doğrudan requests.get() veya webbrowser.open() içine verin.
  • JavaScript: aynı fikir — result.data[0].url.
  • Genel: URL içindeki & ve % karakterlerinin kesilmediğinden veya iki kez escape edilmediğinden emin olun.

Yetkilendirmeler

​
Authorization
string
header
gerekli

Bearer token authentication. Use your CometAPI key.

Gövde

application/json

Parameters for Seedream image generation (text-to-image and image-to-image).

​
model
string
varsayılan:doubao-seedream-5-0-260128
gerekli

Model to use. See the Models page for current Seedream model IDs.

​
prompt
string
varsayılan:a cat wearing a scarf sitting by the window
gerekli

Text prompt describing the image to generate. Supports both Chinese and English. Recommended max 300 Chinese characters or 1000 English characters.

​
response_format
enum<string>
varsayılan:url

Output format. url returns a temporary image link (valid for 24 hours); b64_json returns base64-encoded image data.

Mevcut seçenekler:
url,
b64_json
​
size
string
varsayılan:2048x2048

Output resolution. Presets 2K, 4K, or exact pixels like 2048x2048, 2304x1728, 2848x1600, 1600x2848, etc. Default: 2048x2048.

​
image
string[]

Reference image(s) for image-to-image generation. Each item is a public URL or base64 data URI (data:image/png;base64,...). Supports up to 14 reference images. Supported formats: jpeg, png, webp, bmp, tiff, gif.

​
watermark
boolean
varsayılan:true

When true, adds an 'AI Generated' watermark to the bottom-right corner of the output image.

​
guidance_scale
number
varsayılan:2.5

Controls how closely the output follows the prompt. Higher values increase adherence but may reduce naturalness. Range: 1.0–10.0. Not supported by Seedream 5.0 (ignored).

​
seed
integer
varsayılan:-1

Random seed for reproducible outputs. Range: -1 to 2147483647. Use -1 (default) for random generation. Legacy parameter — ignored by newer models.

​
sequential_image_generation
enum<string>
varsayılan:disabled

Controls sequential (multi-image) generation mode.

  • auto: model decides whether to generate a sequence based on the prompt
  • disabled: always generate a single image
Mevcut seçenekler:
auto,
disabled
​
sequential_image_generation_options
object

Configuration for sequential (multi-image) generation. Only effective when sequential_image_generation is auto.

​
output_format
enum<string>
varsayılan:jpeg

Output image file format. Options: png, jpeg.

Mevcut seçenekler:
png,
jpeg

Yanıt

200 - application/json

Successful Response

​
created
integer
gerekli

Unix timestamp (seconds) when the image was generated.

​
data
object[]
gerekli

Array of generated image objects.

​
usage
object
gerekli

Resource usage information for this request.

​
model
string

The model used for generation.