Avvia una sessione di verifica con persona reale

curl --request POST \
  --url https://api.orcarouter.ai/v1/asset/real-human/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "return_url": "https://your-app.com/verify/done"
}
'

{
  "session_id": "Xa9f...40-char-token",
  "h5_link": "https://verify.example.com/?session=...",
  "status": "pending"
}

Seedance Assets

Avvia una sessione di verifica con persona reale

Inizia la creazione di un gruppo di asset con persona reale (LivenessFace). Restituisce un link H5 che l’utente finale apre per completare una verifica del volto una tantum. Al termine, la pagina di verifica reindirizza il suo browser a una callback di OrcaRouter (gestita per te) e il nuovo gruppo viene registrato. Esegui il polling di GET /asset/real-human/sessions/{session_id} per il risultato. Il dispositivo dell’utente finale non deve essere autenticato.

POST

asset

real-human

sessions

Avvia una sessione di verifica con persona reale

curl --request POST \
  --url https://api.orcarouter.ai/v1/asset/real-human/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "return_url": "https://your-app.com/verify/done"
}
'

{
  "session_id": "Xa9f...40-char-token",
  "h5_link": "https://verify.example.com/?session=...",
  "status": "pending"
}

Autorizzazioni

Authorization

string

header

obbligatorio

Le chiavi API di OrcaRouter hanno la forma sk-orca-.... Passale nell'header Authorization: Bearer sk-orca-....

Corpo

application/json

Qualsiasi campo diverso da return_url viene inoltrato così com'è alla chiamata di verifica upstream, quindi puoi passare qualsiasi parametro supportato dal servizio asset. CallbackURL e ProjectName sono impostati da OrcaRouter e non possono essere sovrascritti.

return_url

string

URL http(s) opzionale a cui viene reindirizzato il browser dell'utente finale dopo la verifica, con ?status=&session_id=&group_id=. Ometti per mostrare una pagina di completamento integrata.

Risposta

200 - application/json

Sessione creata

session_id

string

h5_link

string

status

string

Elimina un asset Polling di una sessione di verifica con persona reale (per id)