使用 `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 官方视频 API 文档明确说明，包含真人脸的参考图或视频不能直接上传，官方路径是使用已授权的真人人像资产。官方私域真人人像库指南要求完成人证核验、素材一致性校验、等待 Active 状态，再通过 Asset URI 生成视频。火山方舟真人人像库指南还列出了发起邀约、本人认证授权、上传素材、接收授权和获取 Asset ID 等步骤。

步骤	Seedance 2.0 官方直连接口	Ofox 视频 API
首次请求前	创建资产组、完成真人认证与授权、上传并校验素材、取得 Asset ID	无需在服务商平台预先入库；直接使用你已获授权处理的图片
参考图传法	使用已生效的授权资产 `asset://<asset_id>`	在现有 `frame_images` 或 `input_references` 中传图片 URL 或 `data:` URI
请求开关	改用审核通过的资产 URI	顶层加入 `"real_person": true`

Ofox 简化的是技术接入，不会减免用户对肖像权、授权和合法使用的责任。

快速开始


curl -X POST https://api.ofox.io/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 中至少要有一张图片，而且这两个参考字段仍然互斥。具体结构与数量限制见创建视频任务。

提交后会发生什么

Ofox 校验并预处理所选参考字段中的每张图片。
预处理后的请求被提交给所选视频服务商。
服务商仍会执行自己的身份、反深度伪造和内容安全检查。

适合的输入通常可以进入正常的异步任务流程，但预处理不保证上游一定接受。少量图片仍可能触发上游真人审核或拒绝；被拒绝的任务不会计费。

图片仍触发真人审核时

让人物更容易被稳定识别，然后保持 real_person: true 重新提交：

保留一个清晰的主要人物，减少画面里其他可见人脸的数量；
裁剪或重新布局，让主要人脸足够大，不要贴近画面边缘；
优先使用清晰、正面、无遮挡且光线均匀的人脸；
尽量移除或裁掉背景人物、海报、屏幕、镜面和反光中的人脸；
避免极端角度、明显运动模糊、重阴影、口罩和大面积遮挡；
换用更高质量的原图，并简化过于拥挤的构图。

这些调整可以减少识别歧义，但不会覆盖服务商政策，也不保证一定通过。如果仍被拒绝，请更换另一张已获授权的参考图。

可直接修复的预处理错误

如果 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`	减小文件、像素尺寸或单次处理的图片数量

完整错误对象与诊断方式见视频 API 错误码。

使用 real_person 直接提交真人参考图