Creatify API Docs

Appearance

Product Video ​

Fresh

Purpose ​

Convert a product image into a professional video ad with AI-generated scenes and effects using the Creatify Product Video API.

Prerequisites ​

  • Authenticated API access (Authentication SOP)
  • Product image (publicly accessible URL)
  • Sufficient credits (3 per 30s of video)

Procedure ​

Step 1: Generate AI Image from Product ​

Upload your product image and let AI generate a styled scene.

bash
curl --request POST \
  --url https://api.creatify.ai/api/product_videos/gen_image/ \
  --header "Content-Type: application/json" \
  --header "X-API-ID: $CREATIFY_API_ID" \
  --header "X-API-KEY: $CREATIFY_API_KEY" \
  --data '{
    "image_url": "https://example.com/product-photo.jpg",
    "prompt": "Professional product showcase in a modern studio setting"
  }'

Response:

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

Step 2: Poll Image Generation Status ​

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

Step 3: Regenerate Image (Optional) ​

If the generated image does not match your vision, regenerate with a different prompt:

bash
curl --request POST \
  --url https://api.creatify.ai/api/product_videos/pv-task-uuid/regen_image/ \
  --header "Content-Type: application/json" \
  --header "X-API-ID: $CREATIFY_API_ID" \
  --header "X-API-KEY: $CREATIFY_API_KEY" \
  --data '{
    "prompt": "Luxury product on marble surface with soft lighting"
  }'

Step 4: Generate Video from Image ​

Once the AI-generated image is satisfactory, generate the video:

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

Step 5: Poll Video Generation and Download ​

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

Completed response:

json
{
  "id": "pv-task-uuid",
  "status": "done",
  "output": "https://cdn.creatify.ai/videos/product-video-output.mp4",
  "generated_image": "https://cdn.creatify.ai/images/ai-product-scene.jpg"
}

Step 6: Regenerate Video (Optional) ​

If the video needs adjustment:

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

Credit Cost ​

OperationCredits
Generate AI imageIncluded
Regenerate imageIncluded
Generate video3 per 30s
Regenerate video3 per 30s

TIP

Product Video is cheaper than URL-to-Video (3 credits/30s vs 5 credits/30s). Use it when you already have product images.

Verification Checklist ​

  • [ ] Product image URL is publicly accessible
  • [ ] AI-generated image correctly features the product
  • [ ] Video showcases the product with appropriate motion
  • [ ] Video output is the correct aspect ratio
  • [ ] Output URL returns valid MP4

See Also