Skip to main content
POST
/
api
/
agent
/
shorts
/
merge
Merge shorts videos and add subtitles
curl --request POST \
  --url https://www.citedy.com/api/agent/shorts/merge \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "video_urls": [
    "<string>"
  ],
  "phrases": [
    {
      "text": "<string>"
    }
  ],
  "config": {
    "words_per_phrase": 5,
    "font_size": 44,
    "position_from_bottom": 175,
    "text_color": "<string>",
    "stroke_color": "<string>",
    "stroke_width": 2
  }
}
'
{
  "video_url": "<string>",
  "r2_key": "<string>",
  "duration": 1,
  "segment_durations": [
    1
  ],
  "credits_charged": 1
}

Authorizations

Authorization
string
header
required

Bearer citedy_agent_* key

Body

application/json
video_urls
string<uri>[]
required

2-4 video URLs hosted on download.citedy.com

Required array length: 2 - 4 elements
Pattern: ^https://download\.citedy\.com/
phrases
object[]
required

Must contain exactly one phrase per video URL

Required array length: 2 - 4 elements
config
object

Response

Merge completed

video_url
string<uri>
required
r2_key
string
required
duration
number
required
Required range: x >= 0
segment_durations
number[]
required
Required range: x >= 0
credits_charged
integer
required
Required range: x >= 0