Skip to content

Preview URL to Video

FreshPOST
POST https://api.creatify.ai/api/link_to_videos/preview/

Generate a preview of a URL-to-video task. Previews are lower quality but allow you to verify content before rendering.

Credit Cost

1 credit per 30 seconds of video

Request Body

NameTypeRequiredDescription
idstringYesThe task ID to preview

Headers

HeaderTypeRequiredDescription
X-API-IDstringYesYour Creatify API ID
X-API-KEYstringYesYour Creatify API key
Content-TypestringYesapplication/json

Example Request

bash
curl -X POST 'https://api.creatify.ai/api/link_to_videos/preview/' \
  -H 'X-API-ID: your-api-id' \
  -H 'X-API-KEY: your-api-key' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "ltv-001"
  }'

Response

json
{
  "id": "ltv-001",
  "status": "processing",
  "preview": null
}

When complete:

json
{
  "id": "ltv-001",
  "status": "done",
  "preview": "https://cdn.creatify.ai/previews/ltv-001.mp4"
}

Status Codes

CodeDescription
200Preview generation started
401Unauthorized -- invalid API credentials
402Insufficient credits
404Task not found
500Internal server error

TIP

Always preview before rendering to verify the video content matches your expectations. Previewing costs 1 credit vs 4 credits for rendering.