Creatify API Docs

Appearance

AI Editing ​

Fresh

Purpose ​

Upload an existing video and let Creatify's AI enhance, stylize, and transform it using the AI Editing API.

Prerequisites ​

  • Authenticated API access (Authentication SOP)
  • A video file (publicly accessible URL)
  • Sufficient credits (5/30s create, 1/30s preview, 4/30s render)

Procedure ​

Step 1: Create an AI Editing Task ​

bash
curl --request POST \
  --url https://api.creatify.ai/api/ai_editing/ \
  --header "Content-Type: application/json" \
  --header "X-API-ID: $CREATIFY_API_ID" \
  --header "X-API-KEY: $CREATIFY_API_KEY" \
  --data '{
    "video_url": "https://example.com/raw-video.mp4",
    "style": "professional",
    "aspect_ratio": "9:16"
  }'

Response:

json
{
  "id": "ai-edit-task-uuid",
  "status": "pending"
}

Step 2: Poll for Preview Completion ​

bash
curl --request GET \
  --url https://api.creatify.ai/api/ai_editing/ai-edit-task-uuid/ \
  --header "X-API-ID: $CREATIFY_API_ID" \
  --header "X-API-KEY: $CREATIFY_API_KEY"

Poll every 5-10 seconds until status is done.

Step 3: Review Preview ​

The preview is a lower-quality version for review purposes. Check:

  • Style matches expectations
  • Edits enhance rather than distort
  • Audio is preserved correctly
  • Timing and pacing are appropriate

Step 4: Render Final Video ​

bash
curl --request POST \
  --url https://api.creatify.ai/api/ai_editing/ai-edit-task-uuid/render/ \
  --header "X-API-ID: $CREATIFY_API_ID" \
  --header "X-API-KEY: $CREATIFY_API_KEY"

Step 5: Poll Render and Download ​

bash
curl --request GET \
  --url https://api.creatify.ai/api/ai_editing/ai-edit-task-uuid/ \
  --header "X-API-ID: $CREATIFY_API_ID" \
  --header "X-API-KEY: $CREATIFY_API_KEY"

Completed response:

json
{
  "id": "ai-edit-task-uuid",
  "status": "done",
  "output": "https://cdn.creatify.ai/videos/edited-output.mp4"
}

Credit Cost ​

OperationCredits
Create editing task5 per 30s
Generate preview1 per 30s
Render final4 per 30s

Verification Checklist ​

  • [ ] Video URL is publicly accessible
  • [ ] Task creation returns pending status
  • [ ] Preview shows appropriate AI enhancements
  • [ ] Audio is intact after editing
  • [ ] Rendered video is higher quality than preview
  • [ ] Output URL returns valid MP4

See Also