Skip to main content
Эта страница посвящена кодовый путь: преобразуйте локальное изображение в идентификатор актива asset://, затем используйте его для генерации видео с единым образом персонажа — один скрипт, от начала до конца. Для документации по каждому эндпоинту и веб-интерфейса без кода см. Библиотека активов; для полной таблицы параметров эндпоинта генерации см. API генерации видео.Библиотека активов бесплатна в составе Seedance 2.0 API — без ежегодной платы (официально — это отдельно приобретаемая дополнительная опция: годовой контракт на шестизначную сумму в CNY для клиентов без рамочного соглашения).

Когда вам нужны ссылки на активы

При генерации видео с единым образом персонажа Seedance 2.0 не принимает изображения-референсы с фотореалистичными человеческими лицами напрямую (фильтрация против deepfake). Сначала вы должны загрузить портрет как доверенный asset, получить asset://xxx asset ID и указать его в запросе на генерацию — чтобы лицо и одежда персонажа оставались единообразными в разных эпизодах и кадрах. Сначала найдите свой случай:

Предварительные требования

Два разных ключа — не перепутайте их:
  • КЛЮЧ библиотеки ресурсов (создаётся в разделе Settings → КЛЮЧ библиотеки ресурсов на icover.ai, sk-...): для загрузки / добавления / запросов к ресурсам; см. Шаг 0 на странице библиотеки ресурсов.
  • Видеотокен APIYI Seedance (создаётся на api.apiyi.com, sk-..., с включённой группой SeeDance2, общей для версии 2.5 и семейства 2.0): для эндпоинта генерации видео.

Пайплайн в общих чертах

Локальное изображение → 1) presign URL для прямой загрузки и PUT файл, чтобы получить публичный URL → 2) загрузите объект и получите ID объекта → 3) выполняйте опрос, пока Active (около 13 секунд на изображение) → 4) укажите asset://<Id> в запросе на генерацию, называя его «Image 1» в prompt → 5) выполняйте опрос задачи, пока succeeded → 6) скачайте content.video_url (подписанная ссылка истекает через 24 часа — сохраните ее сразу). Если у вас уже есть публичный URL изображения, пропустите шаг 1. ID объектов постоянны — загрузите один раз, используйте в ссылках всегда.

Полный код

Ссылайтесь на ресурсы в prompt как на «Image 1», «Image 2» (в соответствии с их порядком в массиве content) — никогда не указывайте в prompt необработанный ID ресурса.

Расширенное использование с несколькими ресурсами

  • Несколько изображений-референсов: поместите несколько image_url элементов в content (0–9 изображений, каждое с role: "reference_image") и указывайте на них как на «Изображение 1», «Изображение 2» по порядку. Для одного персонажа наилучшую согласованность дает совместное использование полного фронтального снимка в полный рост и нейтрального крупного плана лица анфас.
  • Смешивание источников: asset:// ID, публичные URL и Base64 (data:image/png;base64,...) можно смешивать в одном массиве content — только изображения с фотореалистичными лицами должны проходить через asset://.
  • Видео / аудио-референсы: вы также можете добавить 0–3 video_url элемента (role: "reference_video") и 0–3 audio_url элемента (role: "reference_audio"); требуется как минимум одно изображение или одно видео, а аудио должно отправляться вместе с изображением или видео.
  • Ресурсы реального человека: сначала запустите полностью автоматизированный поток проверки реального человека — актер проходит проверку на живость, и вы получаете отдельную группу ресурсов для реального человека GroupId; передавайте ее как groupId при загрузке. Код на стороне генерации идентичен коду на этой странице.

Распространённые ошибки

Связанные страницы

Обзор Seedance 2.0

Выбор модели, таблицы тарифов и разрешений, а также часто задаваемые вопросы

API генерации видео

Полная таблица параметров, четыре режима генерации и формат ответа

Библиотека ресурсов

Все эндпоинты библиотеки ресурсов, веб-интерфейс без кода и проверка личности реального человека

Рабочий процесс с приоритетом ресурсов

Почему ID ресурса превосходит встроенное изображение по скорости и надёжности, а также как обрабатывать тайм-ауты отправки