POST
/
api
/
ai_scripts
curl --request POST \
  --url https://api.creatify.ai/api/ai_scripts/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-ID: <api-key>' \
  --header 'X-API-KEY: <api-key>' \
  --data '{
  "url": "<string>",
  "title": "<string>",
  "description": "<string>",
  "language": "ar",
  "target_audience": "<string>",
  "video_length": 15,
  "script_styles": [
    "BenefitsV2"
  ]
}'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "language": "ar",
  "target_audience": "<string>",
  "video_length": 15,
  "script_styles": [
    "BenefitsV2"
  ],
  "generated_scripts": [
    {
      "paragraphs": "<string>",
      "script_name": "<string>",
      "script_style": "",
      "title": "<string>"
    }
  ],
  "failed_reason": "<string>",
  "status": "pending",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "user": 123,
  "workspace": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "product": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "url": "<string>",
    "slug": "<string>",
    "title": "<string>",
    "alias_name": "<string>",
    "description": "<string>",
    "image_urls": "<any>",
    "video_urls": "<any>",
    "image_selected": "<any>",
    "video_selected": "<any>",
    "is_auto_analyzed": true,
    "status": "raw",
    "reviews": "<any>",
    "created_with": "link_to_video",
    "logo_url": "<string>",
    "price": "<string>",
    "original_price": "<string>",
    "promo_price": "<string>",
    "use_promotional_info": true,
    "highlight_features": "<string>",
    "brand_info": "<string>",
    "promotional_details": "<string>",
    "ai_summary": "<string>",
    "ai_target_audiences": "<any>",
    "ai_key_features": "<any>",
    "ai_keywords": "<any>",
    "updated_at": "2023-11-07T05:31:56Z"
  },
  "credits_used": 123
}

Authorizations

​
X-API-ID
string
header
required

API ID, from your settings page.

​
X-API-KEY
string
header
required

API Key, from your settings page.

Body

​
url
string
​
title
string
​
description
string
​
language
enum<string>
  • ar - Arabic
  • bg - Bulgarian
  • cs - Czech
  • da - Danish
  • de - German
  • el - Greek, Modern
  • en - English
  • es - Spanish; Castilian
  • fi - Finnish
  • fr - French
  • hi - Hindi
  • hr - Croatian
  • id - Indonesian
  • it - Italian
  • ja - Japanese
  • ko - Korean
  • ms - Malay
  • nl - Dutch
  • pl - Polish
  • pt - Portuguese
  • ro - Romanian, Moldavian, Moldovan
  • ru - Russian
  • sk - Slovak
  • sv - Swedish
  • ta - Tamil
  • tl - Tagalog
  • tr - Turkish
  • uk - Ukrainian
  • zh - Chinese
Available options:
ar,
bg,
cs,
da,
de,
el,
en,
es,
fi,
fr,
hi,
hr,
id,
it,
ja,
ko,
ms,
nl,
pl,
pt,
ro,
ru,
sk,
sv,
ta,
tl,
tr,
uk,
zh
​
target_audience
string | null
​
video_length
enum<integer>
  • 15 - 15
  • 30 - 30
  • 60 - 60
Available options:
15,
30,
60
​
script_styles
enum<string>[]

List of script styles to generate, if not provided, four random script styles will be generated

  • BenefitsV2 - Benefits
  • BrandStoryV2 - Brand Story
  • CallToActionV2 - Call To Action
  • DiscoveryWriter - Discovery
  • DontWorryWriter - Don't Worry
  • EmotionalWriter - Emotional
  • GenzWriter - Gen Z
  • HowToV2 - How To
  • LetMeShowYouWriter - Let Me Show You
  • MotivationalWriter - Motivational
  • ProblemSolutionV2 - Problem Solution
  • ProblemSolutionWriter - Problem-Solution
  • ProductHighlightsV2 - Product Highlights
  • ProductLifestyleV2 - Product Lifestyle
  • ResponseBubbleWriter - Response Bubble
  • SpecialOffersV2 - Special Offers
  • StoryTimeWriter - Storytime
  • ThreeReasonsWriter - 3 Reasons Why
  • TrendingTopicsV2 - Trending Topics
