Перейти к основному содержанию
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.

​
Обзор

Генерируйте изображения с помощью моделей 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, чтобы ограничить количество выходных изображений. Общее количество reference images и сгенерированных изображений должно быть ≤ 15.

​
Image-to-image

Передайте одно или несколько reference images через параметр image (массив URL или base64 data URI) вместе с текстовым prompt. Поддерживается до 14 reference images.

​
Returned URL gives 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 не обрезаются и не экранируются дважды.

Авторизации

​
Authorization
string
header
обязательно

Bearer token authentication. Use your CometAPI key.

Тело

application/json

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

​
model
string
по умолчанию:doubao-seedream-5-0-260128
обязательно

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

​
prompt
string
по умолчанию:a cat wearing a scarf sitting by the window
обязательно

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>
по умолчанию:url

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

Доступные опции:
url,
b64_json
​
size
string
по умолчанию: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
по умолчанию:true

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

​
guidance_scale
number
по умолчанию: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
по умолчанию:-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>
по умолчанию: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
Доступные опции:
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>
по умолчанию:jpeg

Output image file format. Options: png, jpeg.

Доступные опции:
png,
jpeg

Ответ

200 - application/json

Successful Response

​
created
integer
обязательно

Unix timestamp (seconds) when the image was generated.

​
data
object[]
обязательно

Array of generated image objects.

​
usage
object
обязательно

Resource usage information for this request.

​
model
string

The model used for generation.