GEN_VIDEO API Documentation #

🌐 Language Switch #

中文版 | English

Interface Information #

POST /openapi/capcut-mate/v1/gen_video

Function Description #

Submit video generation task. This interface uses asynchronous processing mode, immediately returning task submission status, with video generation performed in the background. Supports task queuing to ensure system stability.

More Documentation #

📖 For more detailed documentation and tutorials, please visit: https://docs.jcaigc.cn

Request Parameters #

{
  "draft_url": "https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_draft?draft_id=2025092811473036584258"
}

Parameter Description #

Parameter Details #

Draft URL Parameter #

• draft_url: Complete URL address of the draft
  • Format: https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_draft?draft_id={draft_ID}
  • Example: "https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_draft?draft_id=2025092811473036584258"
  • Acquisition Method: Obtained via Create Draft or Save Draft interfaces

Response Format #

Success Response (200) #

{
  "message": "Video generation task submitted, please use draft_url to check progress"
}

Response Field Description #

Error Response (4xx/5xx) #

{
  "detail": "Error message description"
}

Usage Examples #

cURL Examples #

1. Basic Video Generation #

curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/gen_video \
  -H "Content-Type: application/json" \
  -d '{
    "draft_url": "YOUR_DRAFT_URL"
  }'

Error Code Description #

Notes #

1. Processing Time: Video generation is time-consuming, may take minutes to tens of minutes
2. File Size: Draft complexity and number of materials affect processing time
3. Network Stability: Ensure material URLs are stably accessible
4. Timeout Settings: Suggest setting longer timeout or using polling mechanism
5. Concurrency Limit: Avoid generating large numbers of videos simultaneously
6. Storage Space: Generated video files may be large, pay attention to storage space
7. URL Validity: Generated video_url may have time-based restrictions
8. System Requirements: Video generation feature only available on Windows systems

Workflow #

1. Validate draft_url parameter
2. Parse draft configuration file
3. Download all required material files
4. Arrange and process materials according to timeline
5. Apply visual effects and transitions
6. Mix audio tracks
7. Render final video
8. Encode and upload video file
9. Return video URL

Related Interfaces #

• Create Draft
• Save Draft
• Add Videos
• Add Audios
• Add Images
• Get Draft
• Query Video Generation Status

Language Switch #

中文版 | English