APIMaster.ai

Проверка владельца и портретные материалы

Общее руководство 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.