APIMaster.ai

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.