real_person で実在人物の参照画像を直接送信する

OfoxAI では、通常の POST /v1/videos リクエストに、利用許諾を得た実在人物の参照画像を直接含めることができます。トップレベルに real_person: true を追加し、frame_images または input_references で画像を渡すだけで、タスクを動画プロバイダーへ渡す前に Ofox がプライバシー保護の前処理を自動で行います。

一部のプロバイダーは、実在人物の顔を含む参照画像について、事前にそのプラットフォームで素材の登録と本人認証を済ませることを求めています（例：Seedance。比較は Seedance · 実在人物の参照画像を参照）。real_person を使う場合、これらの手順を事前に済ませる必要はありません。

クイックスタート

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0",
    "prompt": "画面の人物が映画のような夜市を歩く",
    "real_person": true,
    "input_references": [
      {
        "type": "image_url",
        "image_url": { "url": "https://example.com/person.jpg" }
      }
    ]
  }'

real_person はリクエストのトップレベルに置く必要があります。frame_images または input_references に画像が 1 枚以上必要で、この 2 つの参照フィールドは引き続き同時に使用できません。具体的な構造と数の上限は動画タスクを作成を参照してください。

送信後の流れ

1. Ofox が選択された参照フィールド内の各画像を検証し、前処理します。
2. 前処理後のリクエストが、選択した動画プロバイダーへ送信されます。
3. プロバイダーは引き続き、独自の本人確認、ディープフェイク対策、コンテンツ安全性のチェックを行います。

適切な入力であれば通常の非同期タスクの流れに進めますが、前処理はアップストリームでの受理を保証しません。一部の画像はアップストリームの実在人物審査に該当したり、拒否されたりする場合があります。拒否されたタスクは課金されません。

画像が実在人物審査に該当する場合

人物を安定して識別しやすいように調整し、real_person: true のまま再送信してください。

• はっきり写った主要人物を 1 人に絞り、画面内に見えるほかの顔の数を減らす；
• トリミングやレイアウトの変更で主要な顔を十分な大きさにし、画面の端に寄せない；
• 鮮明で正面を向き、遮るものがなく、照明が均一な顔を優先する；
• 背景の人物、ポスター、画面、鏡、反射に写った顔はできるだけ除去するかトリミングする；
• 極端な角度、目立つモーションブラー、濃い影、マスク、広範囲の遮蔽を避ける；
• より高品質な元画像に替え、混み合った構図を簡素化する。

これらの調整は識別の曖昧さを減らせますが、プロバイダーのポリシーを上書きするものではなく、必ず通過することも保証しません。それでも拒否される場合は、利用許諾を得た別の参照画像に替えてください。

直接修正できる前処理エラー

Ofox が入力画像を前処理できない場合、リクエストは HTTP 400 を返し、error.code は "invalid_request" になります。error.message の末尾には安定した原因コードが含まれます。

エラーオブジェクトの全体と診断方法は Video API エラーコードを参照してください。

関連ドキュメント

• 動画タスクを作成
• 動画タスクを照会
• Video API エラーコード