Available options:
BenefitsV2,
BrandStoryV2,
CallToActionV2,
DiscoveryWriter,
DontWorryWriter,
EmotionalWriter,
GenzWriter,
HowToV2,
LetMeShowYouWriter,
MotivationalWriter,
ProblemSolutionV2,
ProblemSolutionWriter,
ProductHighlightsV2,
ProductLifestyleV2,
ResponseBubbleWriter,
SpecialOffersV2,
StoryTimeWriter,
ThreeReasonsWriter,
TrendingTopicsV2

Response

201 - application/json
​
id
string
required
​
generated_scripts
object[]
required
​
failed_reason
string | null
required
​
status
enum<string>
required
  • pending - Pending
  • in_queue - In Queue
  • running - Running
  • failed - Failed
  • done - Done
  • rejected - Rejected
Available options:
pending,
in_queue,
running,
failed,
done,
rejected
​
created_at
string
required
​
updated_at
string
required
​
user
integer | null
required
​
workspace
string | null
required
​
product
object
required
​
credits_used
integer
required

Credits used in this api call

​
language
enum<string>
  • ar - Arabic
  • bg - Bulgarian
  • cs - Czech
  • da - Danish
  • de - German
  • el - Greek, Modern
  • en - English
  • es - Spanish; Castilian
  • fi - Finnish
  • fr - French
  • hi - Hindi
  • hr - Croatian
  • id - Indonesian
  • it - Italian
  • ja - Japanese
  • ko - Korean
  • ms - Malay
  • nl - Dutch
  • pl - Polish
  • pt - Portuguese
  • ro - Romanian, Moldavian, Moldovan
  • ru - Russian
  • sk - Slovak
  • sv - Swedish
  • ta - Tamil
  • tl - Tagalog
  • tr - Turkish
  • uk - Ukrainian
  • zh - Chinese
Available options:
ar,
bg,
cs,
da,
de,
el,
en,
es,
fi,
fr,
hi,
hr,
id,
it,
ja,
ko,
ms,
nl,
pl,
pt,
ro,
ru,
sk,
sv,
ta,
tl,
tr,
uk,
zh
​
target_audience
string | null
​
video_length
enum<integer>
  • 15 - 15
  • 30 - 30
  • 60 - 60
Available options:
15,
30,
60
​
script_styles
enum<string>[]

List of script styles to generate, if not provided, four random script styles will be generated

  • BenefitsV2 - Benefits
  • BrandStoryV2 - Brand Story
  • CallToActionV2 - Call To Action
  • DiscoveryWriter - Discovery
  • DontWorryWriter - Don't Worry
  • EmotionalWriter - Emotional
  • GenzWriter - Gen Z
  • HowToV2 - How To
  • LetMeShowYouWriter - Let Me Show You
  • MotivationalWriter - Motivational
  • ProblemSolutionV2 - Problem Solution
  • ProblemSolutionWriter - Problem-Solution
  • ProductHighlightsV2 - Product Highlights
  • ProductLifestyleV2 - Product Lifestyle
  • ResponseBubbleWriter - Response Bubble
  • SpecialOffersV2 - Special Offers
  • StoryTimeWriter - Storytime
  • ThreeReasonsWriter - 3 Reasons Why
  • TrendingTopicsV2 - Trending Topics
Available options:
BenefitsV2,
BrandStoryV2,
CallToActionV2,
DiscoveryWriter,
DontWorryWriter,
EmotionalWriter,
GenzWriter,
HowToV2,
LetMeShowYouWriter,
MotivationalWriter,
ProblemSolutionV2,
ProblemSolutionWriter,
ProductHighlightsV2,
ProductLifestyleV2,
ResponseBubbleWriter,
SpecialOffersV2,
StoryTimeWriter,
ThreeReasonsWriter,
TrendingTopicsV2