Verificação do titular e recursos de retrato
Guia comum APIMaster para verificação, recursos e geração Seedance.
Verificação do titular e recursos de retrato
Utilize a biblioteca unificada para imagens, vídeos e áudio comuns. Crie o grupo apenas com o modelo e o nome, sem channel_id nem purpose. O servidor gere a revisão e as cópias para os modelos de destino.
Importante: celebridades e pessoas não famosas seguem processos diferentes
Apenas as celebridades precisam do endpoint de verificação de pessoas reais para iniciar a prova de vida:
POST /v1/seedance2/private-avatar/verifications.As pessoas não famosas devem enviar os materiais diretamente para análise através de
POST /v1/seedance2/private-avatar/assets. Não utilizem o endpoint de verificação de pessoas reais nem criem uma sessão de prova de vida. O material pode ser referenciado quando o estado forActive.
Os quatro modelos usam as mesmas interfaces APIMaster. O backend adapta endpoints, identificadores e estados do fornecedor. Verificação oficial do titular, revisão de retratos pelo canal e recursos comuns ou virtuais são processos distintos. Use apenas fotografias expressamente autorizadas.
1. Capacidades e âmbito
Para a verificação oficial H5, consulte as capacidades e use um channel_id disponível com o método official_h5. O envio comum para a biblioteca unificada não exige selecionar um canal.
| 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 |
Materiais unificados: criar, guardar e reutilizar
Utilize a biblioteca unificada para imagens, vídeos e áudio comuns. Crie o grupo apenas com o modelo e o nome, sem channel_id nem purpose. O servidor gere a revisão e as cópias para os modelos de destino.
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"}]}'
Guarde group_id (data.id), asset_id e asset_url (a referência asset://). Envie os materiais para revisão e consulte a tarefa, available_models e model_readiness antes de gerar com um modelo pronto. O mesmo ID pode ser reutilizado enquanto estiver disponível; eliminação, expiração ou novas cópias podem exigir um original acessível. A verificação oficial H5 do titular é um processo separado e não é um requisito para a revisão comum.
3. Verificação no telemóvel
Esta secção aplica-se apenas a celebridades. As pessoas não famosas devem ignorar a prova de vida e passar diretamente ao envio e à análise dos materiais.
Para official_h5, crie uma sessão e peça ao titular que abra h5_link no seu telemóvel. APIMaster aloja o callback HTTPS; não é necessário servidor do cliente. Omita callback_url. Chaves permanentes e BytedToken ficam no servidor. O resultado do navegador não basta: o servidor confirma-o com o fornecedor. Callbacks repetidos não criam recursos adicionais.
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. Confirmar o resultado
Após completed use o group_id público. Os estados e prazos abaixo são distintos da duração da autorização do retrato. Erros temporários de rede preservam o estado; não crie sessões automaticamente. A consola encontra-se em /console/seedance-materials. Sessão, grupo, recurso e tarefa de vídeo têm identificadores separados.
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. Enviar e verificar recursos
As pessoas não famosas precisam apenas do endpoint de envio de materiais desta secção; não devem chamar primeiro o de verificação de pessoas reais.
POST /uploads aloja o original; POST /assets envia os materiais para revisão. Os grupos comuns usam unified_virtual. Gere apenas quando o modelo de destino estiver pronto. Novas fotos num grupo oficial real_person continuam a exigir a verificação da mesma pessoa. Os sucessos parciais conservam os materiais aceites. Se o envio não estiver confirmado, guarde os ID originais, consulte o estado e não volte a enviar automaticamente.
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. Gerar e descarregar
Antes de gerar consulte /v1/videos/quote: é uma estimativa, não um teto garantido. O servidor mantém canal, conta e projeto compatíveis. Combinações incompatíveis são rejeitadas. Trocar modelo exige validar os seus próprios limites; novas fotos exigem nova revisão. Depois do sucesso consulte o recibo e descarregue o vídeo.
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. Privacidade e eliminação
Os links assinados são sensíveis: quem os detém pode descarregar durante a validade. Não registe links H5, URLs assinados ou credenciais de callback. Eliminar o original não elimina o recurso do fornecedor. A eliminação remove a associação APIMaster e usa eliminação remota quando suportada; não promete operações remotas indisponíveis. Elimine recursos antes do grupo. Vídeos já gerados não desaparecem automaticamente. Não são guardados modelos biométricos; aprovação não substitui autorização de uso.
| 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. Custos e erros
Verificado em 2026-10-07: a documentação oficial descreve a verificação como temporariamente gratuita. Custos reais de sessão, revisão, envio, armazenamento e gestão dependem do contexto e não estão todos confirmados. Nenhuma compra automática de pacotes. A geração mantém orçamento, reserva, liquidação e reembolso existentes; consulte o recibo real. Os erros distinguem permissões, capacidade indisponível, revisão pendente ou falhada, recursos incompatíveis e resposta incerta do fornecedor. Não é permitido aceder a recursos de outros utilizadores.
| HTTP | context |
|---|---|
| 400 | input / callback |
| 403 | permissions |
| 404 | resource |
| 409 | pending / failed review / incompatible context |
| 429 | rate limit |
| 502 / 503 | uncertain upstream result / unavailable |
Idempotência Seedance e recuperação de envios
Materiais virtuais e recuperação automática
Um grupo virtual sem channel_id permite usar um ID asset:// nos modelos compatíveis. available_models, model_readiness e all_models_ready indicam prontidão. Cada serviço aprova suas próprias cópias. Consulte a revisão; preparar cópias exige um original acessível. Canais explícitos, grupos de materiais existentes e materiais H5 oficiais mantêm suas restrições.
A geração exige Idempotency-Key. Antes da aceitação, a troca só é possível após rejeição explícita por limite de taxa sem ID de tarefa. Uma tarefa aceita encerrada por conta desativada, credencial inválida ou falha de serviço confirmadas pode ser recuperada automaticamente uma única vez se houver serviço compatível. ID público e tarifa do usuário congelada são mantidos, sem segunda reserva de geração. Consulte a tarefa original e o recibo de cobrança.
O destino precisa de cópias compatíveis aprovadas ou concluir revisão independente. Aprovações e verificação H5 oficial não são transferidas entre serviços ou contas. Erros de parâmetros, moderação, direitos autorais, timeout, desconexão e aceitação incerta ficam excluídos. Antes de reenviar manualmente consulte o recibo; nova chave somente com new_submission_safe=true.
