APIMaster.ai

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 for Active.

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.