Entegrasyon Kılavuzları
Hatalar
Fiyatlandırma ve Faturalandırma
Seedream Görüntü Oluşturma
Seedream metinden görüntüye ve görüntüden görüntüye oluşturma için CometAPI POST /v1/images/generations kullanın — ardışık çoklu görüntü çıktısını ve referans görüntüleri destekler.
{
"created": 123,
"data": [
{
"url": "<string>",
"b64_json": "<string>",
"size": "<string>"
}
],
"usage": {
"generated_images": 123,
"output_tokens": 123,
"total_tokens": 123
},
"model": "<string>"
}Genel Bakış
Standart OpenAI uyumlu/v1/images/generations endpoint’i üzerinden ByteDance’in Seedream modellerini kullanarak görüntüler oluşturun. Hem text-to-image hem de image-to-image 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.
sequential_image_generation değerini auto olarak ayarlayın ve çıktı görüntülerinin 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örüntülerin toplamı ile oluşturulan görüntülerin toplamı ≤ 15 olmalıdır.Görüntüden Görüntüye
Metin Prompt ile birlikteimage parametresi üzerinden bir veya daha fazla referans görüntü (URL dizisi veya base64 data URI’leri) iletin. En fazla 14 referans görüntü desteklenir.
Döndürülen URL AccessDenied mi Veriyor?
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 escape işlemi ya da terminal kısaltması imza parametrelerini kaldırabilir ve bunun sonucunda şunu alabilirsiniz:
\{"Code":"AccessDenied","Message":"Access Denied","EC":"0003-00000015"\}
- curl: URL’yi temiz şekilde çıkarmak için
| jq -r '.data[].url'üzerinden pipe edin. - Python:
result.data[0].urlveyaimage["url"]kullanın — string zaten tamdır; doğrudanrequests.get()veyawebbrowser.open()içine verin. - JavaScript: aynı fikir —
result.data[0].url. - Genel: URL içindeki
&ve%karakterlerinin kesilmediğinden veya çift escape edilmediğinden emin olun.
Yetkilendirmeler
Bearer token authentication. Use your CometAPI key.
Gövde
Parameters for Seedream image generation (text-to-image and image-to-image).
Model to use. See the Models page for current Seedream model IDs.
Text prompt describing the image to generate. Supports both Chinese and English. Recommended max 300 Chinese characters or 1000 English characters.
Output format. url returns a temporary image link (valid for 24 hours); b64_json returns base64-encoded image data.
url, b64_json Output resolution. Presets 2K, 4K, or exact pixels like 2048x2048, 2304x1728, 2848x1600, 1600x2848, etc. Default: 2048x2048.
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.
When true, adds an 'AI Generated' watermark to the bottom-right corner of the output image.
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).
Random seed for reproducible outputs. Range: -1 to 2147483647. Use -1 (default) for random generation. Legacy parameter — ignored by newer models.
Controls sequential (multi-image) generation mode.
auto: model decides whether to generate a sequence based on the promptdisabled: always generate a single image
auto, disabled Configuration for sequential (multi-image) generation. Only effective when sequential_image_generation is auto.
Show child attributes
Show child attributes
Output image file format. Options: png, jpeg.
png, jpeg Yanıt
Successful Response
{
"created": 123,
"data": [
{
"url": "<string>",
"b64_json": "<string>",
"size": "<string>"
}
],
"usage": {
"generated_images": 123,
"output_tokens": 123,
"total_tokens": 123
},
"model": "<string>"
}