zh · Markdown
EVA 视频生成 API:按次与按秒线路
Seedance、WAN、H3 按次和按秒模型、分组、请求、查询、下载及人民币计费。
本文介绍 Seedance、WAN 和 H3 的按次与按秒线路。请先登录 EVA 控制台,在密钥管理中创建所需线路分组的 API Key,并把密钥保存在服务端。
服务地址为 https://api.eveapis.com。请求使用 Authorization: Bearer <EVA_API_KEY>,创建任务时使用 Content-Type: application/json。
| 操作 | 方法 | 地址 |
|---|---|---|
| 创建视频 | POST | /v1/videos |
| 查询任务 | GET | /v1/videos/{id} |
| 下载视频 | GET | /v1/videos/{id}/content |
创建任务会产生计费请求。响应返回任务 ID,保存后用于查询和下载。
模型与分组
创建 Key 时先选择「视频按次」或「视频按秒」。在同一分组内,修改请求中的模型 ID 即可选择特价版或稳定版。模型广场列出各版本的人民币报价和支持参数。
| 模型版本 | API 模型 ID | Key 分组 |
|---|---|---|
| Seedance 2.0 · 720P · 按秒 · 稳定版 | seedance-2-0 |
视频按秒 |
| Seedance 2.0 · 720P · 按次 · 特价版 | seedance-2-0-request-special |
视频按次 |
| Seedance 2.5 · 480P · 按秒 · 特价版 | seedance-2-5-second-special |
视频按秒 |
| Seedance 2.5 · 720P · 按秒 · 稳定版 | seedance-2-5-second-stable |
视频按秒 |
| Seedance 2.5 · 720P · 按次 · 特价版 | seedance-2-5-request-special |
视频按次 |
| H3 · 480P / 768P · 按秒 · 特价版 | h3-second-special |
视频按秒 |
| H3 · 768P · 按秒 · 稳定版 | h3-second-stable |
视频按秒 |
| H3 · 1080P · 按次 · 稳定版 | h3-request-stable |
视频按次 |
| WAN 3.0 · 480P / 720P / 1080P · 按次 · 特价版 | wan3-request-special |
视频按次 |
这些入口使用 POST /v1/videos 创建,GET /v1/videos/{id} 查询,GET /v1/videos/{id}/content 下载。每次创建返回的 EVA 任务 ID 需保存,查询和下载使用同一账号的有效 Key。状态为 queued 或 in_progress 时等待,completed 时下载,failed 时查看错误。
按秒示例
创建一个选择「视频按秒」分组的 Key,将其设置为环境变量 EVA_API_KEY。示例使用 Seedance 2.0 720P 按秒稳定版,时长可选 5、10 或 15 秒。
curl --fail-with-body 'https://api.eveapis.com/v1/videos' \
-H "Authorization: Bearer $EVA_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"model":"seedance-2-0","prompt":"清晨湖面,镜头缓慢向前推进","seconds":5,"resolution":"720p"}'
按秒线路依据该线路的秒单价和计费时长计算费用。例如线路每秒单价为 P 元,计费时长为 5 秒,则费用为 5 × P 元。实际单价、分辨率和结算以模型广场及用量账单为准。
按次示例
创建一个选择「视频按次」分组的 Key。下面使用 Seedance 2.0 720P 按次特价版生成 5 秒视频。
curl --fail-with-body 'https://api.eveapis.com/v1/videos' \
-H "Authorization: Bearer $EVA_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"model":"seedance-2-0-request-special","prompt":"阳光下的海边,镜头缓慢移动","seconds":5,"resolution":"720p"}'
按次线路按任务收费。具体线路的时长和分辨率要求以模型广场为准。
WAN 和 H3
WAN 3 的按次特价版按分辨率定价。H3 的按秒特价版按分辨率、档位和放大选项定价。Seedance 2.5 按次特价版为 720P、固定 15 秒,需要 1 至 9 张参考图。使用 H3 按秒稳定版时请提交参考图。
查询和下载示例
curl --fail-with-body "https://api.eveapis.com/v1/videos/${EVA_TASK_ID}" \
-H "Authorization: Bearer $EVA_API_KEY"
curl --fail-with-body "https://api.eveapis.com/v1/videos/${EVA_TASK_ID}/content" \
-H "Authorization: Bearer $EVA_API_KEY" --output result.mp4
Seedance 2.5 按次线路详细参数
| 模型 ID | 分辨率 | 时长 | 图片参考 |
|---|---|---|---|
| seedance-2-5-480p-request-line-g | 480P | 网关接受 4–28 秒整数,默认 6 秒 | 最多 30 个图片 URL |
| seedance-2-5-720p-request-line-c | 720P | 固定 30 秒 | 最多 9 个 HTTPS 图片 URL |
480P 时长是网关校验范围,实际任务以处理结果为准。两条线路的详细请求示例、参考图上传和查询下载见 Seedance 2.5 按次线路接入指南。
H3 768P 按秒稳定版示例
该线路使用视频按秒分组;时长填写 5–15 秒,且需要至少一张可访问的参考图。将示例图片地址替换为实际 HTTPS 地址:
curl --fail-with-body 'https://api.eveapis.com/v1/videos' \
-H "Authorization: Bearer $EVA_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"model":"h3-second-stable","prompt":"参考图片,镜头缓缓推进","seconds":5,"resolution":"768p","reference_images":["https://example.com/reference.png"]}'
调用其他模型时,请以该模型线路的时长、参考素材要求和模型广场价格为准。豆包原生接口另见 豆包原生视频 API。