Create AI Short

FreshPOST

POST https://api.creatify.ai/api/ai_shorts/

Create a new AI short-form video. AI Shorts automatically generates short, engaging video content optimized for platforms like TikTok, Instagram Reels, and YouTube Shorts.

Request Body

Name	Type	Required	Description
video_url	string	No	Source video URL to create a short from
text	string	No	Script or topic for the short
aspect_ratio	string	No	Output aspect ratio. Defaults to 9:16 for shorts
style	string	No	Visual style preset
duration	string	No	Target duration (e.g., 15, 30, 60)

Headers

Header	Type	Required	Description
X-API-ID	string	Yes	Your Creatify API ID
X-API-KEY	string	Yes	Your Creatify API key
Content-Type	string	Yes	application/json

Example Request

curl -X POST 'https://api.creatify.ai/api/ai_shorts/' \
  -H 'X-API-ID: your-api-id' \
  -H 'X-API-KEY: your-api-key' \
  -H 'Content-Type: application/json' \
  -d '{
    "text": "5 reasons why our product saves you time",
    "aspect_ratio": "9:16",
    "duration": "30"
  }'

Response

{
  "id": "short-001",
  "status": "pending",
  "created_at": "2024-01-15T10:30:00Z"
}

Status Codes

Code	Description
201	Task created successfully
400	Bad request -- invalid parameters
401	Unauthorized -- invalid API credentials
402	Insufficient credits
429	Rate limit exceeded
500	Internal server error

Workflow

1. Create the AI short task
2. Poll GET /api/ai_shorts/{id}/ until status is done
3. Preview with POST /api/ai_shorts/{id}/preview/
4. Render final with POST /api/ai_shorts/{id}/render/

TIP

AI Shorts defaults to 9:16 vertical format, optimized for mobile-first social platforms.