Mage API · Модель изображений
Seedream API
Seedream со строгим фильтром
POST https://api.mage.space/v1/seedream/generateГлавное
Seedream API запускает Seedream 5.5 и ещё 5 вариантов через Mage по адресу POST https://api.mage.space/v1/seedream/generate. Запрос с настройками по умолчанию стоит 42 Gems (около $0,042), без подписки. Seedream поддерживает сохранённых персонажей и референсы: укажи их через @handle в промпте.
- ИзображениеРезультат
- 6Варианты
- 42Gems за изображение по умолчанию
- $0.042Примерно, в USD
Обзор
Что умеет Seedream API
Seedream от ByteDance: от Seedream 5.0 Flash для черновиков до Seedream 5.5 — самой новой модели и варианта по умолчанию — с детализированными сценами, читаемым текстом и редактированием по 10 референсам или Characters; Seedream 4.5 поддерживает до 4K. Строгий фильтр: промпты и первые изображения проверяются перед каждым запуском.
Семейство моделей Seedream от ByteDance для изображений: подходит для детализированных сцен, читаемого текста и правок по 10 референсам или Characters. Seedream 5.5 (`seedream-5.5`) — новейшая и используется по умолчанию: изображения реалистичнее, мелкий текст чётче, а повторные правки стабильнее. Seedream 5.0 Pro (`seedream-5.0-pro`) — предыдущий флагман. Seedream 5.0 Flash (`seedream-5.0-flash`) — одна фиксированная цена с учётом входных изображений, самая низкая в 2K или с входными изображениями (для промпта в 1K без изображений Seedream 5.5 обойдётся дешевле). Seedream 5.0 Lite (`seedream-5.0-lite`) — до 3K. Seedream 4.5 (`seedream-4.5`) — до 4K. И Seedream 4.0 (`seedream-4.0`). Строгий фильтр: Mage проверяет промпт и первое изображение до запуска; запрос, который он отклоняет, завершается ошибкой `content_blocked` с указанием причины, а потраченные средства возвращаются.
На вход принимает image, additional_images.
Быстрый старт
Как вызвать Seedream API
Задайте MAGE_API_KEY, отправьте запрос на /seedream/generate и опрашивайте status_url, пока запрос не завершится.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/seedream/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "seedream-5.5"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('seedream', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'seedream-5.5',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("seedream", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "seedream-5.5",
})
print(request["result"]["url"])Модели
Значения model_id для Seedream
Передайте model_id, чтобы выбрать вариант. Запрос без него использует вариант по умолчанию.
| model_id | Название | По умолчанию |
|---|---|---|
| seedream-4.0 | Seedream 4.0 | |
| seedream-4.5 | Seedream 4.5 | |
| seedream-5.0-lite | Seedream 5.0 Lite | |
| seedream-5.0-pro | Seedream 5.0 Pro | |
| seedream-5.0-flash | Seedream 5.0 Flash | |
| seedream-5.5 | Seedream 5.5 | Да |
Параметры
Параметры Seedream
Допустимые значения для всех вариантов; у отдельного варианта их может быть меньше. Параметры каждого варианта перечислены в документации.
| Поле | Значения |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 1K, 2K, 3K, 4K |
Входные данные
Какие медиафайлы принимает Seedream
Передавайте каждый файл как https-ссылку, data URL или загрузку размером до 100 МБ.
| Поле | Роль |
|---|---|
| image | Референсное изображение. |
| additional_images | Дополнительные референсные изображения. |
Другие модели изображений
Другие API для генерации изображений на Mage
Stable Diffusion v1.5 API
Классика по доступной цене
Stable Diffusion v3.5 Large API
Stable Diffusion, который лучше всех понимает запросы
Stable Diffusion XL API
SDXL, настроенная на фотореализм
Z-Image API
Самая быстрая модель для изображений в Mage
Anima API
Создана специально для аниме
Chroma API
Открытые веса, на базе Flux
FAQ
Частые вопросы
Сколько стоит Seedream API?
Какой эндпоинт у Seedream API?
Какие модели Seedream можно вызывать?
Поддерживает ли Seedream референсные изображения и персонажей?
Можно ли использовать Seedream из Claude или ChatGPT?
Как долго хранятся результаты Seedream?
Начните создавать с Mage
Один аккаунт, один баланс Gems, все модели. Платите только за то, что генерируете.