eva
← 开发者文档

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。结果地址可能过期,完成后请及时保存。

八、常见问题

  1. 提示模型不可用:先查询 /v1/models,确认 Key 选择了视频按次分组并允许该模型。
  2. 提示时长错误:480P 使用整数 4–28;720P 使用 30。不要同时发送不同的 seconds 和 duration。
  3. 提示参考素材错误:先确认参考图地址可被服务端访问、使用 HTTPS,并检查该模型的图片数量;本地图片先按第六节上传。
  4. 提示不支持某个字段:按示例保留必要字段,具体模型的可用参数有差异。
  5. 余额或权限错误:检查账户余额、Key 限额及分组;具体信息以接口响应和账单为准。

模型、分组及价格请查看 https://api.eveapis.com/pricing 。本文中的响应 ID 和图片地址仅为示例,不能直接使用。