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

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

そのため、初回リクエスト前に Seedance 側で人物アセットグループを作成し、本人確認と利用許諾、素材の有効化、Asset ID の取得を済ませ、画像を asset://... URI に置き換える必要はありません。

法的に利用でき、本人から必要な許諾を得た画像だけを送信してください。real_person は処理指示であり、同意の証明ではありません。Ofox や上流プロバイダーのコンテンツポリシーを回避する機能でもありません。

Ofox のフローがシンプルな理由

BytePlus Seedance 2.0 の公式 Video API ドキュメントでは、実在人物の顔を含む参照画像や動画を直接アップロードできず、許諾済み人物アセットを使うと説明されています。公式の非公開人物アセットライブラリガイドには、本人確認、素材の同一性チェック、Active 状態、生成時の Asset URI が記載されています。Volcano Ark のガイドでは、招待、本人による認証と許諾、アップロード、受領、Asset ID 取得の手順も示されています。

手順	Seedance 2.0 公式 API へ直接接続	Ofox Video API
初回リクエスト前	アセットグループ作成、本人確認と許諾、素材検証、Asset ID 取得	プロバイダー側の事前登録は不要。処理許諾を得た画像を使用
参照値	有効な許諾済みアセットを `asset://<asset_id>` で指定	既存の `frame_images` または `input_references` に画像 URL / `data:` URI を指定
リクエスト設定	承認済みアセット URI を使用	トップレベルに `"real_person": true` を追加

Ofox が簡略化するのは技術的な受け渡しであり、肖像権、許諾、適法利用に関する利用者の責任は変わりません。

クイックスタート


curl -X POST https://api.ofox.run/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 枚以上必要で、両フィールドは同時に使用できません。正確な形式と上限は動画タスクの作成を参照してください。

送信後の流れ

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

適切な入力の多くは通常の非同期タスクへ進めますが、前処理は上流での受理を保証しません。一部の画像は実在人物の追加審査や拒否を受ける場合があります。拒否されたジョブには課金されません。

それでも人物審査に該当する場合

人物を一貫して認識しやすく調整し、real_person: true のまま再送信してください。

主役を 1 人に絞り、ほかの顔の数を減らす；
主な顔が十分大きく、画面端に寄らないようトリミングやレイアウトを調整する；
明瞭な正面顔、均一な照明、遮蔽の少ない画像を優先する；
背景人物、ポスター、画面、鏡、反射に映る顔を可能な限り除く；
極端な角度、強いモーションブラー、濃い影、マスク、大きな遮蔽を避ける；
高品質な元画像を使い、混雑した構図を簡素化する。

これらは認識の曖昧さを減らす方法であり、ポリシーを上書きしたり承認を保証したりするものではありません。拒否が続く場合は、別の許諾済み参照画像を使用してください。

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

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

理由トークン	修正方法
`bad_data_uri`	不正な `data:` URI または base64 を修正する
`download_failed`	接続、タイムアウト、アクセス制御の問題なく URL を取得できるようにする
`unreachable`	成功 HTTP ステータスを返す URL を使う
`not_image`	対応するデコード可能な画像を送る
`too_large`	ファイル、画像寸法、または 1 リクエスト内の画像数を減らす

完全なエラー形式はVideo API エラーを参照してください。

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