zh · Markdown
Seedance 2.5 视频生成 API:480P 与 720P 按次线路
两款 Seedance 2.5 按次视频模型的参数、参考图上传、任务创建、查询与下载。
Seedance 2.5 视频生成 API:480P / 720P 按次线路
本文介绍两款视频模型的调用方法:鉴权、创建任务、参考图、查询状态及下载结果。示例使用 EVA 统一接口;请以模型广场当前报价和账户分组实际结算为准。
一、模型和参数
| 模型 | 模型 ID | 分辨率 | 时长 | 图片参考 | 参考价格 |
|---|---|---|---|---|---|
| Seedance 2.5 480P 按次 | seedance-2-5-480p-request-line-g | 480p | 网关接受 4–28 秒整数,默认 6 秒 | 最多 30 个图片 URL | ¥2.50/次 |
| Seedance 2.5 720P 按次 | seedance-2-5-720p-request-line-c | 720p | 固定 30 秒,默认 30 秒 | 最多 9 个 HTTPS 图片 URL | ¥3.60/次 |
480P 的 4–28 秒是网关参数校验范围,不代表该范围内所有时长均已实测;具体以任务结果为准。720P 的参考视频、参考音频、首尾帧能力未纳入本指南。两条线路的音视频参考能力不能按统一接口的全局上限推定。图片格式和数量还应以实际任务校验结果为准。
按次为每个生成任务计价。使用账号专属优惠时,实际扣费以账单为准。提交任务并返回任务 ID 代表已受理,不代表生成完成。
二、准备
在 EVA 控制台创建所属「视频按次」分组且有目标模型权限的 API Key。以下变量用于服务端 shell:
export EVA_BASE_URL='https://api.eveapis.com'
export EVA_API_KEY='替换为你的 EVA API Key'
所有 API 请求使用 Authorization: Bearer <EVA_API_KEY>。请在服务端保管密钥,勿放入公开页面或客户端代码。
查询该 Key 实际可用的模型:
curl --fail-with-body "$EVA_BASE_URL/v1/models" \
-H "Authorization: Bearer $EVA_API_KEY"
在返回的 data 数组中检查 id。如果看不到目标 ID,请检查 Key 的分组、模型限制及账户权限。
三、接口总览
| 操作 | 方法 | 路径 |
|---|---|---|
| 查看模型 | GET | /v1/models |
| 创建视频任务 | POST | /v1/videos |
| 查询视频任务 | GET | /v1/videos/{id} |
| 下载视频内容 | GET | /v1/videos/{id}/content |
| 创建素材上传 | POST | /v1/video/uploads |
| 上传分片 | PUT | /v1/video/uploads/{id}/chunks/{index} |
| 完成素材上传 | POST | /v1/video/uploads/{id}/complete |
四、创建 480P 视频
curl --fail-with-body "$EVA_BASE_URL/v1/videos" \
-H "Authorization: Bearer $EVA_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "seedance-2-5-480p-request-line-g",
"prompt": "晨光洒在海面,镜头平稳向前推进",
"seconds": 6,
"resolution": "480p",
"aspect_ratio": "16:9"
}'
参数:model 和 prompt 必填;seconds 为整数秒,省略默认为 6。resolution 使用 480p,可使用 size 替代;aspect_ratio 可选 16:9、9:16、1:1、4:3、3:4、21:9。seconds 和 duration 可二选一;同时传入时数值必须一致。size 和 resolution 同时传入时必须一致。不要用 1280x720 或 16:9 填写本线路的 size。
480P 图生视频
将参考图替换成服务端可访问的 HTTPS 图片地址。reference_images 最多 30 张;实际可用数量以任务处理结果为准。只使用 reference_images、images、image_urls 三种名称之一,避免重复传入。
curl --fail-with-body "$EVA_BASE_URL/v1/videos" \
-H "Authorization: Bearer $EVA_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "seedance-2-5-480p-request-line-g",
"prompt": "参考画面中人物与场景,镜头缓慢推进",
"seconds": 6,
"resolution": "480p",
"aspect_ratio": "16:9",
"reference_images": ["https://example.com/reference.png"]
}'
五、创建 720P 视频
curl --fail-with-body "$EVA_BASE_URL/v1/videos" \
-H "Authorization: Bearer $EVA_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "seedance-2-5-720p-request-line-c",
"prompt": "海边日落,海浪缓缓涌向沙滩",
"seconds": 30,
"resolution": "720p",
"aspect_ratio": "16:9"
}'
本模型固定 30 秒,seconds 可省略,也可用 duration 表示 30;两个字段同时传入须一致。resolution 使用 720p。比例可使用 16:9、9:16、1:1、4:3、3:4、21:9。
720P 图生视频
参考图使用可从服务端访问的 HTTPS 地址,最多 9 张:
curl --fail-with-body "$EVA_BASE_URL/v1/videos" \
-H "Authorization: Bearer $EVA_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "seedance-2-5-720p-request-line-c",
"prompt": "参考图片中的场景,镜头缓慢向前推进",
"seconds": 30,
"resolution": "720p",
"reference_images": ["https://example.com/reference.png"]
}'
六、上传本地图片并获得参考 URL
已有可访问的图片 URL 时,可直接填写 reference_images。本地图片可先上传至 EVA,完成后取得返回的 url,再放入 reference_images。使用同一账号下有权限的 Key;临时地址有效期有限,请上传完成后尽快提交任务。图片支持 JPG、PNG、WebP,单张不超过 20 MiB。上传分片大小以创建上传返回的 chunk_size 为准,当前为 8 MiB。
Python 示例仅上传图片,不创建视频任务。运行前安装 requests,设置 EVA_API_KEY,指定本地图片路径:
import hashlib
import mimetypes
import os
import pathlib
import sys
import requests
base = 'https://api.eveapis.com'
key = os.environ['EVA_API_KEY']
path = pathlib.Path(sys.argv[1])
raw = path.read_bytes()
mime = mimetypes.guess_type(path.name)[0]
if mime not in ('image/jpeg', 'image/png', 'image/webp'):
raise ValueError('请选择 JPG、PNG 或 WebP 图片')
headers = {'Authorization': 'Bearer ' + key}
s = requests.Session()
s.headers.update(headers)
def checked(response):
response.raise_for_status()
return response
created = checked(s.post(base + '/v1/video/uploads', json={
'name': path.name,
'media_type': 'image',
'mime_type': mime,
'size': len(raw),
'sha256': hashlib.sha256(raw).hexdigest(),
}, timeout=60)).json()
uid = created['upload']['id']
chunk_size = created['chunk_size']
for index, offset in enumerate(range(0, len(raw), chunk_size)):
chunk = raw[offset:offset + chunk_size]
checked(s.put(base + '/v1/video/uploads/' + uid + '/chunks/' + str(index),
headers={'Content-Type': 'application/octet-stream',
'X-Chunk-SHA256': hashlib.sha256(chunk).hexdigest()},
data=chunk, timeout=120))
completed = checked(s.post(base + '/v1/video/uploads/' + uid + '/complete', timeout=60)).json()
print('参考图 URL:', completed['url'])
python upload_reference.py reference.png
将输出的参考图 URL 填入对应创建请求的 reference_images 数组。不同模型对素材数量、格式和任务参数有各自限制;不要将本地文件路径直接写入 JSON。
七、创建响应、查询与下载
创建成功后保存响应中的 id。示意:
{"id":"task_example_123","object":"video","status":"queued","progress":0}
查询时替换为自己的任务 ID:
export EVA_TASK_ID='替换为创建响应中的 id'
curl --fail-with-body "$EVA_BASE_URL/v1/videos/$EVA_TASK_ID" \
-H "Authorization: Bearer $EVA_API_KEY"
| status | 含义 | 建议 |
|---|---|---|
| queued | 排队中 | 继续查询 |
| in_progress | 生成中 | 继续查询 |
| completed | 已完成 | 下载视频 |
| failed | 失败 | 停止轮询并检查错误 |
推荐每 5 秒查询一次,并设置总等待时间;遇到 429 时按 Retry-After 退避。等待超时不代表任务已取消,请保留任务 ID 继续查询。创建请求超时也可能已经受理,先核查再决定是否重试。
任务完成后下载:
curl --fail-with-body "$EVA_BASE_URL/v1/videos/$EVA_TASK_ID/content" \
-H "Authorization: Bearer $EVA_API_KEY" \
-o result.mp4
查询和下载需使用有权限访问该任务的有效 Key。结果地址可能过期,完成后请及时保存。
八、常见问题
- 提示模型不可用:先查询 /v1/models,确认 Key 选择了视频按次分组并允许该模型。
- 提示时长错误:480P 使用整数 4–28;720P 使用 30。不要同时发送不同的 seconds 和 duration。
- 提示参考素材错误:先确认参考图地址可被服务端访问、使用 HTTPS,并检查该模型的图片数量;本地图片先按第六节上传。
- 提示不支持某个字段:按示例保留必要字段,具体模型的可用参数有差异。
- 余额或权限错误:检查账户余额、Key 限额及分组;具体信息以接口响应和账单为准。
模型、分组及价格请查看 https://api.eveapis.com/pricing 。本文中的响应 ID 和图片地址仅为示例,不能直接使用。