Проверка владельца и портретные материалы
Общее руководство APIMaster по проверке, материалам и генерации Seedance.
Проверка владельца и портретные материалы
Для обычных изображений, видео и аудио используйте единую библиотеку материалов. При создании группы передавайте только модель и название, без channel_id и purpose. Сервер управляет проверкой и копиями для целевых моделей.
Важно: знаменитости и обычные люди используют разные процессы
Только знаменитостям нужен интерфейс проверки реального человека для запуска проверки живого присутствия:
POST /v1/seedance2/private-avatar/verifications.Обычные люди отправляют материалы непосредственно на проверку через
POST /v1/seedance2/private-avatar/assets. Не используйте интерфейс проверки реального человека и не создавайте сессию проверки живого присутствия. Материал можно использовать по ссылке после получения статусаActive.
Все четыре модели используют общие интерфейсы APIMaster. Сервер сопоставляет интерфейсы, идентификаторы и статусы поставщика. Официальная проверка личности, проверка портретных материалов каналом и обычные или виртуальные материалы — разные процессы. Используйте только фотографии с явным разрешением.
1. Возможности и область применения
Для отдельного процесса официальной проверки H5 запросите возможности и используйте доступный channel_id с методом official_h5. При обычной отправке в единую библиотеку выбирать канал не нужно.
| model | duration | Image | Video | Audio |
|---|---|---|---|---|
| seedance-2.0 | 4–15 s | ≤9 | ≤3 / ≤15 s | ≤3 / ≤15 s |
| seedance-2.0-fast | 4–15 s | ≤9 | ≤3 / ≤15 s | ≤3 / ≤15 s |
| seedance-2.0-mini | 4–15 s | ≤9 | ≤3 / ≤15 s | ≤3 / ≤15 s |
| seedance-2.5 | 4–30 s / -1 | ≤30 | ≤10 / ≤30 s | ≤10 / ≤30 s |
Единые материалы: создание, сохранение и повторное использование
Для обычных изображений, видео и аудио используйте единую библиотеку материалов. При создании группы передавайте только модель и название, без channel_id и purpose. Сервер управляет проверкой и копиями для целевых моделей.
export APIMASTER_KEY='<your APIMaster key>'
curl --fail-with-body 'https://apimaster.ai/v1/seedance2/private-avatar/groups' \
-H "Authorization: Bearer $APIMASTER_KEY" -H 'Content-Type: application/json' \
-d '{"model":"seedance-2.5","name":"My materials"}'
asset_type: Image / Video / Audio.
curl --fail-with-body 'https://apimaster.ai/v1/seedance2/private-avatar/assets' \
-H "Authorization: Bearer $APIMASTER_KEY" -H 'Content-Type: application/json' \
-H 'Idempotency-Key: unified-audio-001' \
-d '{"model":"seedance-2.5","group_id":"group_PUBLIC_ID","asset_type":"Audio","assets":[{"url":"https://your-storage.example/audio.mp3","name":"Reference audio"}]}'
Сохраните полученные group_id (data.id), asset_id и asset_url (ссылку asset://). Отправьте материалы на проверку и запросите задачу, available_models и model_readiness. Генерируйте после готовности целевой модели. Один ID можно использовать повторно, пока материал доступен; удаление, истечение срока или создание новых копий могут потребовать доступного оригинала. Официальная H5-проверка владельца является отдельным процессом и не нужна перед обычной проверкой материалов.
3. Проверка на телефоне
Этот раздел предназначен только для знаменитостей. Обычным людям следует пропустить проверку живого присутствия и сразу перейти к отправке и проверке материалов.
Для official_h5 создайте сеанс; владелец открывает h5_link на своём телефоне. APIMaster принимает HTTPS-callback, собственный сервер клиенту не нужен. Не передавайте callback_url. Постоянные ключи и BytedToken остаются на сервере. Результата браузера недостаточно: сервер подтверждает его у поставщика. Повторные callback не создают дополнительные ресурсы.
export APIMASTER_KEY='<your APIMaster key>'
export APIMASTER_CHANNEL_ID='<available channel ID from the capability API>'
curl --fail-with-body 'https://apimaster.ai/v1/seedance2/private-avatar/capabilities?model=seedance-2.5' -H "Authorization: Bearer $APIMASTER_KEY"
curl --fail-with-body 'https://apimaster.ai/v1/seedance2/private-avatar/verifications' \
-H "Authorization: Bearer $APIMASTER_KEY" -H 'Content-Type: application/json' \
-H 'Idempotency-Key: portrait-session-001' \
-d "{\"model\":\"seedance-2.5\",\"channel_id\":${APIMASTER_CHANNEL_ID},\"name\":\"My portrait\"}"
4. Подтверждение результата
После completed используйте публичный group_id. Приведённые ниже сроки и статусы не определяют срок разрешения на использование портрета. Временная сетевая ошибка сохраняет статус; не создавайте новые сеансы автоматически. Консоль: /console/seedance-materials. У сеанса, группы, материала и видеозадачи отдельные идентификаторы.
curl --fail-with-body 'https://apimaster.ai/v1/seedance2/private-avatar/verifications/verification_PUBLIC_ID' -H "Authorization: Bearer $APIMASTER_KEY"
| API | fields / values |
|---|---|
| capabilities | model, channel_id, method, configured, reason, hosted_callback, real_person_verified |
| verification | session_id (id), method, status, h5_link (verification_url), created_at, expires_at, group_id |
| verification.status | creating, pending, completed, failed, expired, failed_unconfirmed, submission_unknown |
| Idempotency-Key | 8–128; same request → original receipt; changed request → 409 |
| verification rate | ≤3 / user / minute; upstream limits also apply |
| H5 / BytedToken | single-use H5; query credential ≤30 min; expires_at ≠ portrait authorization expiry |
5. Загрузка и проверка материалов
Обычным людям достаточно интерфейса отправки материалов из этого раздела; предварительно вызывать интерфейс проверки реального человека не нужно.
POST /uploads хранит оригинал, а POST /assets отправляет материалы на проверку. Обычные группы имеют тип unified_virtual. Генерируйте только после готовности целевой модели; новые фотографии в официальной группе real_person по-прежнему проверяются на соответствие человеку. Частичный успех сохраняет принятые материалы. Если отправка не подтверждена, сохраните исходные ID задачи и материалов, запросите статус и не загружайте файл повторно автоматически.
curl --fail-with-body 'https://apimaster.ai/v1/seedance2/private-avatar/uploads' \
-H "Authorization: Bearer $APIMASTER_KEY" -F 'file=@authorized-owner.png'
curl --fail-with-body 'https://apimaster.ai/v1/seedance2/private-avatar/assets' \
-H "Authorization: Bearer $APIMASTER_KEY" -H 'Content-Type: application/json' \
-H 'Idempotency-Key: portrait-asset-001' \
-d '{"model":"seedance-2.5","group_id":"group_PUBLIC_ID","asset_type":"Image","assets":[{"url":"<signed upload URL>","name":"Owner"}]}'
curl --fail-with-body 'https://apimaster.ai/v1/tasks/asset_task_PUBLIC_ID' -H "Authorization: Bearer $APIMASTER_KEY"
curl --fail-with-body 'https://apimaster.ai/v1/seedance2/private-avatar/assets?group_id=group_PUBLIC_ID' -H "Authorization: Bearer $APIMASTER_KEY"
curl --fail-with-body 'https://apimaster.ai/v1/seedance2/private-avatar/assets/asset_PUBLIC_ID' -H "Authorization: Bearer $APIMASTER_KEY"
| API | fields / values |
|---|---|
| uploads | JPEG / PNG ≤10 MB; upload_id, url, url_expires_at, delete_after |
| groups | public id; group_type=unified_virtual / real_person |
| assets | public asset_id; status=Pending / Processing / Active / Failed / SubmissionUnknown |
| review task | asset_task_*; GET /v1/tasks/{id} |
6. Генерация и скачивание
Перед генерацией запросите /v1/videos/quote: оценка не гарантирует верхний предел оплаты. Сервер сохраняет совместимые канал, аккаунт и проект. Несовместимые сочетания отклоняются. При смене модели проверяются её собственные ограничения; новые фотографии требуют новой проверки. После успеха запросите расчёт и скачайте видео.
curl --fail-with-body 'https://apimaster.ai/v1/videos' \
-H "Authorization: Bearer $APIMASTER_KEY" -H 'Content-Type: application/json' \
-H 'Idempotency-Key: portrait-video-001' \
-d '{"model":"seedance-2.5","prompt":"The person smiles naturally","image_urls":["asset://asset_PUBLIC_ID"],"resolution":"480p","duration":4,"generate_audio":false}'
curl --fail-with-body 'https://apimaster.ai/v1/seedance2/private-avatar/video-requests/video_request_PUBLIC_ID' -H "Authorization: Bearer $APIMASTER_KEY"
curl --fail-with-body 'https://apimaster.ai/v1/videos/task_PUBLIC_ID' -H "Authorization: Bearer $APIMASTER_KEY"
curl --fail-with-body 'https://apimaster.ai/v1/videos/task_PUBLIC_ID/billing' -H "Authorization: Bearer $APIMASTER_KEY"
curl --fail-with-body 'https://apimaster.ai/v1/videos/task_PUBLIC_ID/content' -H "Authorization: Bearer $APIMASTER_KEY" -o owner.mp4
| API | fields / values |
|---|---|
| generation | Idempotency-Key required; no automatic POST retry |
| receipt | video_request_*; X-Seedance-Request-Id; replay → 202 + original receipt |
| video task | task_*; separate from receipt, verification and asset IDs |
7. Конфиденциальность и удаление
Подписанные ссылки конфиденциальны: их обладатель может скачать файл в пределах срока действия. Не записывайте H5-ссылки, подписанные URL и данные callback в журналы. Удаление оригинала не удаляет ресурс поставщика. Удаление ресурса удаляет привязку APIMaster и вызывает удаление у поставщика, если оно доступно; неподдерживаемое удалённое удаление не обещается. Сначала удаляйте материалы, затем группу. Готовые видео не исчезают автоматически. Биометрические шаблоны не сохраняются; одобрение не заменяет разрешение на использование.
| API / storage | values |
|---|---|
| signed original URL | 1 h |
| hosted original | access ≤24 h; deletion ≤25 h |
| DELETE /uploads/{upload_id} | hosted original |
| DELETE /assets/{asset_id} | APIMaster mapping; upstream deletion if supported |
| DELETE /groups/{group_id} | empty group |
8. Стоимость и ошибки
Проверено 2026-10-07: официальная документация описывает проверку как временно бесплатную. Реальные расходы на сеанс, проверку, загрузку, хранение и управление зависят от контекста и подтверждены не полностью. Автоматической покупки пакетов нет. Генерация использует существующие оценку, резервирование, расчёт и возврат; проверяйте фактическую квитанцию. Ошибки различают права, неподдерживаемую возможность, ожидающую или неудачную проверку, несовместимые ресурсы и неопределённый ответ поставщика. Доступ к ресурсам других пользователей запрещён.
| HTTP | context |
|---|---|
| 400 | input / callback |
| 403 | permissions |
| 404 | resource |
| 409 | pending / failed review / incompatible context |
| 429 | rate limit |
| 502 / 503 | uncertain upstream result / unavailable |
Идемпотентность Seedance и восстановление отправок
Виртуальные материалы и автоматическое восстановление
Виртуальная группа без channel_id позволяет использовать один ID asset:// для совместимых моделей. available_models, model_readiness, all_models_ready показывают готовность. Каждый сервис проверяет копии независимо. Опрашивайте задачу проверки; для новых копий нужен доступный оригинал. Явный выбор канала, существующие группы материалов и официальные H5-материалы сохраняют свои ограничения.
Генерация требует Idempotency-Key. До принятия переключение возможно только после явного отказа из-за ограничения частоты без ID задачи. Принятая задача, завершившаяся подтверждённой блокировкой аккаунта, недействительными учётными данными или сбоем сервиса, может восстановиться автоматически не более одного раза при наличии совместимого сервиса. Публичный ID и зафиксированный пользовательский тариф сохраняются, повторного резервирования оплаты нет. Проверяйте исходную задачу и платёжную квитанцию.
Целевому сервису нужны совместимые одобренные копии либо независимая проверка материалов. Одобрение и официальная H5-верификация не переносятся между сервисами или аккаунтами. Ошибки параметров, модерации, авторских прав, тайм-ауты, обрывы связи и неопределённое принятие исключены. Перед ручной повторной отправкой проверьте квитанцию; новый ключ допустим только при new_submission_safe=true.
