Руководства по интеграции
Цены и оплата
Генерация изображений Seedream
Используйте CometAPI POST /v1/images/generations для Seedream text-to-image и image-to-image генерации — поддерживается последовательный вывод нескольких изображений и референсные изображения.
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>"
}Обзор
Генерируйте изображения с помощью моделей Seedream от ByteDance через стандартный OpenAI-совместимый endpoint/v1/images/generations. Поддерживаются и text-to-image, и image-to-image генерация.
Полный список моделей см. на странице Models page. Подробную документацию по параметрам от провайдера см. в документации 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 — это подписанная ссылка объектного хранилища, которая содержит & и другие специальные символы.Если вы скопируете исходный 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
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>"
}