Семейство Seedream (Doubao)

Модели изображений Doubao от ByteDance, всего три. Вызываются через OpenAI-совместимый эндпоинт /v1/images/generations; и генерация по тексту, и редактирование используют этот эндпоинт.

Выбор модели

Актуальные цены см. на странице модели .

Текст в изображение

import base64
from openai import OpenAI
 
client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.io/v1", timeout=600)
 
resp = client.images.generate(
    model="volcengine/doubao-seedream-5.0-pro",
    prompt="Красное яблоко на белом столе",
    size="2560x1440",
)
 
with open("output.jpg", "wb") as f:
    f.write(base64.b64decode(resp.data[0].b64_json))

curl https://api.ofox.io/v1/images/generations \
  --max-time 600 \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "volcengine/doubao-seedream-5.0-pro",
    "prompt": "Красное яблоко на белом столе",
    "size": "2560x1440"
  }' | jq -r '.data[0].b64_json' | base64 --decode > output.jpg

Формат вывода всегда JPEG — сохраняйте файл с расширением .jpg. По умолчанию возвращается base64; с "response_format": "url" вместо этого возвращается ссылка на изображение.

Размер (size)

size поддерживает два варианта записи:

• Уровень разрешения 1k, 2k, 4k (без учёта регистра): задаёт только разрешение, а соотношение сторон модель выбирает по промпту. По замерам, 4.5 с 2k выдавала как 2048×2048, так и 1664×2496.
• Точные размеры ШИРИНАxВЫСОТА: соотношение сторон фиксировано, число пикселей должно укладываться в диапазон из таблицы ниже.

«—» означает, что в этот раз замеры не проводились; ориентируйтесь на официальную документацию Volcano Engine Ark .

Распространённые допустимые размеры (удовлетворяют минимуму пикселей для 4.5 и 5.0 Lite):

Редактирование и несколько референсов

import base64
from openai import OpenAI
 
client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.io/v1", timeout=600)
 
with open("apple.jpg", "rb") as f:
    ref = "data:image/jpeg;base64," + base64.b64encode(f.read()).decode()
 
resp = client.images.generate(
    model="volcengine/doubao-seedream-5.0-pro",
    prompt="Сделай яблоко фиолетовым, остальное оставь без изменений",
    size="2k",
    extra_body={"image": [ref]},
)
 
with open("apple_purple.jpg", "wb") as f:
    f.write(base64.b64decode(resp.data[0].b64_json))

# base64 очень длинный: если вставить его прямо в командную строку, будет ошибка Argument list too long, поэтому сначала запишите его в файл
printf 'data:image/jpeg;base64,%s' "$(base64 < apple.jpg | tr -d '\n')" > apple.b64
jq -n --rawfile img apple.b64 '{
  model: "volcengine/doubao-seedream-5.0-pro",
  prompt: "Сделай яблоко фиолетовым, остальное оставь без изменений",
  size: "2k",
  image: [$img]
}' > body.json
 
curl https://api.ofox.io/v1/images/generations \
  --max-time 600 \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d @body.json | jq -r '.data[0].b64_json' | base64 --decode > apple_purple.jpg

• image — массив, каждый элемент которого является URL изображения или строкой, начинающейся с data:image/...;base64,. Несколько референсных изображений помещайте в массив по порядку и описывайте в промпте роль каждого.
• input_images — поле только для Qwen-Image, Seedream его не поддерживает.
• Seedream не поддерживает /v1/images/edits; для редактирования используйте поле image, описанное в этом разделе.

Серии и несколько изображений

Пример серии изображений:

{
  "model": "volcengine/doubao-seedream-5.0-lite",
  "prompt": "Сгенерируй 3 отдельных изображения: одна и та же лиса весной, летом и осенью",
  "size": "2k",
  "sequential_image_generation": "auto",
  "sequential_image_generation_options": { "max_images": 3 }
}

• auto означает, что количество изображений определяет модель, а max_images задаёт только верхний предел. По замерам, на тот же запрос 4.5 объединила три кадра комикса в одном изображении и вернула только 1. Если нужно фиксированное количество, явно напишите в промпте «сгенерируй N отдельных изображений».
• Каждое изображение оплачивается отдельно; usage.output_tokens — сумма по всем изображениям.

Водяной знак

По замерам, при вызове через OfoxAI водяного знака по умолчанию нет, дополнительные параметры не нужны.

Задержка

По замерам, 2K занимает около 12–40 секунд, серия из 3 изображений — около 76 секунд. Рекомендуется таймаут клиента 300 секунд или больше.

Типичные ошибки

Request id: 0217… в конце текста ошибки — номер запроса на стороне поставщика; обращаясь в техническую поддержку, приложите его вместе с request_id из ответа.

The parameter `size` specified in the request is not valid: image size must be at least 3686400 pixels.
The parameter `size` specified in the request are not valid: image area must be at least 921600 pixels.
The parameter `size` specified in the request is not valid: image size must be at most 16777216 pixels.
The parameter `size` specified in the request is not valid: the specified size is not supported for model doubao-seedream-4-5.
The parameter `size` specified in the request are not valid: must be 'WIDTHxHEIGHT' or a supported size preset.
The parameter `size` specified in the request is not valid: size must be one of 'WIDTHxHEIGHT', '1k', '2k', or '4k'.
The parameter `sequential_image_generation` specified in the request are not valid: the parameter `sequential_image_generation` is not supported by the current model.
The parameter `output_format` specified in the request is not valid: the parameter `output_format` is not supported by the current model.

Официальная документация

Официальная документация описывает поведение при прямом обращении к Volcano Engine Ark; при вызове через OfoxAI приоритет имеют выводы из замеров на этой странице.

• Центр документации Volcano Engine Ark 

Часто задаваемые вопросы