Flikly Developers
Core APIs

AI Video Jobs

Create AI video generation jobs at POST https://api.flikly.ai/api/v1/developer/video-jobs. Supports text-to-video and image-to-video via source_asset_id.

Text-to-video

{
  "prompt": "A slow aerial shot over misty mountains at dawn",
  "aspect_ratio": "9:16",
  "duration_seconds": 10,
  "model": "auto"
}

Image-to-video

Upload an image asset with purpose image_source, then reference it:

{
  "prompt": "Subtle parallax and warm lighting",
  "source_asset_id": "asset_abc123",
  "duration_seconds": 5,
  "style": "cinematic"
}

Parameters

  • aspect_ratio: 9:16, 16:9, 1:1
  • duration_seconds: 5, 10, 15
  • model: auto only in v1
  • style (optional): realistic, cinematic, animated
  • metadata (optional JSON, max 8 KB) — may include external_id for filtering in unified jobs

Idempotency

Send Idempotency-Key on create. See Idempotency.

Statuses

queued → processing → completed | failed | cancelled | expired

Result retrieval

  • GET /video-jobs/{id} — status, credits, progress (no download URL)
  • GET /video-jobs/{id}/result — presigned download_url when completed

Credits and concurrency

Jobs estimate and charge credits on create. Insufficient balance returns INSUFFICIENT_CREDITS. Active queued + processing jobs count toward concurrent_video_jobs (Team default: 3). Exceeding the limit returns CONCURRENT_JOB_LIMIT_EXCEEDED.

Scopes: video:create, video:read.