POST
/
v1
/
video
curl --request POST \
  --url https://nano-gpt.com/api/v1/video \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "prompt": "Create a whimsical animated story about a young inventor who creates a flying bicycle",
  "script": "A young inventor'\''s workshop filled with whimsical contraptions and floating gears.",
  "framework": "default",
  "targetLengthInWords": 70,
  "directorNotes": "Use warm, golden lighting and make the workshop scenes feel cozy and inviting",
  "imageConfig": {
    "model": "recraft",
    "style": "realistic_image/studio_portrait",
    "loraConfig": {
      "loraSlug": "ghibsky-comic-book"
    }
  },
  "voice": "pNInz6obpgDQGcFmaJgB",
  "captionsShow": true,
  "captionsStyle": "default",
  "effects": {
    "transition": "fade",
    "floating": false
  },
  "quality": "medium",
  "motion": {
    "enabled": false,
    "strength": 3
  },
  "music": "video-creation/music/dramatic_cinematic_score.mp3"
}'
{
  "runId": "<string>",
  "projectId": "<string>",
  "cost": 123,
  "paymentSource": "<string>",
  "status": "PENDING"
}

Authorizations

​
x-api-key
string
header
required

Body

application/json
Parameters for video generation
​
prompt
string
required

The prompt for video generation (mutually exclusive with script)

Example:

"Create a whimsical animated story about a young inventor who creates a flying bicycle"

​
script
string

A fully-written script to skip AI script generation (takes precedence over prompt)

Example:

"A young inventor's workshop filled with whimsical contraptions and floating gears."

​
framework
enum<string>
default:default

The story framework to use

Available options:
default,
emotional_story,
product_showcase,
tutorial
​
targetLengthInWords
integer
default:70

Target length in words

Example:

70

​
directorNotes
string

Specific instructions for the image generation engine

Example:

"Use warm, golden lighting and make the workshop scenes feel cozy and inviting"

​
imageConfig
object

Configuration for image generation

​
voice
string

Voice ID to use for narration

Example:

"pNInz6obpgDQGcFmaJgB"

​
captionsShow
boolean
default:true

Whether to show captions

​
captionsStyle
enum<string>
default:default

Style for captions

Available options:
default,
minimal,
neon,
cinematic,
fancy,
tiktok,
highlight,
gradient,
instagram,
vida,
manuscripts
​
effects
object

Video effects configuration

​
quality
enum<string>
default:medium

Video quality

Available options:
low,
medium,
high
​
motion
object

Motion configuration

​
music
string

Music track to use

Example:

"video-creation/music/dramatic_cinematic_score.mp3"

Response

200
application/json
Video generation request submitted successfully
​
runId
string

Unique identifier for the generation run

​
projectId
string

Unique identifier for the project

​
cost
number

Cost of the video generation

​
paymentSource
string

Payment source used

​
status
enum<string>

Current status of the generation

Available options:
PENDING,
PROCESSING,
COMPLETED,
FAILED