HiAPI
Блог

Руководство по использованию

Seedance 2.0@ext короткие видео: практический API-воркфлоу для социальных роликов

С помощью асинхронного task API seedance-2.0@ext превратите подробный промпт в вертикальный ролик со звуком

Aug 10, 2026
Seedance 2.0@ext короткие видео: практический API-воркфлоу для социальных роликов

Сегодня большинство открытий социального контента происходит в коротких видео, а чистый вертикальный ролик обычно означает съёмку, монтаж или и то и другое. seedance-2.0@ext на hiapi пропускает эти шаги: напишите подробный промпт, вызовите одну конечную точку API — и через несколько минут получите готовое видео 9:16 со звуком.

В этом практическом руководстве на примере одного реально сгенерированного ролика разобран весь воркфлоу от начала до конца: как устроен промпт, как на практике используется асинхронный task API, сколько это стоило и где ценовая политика перестаёт соответствовать вашим ожиданиям.

Почему для коротких видео стоит выбрать seedance-2.0@ext

seedance-2.0@ext — это маршрут ext семейства моделей seedance-2.0 на hiapi: отдельный маршрут со своей ценовой политикой и набором параметров, отличный от маршрута seedance-2.0 по умолчанию. Он создан специально для вертикального, социально-нативного вывода: нативная композиция 9:16, движение камеры, которое хорошо смотрится на экране телефона, и аудио, создаваемое в той же генерации, что и видео, а не добавляемое постфактум.

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

Промпт: что на самом деле использовалось для этого ролика

Для этой статьи мы сгенерировали демонстрационный ролик от начала до конца: вертикальный крупный план продукта — холодный кофе, наливаемый в стакан, наполненный льдом, в стиле, ориентированном на социальную ленту. Ниже — фактический результат и исходный промпт, который его создал.

Вертикальный крупный план продукта 9:16 для социальной ленты: матовый стакан по центру на освещённой солнцем мраморной столешнице. Камера медленно наезжает сверху на пустой стакан, который наполняется прозрачными кубиками льда, отражающими свет золотого часа. На второй секунде сверху за кадром наливается струя холодного кофе, закручивается и затемняет лёд, после чего молоко тонкими спиральными струйками проникает внутрь. Капли воды стекают по стеклу, холодный пар поднимается в контровом свете. Камера медленно по дуге переходит от верхнего ракурса к низкому ракурсу в три четверти, завершаясь чётким крупным планом с малой глубиной резкости, где в фоне за окном видны тёплые боке. Яркое естественное коммерческое освещение, глянцевые отражения, малая глубина резкости, сверхчистая эстетика продуктового видео, плавное лёгкое движение ручной камеры, премиальное коммерческое качество. Нативное аудио: мягкое журчание наливания, стук кубиков льда о стекло, лёгкий фоновый шум кафе, без музыки. Без читаемого текста, без логотипов, без людей, без рук, без монтажных склеек.

Результат: 720×1280 (9:16), 24fps, около 8 секунд, встроенное нативное стереоаудио AAC — отдельный процесс фоли не нужен.

Почему этот промпт работает

Этот промпт делает несколько вещей, которые не делают более короткие и расплывчатые промпты:

  • Он задаёт камере путь, а не один кадр. «Наезд сверху» → «медленный переход по дуге к низкому ракурсу в три четверти» → «чёткий крупный план» описывает движение на протяжении всего ролика, а не статичную композицию.
  • Он привязывает действие ко времени. «На второй секунде наливается струя холодного кофе» закрепляет действие наливания за конкретным моментом, а не заставляет модель угадывать, когда должно произойти «интересное».
  • Он накладывает подсказки о материалах и свете. Капли воды, холодный пар, тёплые боке, глянцевые отражения — эти детали переводят продуктовый кадр из обычного в премиальный.
  • Аудио вписано прямо в промпт, а не добавлено постфактум: журчание наливания, стук льда, фоновый шум и явный запрет музыки. Модель синхронизирует звук с визуальными действиями, описанными выше.
  • Он заканчивается негативным списком. «Без читаемого текста, без логотипов, без людей, без рук, без монтажных склеек» заранее отсекает самые распространённые режимы отказа при продуктовой генерации.

Относитесь к промпту как к краткому творческому брифу, а не к подписи к посту — именно здесь и кроется настоящая разница в качестве результата.

Воспроизведение через API /v1/tasks

seedance-2.0@ext работает через асинхронную конечную точку задач hiapi. Вы отправляете задачу, опрашиваете её до завершения, затем извлекаете видео из ответа.

Отправка:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0@ext",
    "input": {
      "prompt": "<your prompt>",
      "aspect_ratio": "9:16",
      "resolution": "720p",
      "duration": 8,
      "generate_audio": true
    }
  }'

