APIMaster.ai

Vérification du titulaire et ressources de portrait

Guide commun APIMaster pour la vérification, les ressources et la génération Seedance.

Vérification du titulaire et ressources de portrait

Utilisez la bibliothèque unifiée pour les images, vidéos et fichiers audio ordinaires. Créez le groupe avec le modèle et le nom uniquement, sans channel_id ni purpose. Le serveur gère la vérification et les copies pour les modèles cibles.

Important : les célébrités et les personnes non célèbres suivent des parcours différents

Seules les célébrités doivent utiliser le point de terminaison de vérification des personnes réelles pour lancer la vérification de présence : POST /v1/seedance2/private-avatar/verifications.

Les personnes non célèbres soumettent directement leurs ressources à la vérification via POST /v1/seedance2/private-avatar/assets. N’utilisez pas le point de terminaison de vérification des personnes réelles et ne créez pas de session de vérification de présence. La ressource peut être référencée dès que son statut est Active.

Les quatre modèles utilisent les mêmes interfaces APIMaster. Le serveur adapte les interfaces, identifiants et états des fournisseurs. La vérification officielle du titulaire, la validation de portraits par une filière et les ressources ordinaires ou virtuelles restent distinctes. Utilisez uniquement des photos expressément autorisées.

1. Capacités et portée

Pour la vérification officielle H5, consultez les capacités et utilisez un channel_id disponible avec la méthode official_h5. L’envoi ordinaire dans la bibliothèque unifiée ne nécessite pas de choisir un 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

Matériaux unifiés : créer, conserver et réutiliser

Utilisez la bibliothèque unifiée pour les images, vidéos et fichiers audio ordinaires. Créez le groupe avec le modèle et le nom uniquement, sans channel_id ni purpose. Le serveur gère la vérification et les copies pour les modèles cibles.

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"}]}'

Conservez group_id (data.id), asset_id et asset_url (la référence asset://). Soumettez les matériaux à la vérification, puis consultez la tâche, available_models et model_readiness avant de générer avec un modèle prêt. Le même identifiant reste réutilisable tant que le matériau est disponible ; une suppression, une expiration ou de nouvelles copies peuvent nécessiter un original accessible. La vérification officielle H5 du propriétaire est distincte et ne précède pas obligatoirement la vérification ordinaire.

3. Vérification sur téléphone

Cette section concerne uniquement les célébrités. Les personnes non célèbres doivent passer directement à la soumission et à la vérification des ressources, sans vérification de présence.

Pour official_h5, créez une session puis ouvrez le h5_link sur le téléphone du titulaire. APIMaster héberge le rappel HTTPS : aucun serveur de rappel client n’est nécessaire. Omettez callback_url. Les clés durables et BytedToken restent sur le serveur. Le résultat du navigateur seul ne suffit pas : le serveur confirme le résultat auprès du fournisseur. Les rappels répétés ne créent pas de nouvelles ressources.

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. Confirmer le résultat

Après completed, utilisez le group_id public. Les états et délais ci-dessous sont distincts de la durée d’autorisation du portrait. Une erreur réseau temporaire conserve l’état ; n’ouvrez pas automatiquement une nouvelle session. Consultez aussi /console/seedance-materials. Une session, un groupe, une ressource et une tâche vidéo ont des identifiants distincts.

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. Importer et vérifier les ressources

Les personnes non célèbres utilisent uniquement le point de terminaison de soumission des ressources présenté ici, sans appeler d’abord celui de vérification des personnes réelles.

POST /uploads héberge l’original ; POST /assets soumet les matériaux à la vérification. Les groupes ordinaires utilisent unified_virtual. Générez seulement lorsque le modèle cible est prêt. Les nouvelles photos d’un groupe officiel real_person nécessitent toujours une vérification de la même personne. Les succès partiels conservent les matériaux acceptés. Si la soumission reste incertaine, conservez les identifiants initiaux, consultez leur statut et ne relancez pas automatiquement le téléversement.

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. Générer et télécharger

Obtenez une estimation avec /v1/videos/quote avant de générer. Elle ne garantit pas un plafond de facturation. Le serveur conserve la filière, le compte et le projet compatibles avec les ressources. Les combinaisons incompatibles sont refusées. Le changement de modèle exige le contrôle de ses propres limites ; les nouvelles photos exigent une nouvelle validation. Après succès, consultez le reçu et téléchargez la vidéo.

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. Confidentialité et suppression

Les liens signés sont sensibles : toute personne les détenant peut télécharger le fichier pendant leur validité. Ne journalisez pas les liens H5, les URL signées ou les identifiants de rappel. La suppression du fichier hébergé ne supprime pas la ressource fournisseur. La suppression d’une ressource retire son association APIMaster et utilise la suppression fournisseur si disponible ; aucune suppression distante non prise en charge n’est promise. Supprimez les ressources avant le groupe. Les vidéos déjà produites ne disparaissent pas automatiquement. Aucun modèle biométrique n’est conservé ; validation et autorisation d’usage sont distinctes.

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. Coûts et erreurs

Vérifié le 2026-10-07 : la documentation officielle décrit la vérification comme temporairement gratuite. Les frais réels de session, validation, import, stockage et gestion dépendent du contexte et ne sont pas tous confirmés. Aucun achat de droits n’est automatique. La génération utilise les mécanismes existants de devis, réservation, règlement et remboursement ; consultez le reçu réel. Les erreurs distinguent permissions, capacité indisponible, validation en attente ou échouée, ressource incompatible et réponse fournisseur incertaine. Aucun accès interutilisateur n’est autorisé.

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 : idempotence et récupération des soumissions

Matériaux virtuels et récupération automatique

Un groupe virtuel sans channel_id permet une référence asset:// commune aux modèles compatibles. available_models, model_readiness et all_models_ready indiquent la disponibilité. Chaque service valide indépendamment les copies. Interrogez la tâche de validation ; les copies manquantes nécessitent un original accessible. Les canaux explicites, les usages groupes de matériaux existants et les éléments H5 officiels conservent leurs restrictions.

La génération exige Idempotency-Key. Avant acceptation, un basculement est possible uniquement après un refus explicite de limitation sans identifiant de tâche. Une tâche acceptée terminée pour compte désactivé, identifiants invalides ou panne de service confirmés peut être récupérée automatiquement une seule fois si un service compatible est disponible. Identifiant public et tarif utilisateur figé sont conservés, sans seconde réservation de génération. Consultez la tâche initiale et son reçu de facturation.

Le service cible doit disposer de copies compatibles approuvées ou effectuer sa propre validation. Les validations et la vérification H5 officielle ne sont pas transférables entre services ou comptes. Erreurs de paramètres, modération, droits, délais dépassés, déconnexions et acceptation incertaine sont exclus. Avant une nouvelle soumission manuelle, consultez le reçu ; nouvelle clé uniquement avec new_submission_safe=true.