接入说明

下表的路径接在接口地址后面。

1. 调用创建视频，返回的视频对象里 id 是视频 ID，status 是 queued。
2. 每 10 秒左右调用一次查询视频，status 依次经过 queued（排队中）、in_progress（生成中），最后变成 completed（成功）或 failed（失败）。
3. 成功后 video_url 就是视频地址，也可以调用下载视频取回文件。失败时 error 说明原因，费用全部退回。

可以直接使用 OpenAI 的官方 Python SDK，创建客户端时把 base_url 指向本平台：

python -m pip install --upgrade openai

import os

from openai import OpenAI

client = OpenAI(
    base_url="https://your-domain/v1",
    api_key=os.environ["API_KEY"],
)

• SDK 的 videos.create 只有 model、prompt、seconds、size、input_reference 几个参数，resolution、audio、参考素材等其他参数放在 extra_body 里，写法见创建视频的示例。
• SDK 的 input_reference 只接受文件；首帧传图片链接时，同样放在 extra_body 里。
• 调用 videos 接口时，SDK 会打印 DeprecationWarning: The Sora API is scheduled to permanently shut down...，这是 OpenAI 关于自家 Sora 服务的提示，不影响调用本平台。以后的 SDK 版本可能移除 videos 接口，长期使用建议固定 SDK 版本（本文示例用 openai 3.28.0 验证），或者直接发 HTTP 请求。

其他语言直接发 HTTP 请求即可，各接口页面都有 cURL 和 Node.js 的示例。

import os

from openai import OpenAI

client = OpenAI(
    base_url="https://your-domain/v1",
    api_key=os.environ["API_KEY"],
)

# 提交任务，每 10 秒查询一次，直到任务结束
video = client.videos.create_and_poll(
    model="doubao-seedance-2-0-260128",
    prompt="清晨的海边，一只金毛犬沿着浪花奔跑，镜头缓慢跟随，阳光穿过薄雾",
    seconds="5",
    size="1280x720",
    poll_interval_ms=10000,
)
if video.status == "completed":
    client.videos.download_content(video.id).write_to_file("video.mp4")
    print("已保存到 video.mp4")
else:
    print("生成失败:", video.error.code, video.error.message)

请求、返回结果和视频状态的格式与 OpenAI 一致，在此基础上有这些不同：

各种格式的任务是同一份：OpenAI 格式的视频列表包含账号下的所有视频，也包括用火山方舟格式、MiniMax 格式创建的任务；用 OpenAI 格式创建的 Seedance 任务，也可以用 GET /ark/api/v3/contents/generations/tasks/{id} 查询，或者用火山方舟格式取消；MiniMax 任务同样可以用 GET /minimax/v2/query/video_generation/{task_id} 查询，或者用 MiniMax 格式取消。

出错时返回 HTTP 4xx 或 5xx 状态码，返回结果是 {"error": {...}}，格式与 OpenAI 相同，OpenAI SDK 会把它转成 openai.APIStatusError 异常。错误码列表和捕获异常的写法见错误码。