mirror of https://github.com/Hommy-master/capcut-mate.git synced 2026-08-28 23:27:50 +08:00

Files

T

2. 删除多余文档。
3. 添加中英文切换开关。

2026-03-01 20:27:45 +08:00

5.4 KiB

Raw Blame History

AUDIO_TIMELINES API Documentation

🌐 Language Switch

中文版 | English

Interface Information

POST /openapi/capcut-mate/v1/audio_timelines

Function Description

Calculate timelines based on audio file durations. This interface analyzes the duration information of input audio files and automatically calculates and generates appropriate timeline configurations for precise time arrangement of audio materials in video editing.

Request Parameters

{
  "links": [
    {
      "url": "https://assets.jcaigc.cn/audio1.mp3",
      "duration": 5000000
    },
    {
      "url": "https://assets.jcaigc.cn/audio2.mp3",
      "duration": 3000000
    }
  ]
}

Parameter Description

Parameter	Type	Required	Default	Description
links	array[object]	✅	-	Audio link information array

links Array Structure

Each links array element contains the following fields:

Field	Type	Required	Default	Description
url	string	✅	-	Audio file URL address
duration	number	✅	-	Audio duration (microseconds)

Parameter Details

url

Type: string
Description: Complete URL address of the audio file
Example: "https://assets.jcaigc.cn/background.mp3"

duration

Type: number
Description: Duration of the audio file in microseconds (1 second = 1,000,000 microseconds)
Example: 5000000 (5 seconds)

Response Format

Success Response (200)

{
  "timelines": [
    {
      "start": 0,
      "end": 5000000
    },
    {
      "start": 5000000,
      "end": 8000000
    }
  ],
  "all_timelines": [
    {
      "start": 0,
      "end": 8000000
    }
  ]
}

Response Field Description

Field	Type	Description
timelines	array	Segmented audio timeline array
all_timelines	array	Complete audio timeline array
start	number	Start time of time segment (microseconds)
end	number	End time of time segment (microseconds)

Error Response (4xx/5xx)

{
  "detail": "Error message description"
}

Usage Examples

cURL Examples

1. Basic Audio Timeline Calculation

curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/audio_timelines \
  -H "Content-Type: application/json" \
  -d '{
    "links": [
      {
        "url": "https://assets.jcaigc.cn/intro.mp3",
        "duration": 3000000
      },
      {
        "url": "https://assets.jcaigc.cn/bgm.mp3",
        "duration": 15000000
      }
    ]
  }'

2. Multiple Audio Timeline Calculation

curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/audio_timelines \
  -H "Content-Type: application/json" \
  -d '{
    "links": [
      {
        "url": "https://assets.jcaigc.cn/opening.mp3",
        "duration": 2000000
      },
      {
        "url": "https://assets.jcaigc.cn/content.mp3",
        "duration": 10000000
      },
      {
        "url": "https://assets.jcaigc.cn/ending.mp3",
        "duration": 3000000
      }
    ]
  }'

Error Code Description

Error Code	Error Message	Description	Solution
400	links is required	Missing audio link parameter	Provide valid links array
400	links format error	Invalid JSON format	Check JSON array format
400	url is required	Missing audio URL	Provide URL for each audio
400	duration is required	Missing audio duration	Provide duration for each audio
400	duration must be greater than 0	Invalid duration parameter	Use duration value greater than 0
404	Audio resource not found	Audio URL inaccessible	Check if audio URL is accessible
500	Audio timeline calculation failed	Internal processing error	Contact technical support

Notes

Time Unit: All time parameters use microseconds (1 second = 1,000,000 microseconds)
Parameter Requirements: links array is required, and each element needs url and duration
Duration Accuracy: Ensure the provided duration parameter accurately reflects the actual audio duration
Network Access: Audio URLs must be accessible (for verification)
Continuity: Timelines are arranged continuously in audio order without gaps
Total Duration: The end value of complete timeline equals the sum of all audio durations

Workflow

Validate required parameter (links)
Parse audio information from each element in links array
Validate url and duration parameters for each audio
Calculate time segments for each audio in order
Generate segmented audio timeline array
Generate complete audio timeline array
Return timeline configuration result

📚 Project Resources
GitHub: https://github.com/Hommy-master/capcut-mate
Gitee: https://gitee.com/taohongmin-gitee/capcut-mate

Language Switch