素材与参数
4.1 素材字段的统一写法(适用于全部模型)
统一使用扁平字段,所有模型通用:
curl -X POST 'https://newapi.nskeven.uk/v1/video/generations' \
-H 'Authorization: Bearer sk-xxx' \
-H 'Content-Type: application/json' \
-d '{
"model": "even-sd2.5-A",
"prompt": "按 @图1 的构图与 @视频1 的运镜,生成雨夜霓虹街道镜头",
"seconds": "8",
"aspect_ratio": "9:16",
"resolution": "720p",
"images": ["https://your-cdn.com/ref-1.jpg"],
"videos": ["https://your-cdn.com/ref-cam.mp4"],
"audios": ["https://your-cdn.com/ref.mp3"]
}'
两处例外(仅位置不同,字段名不变):
| 模型 | 差异 |
|---|---|
豆包 Seedancedoubao-seedance-* |
素材与分辨率、画幅全部写在 metadata.content,见 4.2 |
快线系列sd-2-* / wan-3.0-* |
images 用顶层;参考视频 / 音频须写在 metadata.videos / metadata.audios,见 4.3 |
@ 引用规则:even-sd2.0-A / even-sd2.5-A 带参考素材时,prompt 中须用 @图1、@视频1、@音频1 引用对应素材(编号从 1 开始,按数组顺序)。
A 系列省略 resolution 时默认 480p,请务必显式传入。
4.2 豆包 Seedance(doubao-seedance-*)
豆包模型的分辨率、画幅、素材须写在 metadata 内,顶层 resolution / aspect_ratio / images / videos / audios 不生效。
| 参数名 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
model | 顶层 | string | 必填 | 模型名 |
prompt | 顶层 | string | 必填 | 视频内容描述 |
seconds | 顶层 | string | 可选 | 时长,不传默认 4 秒 |
metadata.resolution | metadata | string | 必填 | 分辨率 |
metadata.ratio | metadata | string | 可选 | 画幅,默认 16:9 |
metadata.content | metadata | array | 可选 | 参考素材数组 |
metadata.generate_audio | metadata | bool | 可选 | 声音开关 |
metadata.watermark | metadata | bool | 可选 | 水印开关 |
metadata.seed | metadata | number | 可选 | 随机种子 |
metadata.content 素材项:
type | 内容字段 | role |
|---|---|---|
image_url | image_url.url | reference_image / first_frame / last_frame |
video_url | video_url.url | reference_video |
audio_url | audio_url.url | reference_audio |
- 素材 URL 支持公网 HTTP(S) 链接,或平台素材库地址
asset://ast-xxx - 首帧、尾帧各最多 1 张;使用首尾帧时图片总数不超过 2 张,且不可同时带参考视频
- 素材请全部写在
metadata.content,不要同时再传顶层images
示例:
curl -X POST 'https://newapi.nskeven.uk/v1/video/generations' \
-H 'Authorization: Bearer sk-xxx' \
-H 'Content-Type: application/json' \
-d '{
"model": "doubao-seedance-2-0-fast-260128",
"prompt": "参考图片中的人物,按参考视频的运镜生成街头镜头",
"seconds": "8",
"metadata": {
"resolution": "720p",
"ratio": "9:16",
"content": [
{ "type": "image_url", "image_url": { "url": "https://your-cdn.com/ref-1.jpg" }, "role": "reference_image" },
{ "type": "video_url", "video_url": { "url": "https://your-cdn.com/ref.mp4" }, "role": "reference_video" }
]
}
}'
4.3 快线系列
适用模型:sd-2-E4 / sd-2-E5 / sd-2-E6 / sd-2-E8 / sd-2.5-E1 / wan-3.0-1080
参考图用顶层 images;参考视频 / 音频写在 metadata.videos / metadata.audios。
curl -X POST 'https://newapi.nskeven.uk/v1/video/generations' \
-H 'Authorization: Bearer sk-xxx' \
-H 'Content-Type: application/json' \
-d '{
"model": "sd-2-E6",
"prompt": "根据参考图与参考视频节奏生成同款镜头",
"seconds": "8",
"aspect_ratio": "16:9",
"resolution": "720p",
"images": ["https://your-cdn.com/ref-1.jpg"],
"metadata": {
"videos": ["https://your-cdn.com/ref.mp4"],
"audios": ["https://your-cdn.com/ref.mp3"]
}
}'
该系列限制:参考图 ≤9、视频 ≤3、音频 ≤3;输入视频与输出视频时长合计不超过约 25 秒;参考图片分辨率建议 ≥300×300。