curl --request POST \
--url https://toapis.com/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "doubao-seedream-5-0",
"prompt": "Милая панда играет в бамбуковом лесу",
"size": "1:1",
"n": 1,
"metadata": {
"resolution": "2K"
}
}'
curl --request POST \
--url https://toapis.com/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "doubao-seedream-5-0",
"prompt": "Милая панда играет в бамбуковом лесу",
"size": "1:1",
"n": 1,
"image_urls": [
"https://example.com/panda.jpg"
],
"metadata": {
"resolution": "3K"
}
}'
import requests
response = requests.post(
"https://toapis.com/v1/images/generations",
headers={
"Authorization": "Bearer your-ToAPIs-key",
"Content-Type": "application/json"
},
json={
"model": "doubao-seedream-5-0",
"prompt": "Милая панда играет в бамбуковом лесу",
"size": "1:1",
"n": 1,
"metadata": {
"resolution": "2K"
}
}
)
task = response.json()
print(f"ID задачи: {task['id']}")
print(f"Статус: {task['status']}")
const response = await fetch('https://toapis.com/v1/images/generations', {
method: 'POST',
headers: {
'Authorization': 'Bearer your-ToAPIs-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'doubao-seedream-5-0',
prompt: 'Милая панда играет в бамбуковом лесу',
size: '1:1',
n: 1,
metadata: {
resolution: '2K'
}
})
});
const task = await response.json();
console.log(`ID задачи: ${task.id}`);
console.log(`Статус: ${task.status}`);
{
"id": "task_img_abc123def456",
"object": "generation.task",
"model": "doubao-seedream-5-0",
"status": "queued",
"progress": 0,
"created_at": 1703884800,
"metadata": {}
}
Seedream-5.0
Seedream-5.0 Генерация изображений
Генерация высококачественных изображений с помощью модели Seedream 5.0 lite с поддержкой 2K/3K и поиском в интернете
POST
/
v1
/
images
/
generations
curl --request POST \
--url https://toapis.com/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "doubao-seedream-5-0",
"prompt": "Милая панда играет в бамбуковом лесу",
"size": "1:1",
"n": 1,
"metadata": {
"resolution": "2K"
}
}'
curl --request POST \
--url https://toapis.com/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "doubao-seedream-5-0",
"prompt": "Милая панда играет в бамбуковом лесу",
"size": "1:1",
"n": 1,
"image_urls": [
"https://example.com/panda.jpg"
],
"metadata": {
"resolution": "3K"
}
}'
import requests
response = requests.post(
"https://toapis.com/v1/images/generations",
headers={
"Authorization": "Bearer your-ToAPIs-key",
"Content-Type": "application/json"
},
json={
"model": "doubao-seedream-5-0",
"prompt": "Милая панда играет в бамбуковом лесу",
"size": "1:1",
"n": 1,
"metadata": {
"resolution": "2K"
}
}
)
task = response.json()
print(f"ID задачи: {task['id']}")
print(f"Статус: {task['status']}")
const response = await fetch('https://toapis.com/v1/images/generations', {
method: 'POST',
headers: {
'Authorization': 'Bearer your-ToAPIs-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'doubao-seedream-5-0',
prompt: 'Милая панда играет в бамбуковом лесу',
size: '1:1',
n: 1,
metadata: {
resolution: '2K'
}
})
});
const task = await response.json();
console.log(`ID задачи: ${task.id}`);
console.log(`Статус: ${task.status}`);
{
"id": "task_img_abc123def456",
"object": "generation.task",
"model": "doubao-seedream-5-0",
"status": "queued",
"progress": 0,
"created_at": 1703884800,
"metadata": {}
}
Для пользователей из материкового Китая: используйте
https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.- Seedream 5.0 lite — новейшая модель генерации изображений от команды ByteDance Seed
- Используйте параметр model для выбора
doubao-seedream-5-0 - Поддерживает генерацию по тексту, по изображению и с несколькими референсами
- Новая возможность поиска в интернете для генерации с актуальными данными
- Поддерживает разрешение 2K и 3K
- Асинхронное управление задачами, запрос результатов по ID задачи
Важное изменение: Для повышения производительности и контроля затрат мы больше не поддерживаем передачу данных изображений в формате base64 напрямую в
image_urls. Пожалуйста, сначала используйте API загрузки изображений для загрузки изображений и получения URL, а затем вызывайте этот эндпоинт.Авторизация
string
обязательно
Все API требуют аутентификации Bearer TokenПолучите API Key на странице управления API KeyДобавьте в заголовок запроса:
Authorization: Bearer YOUR_API_KEY
Тело запроса
string
по умолчанию:"doubao-seedream-5-0"
обязательно
Название модели для генерации изображенийПример:
"doubao-seedream-5-0"string
обязательно
Текстовое описание для генерации изображения
string
по умолчанию:"1:1"
Соотношение сторон изображенияПоддерживаемые соотношения:
1:1- Квадрат (по умолчанию)4:3- Горизонтальный 4:33:4- Вертикальный 3:416:9- Широкоформатный9:16- Вертикальный3:2- Горизонтальный 3:22:3- Вертикальный 2:321:9- Ультраширокий9:21- Ультравысокий
integer
по умолчанию:1
Количество генерируемых изображенийДиапазон: 1-15По умолчанию: 1Примечание:
- Сумма референсных изображений + генерируемых должна быть ≤ 15
- Вводите только число (например
1), без кавычек
string[]
Список URL референсных изображений для генерации по изображению⚠️ Только формат URL (base64 больше не поддерживается)
- Публично доступный URL изображения (http:// или https://)
- Используйте API загрузки изображений для загрузки локальных файлов
- Максимум 10 изображений
- Форматы: jpeg, png
- Соотношение сторон: [1/3, 3]
- Ширина и высота (px) > 14
- Размер: не более 10 МБ
- Всего пикселей: не более 6000×6000 px
object
Специфичные параметры для расширенной настройки модели Seedream 5.0
Показать Свойства metadata
Показать Свойства metadata
string
по умолчанию:"2K"
Разрешение изображенияПоддерживаемые разрешения:
2K- Стандартное разрешение (по умолчанию)3K- Высокое разрешение
Примечание: Seedream 5.0 не поддерживает разрешения 1K и 4KСправочные размеры:
| Разрешение | 1:1 | 16:9 |
|---|---|---|
| 2K | 2048×2048 | 2848×1600 |
| 3K | 3072×3072 | 4096×2304 |
string
по умолчанию:"disabled"
Режим последовательной генерации (функция Doubao)
disabled: Отключён, генерируется только 1 изображение (по умолчанию)auto: Включён, можно генерировать несколько изображений
- ✅ Установите
n: 3или используйте"auto"+max_images: 3 - ✅ Поддерживает генерацию набора по тексту: до 15 изображений
- ✅ Поддерживает генерацию по изображению с несколькими вариантами
- ⚠️ При
n > 1автоматически устанавливаетсяauto
object
Настройки последовательной генерацииДоступно при
sequential_image_generation: "auto"Свойства:max_images(integer): Количество изображений, диапазон 1-15
"sequential_image_generation_options": { "max_images": 3 }
boolean
по умолчанию:false
Добавить водяной знак на изображение
true: С водяным знакомfalse: Без водяного знака (по умолчанию)
Ответ
string
Уникальный идентификатор задачи для запроса статуса
string
Тип объекта, всегда
generation.taskstring
Название используемой модели
string
Статус задачи
queued- В очередиin_progress- Обрабатываетсяcompleted- Успешно завершенаfailed- Ошибка
integer
Прогресс задачи в процентах (0-100)
integer
Временная метка создания задачи (Unix timestamp)
object
Метаданные задачи
curl --request POST \
--url https://toapis.com/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "doubao-seedream-5-0",
"prompt": "Милая панда играет в бамбуковом лесу",
"size": "1:1",
"n": 1,
"metadata": {
"resolution": "2K"
}
}'
curl --request POST \
--url https://toapis.com/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "doubao-seedream-5-0",
"prompt": "Милая панда играет в бамбуковом лесу",
"size": "1:1",
"n": 1,
"image_urls": [
"https://example.com/panda.jpg"
],
"metadata": {
"resolution": "3K"
}
}'
import requests
response = requests.post(
"https://toapis.com/v1/images/generations",
headers={
"Authorization": "Bearer your-ToAPIs-key",
"Content-Type": "application/json"
},
json={
"model": "doubao-seedream-5-0",
"prompt": "Милая панда играет в бамбуковом лесу",
"size": "1:1",
"n": 1,
"metadata": {
"resolution": "2K"
}
}
)
task = response.json()
print(f"ID задачи: {task['id']}")
print(f"Статус: {task['status']}")
const response = await fetch('https://toapis.com/v1/images/generations', {
method: 'POST',
headers: {
'Authorization': 'Bearer your-ToAPIs-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'doubao-seedream-5-0',
prompt: 'Милая панда играет в бамбуковом лесу',
size: '1:1',
n: 1,
metadata: {
resolution: '2K'
}
})
});
const task = await response.json();
console.log(`ID задачи: ${task.id}`);
console.log(`Статус: ${task.status}`);
{
"id": "task_img_abc123def456",
"object": "generation.task",
"model": "doubao-seedream-5-0",
"status": "queued",
"progress": 0,
"created_at": 1703884800,
"metadata": {}
}