Посібники з інтеграції
Помилки
Ціни та оплата
Генерація зображень Seedream
Використовуйте CometAPI POST /v1/images/generations для генерації Seedream text-to-image та image-to-image — підтримується послідовний вивід кількох зображень і референсні зображення.
{
"created": 123,
"data": [
{
"url": "<string>",
"b64_json": "<string>",
"size": "<string>"
}
],
"usage": {
"generated_images": 123,
"output_tokens": 123,
"total_tokens": 123
},
"model": "<string>"
}Огляд
Генеруйте зображення за допомогою моделей Seedream від ByteDance через стандартний OpenAI-сумісний endpoint/v1/images/generations. Підтримуються обидва режими: text-to-image і image-to-image.
Повний список моделей дивіться на сторінці Models. Детальну документацію щодо параметрів від провайдера дивіться в документації VolcEngine.
sequential_image_generation в auto і за потреби налаштуйте sequential_image_generation_options.max_images, щоб обмежити кількість вихідних зображень. Загальна кількість референсних і згенерованих зображень має бути ≤ 15.Image-to-Image
Передайте одне або кілька референсних зображень через параметрimage (масив URL-адрес або base64 data URI) разом із текстовим Prompt. Підтримується до 14 референсних зображень.
Повернений URL дає AccessDenied?
url — це підписане посилання на object storage, яке містить & та інші спеціальні символи.Якщо ви скопіюєте сирий JSON і вставите його безпосередньо в браузер або скрипт, екранування shell чи обрізання в терміналі може прибрати параметри підпису, що призведе до:
\{"Code":"AccessDenied","Message":"Access Denied","EC":"0003-00000015"\}
- curl: використайте конвеєр
| jq -r '.data[].url', щоб коректно витягти URL. - Python: використовуйте
result.data[0].urlабоimage["url"]— рядок уже повний; передавайте його напряму вrequests.get()абоwebbrowser.open(). - JavaScript: та сама ідея —
result.data[0].url. - Загалом: переконайтеся, що
&і%в URL не обрізаються та не екрануються двічі.
Авторизації
Bearer token authentication. Use your CometAPI key.
Тіло
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 Відповідь
Successful Response
{
"created": 123,
"data": [
{
"url": "<string>",
"b64_json": "<string>",
"size": "<string>"
}
],
"usage": {
"generated_images": 123,
"output_tokens": 123,
"total_tokens": 123
},
"model": "<string>"
}