模型说明

支持可选文本提示词与参考图；提交后返回任务 ID，需轮询任务状态，完成后下载视频二进制结果。

功能接口详情

编辑视频

请求url

POST https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/decart/jobs

Content-Type：multipart/form-data

请求Body参数/请求query参数

参数名	字段类型	是否必填	默认值	描述
data	binary	是	-	视频文件
prompt	string	否	''	提示词，默认为空
reference_image	binary | null	否	-	参考图
seed	integer	否	-	随机种子（范围 0～4294967295）
resolution	string	否	720p	输出分辨率
enhance_prompt	boolean	否	true	是否增强提示词
self_anchor	boolean	否	true	在模型自身的潜在变量（lucy-2.5 自锚）上重新锚定。默认开启。

响应参数

官方 OpenAPI 成功响应 schema 为空

参数名	字段类型	描述
job_id	string	任务 ID，用于查询状态与下载结果
status	string	任务状态；提交成功为 pending，完成为completed

请求示例

curl --location 'https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/decart/jobs' \
--header 'Authorization: Bearer ${YOUR_AK}' \
--form 'data=@"/path/to/input-video.mp4"' \
--form 'prompt="Change the car to a vintage motorcycle"' \
--form 'resolution="720p"' \
--form 'enhance_prompt="true"' \
--form 'self_anchor="true"'

响应示例

{
    "job_id": "0ea63348-6b5d-4802-b2e2-7b4da2f2e250",
    "status": "pending"
}

---

查询视频状态

同步查询。用于轮询任务是否完成

请求url

GET https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/decart/jobs/{job_id}

请求Body参数/请求query参数

参数名	字段类型	是否必填	默认值	描述
job_id	string（path）	是	-	Job Id

响应参数

官方 OpenAPI 成功响应 schema 为空；以下为联调实测结构。文档示例另可见 failed。

参数名	字段类型	描述
job_id	string	任务 ID
status	string	任务状态；完成实测为 completed（另见文档示例：failed）

请求示例

curl --location 'https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/decart/jobs/0ea63348-6b5d-4802-b2e2-7b4da2f2e250' \
--header 'Authorization: Bearer ${YOUR_AK}'

响应示例

{
    "job_id": "0ea63348-6b5d-4802-b2e2-7b4da2f2e250",
    "status": "completed"
}

---

获取视频内容

同步下载已完成任务的结果。

请求url

GET https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/decart/jobs/{job_id}/content

请求Body参数/请求query参数

参数名	字段类型	是否必填	默认值	描述
job_id	string	是	-	Job Id

响应参数

参数名	字段类型	描述
body	binary	下载已完成任务的结果. 返回二进制内容或错误信息

请求示例

curl --location 'https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/decart/jobs/0ea63348-6b5d-4802-b2e2-7b4da2f2e250/content' \
--header 'Authorization: Bearer ${YOUR_AK}' \
--output edited-video.mp4

响应示例

二进制视频文件（非 JSON）。成功时 HTTP 200，Content-Type: video/mp4，body 为 MP4 字节流。