Seedream 5.0
Seedream 5.0 создаёт изображения по текстовому заданию, поддерживает изменения по изображению и наборы связанных изображений. В Ailoot Ultra используйте bytedance-seed/seedream-5-0; точный псевдоним doubao-seedream-5-0-260128 выбирает ту же модель. Опишите сцену или изменение, задайте ясную роль каждому референсу и сохраните каждое возвращённое изображение для проверки.
- Ailoot Ultra · Images
POST /v1/images/generationsbytedance-seed/seedream-5-0 - Ailoot Ultra · Images
POST /v1/images/generationsdoubao-seedream-5-0-260128
О модели
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
Seedream 5.0 — модель генерации изображений с режимами создания по тексту, преобразования изображения и создания связанных изображений. В Ailoot Ultra она доступна как bytedance-seed/seedream-5-0 и по псевдониму doubao-seedream-5-0-260128. Для запроса изображения используйте POST /v1/images/generations с model и prompt. Для новой композиции опишите объект, расположение, освещение и визуальное решение; для изменения объясните нужную правку и детали источника, которые следует сохранить.
В документированном сценарии работы по изображениям через URL передайте image как массив строк с доступными URL изображений и задайте каждому референсу роль в запросе. Например, одно изображение может определять продукт, а другое — показывать желаемое расположение; назовите эти роли в запросе. В задании на замену одежды можно указать человека на первом референсе и предмет одежды на втором. Сравните получившийся объект, одежду или персонажа с оригиналом, не предполагая, что каждая деталь сохранилась.
Генерация связанных изображений использует sequential_image_generation. disabled запрашивает одно изображение; auto позволяет модели решить, уместен ли набор. sequential_image_generation_options.max_images ограничивает запрошенный набор значением от 1 до 15; документированное значение по умолчанию — 15. Для серии иллюстраций четырёх времён года задайте общую сцену, четыре сезонных отличия и max_images:4. Это верхний предел, поэтому проверяйте фактическое число возвращённых элементов.
В документированных примерах используется size:2K. Необязательный seed — целое число от -1 до 2147483647; при его отсутствии seed выбирается автоматически. watermark — логический параметр. В документации модели также указан элемент tools с type:web_search. Явно задавайте требования к сцене даже при использовании референса или управления поиском: для иллюстрации продукта опишите, какие детали внешнего вида должны сохраниться и какие части окружения могут измениться.
response_format:url возвращает ссылки на изображения; b64_json возвращает закодированные данные изображения. Этот метод Ailoot возвращает весь набор изображений в одном непотоковом ответе JSON; задайте stream:false или опустите его. Сохраняйте каждое изображение data[] и usage.generated_images. Декодируйте каждое значение b64_json или загрузите каждый возвращённый подписанный URL Ailoot. Ailoot сохраняет готовые изображения как принадлежащие вам медиаресурсы и возвращает подписанные URL Ailoot для результатов в виде ссылок. Найдите записи ресурсов через GET /v1/media/assets?family=image и пройдите по всем next_cursor. Используйте каждый фактический asset_id с GET /v1/media/assets/{asset_id}, чтобы прочитать content_url. Если подписанная ссылка возвращает link_expired, повторно прочитайте тот же ресурс для обновлённого content_url. При неполной доставке сохраняйте исходную операцию и все полученные результаты и изучите их, прежде чем создавать новую генерацию.
Ailoot Ultra · Images POST /v1/images/generations bytedance-seed/seedream-5-0
bytedance-seed/seedream-5-0bytedance-seed/seedream-5-0doubao-seedream-5-0-260128
Начало
Seedream 5.0 создаёт изображения по текстовому заданию, поддерживает изменения по изображению и наборы связанных изображений. В Ailoot Ultra используйте bytedance-seed/seedream-5-0; точный псевдоним doubao-seedream-5-0-260128 выбирает ту же модель. Опишите сцену или изменение, задайте ясную роль каждому референсу и сохраните каждое возвращённое изображение для проверки.
- Допустимые входные данные
- Текст · Картинки
- Результаты
- Картинки
Доступно в Ailoot · входные данные и методы
Ailoot Ultra · Images POST /v1/images/generations
- Входные данные
text,image- Результат
image- Выходной формат
- Файл изображения
| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения bytedance-seed/seedream-5-0 | По умолчанию— |
Полеprompt | Типstring | ТребованиеОбязательно | Значения и ограничения | По умолчанию— |
Полеstream | Типboolean | ТребованиеНеобязательно | Значения и ограничения false | По умолчаниюfalse |
Полеimage | Типarray | ТребованиеНеобязательно | Значения и ограничения | По умолчанию— |
Параметры и жизненный цикл метода
| Параметр | Контракт |
|---|---|
Параметрcontent_type | Контрактapplication/json |
Параметрrequired | Контрактmodel, prompt |
Параметрoptional | Контрактstream, image |
Параметрmaterial_types | Контрактtext, image |
Параметрconditions | КонтрактUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Жизненный цикл: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Тарифы
Как рассчитывается итоговая плата
Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом.
Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.
- Быстрый режим
- Не указано При выборе быстрого режима
- Режим flex
- Не указано При выборе режима flex
- Максимальная интенсивность рассуждений
- Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)
Оценочные ставки для сравнения
Цены по конфигурациям
Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.
| Конфигурация | Шкала ставок | Прогноз количества | Плата |
|---|---|---|---|
| КонфигурацияБазовые тарифы на токены | Шкала ставокБазовая ставка | Прогноз количества— | Плата Вход · Входные токены · Оценка только для сравнения — / 1K токенов Выход · Выходные токены · Оценка только для сравнения — / 1K токенов Вход · Чтение кэша · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш, 1 час · Оценка только для сравнения — / 1K токенов |
| КонфигурацияEstimated generation cost | Шкала ставок— | Прогноз количестваОценка для одной генерации | Плата Вход · Оценочная стоимость генерации · Оценка только для сравнения $0.09 оценка до генерации This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →
Примеры запросов
Ailoot Ultra · Images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "bytedance-seed/seedream-5-0", "prompt": "A calm studio product photograph with a plain background."}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Получить и сохранить результаты
Ailoot Ultra · Images
Загрузите каждое полученное изображение или сохраните его содержимое Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Сохраняйте все готовые результаты
Сохраните каждое готовое изображение; загрузите содержимое по каждому полученному URL или декодируйте его содержимое Base64.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Если нужно проверить исходный ответ
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Псевдонимы
Псевдонимы моделей
Ailoot Ultra bytedance-seed/seedream-5-0, doubao-seedream-5-0-260128
Псевдонимы путей метода
Используйте пути методов, указанные выше.
Связанные ID для вызова
Ailoot Ultra · Images POST /v1/images/generations doubao-seedream-5-0-260128
doubao-seedream-5-0-260128bytedance-seed/seedream-5-0doubao-seedream-5-0-260128
Начало
Seedream 5.0 создаёт изображения по текстовому заданию, поддерживает изменения по изображению и наборы связанных изображений. В Ailoot Ultra используйте bytedance-seed/seedream-5-0; точный псевдоним doubao-seedream-5-0-260128 выбирает ту же модель. Опишите сцену или изменение, задайте ясную роль каждому референсу и сохраните каждое возвращённое изображение для проверки.
- Допустимые входные данные
- Текст · Картинки
- Результаты
- Картинки
Доступно в Ailoot · входные данные и методы
Ailoot Ultra · Images POST /v1/images/generations
- Входные данные
text,image- Результат
image- Выходной формат
- Файл изображения
| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения doubao-seedream-5-0-260128 | По умолчанию— |
Полеprompt | Типstring | ТребованиеОбязательно | Значения и ограничения | По умолчанию— |
Полеstream | Типboolean | ТребованиеНеобязательно | Значения и ограничения false | По умолчаниюfalse |
Полеimage | Типarray | ТребованиеНеобязательно | Значения и ограничения | По умолчанию— |
Параметры и жизненный цикл метода
| Параметр | Контракт |
|---|---|
Параметрcontent_type | Контрактapplication/json |
Параметрrequired | Контрактmodel, prompt |
Параметрoptional | Контрактstream, image |
Параметрmaterial_types | Контрактtext, image |
Параметрconditions | КонтрактUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Жизненный цикл: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Тарифы
Как рассчитывается итоговая плата
Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом.
Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.
- Быстрый режим
- Не указано При выборе быстрого режима
- Режим flex
- Не указано При выборе режима flex
- Максимальная интенсивность рассуждений
- Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)
Оценочные ставки для сравнения
Цены по конфигурациям
Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.
| Конфигурация | Шкала ставок | Прогноз количества | Плата |
|---|---|---|---|
| КонфигурацияБазовые тарифы на токены | Шкала ставокБазовая ставка | Прогноз количества— | Плата Вход · Входные токены · Оценка только для сравнения — / 1K токенов Выход · Выходные токены · Оценка только для сравнения — / 1K токенов Вход · Чтение кэша · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш, 1 час · Оценка только для сравнения — / 1K токенов |
| КонфигурацияEstimated generation cost | Шкала ставок— | Прогноз количестваОценка для одной генерации | Плата Вход · Оценочная стоимость генерации · Оценка только для сравнения $0.09 оценка до генерации This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →
Примеры запросов
Ailoot Ultra · Images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "doubao-seedream-5-0-260128", "prompt": "A calm studio product photograph with a plain background."}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Получить и сохранить результаты
Ailoot Ultra · Images
Загрузите каждое полученное изображение или сохраните его содержимое Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Сохраняйте все готовые результаты
Сохраните каждое готовое изображение; загрузите содержимое по каждому полученному URL или декодируйте его содержимое Base64.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Если нужно проверить исходный ответ
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Псевдонимы
Псевдонимы моделей
Ailoot Ultra bytedance-seed/seedream-5-0, doubao-seedream-5-0-260128
Псевдонимы путей метода
Используйте пути методов, указанные выше.
Связанные ID для вызова
FAQ · Seedream 5.0
- Какие входные данные и результаты доступны?
POST /v1/images/generations·bytedance-seed/seedream-5-0:text,image→imagePOST /v1/images/generations·doubao-seedream-5-0-260128:text,image→image- Какие поля использует запрос?
POST /v1/images/generations·bytedance-seed/seedream-5-0:model,prompt,stream,imagePOST /v1/images/generations·doubao-seedream-5-0-260128:model,prompt,stream,image