API DOCUMENT

纯梦tk 视频生成 API

使用纯梦授权码提交 Seedance 2.0 多参考视频任务。账号、Cookie 和代理均由纯梦服务端管理，下游无需也不能传入。

提交任务

POST https://puream.cn/api/ai/puream-tk/tasks

Header	必填	说明
`Authorization`	是	`Bearer 你的纯梦授权码`
`Idempotency-Key`	建议	业务侧唯一请求号；重试时保持不变。
`Content-Type`	是	`application/json`

images、videos、audios 合计至少 1 个、最多 12 个。建议每次提交都携带唯一的 Idempotency-Key，网络重试时沿用同一个值，避免重复生成和重复冻结余额。

入参配置

变量名	类型	必填	变量简介
`prompt`	String	是	视频生成提示词。
`duration`	Number	是	当前固定填写 5，单位秒。
`images`	Array<String>	否	公网图片地址，最多 9 个。
`videos`	Array<String>	否	公网视频地址，最多 3 个。
`audios`	Array<String>	否	公网音频地址，最多 3 个。
`aliossid`	String	是	阿里云 OSS AccessKey ID，仅用于本次成片上传，不会作为任务字段保存；私有 Bucket 的签名 URL 可能按 OSS 标准包含 AccessKey ID。
`aliosskey`	String	是	阿里云 OSS AccessKey Secret，仅用于本次成片上传，不会保存或返回。
`bucket`	String	是	成片写入的 OSS Bucket。
`diyu`	String	是	OSS Endpoint，例如 oss-cn-beijing.aliyuncs.com。
`model`	String	否	可不填，默认 seedance2.0。

请求示例

curl -X POST https://puream.cn/api/ai/puream-tk/tasks \
  -H "Authorization: Bearer 你的纯梦授权码" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 业务侧唯一请求号" \
  -d '{
    "prompt": "让参考人物自然转身并看向镜头",
    "duration": 5,
    "images": ["https://example.com/reference.jpg"],
    "videos": [],
    "audios": [],
    "aliossid": "你的 OSS AccessKey ID",
    "aliosskey": "你的 OSS AccessKey Secret",
    "bucket": "your-bucket",
    "diyu": "oss-cn-beijing.aliyuncs.com"
  }'

出参配置

变量名	类型	变量简介
`task_id`	String	纯梦任务 ID，后续查询和下载均使用此 ID。
`status`	String	processing、done 或 failed。
`duration_seconds`	Number	本次计费时长。
`price_yuan_per_second`	Number	每秒价格，固定为 0.15 元。

查询任务

GET https://puream.cn/api/ai/puream-tk/tasks/{task_id}

Header	必填	说明
`Authorization`	是	`Bearer 你的纯梦授权码`

变量名	类型	变量简介
`task_id`	String	纯梦任务 ID。
`status`	String	processing、done 或 failed。
`progress`	String	上游进度说明。
`result.video_url`	String	成功后的 OSS 成片地址。
`charge_yuan`	Number	成功结算金额；失败任务不扣费。
`settlement_status`	String	reserved、charged 或 not_charged。

processing 时继续轮询；临时上游网络错误会返回可重试状态，不会直接把任务判为失败。只有上游明确失败或最终没有有效成片地址时才退款并结束任务。

下载成片

GET https://puream.cn/api/ai/puream-tk/tasks/{task_id}/download

Header	必填	说明
`Authorization`	是	`Bearer 你的纯梦授权码`

任务成功后，此接口会以 302 跳转到 OSS 成片地址。查询和下载只允许任务所属的纯梦账号访问。

兼容地址与计费

能力	接口	说明
提交	`POST /api/ai/puream-tk/generate`	兼容别名，与标准提交接口一致。
查询	`GET /api/ai/puream-tk/status/{task_id}`	兼容别名，与标准查询接口一致。
下载	`GET /api/ai/puream-tk/download/{task_id}`	兼容别名，与标准下载接口一致。
计费	0.15 元/秒	当前 5 秒任务成功扣 0.75 元；提交时先冻结，失败自动退回，查询和下载免费。