Skip to main content
POST
Generate short-form video

Authorizations

Authorization
string
header
required

Bearer citedy_agent_* key

Body

application/json
prompt
string
required
Required string length: 10 - 2000
avatar_url
string<uri>
required
duration
enum<integer>
required
Available options:
5,
10,
15
article_id
string<uuid>

Optional article ID. When provided, shorts_video_url is saved to article metadata on completion.

resolution
enum<string>
default:480p
Available options:
480p,
720p
aspect_ratio
enum<string>
default:9:16
Available options:
9:16,
16:9,
1:1
speech_text
string
Required string length: 5 - 1000

Response

Generation accepted. Poll GET /api/agent/shorts/{id} with the same Authorization: Bearer <AGENT_API_KEY> header for status.

id
string<uuid>
required
status
enum<string>
required
Available options:
generating
video_url
string | null
required
credits_charged
integer
required
Required range: x >= 0
estimated_seconds
integer
required
Required range: x >= 1