Перейти до вмісту
PlaygroundДокументаціяОтримати API-ключ

Mage API · Модель зображень

Seedream API

Seedream із суворим фільтром

Отримати API-ключСпробувати Seedream у playground
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, до 4K у Seedream 4.5. Суворий фільтр: промпти та перші зображення перевіряються перед кожним запуском.

Сімейство моделей зображень 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 або з вхідними зображеннями (Seedream 5.5 коштує менше для промпту в 1K без зображень); 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.0Seedream 4.0
seedream-4.5Seedream 4.5
seedream-5.0-liteSeedream 5.0 Lite
seedream-5.0-proSeedream 5.0 Pro
seedream-5.0-flashSeedream 5.0 Flash
seedream-5.5Seedream 5.5Так

Параметри

Параметри Seedream

Допустимі значення для всіх варіантів; окремий варіант може пропонувати менше. Параметри кожного варіанта наведено в документації.

ПолеЗначення
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K, 3K, 4K

Вхідні дані

Медіавхідні дані, які приймає Seedream

Надсилайте кожен файл як https-посилання, data URL або завантаження до 100 МБ.

ПолеРоль
imageРеференсне зображення.
additional_imagesДодаткові референсні зображення.

Більше моделей для зображень

Інші API для генерації зображень на Mage

  • Зображення · від 10 Gems

    Stable Diffusion v1.5 API

    Класика за помірну ціну

  • Зображення · від 10 Gems

    Stable Diffusion v3.5 Large API

    Stable Diffusion, що найкраще слухається промпту

  • Зображення · від 10 Gems

    Stable Diffusion XL API

    SDXL, налаштована на фотореалізм

  • Зображення · від 10 Gems

    Z-Image API

    Найшвидша модель зображень у Mage

  • Зображення · від 20 Gems

    Anima API

    Створено спеціально для аніме

  • Зображення · від 35 Gems

    Chroma API

    З відкритими вагами, на основі Flux

Поширені запитання

Поширені запитання

Скільки коштує Seedream API?
Запит до Seedream із типовими налаштуваннями (Seedream 5.5) коштує 42 Gems, приблизно $0,042. Інші роздільності, тривалість і варіанти змінюють ціну; точну суму списання показано у відповіді. Якщо генерація не вдалася, Gems повертаються; якщо її заблокувала політика вмісту Mage, не повертаються.
Яка кінцева точка Seedream API?
POST https://api.mage.space/v1/seedream/generate із заголовком Authorization: Bearer, що містить ваш ключ Mage API. Відповідь містить status_url, який потрібно опитувати, щоб отримати результат.
Які моделі Seedream можна викликати?
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 5.5.
Чи підтримує Seedream референсні зображення або персонажів?
Seedream приймає image, additional_images. Seedream приймає збережених персонажів і референси за @handle у промпті.
Чи можна користуватися Seedream із Claude або ChatGPT?
Так. Підключіть MCP-сервер Mage до Claude, ChatGPT, Claude Code, Grok або Cursor і просто назвіть Seedream. Ваш асистент зчитає його параметри через get_model і назве ціну ще до генерації.
Як довго зберігаються результати Seedream?
Результати та вхідні дані зберігаються 30 днів. Завантажте все, що хочете залишити, у власне сховище.

Створюй з Mage

Один акаунт, один баланс Gems, усі моделі. Плати лише за те, що генеруєш.

Отримати API-ключСпробувати Seedream у playground