开发者文档

网关地址

https://dev.timeline-video.com/api/v1

生产环境：https://timeline-video.com/api/v1

鉴权方式

所有请求需携带开发者 API-Key，通过 HTTP Header 传递：

Authorization: Bearer vpp_dev_YOUR_KEY

调用示例

Python

import requests

resp = requests.post(
    "https://dev.timeline-video.com/api/v1/video-gen",
    headers={"Authorization": "Bearer vpp_dev_YOUR_KEY"},
    json={"prompt": "一只橘猫在窗台上晒太阳", "durationSec": 4},
)
task = resp.json()  # {"ok": true, "taskId": "...", "status": "pending"}
print(task)

# 查询任务结果
result = requests.get(
    f"https://dev.timeline-video.com/api/v1/tasks/{task['taskId']}",
    headers={"Authorization": "Bearer vpp_dev_YOUR_KEY"},
).json()
print(result)  # {"taskId": "...", "status": "done", "resultUrl": "..."}

Curl

curl -X POST https://dev.timeline-video.com/api/v1/video-gen \
  -H "Authorization: Bearer vpp_dev_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"一只橘猫在窗台上晒太阳","durationSec":4}'

请求参数（POST /api/v1/video-gen）

错误码

计费规则

• 按量计费：基础价 ×（1 + 溢价百分比），随算力成本联动
• 加急通道：priority=rush 时按加急倍率计价，优先级高于普通外部流量
• 阶梯批发/包月/锁价合约：联系平台商务开通
• 任务失败/取消自动回滚，不计费

常见问题 FAQ