Как использовать Seedance Private Assets с Seedance API

Workflow Seedance Private Asset Library для переиспользуемых video references
PiAPI
PiAPI

PiAPI теперь поддерживает Seedance Private Asset Library — workflow Seedance API для загрузки переиспользуемых референсов и последующего вызова через asset://<asset_id>.

Библиотека позволяет загружать лицо, персонажа, продукт, сцену, видео или аудио и повторно использовать их в задачах Seedance API. Она подходит для reusable references и consistency персонажей, но не является классическим face swap, inpainting или pixel-perfect редактированием изображений.

Главное

  • Используйте private assets, когда лицо, персонаж, продукт или объект должны появляться в нескольких будущих видео.
  • Используйте raw URL для одноразовых фонов, сцен, props или референсов.
  • Используйте auto_upload_assets: true для временного пользовательского референса в одной задаче.
  • Asset должен получить статус Active перед использованием в Seedance.
  • asset:// работает с seedance-2-less-restriction и seedance-2-fast-less-restriction, но не со strict task types.

Короткий ответ

Seedance private assets нужны для переиспользуемых референсов в Seedance API. Загрузите референс один раз, дождитесь Active, затем используйте его в будущих video tasks через asset://<asset_id>.

Что такое Seedance Private Assets?

Это переиспользуемые файлы, которые приложение загружает в PiAPI до генерации видео. После загрузки PiAPI возвращает asset_id. Когда asset становится Active, запросы Seedance API могут использовать asset://<asset_id>. Подробности endpoint, квот и lifecycle есть в Private Asset Library docs.

Какую проблему они решают?

AI video generation часто испытывает сложности, когда один и тот же объект должен оставаться стабильным в разных prompts, сценах или creative variations. Raw image URL подходит для одной задачи, но неудобен для многократного использования.

Типичные сценарии: сохранять одного человека или персонажа, строить avatar или influencer products, переиспользовать product reference в объявлениях, поддерживать стабильный cast и уменьшать повторные uploads в backend. Для обзора модели начните с Seedance 2.0 API guide.

Чем Private Assets не являются

Seedance Private Asset Library не является face swap, inpainting или точной фотокомпозицией. Seedance использует входные данные как generation references. Результат — видео, направленное референсом, а не точная замена лица или пиксельное редактирование.

Private Assets vs Raw URL vs Auto-Upload

ПаттернЛучше всего дляПримерКогда использовать
Managed private assetПовторяющиеся люди, персонажи, продукты или объектыasset://asset-123Когда один референс нужен в нескольких задачах.
Raw URLОдноразовый фон, сцена или prophttps://your-cdn.com/scene.jpgКогда референс важен только сейчас.
Auto-uploaded ephemeral assetВременные пользовательские референсыURL + auto_upload_assets: trueКогда PiAPI должен временно ingest файл.

Правило простое: если референс будет использоваться снова, сделайте private asset; если только один раз — используйте raw URL или auto-upload.

Workflow

  1. Загрузите reusable reference.
  2. Дождитесь статуса Active.
  3. Отправьте Seedance task с asset://<asset_id> в image_urls, video_urls или audio_urls.
  4. В prompt используйте Image 1, Image 2, Video 1 или Audio 1 по порядку inputs.
  5. Poll задачу до завершения видео.
{
  "image_urls": ["asset://asset-person-reference", "https://your-cdn.com/scenic-background.jpg"],
  "prompt": "Image 1 is the person reference. Image 2 is the scenic background. Generate a cinematic 5-second video."
}

API пример

Загрузите референс через https://api.piapi.ai/api/v1/asset/upload, проверьте статус через asset list endpoint и после Active используйте asset://<asset_id> в задаче seedance-2-less-restriction или seedance-2-fast-less-restriction. Strict варианты seedance-2 и seedance-2-fast не поддерживают private asset references.

Best practices

  • Используйте private assets для повторяющихся лиц, главных персонажей, продуктов или brand subjects.
  • Одноразовые фоны оставляйте raw URL.
  • Четко подписывайте inputs в prompt: Image 1, Image 2.
  • Ждите Active перед генерацией.
  • Планируйте квоты, TTL и согласие на использование пользовательских референсов.

FAQ

Что такое Seedance private asset?

Это переиспользуемый референс, загруженный в PiAPI для Seedance video generation. После Active он используется через asset://<asset_id>.

Можно ли переиспользовать фото лица?

Да, как reference-guided generation. Это не гарантирует точный face swap.

Итог

Seedance Private Asset Library дает разработчикам более чистый способ строить reusable reference workflows с Seedance API. Загрузите референс, подтвердите Active, затем отправьте less-restriction task с asset, prompt и одноразовыми raw URLs. Тестировать можно в Seedance workspace.

More Stories

What Is Seedance 2.5? ByteDance's AI Video Model Explained

June 25, 2026

Learn what Seedance 2.5 is, what the new model adds, whether the Seedance 2.5 API is available, and how to prepare with PiAPI.

PiAPI
PiAPI

How to Create a Korean Baseball AI Trend Video From Your Photo

June 17, 2026

Use an AI sports video generator to turn a photo into a Korean baseball-style image, review it, then animate it into an AI baseball trend video.

PiAPI
PiAPI