火山原生兼容接口

如果你已经按火山方舟 Seedance 的接口格式接入，把地址换成下面的地址、密钥换成平台 API Key 即可继续使用，请求体与返回结构保持火山方舟格式。新接入推荐使用视频生成接口。

接口地址#

POST/seedance/api/v3/contents/generations/tasks创建任务，返回 { "id": "task_..." }

GET/seedance/api/v3/contents/generations/tasks/{id}查询任务

使用火山方舟 SDK 时，把 base_url 设置为 https://api-ganfonxai.gangfeng.net/seedance/api/v3。

创建任务#

请求体与火山方舟一致：

参数	类型	必填	说明
`model`	string	是	模型名，见模型与能力。
`content`	array	是	提示词与素材数组，`text` / `image_url` / `video_url` / `audio_url`，素材角色与限制同参考素材。
`duration`	integer	否	时长（秒），默认 5；2.0 系列 4–15，2.5 为 4–30，`-1` 为自动。
`resolution / ratio`	string	否	分辨率与宽高比，取值同视频生成接口。
`generate_audio / watermark / seed`	—	否	同视频生成接口。
`return_last_frame`	boolean	否	为 `true` 时，查询结果额外返回 `content.last_frame_url`（PNG 尾帧）。
`execution_expires_after`	integer	否	3600–82800 秒，默认 82800。
`output_format / safety_identifier`	string	否	同视频生成接口。

暂不支持 tools（联网搜索）和 asset:// 素材库引用，传入会返回 400。

cURL

curl https://api-ganfonxai.gangfeng.net/seedance/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-fast-260128",
    "content": [
      { "type": "text", "text": "一只橘猫在午后阳光下的窗台上打盹，镜头缓慢推进" }
    ],
    "duration": 5,
    "ratio": "16:9",
    "resolution": "720p",
    "generate_audio": false
  }'

查询任务#

status 取值：queued / running / succeeded / failed。成功时 content.video_url 为视频的直接下载地址，24 小时内有效；失败时返回 error.code 与 error.message，含义同任务失败原因。

curl https://api-ganfonxai.gangfeng.net/seedance/api/v3/contents/generations/tasks/task_xxx \
  -H "Authorization: Bearer $API_KEY"

使用火山方舟 Python SDK#

Python

# pip install 'volcengine-python-sdk[ark]'
import os
from volcenginesdkarkruntime import Ark

client = Ark(base_url="https://api-ganfonxai.gangfeng.net/seedance/api/v3", api_key=os.environ["API_KEY"])

task = client.content_generation.tasks.create(
    model="doubao-seedance-2-0-fast-260128",
    content=[{"type": "text", "text": "一只橘猫在午后阳光下的窗台上打盹"}],
)
result = client.content_generation.tasks.get(task_id=task.id)
print(result.status)