Skip to main content
POST
Seedance 2 Приватные виртуальные аватары
Для пользователей из материкового Китая: используйте https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.
  • Открыт только минимальный пользовательский workflow
  • Загрузка принимает только публичный source_url
  • Для генерации можно использовать только ассеты со status=active
Этот прежний API остается доступным. Для проверки в одной видеозадаче см. проверку материалов по запросу и задайте private_asset_review: true. При использовании старых asset:// пропустите переключатель или задайте false; новый режим отклоняет такие ссылки.

Authorizations

string
обязательно
Все запросы требуют Bearer Token аутентификацию.

Workflow

1. Создание группы ассетов

Вызовите этот интерфейс:
  • POST /v1/videos/doubao-seedance-2-0/private-avatar/groups
Что делает этот интерфейс:
  • Создает новую группу материалов виртуального аватара
  • Возвращает group_id, который понадобится на шаге загрузки

2. Загрузка ассета

Вызовите этот интерфейс:
  • POST /v1/videos/doubao-seedance-2-0/private-avatar/assets
Что делает этот интерфейс:
  • Загружает один материал в выбранную группу
  • Возвращает asset_id
  • Запускает асинхронную обработку
Поддерживаемые asset_type:
  • image
  • video
  • audio
source_url должен быть публичным http/https URL.

3. Проверка статуса ассета

Вызовите этот интерфейс:
  • GET /v1/videos/doubao-seedance-2-0/private-avatar/assets/{asset_id}
Что делает этот интерфейс:
  • Возвращает текущий статус ассета
  • Позволяет понять, готов ли ассет для генерации видео
Выполняйте polling до тех пор, пока status не станет active.

Использование в генерации видео

Вызовите этот интерфейс:
  • POST /v1/videos/generations
Когда материал станет active, используйте asset://<ASSET_ID> в запросе генерации.