実在人物の認証セッションを開始

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

実在人物の認証セッションを開始

実在人物（LivenessFace）資産グループの作成を開始します。エンドユーザーが開いて一度きりの顔認証を完了する H5 リンクを返します。完了後、認証ページはユーザーのブラウザを OrcaRouter のコールバック（あなたの代わりに処理されます）にリダイレクトし、新しいグループが登録されます。 GET /asset/real-human/sessions/{session_id} をポーリングして結果を取得してください。エンドユーザーのデバイスは OrcaRouter にログインしている必要はありません。

POST

asset

real-human

sessions

実在人物の認証セッションを開始

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

承認

Authorization

string

header

必須

OrcaRouter API キーは sk-orca-... のような形式です。 Authorization: Bearer sk-orca-... ヘッダで渡してください。

ボディ

application/json

return_url 以外のフィールドはそのまま上流の認証呼び出しに転送されるため、素材サービスがサポートする任意のパラメータを渡せます。 CallbackURL と ProjectName は OrcaRouter が設定するもので、上書きできません。

return_url

string

任意の http(s) URL で、認証完了後にエンドユーザーのブラウザをここへ ?status=&session_id=&group_id= を付けてリダイレクトします。省略すると組み込みの完了ページを表示します。

レスポンス

200 - application/json

セッションが作成されました

session_id

string

h5_link

string

status

string

資産を削除実在人物の認証セッションをポーリング（id 指定）