Creatify API Docs

Appearance

AI Script Generation ​

Fresh

Purpose ​

Generate AI-powered video scripts from a URL or text description using the Creatify AI Scripts API. Scripts can then be used with avatar, URL-to-video, or shorts endpoints.

Prerequisites ​

  • Authenticated API access (Authentication SOP)
  • A URL to a webpage OR a title and description
  • 1 credit per script

Procedure ​

Step 1: Generate Script from URL ​

Creatify scrapes the URL and generates a video-optimized script.

bash
curl --request POST \
  --url https://api.creatify.ai/api/ai_scripts/ \
  --header "Content-Type: application/json" \
  --header "X-API-ID: $CREATIFY_API_ID" \
  --header "X-API-KEY: $CREATIFY_API_KEY" \
  --data '{
    "url": "https://www.example.com/product-page"
  }'

Alternative: Generate from Title and Description ​

bash
curl --request POST \
  --url https://api.creatify.ai/api/ai_scripts/ \
  --header "Content-Type: application/json" \
  --header "X-API-ID: $CREATIFY_API_ID" \
  --header "X-API-KEY: $CREATIFY_API_KEY" \
  --data '{
    "title": "Amazing Product Launch",
    "description": "A revolutionary product that solves common problems with innovative AI technology. Features include real-time analysis, automated reporting, and seamless integration."
  }'

Response:

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

Step 2: Poll for Completion ​

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

Completed response:

json
{
  "id": "script-task-uuid",
  "status": "done",
  "script": "Are you tired of manual video creation? Meet Creatify - the AI-powered platform that turns any URL into a professional video ad in minutes. With over 1500 AI avatars and studio-grade rendering, your marketing team can produce content 10x faster. Try Creatify today.",
  "scenes": [
    {
      "text": "Are you tired of manual video creation?",
      "visual_description": "Person frustrated at desk with multiple browser tabs open"
    },
    {
      "text": "Meet Creatify - the AI-powered platform that turns any URL into a professional video ad in minutes.",
      "visual_description": "Product demo showing URL being converted to video"
    }
  ]
}

Step 3: Use the Script ​

The generated script can be used in:

Credit Cost ​

OperationCredits
Generate script1 per script
List scripts0

TIP

At 1 credit per script, AI Scripts is one of the cheapest endpoints. Generate multiple script variations and pick the best one before committing to video generation.

Verification Checklist ​

  • [ ] Task creation returns pending status
  • [ ] Final status is done with script content
  • [ ] Script is coherent and relevant to the input
  • [ ] Script length is appropriate for target video duration
  • [ ] Scene breakdowns make sense for multi-scene videos

See Also