Model Description
Supports optional text prompts and reference images; a task ID will be returned upon submission, which requires status polling, and the binary video result can be downloaded once the task is completed.
Details of Functional Interfaces
Edit videos
Request URL
POST https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/decart/jobs
Content-Type：multipart/form-data
Request Body Parameters / Request Query Parameters
| Parameter Name | Field Type | Required or not | default value | Description |
|---|---|---|---|---|
| data | binary | Yes | - | video file |
| prompt | string | No | '' |
Prompt, empty by default |
| reference_image | binary | null | No | - | Reference Diagram |
| seed | integer | No | - | Random seed (range: 0～4294967295) |
| resolution | string | No | 720p |
Output Resolution |
| enhance_prompt | boolean | No | true |
Whether to enhance the prompt |
| self_anchor | boolean | No | true |
Re-anchor on the model's own latent variables (lucy-2.5 self-anchoring). Enabled by default. |
Response Parameters
The official OpenAPI success response schema is empty
| Parameter Name | Field Type | Description |
|---|---|---|
| job_id | string | Task ID, used for querying status and downloading results |
| status | string | Task status; successful submission is pending, and completion is completed |
Request Example
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"'
Response Example
Query video status
Synchronous query. Used for polling to check whether a task is completed
Request URL
GET https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/decart/jobs/{job_id}
Request Body Parameters / Request Query Parameters
| Parameter Name | Field Type | Required or not | default value | Description |
|---|---|---|---|---|
| job_id | string（path） | Yes | - | Job Id |
Response Parameters
The schema of the official OpenAPI successful response is empty; the following is the structure obtained from actual joint debugging tests. Document examples can also be found at failed.
| Parameter Name | Field Type | Description |
|---|---|---|
| job_id | string | Task ID |
| status | string | Task status; the measured result for completion is completed (see also document example: failed) |
Request Example
curl --location 'https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/decart/jobs/0ea63348-6b5d-4802-b2e2-7b4da2f2e250' \
--header 'Authorization: Bearer ${YOUR_AK}'
Response Example
Obtain video content
Download the results of completed tasks synchronously.
Request URL
GET https://genaiapi-m2.cloudsway.net/v1/ai/{YOUR_ENDPOINT}/decart/jobs/{job_id}/content
Request Body Parameters / Request Query Parameters
| Parameter Name | Field Type | Required or not | default value | Description |
|---|---|---|---|---|
| job_id | string | Yes | - | Job Id |
Response Parameters
| Parameter Name | Field Type | Description |
|---|---|---|
| body | binary | Download the results of completed tasks. Returns binary content or error information |
Request Example
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
Response Example
Binary video file (non-JSON). HTTP 200 on success, Content-Type: video/mp4, and the body is an MP4 ByteFlow.