prompt и aspect_ratio обязательны — если опустить aspect_ratio, вызов не пройдёт валидацию ещё до начала генерации. resolution, duration (4–15 секунд) и generate_audio необязательны; значения выше близки к конфигурации, использованной для генерации ролика в этой статье.

Если вы пришли из мира «видео из изображения», стоит предупредить: на странице цен для этой модели указаны тарифы «видео из изображения», но фактическая входная схема принимает только текстовые промпты — поля изображений или опорных кадров будут отклонены. Как бы ни назывались ценовые ярлыки, на практике это модель «текст в видео».

Опрос результата:

curl https://api.hiapi.ai/v1/tasks/<task_id> \
  -H "Authorization: Bearer $HIAPI_API_KEY"

Как только status сообщает об успехе, output[0].url указывает на готовый .mp4. Эта ссылка временная — примерно неделя согласно окну истечения в ответе задачи — поэтому сразу скачайте байты и храните их у себя, а не ссылайтесь на них напрямую.

Цены: странность с 4K

seedance-2.0@ext тарифицируется по секундам вывода, ставка зависит от уровня разрешения:

Разрешение Цена за секунду
720p $0.149
1080p $0.373
2K $0.662
4K $0.467

Обратите внимание: на этой модели 4K дешевле 2K — $0.467/сек против $0.662/сек. Это не опечатка и не типичный шаблон; у большинства моделей здесь цена монотонно растёт с разрешением. Не предполагайте, что так же обстоит дело с другими моделями, и перед тем как закладывать логику стоимости на основе разрешения в конвейер, перепроверьте /api/pricing, поскольку такие уровни действительно корректируются.

Для справки: генерация упомянутого выше демонстрационного 8-секундного ролика в 720p стоила $1.19 — простое вычисление длительность × ставка за секунду для уровня 720p.

Выбор разрешения под то, где ролик реально будет показан

Только переход с 720p на 1080p увеличивает стоимость примерно в 2,5 раза, поэтому перед массовой генерацией чего-либо разрешение — тот рычаг, о котором стоит подумать в первую очередь:

  • Показ в лентах и Stories (TikTok, Reels, Shorts) почти всегда происходит на телефоне, где плотность пикселей — лишь малая часть фактической плотности 1080p; 720p там обычно неотличим и является самым дешёвым уровнем.
  • 1080p оправдан, когда ролик может быть повторно использован в hero-блоке лендинга или в платной рекламе, которая может отображаться в размере больше экрана телефона.
  • 2K и 4K подходят для исходного материала, который вы планируете обрезать, масштабировать или стабилизировать на постпродакшене — дополнительное разрешение даёт пространство для перекомпоновки без видимой потери качества. Учитывая таблицу цен выше, на этой конкретной модели 4K — более выгодный из двух вариант.

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

Поддерживает ли seedance-2.0@ext «видео из изображения», а не только «текст в видео»? Нет — хотя на странице цен для этой модели указаны тарифы «видео из изображения», фактическая схема /v1/tasks маршрута ext принимает только текстовые промпты; поля URL изображений, опорных кадров и опорных видео будут отклонены. Пока в списке моделей платформы не указано иное, считайте её моделью только «текст в видео».

Могу ли я управлять длительностью генерируемого ролика? Да, через необязательное поле duration с целым числом от 4 до 15 секунд. Если его опустить, модель применит значение по умолчанию; если нижестоящий шаблон ожидает определённую длину, надёжнее задать её явно.

Будет ли видео автоматически со звуком? Генерация нативного аудио доступна через необязательное поле generate_audio. Опишите желаемое аудио прямо в промпте — как в примере выше: «мягкое журчание наливания, стук кубиков льда о стекло, лёгкий фоновый шум кафе» — и оно синхронизируется с визуальными действиями без отдельного аудиопроцесса.

4K действительно дешевле 2K или это баг отображения? Это фактическая текущая цена на момент написания статьи (август 2026 года), а не баг — но цены на разрешение могут меняться, поэтому перед тем как опираться на это в модели затрат, сверьтесь с /api/pricing.

Сколько действует возвращённый URL видео? output[0].url завершённой задачи — временная ссылка, действующая примерно неделю согласно метаданным истечения задачи. Скачайте и сохраните файл самостоятельно, а не ссылайтесь на него долгосрочно.

Что делать дальше

Полные сведения о параметрах модели и текущих ценах см. на странице модели seedance-2.0@ext и на странице цен hiapi. Чтобы узнать больше шаблонов промптов для той же модели, в материале рецепты промптов Seedance 2.0@ext есть дополнительные примеры, а короткое видео-презентация продукта на основе Seedance 2.0 показывает, как тот же асинхронный task-воркфлоу применяется к другому творческому брифу.

Похожие статьи

Все статьи →

Начните работать с постоянными артефактами ИИ

Получите API-ключ и вызывайте модели изображений, видео и аудио через один API на основе tasks.

Читать документацию API