Skip to content
当前页导航

SAVE_DRAFT API Documentation

🌐 Language Switch

中文版 | English

Interface Information

POST /openapi/capcut-mate/v1/save_draft

Function Description

Save Jianying draft. This interface is used to save the current draft state, ensuring that edited content is persistently stored. Usually called after completing a series of editing operations to prevent loss of edited content.

More Documentation

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

Request Parameters

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

Parameter Description

ParameterTypeRequiredDefaultDescription
draft_urlstring-Draft URL to be saved

Parameter Details

draft_url

  • Type: String
  • Required: Yes
  • Format: Complete draft URL, usually returned by create_draft interface
  • Example: https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_draft?draft_id=2025092811473036584258

Response Format

Success Response (200)

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

Response Field Description

FieldTypeDescription
draft_urlstringSaved draft URL, usually the same as the URL in the request

Error Response (4xx/5xx)

json
{
  "detail": "Error message description"
}

Usage Examples

cURL Examples

1. Basic Save Draft

bash
curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/save_draft \
  -H "Content-Type: application/json" \
  -d '{
    "draft_url": "https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_draft?draft_id=2025092811473036584258"
  }'

Error Code Description

Error CodeError MessageDescriptionSolution
400draft_url is requiredMissing draft URL parameterProvide a valid draft_url
400Invalid draft_url formatURL format is incorrectCheck if URL format is correct
404Draft does not existSpecified draft cannot be foundConfirm that draft URL is correct and exists
500Save failedInternal service errorContact technical support or retry later
503Service unavailableSystem maintenanceRetry later

Notes

  1. URL Validity: Ensure the passed draft_url is valid and exists
  2. Network Stability: Save operation requires stable network connection
  3. Frequency Control: Avoid overly frequent save operations
  4. Concurrency Safety: Concurrent saves of the same draft may cause conflicts

Workflow

  1. Validate draft_url parameter
  2. Check if draft exists
  3. Get current draft state
  4. Persistently save draft data
  5. Return save result

Language Switch

中文版 | English