新建视频任务
输入你的创意描述，AI 帮你生成视频
提交后从余额预扣，任务完成后自动结算。
我的视频
最近的生成任务，点击视频可播放。
还没有任务，去新建一个吧。
我的素材库
这里显示当前 API key 上传过的素材，其他客户看不到。
还没有素材，先上传一张参考图或一段视频。
操作指南
按字节原生 content[] 调用；真人素材只多加一个 Relay 开关。
上传或登记素材
本地文件用 /v1/uploads；已有公网图片或视频用 /v1/uploads/from-url。返回的素材只归当前 API key 所属账号。
{{ guideUploadCurl }}
按字节原生结构生成
生成任务使用 model、content、resolution、ratio、duration 等字段。content[] 里可以放 text、image_url、video_url、audio_url。
{{ guideNativeCurl }}
一行开关自动过白名单
只在需要真人/人脸参考时加 extra_body.real_person_mode=true。Relay 会在服务端处理素材引用，转换成可用于生成的 asset://ID。
{{ guideRealPersonCurl }}
下面全部是原生 /v1/videos 请求体写法，客户可以直接复制 JSON 放进命令行、SDK 或自己的后台。
{{ item.title }}
{{ item.note }}
{{ item.code }}
客户只用 Relay API Key。生成、素材处理和计费都由 Relay 按当前账号配置执行，内部密钥不会出现在用户端。
素材列表按当前 API key 查询。别人上传生成的 asset://ID 不能被当前账号使用；服务端会返回 asset_not_owned。
API 接入文档
完整端点说明、参数、错误码、Python / JavaScript / Shell 代码示例
低审查内容生成规范
本节是技术文档页下方的客户可见操作规范，用于说明如何上传授权素材、引用素材 ID，并用当前账号的可用模型发起生成任务。
当前独立客户 Endpoint 和素材注册请求统一使用 BytePlus Moderation.Strategy=Skip；Relay 不额外增加内容安全审核层。
适用范围
- 仅适用于已取得授权的成年人素材、商业广告素材、剧情/影视化创作素材。
- 素材上传后会绑定到当前客户账号，其他客户不可见。
- 生成任务只需要传 Relay API Key、模型 ID、提示词和素材引用。
禁止范围
- 不得上传或生成未成年人相关、非授权真人、隐私侵害、诈骗、勒索、仇恨或违法内容。
- 不得把他人肖像、声音、身份标识用于误导性冒充。
- 平台会保留任务、素材引用和账单记录，用于客户查询、争议处理和合规审计。
推荐流程
- 在“素材库”上传客户自己的图片、视频或音频素材。
- 上传成功后复制素材库显示的
asset://...引用，或直接复制完整content[]块。 - 在生成请求里把素材放入
content[]，并填写清楚的授权创作提示词。 - 任务完成后直接读取返回的视频地址；视频文件默认保留在字节侧存储，Relay 只做转发和账单记录。
curl https://seedance3.eu/v1/uploads \
-H "Authorization: Bearer sk-your-relay-key" \
-F "file=@reference.jpg" \
-F "purpose=reference"curl https://seedance3.eu/v1/videos \
-H "Authorization: Bearer sk-your-relay-key" \
-H "Content-Type: application/json" \
-d '{
"model": "dreamina-seedance-2-0-260128",
"content": [
{ "type": "text", "text": "adult-only cinematic editorial video, authorized performer, elegant studio lighting" },
{
"type": "image_url",
"image_url": { "url": "asset://asset_xxx" },
"role": "reference_image"
}
]
}'账号设置
用于 SDK / curl 集成调用