Skip to main content
POST
创建 Gemini 视频任务
使用 Gemini API 的长任务格式调用 Seedance。查询使用 GET,成功结果位于 response.generateVideoResponse.generatedSamples。 如果客户端使用 Vertex AI 路径,请改看 Vertex AI 接口。

接入配置

服务地址为 https://api.aiohub.org,使用 AIOHub API 令牌鉴权。把 <AIOHUB_API_KEY> 替换为完整的 sk- 令牌,并确认其分组可访问所选 Seedance 模型。

请求示例

返回的关键字段如下。保存完整 name,包括模型路径和 operations/,不要只保存最后一段 ID。
拿到任务标识后,转到 查询任务。

输入与参数

未指定参数时,默认 5 秒、720p、adaptive 比例并生成音频。首尾帧与参考图是两种输入方式,不能在同一个 instances[0] 中混用。 图片对象示例:
模型上限见 视频模型与计费。不支持任意 gs:// 输入、视频扩展或全部 Veo 参数。需要参考音频、参考视频或视频编辑时,选择 Ark / Seedance。
安装 google-genai 并在运行环境中设置 AIOHUB_API_KEY。这里使用 Gemini API 模式,Base URL 不包含 /v1beta,版本通过 api_version 指定。
Python
创建请求超时且未拿到任务标识时,先检查 用量日志,避免重复生成和扣费。400 错误需要先修正参数;401 错误请检查令牌。模型权限和额度见 鉴权。

授权

Authorization
string
header
必填

API key (sk-xxx)

路径参数

model
string
必填

完整 Seedance 模型名。

示例:

"doubao-seedance-2-5-260628"

请求体

application/json

本页参数范围针对 Seedance。lastFrame 必须与 image 一起使用;参考图不可与首尾帧混用。不能传入视频扩展、mask、seed、negativePrompt 等未列出的控制参数。

instances
object[]
必填

只提交一个实例。文本生成需 prompt;图生视频可指定 image。

Required array length: 1 element
parameters
object

响应

任务已受理。

name
string
必填

完整 operation name。保存原值用于后续查询。

done
boolean
必填

false 表示等待;true 表示已结束,但可能是失败,须检查 error。

response
object
error
object