Руководство по API Seedream 5.0 Lite: генерация изображений по тексту и редактирование изображений

Краткое содержание

• Seedream 5.0 Lite — это модель изображений от ByteDance. На HiAPI у неё два эндпоинта: seedream-5.0-lite/text-to-image и seedream-5.0-lite/image-to-image, оба стоят $0.035 за изображение, 2K и 4K по одной цене.
• Она хорошо справляется с точной передачей текста на изображении, а также с точечным редактированием: изменение одного объекта, замена текста на вывеске или композиция до 14 референсных изображений, при этом остальная часть сцены остаётся неизменной.
• При каждом вызове необходимо указывать aspect_ratio и resolution. Откройте страницу модели генерации по тексту, чтобы попробовать; новым аккаунтам предоставляется 200 бесплатных кредитов.

Генерация по тексту или по изображению

	Генерация по тексту	Генерация по изображению
ID модели	seedream-5.0-lite/text-to-image	seedream-5.0-lite/image-to-image
Обязательные поля	prompt, aspect_ratio, resolution	то же самое плюс image_urls (1–14)
Цена	$0.035 за изображение	$0.035 за изображение, независимо от количества референсных изображений
Сценарии использования	Плакаты, меню, упаковка, инфографика	Изменение цвета, замена текста, композиция продукта в сцене

Актуальные цены HiAPI, проверено 19 октября 2026 г. Неудачные задачи не оплачиваются.

4K и 2K стоят одинаково, поэтому если нужен печатный размер, сразу запрашивайте 4K. За $1 можно сгенерировать около 28 изображений.

Генерация по тексту: точная передача текста

Заключите каждое слово, которое нужно отрисовать, в кавычки и укажите позицию для каждой строки:

Плакат в стиле ручной ризографии для вымышленного фестиваля ночной уличной еды, крупный китайский каллиграфический заголовок «夜市食堂» вверху, английский подзаголовок «NIGHT MARKET CANTEEN» сразу под ним узким шрифтом без засечек, строка с датой «OCT 17-19 · RIVERSIDE PIER» внизу, тёплое свечение фонарей над многолюдными лотками с едой, пар поднимается из бамбуковых корзин, ограниченная палитра из киновари, кремового и чернильно-синего, заметное зерно печати, винтажная композиция плаката

Сгенерировать этот плакат →

seedream-5.0-lite/text-to-image, 2K, $0.035.

Китайский заголовок, английский подзаголовок и строка с датой отображаются так, как написаны. Та же схема подходит для меню-досок, ценников и упаковки; держите текст в пределах примерно шести строк. Ещё пять схем (включая меню с правильными ценами) см. в статье Рецепты промптов Seedream 5.0 Lite.

Генерация по изображению: меняем только одно, остальное сохраняем

Схема: одним предложением опишите изменение, затем перечислите всё, что должно остаться неизменным.

Локальная смена цвета. Исходное изображение:

Измените эту матовую белую керамическую чашку на чашку глубокого кобальтово-синего цвета с глянцевой глазурью и блестящими отблесками, сохранив пар, дубовый стол, открытый блокнот, ручку, суккулент, освещение и ракурс камеры полностью неизменными, фотореализм

seedream-5.0-lite/image-to-image, одно референсное изображение, 3:2, 2K, $0.035.

Замена текста на вывеске.

Замените текст на деревянной вывеске над дверью на «BAKERY CORNER», сохранив тот же стиль золотого шрифта с засечками и размер шрифта, оставив форму вывески и текстуру дерева, кирпичный фасад, светящиеся окна, оливу и пасмурное освещение полностью неизменными, фотореализм

seedream-5.0-lite/image-to-image, одно референсное изображение, 3:2, 2K, $0.035.

Композиция из двух изображений. Ссылайтесь на изображения в порядке их следования в image_urls:

Возьмите кожаный рюкзак с первого изображения и поместите его на плоский гранитный валун в сцене лагеря со второго изображения, естественно прислонив под небольшим углом, переосветите, чтобы он соответствовал тёплому солнечному свету золотого часа, и добавьте мягкую тень на камне, оставив каменное кострище, сосновый лес и горные вершины неизменными, фотореалистичная композиция

seedream-5.0-lite/image-to-image, два референсных изображения, 3:2, 2K, $0.035.

Устанавливайте aspect_ratio в соответствии с входным изображением. Если запросить другую форму кадра, часть эффекта редактирования будет потеряна из-за повторного кадрирования.

curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0-lite/text-to-image",
    "input": {
      "prompt": "A cafe chalkboard menu listing exactly three items: '\''FLAT WHITE 4.50'\'', '\''COLD BREW 5.00'\'', '\''CROISSANT 3.80'\''",
      "aspect_ratio": "3:4",
      "resolution": "2K"
    }
  }'

Вы получите taskId. Опрашивайте GET https://api.hiapi.ai/v1/tasks/{taskId}, пока data.status не станет success, затем скачайте data.output[0].url. Ссылки истекают, сохраняйте файл сразу.

Для редактирования измените модель на seedream-5.0-lite/image-to-image и добавьте "image_urls": ["https://your-cdn.example.com/input.jpg"].

Python: сначала генерация, затем редактирование

# pip install requests; export HIAPI_KEY=your-key first
import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(model, timeout_s=300, **inp):
    body = {"model": model, "input": inp}
    # Reuse the same Idempotency-Key if you retry a submit, so a retry never bills twice
    r = requests.post(API, json=body, headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)  # 400s list every invalid field
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(5)
    raise TimeoutError(task_id)

# Generate a packshot
shot = generate("seedream-5.0-lite/text-to-image",
                prompt="Studio photo of a matte-black tea tin labeled 'HILLFOG' on slate, no other text",
                aspect_ratio="1:1", resolution="2K")

# Then make a colorway from it; the generated URL works as a reference
green = generate("seedream-5.0-lite/image-to-image",
                 prompt="Recolor the tin to deep forest green, keep the label, slate and lighting unchanged",
                 image_urls=[shot], aspect_ratio="1:1", resolution="2K")

with open("green.jpg", "wb") as f:
    f.write(requests.get(green).content)

Если результаты понадобятся позже, скачивайте каждый сразу после готовности; ссылки на выходные файлы истекают.

Параметры

Поле	Обязательно	Значения	Описание
prompt	Да	4–3 000 символов	Заключайте текст, который нужно отрисовать, в кавычки
aspect_ratio	Да	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9	При редактировании совпадает с входным изображением
resolution	Да	2K, 4K	Заглавными буквами; цена одинаковая
image_urls	Только для генерации по изображению	1–14 URL	jpeg, png или webp, максимум 10 МБ каждое

Параметров seed, negative_prompt или output_format нет.

Частые ошибки

Все перечисленные ошибки возвращаются при отправке с HTTP 400, поэтому задача не создаётся и оплата не взимается:

• aspect_ratio: missing required field / resolution: missing required field: оба поля обязательны, хотя в документации указаны значения по умолчанию.
• resolution: value must be one of '2K', '4K': варианта 1K нет. Используйте заглавные буквы.
• image_urls: maxItems: got 15, want 14: максимум 14 референсных изображений.
• prompt: minLength: got 2, want 4: промпт должен содержать не менее 4 символов.
• additional properties 'output_format' not allowed: в Lite такого поля нет.

Lite, Flash или Pro?

Модель	Цена за изображение	Сценарии использования
Seedream 5.0 Flash	$0.025	Когда важнее всего пакетная обработка и скорость
Seedream 5.0 Lite	$0.035 для 2K или 4K	Текст на изображении, точное редактирование, 4K без доплаты
Seedream 5.0 Pro	$0.05 (1K) / $0.10 (2K)	Финальные материалы требуют максимальной детализации

Сравнительное тестирование двух более дешёвых уровней с одинаковыми промптами см. в статье Сравнение Seedream 5.0 Flash и Lite. Полные цены см. в статье Цены API Seedream 5.0.

Частые вопросы

Взимается ли дополнительная плата за каждое референсное изображение?

Нет. Генерация по изображению стоит $0.035 за изображение независимо от того, отправляете вы 1 или 14 референсных изображений.

Может ли она отрисовывать китайский текст?

Да. Плакат выше содержит одновременно китайский заголовок и английский подзаголовок в одном изображении. Достаточно заключить каждую строку в кавычки и указать позицию.

Сохранит ли она мой продукт полностью неизменным?

Она сохраняет то, что вы явно указали. Перечислите все элементы, которые должны остаться неизменными (форма, этикетка, освещение, ракурс камеры); всё, что не упомянуто, может измениться.

Выбрать 2K или 4K?

Цена одинаковая. У 2K длинная сторона около 2 300 px, у 4K — около 4 096 px. Файлы 2K меньше и удобнее для просмотра при итерациях; для печати переключайтесь на 4K.