Verifica del titolare e risorse ritratto
Guida condivisa APIMaster per verifica, risorse e generazione Seedance.
Verifica del titolare e risorse ritratto
Usa la libreria unificata per immagini, video e audio ordinari. Crea il gruppo specificando solo modello e nome, senza channel_id e purpose. Il server gestisce verifica e copie per i modelli di destinazione.
Importante: celebrità e persone non famose seguono procedure diverse
Solo le celebrità devono usare l’endpoint di verifica delle persone reali per avviare la verifica di presenza:
POST /v1/seedance2/private-avatar/verifications.Le persone non famose inviano direttamente i materiali per la revisione tramite
POST /v1/seedance2/private-avatar/assets. Non usate l’endpoint di verifica delle persone reali e non create una sessione di verifica di presenza. Il materiale può essere utilizzato come riferimento quando lo stato èActive.
I quattro modelli usano le stesse interfacce APIMaster. Il backend adatta endpoint, identificatori e stati del fornitore. Verifica ufficiale del titolare, revisione dei ritratti del canale e risorse ordinarie o virtuali sono processi distinti. Usare solo foto espressamente autorizzate.
1. Capacità e ambito
Per la verifica ufficiale H5, consulta le capacità e usa un channel_id disponibile con il metodo official_h5. L’invio ordinario alla libreria unificata non richiede la selezione di un canale.
| 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 |
Materiali unificati: creare, salvare e riutilizzare
Usa la libreria unificata per immagini, video e audio ordinari. Crea il gruppo specificando solo modello e nome, senza channel_id e purpose. Il server gestisce verifica e copie per i modelli di destinazione.
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"}]}'
Salva group_id (data.id), asset_id e asset_url (il riferimento asset://). Invia i materiali alla verifica e consulta attività, available_models e model_readiness prima di generare con un modello pronto. Lo stesso ID può essere riutilizzato finché resta disponibile; eliminazione, scadenza o nuove copie possono richiedere un originale accessibile. La verifica ufficiale H5 del titolare è separata e non è necessaria per la verifica ordinaria dei materiali.
3. Verifica sul telefono
Questa sezione riguarda solo le celebrità. Le persone non famose saltano la verifica di presenza e passano direttamente all’invio e alla revisione dei materiali.
Per official_h5 creare una sessione e far aprire h5_link al titolare sul proprio telefono. APIMaster ospita il callback HTTPS: non serve un server del cliente. Omettere callback_url. Le chiavi permanenti e BytedToken restano sul server. Il risultato del browser non basta: il server lo conferma presso il fornitore. Callback ripetuti non creano nuove risorse.
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. Confermare il risultato
Dopo completed usare il group_id pubblico. Stati e scadenze sotto non indicano la durata del consenso sul ritratto. Errori temporanei di rete mantengono lo stato; non creare automaticamente altre sessioni. La console è /console/seedance-materials. Sessione, gruppo, risorsa e attività video hanno identificatori distinti.
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. Caricare e verificare risorse
Le persone non famose devono usare solo l’endpoint di invio dei materiali di questa sezione, senza chiamare prima quello di verifica delle persone reali.
POST /uploads ospita l’originale; POST /assets invia i materiali alla verifica. I gruppi ordinari usano unified_virtual. Genera solo quando il modello di destinazione è pronto. Le nuove foto in un gruppo ufficiale real_person richiedono ancora la verifica della stessa persona. I successi parziali mantengono i materiali accettati. Se l’invio non è confermato, conserva gli ID originali, consulta lo stato e non caricare di nuovo 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. Generare e scaricare
Prima di generare chiamare /v1/videos/quote: la stima non garantisce un tetto massimo. Il server mantiene canale, account e progetto compatibili. Combinazioni incompatibili sono rifiutate. Cambiare modello richiede i controlli dei suoi limiti; nuove foto richiedono nuova revisione. Dopo successo consultare la ricevuta e scaricare il video.
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. Privacy ed eliminazione
I link firmati sono sensibili: chi li possiede può scaricare durante la validità. Non registrare link H5, URL firmati o credenziali callback. Eliminare l’originale non elimina la risorsa del fornitore. L’eliminazione rimuove la mappatura APIMaster e usa l’eliminazione remota dove supportata; nessuna operazione remota indisponibile è promessa. Eliminare risorse prima del gruppo. I video già generati non spariscono automaticamente. Nessun modello biometrico viene conservato; revisione e autorizzazione d’uso sono distinte.
| 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. Costi ed errori
Verificato il 2026-10-07: la documentazione ufficiale descrive la verifica come temporaneamente gratuita. I costi effettivi di sessione, revisione, upload, archiviazione e gestione dipendono dal contesto e non sono tutti confermati. Nessun acquisto automatico di pacchetti. La generazione conserva preventivo, prenotazione, liquidazione e rimborso esistenti; verificare la ricevuta reale. Gli errori distinguono permessi, capacità indisponibile, revisione in attesa o fallita, risorse incompatibili e risposta incerta del fornitore. L’accesso ai dati altrui è vietato.
| HTTP | context |
|---|---|
| 400 | input / callback |
| 403 | permissions |
| 404 | resource |
| 409 | pending / failed review / incompatible context |
| 429 | rate limit |
| 502 / 503 | uncertain upstream result / unavailable |
Idempotenza Seedance e recupero degli invii
Materiali virtuali e recupero automatico
Un gruppo virtuale senza channel_id consente un ID asset:// per modelli compatibili. available_models, model_readiness e all_models_ready indicano la disponibilità. Ogni servizio approva le proprie copie. Interrogare la revisione; preparare copie richiede un originale accessibile. Canali espliciti, gruppi di materiali esistenti e materiali H5 ufficiali conservano i relativi vincoli.
La generazione richiede Idempotency-Key. Prima dell’accettazione il cambio è possibile solo dopo un rifiuto esplicito per limite di frequenza senza ID attività. Un’attività accettata terminata per account disabilitato, credenziali non valide o guasto del servizio confermati può essere recuperata automaticamente una sola volta se esiste un servizio compatibile. ID pubblico e tariffa utente congelata restano invariati, senza seconda prenotazione di generazione. Consultare attività originale e ricevuta di fatturazione.
Il servizio di destinazione necessita di copie compatibili approvate o di una revisione indipendente. Approvazioni e verifica H5 ufficiale non si trasferiscono tra servizi o account. Errori di parametri, moderazione, copyright, timeout, disconnessioni e accettazione incerta sono esclusi. Prima di reinviare manualmente consultare la ricevuta; nuova chiave solo con new_submission_safe=true.
