📖 To learn more, take a look at our complete API

📤 Example Request

  1. Generate an api key below👇

  2. Install node-fetch & add the GOOEY_API_KEY to your environment variables.
    Never store the api key in your code and don't use direcly in the browser.

$ npm install node-fetch
$ export GOOEY_API_KEY=sk-xxxx
  1. Use this sample code to call the API.
    If you encounter any issues, write to us at [email protected] and make sure to include the full code snippet and the error message.
import fetch from 'node-fetch';

const payload = {
  "selected_models": [
    "veo-3"
  ],
  "inputs": {
    "seed": 0,
    "prompt": "{\n  \"shot\": {\n    \"composition\": \"tracking shot behind skateboarder weaving through fortress market alleys, villagers and stalls rushing past\",\n    \"lens\": \"handheld Steadicam with wide-angle medieval texture emphasis\",\n    \"frame_rate\": \"96fps with intermittent speed ramps\",\n    \"camera_movement\": \"fluid gliding pan following skateboarder, sudden whip-pans to capture near-collisions\"\n  },\n  \"subject\": {\n    \"description\": \"a young Tamil woman skillfully skateboarding, crouching low to accelerate and kick-turn between narrow market passages\",\n    \"wardrobe\": \"simple medieval tunic with practical wrap for mobility\",\n    \"props\": \"wooden skateboard stylized with carved Chola motifs\"\n  },\n  \"scene\": {\n    \"location\": \"labyrinthine fortress corridors of Thanjavur, lined with medieval Tamilnadu market stalls\",\n    \"time_of_day\": \"late afternoon golden light filtering through fortress arches\",\n    \"environment\": \"crowded with shopkeepers, pottery, spice sacks, silk rolls, and bronze idols; goats and children dart across paths\"\n  },\n  \"visual_details\": {\n    \"action\": \"skater dodges pottery carts, ollies over rope bundles, wall-rides briefly along stone rampart edges\",\n    \"special_effects\": \"motion blur on turns, dust motes swirling in sunlight, sparks when board scrapes stone\"\n  },\n  \"cinematography\": {\n    \"lighting\": \"warm golden-hour shafts through fortress openings, interplays of shadow and torchlight\",\n    \"color_palette\": \"earthy sandstone, turmeric yellow, indigo cloth, bronze gleam\",\n    \"tone\": \"fast-paced, daring, playful yet intense\"\n  },\n  \"audio\": {\n    \"music\": \"fast-paced Carnatic raga played with mridangam and veena, layered for adrenaline feel\",\n    \"ambient\": \"market chatter, clinking bronze, goats bleating faintly, wind whoosh\",\n    \"sound_effects\": \"board wheels scraping stone, whoops and gasps from villagers, occasional grunts from skater\",\n    \"mix_level\": \"dynamic surround with music dominant, market ambience woven underneath\"\n  },\n  \"dialogue\": {\n    \"character\": \"\",\n    \"line\": \"\",\n    \"subtitles\": false\n  }\n}",
    "auto_fix": true,
    "duration": "8s",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "enhance_prompt": true,
    "generate_audio": true,
    "negative_prompt": ""
  }
};

async function gooeyAPI() {
  const response = await fetch("https://test.api.gooey.ai/v2/video?example_id=8yw4xaby0ams", {
    method: "POST",
    headers: {
      "Authorization": "bearer " + process.env["GOOEY_API_KEY"],
      "Content-Type": "application/json",
    },
    body: JSON.stringify(payload),
  });

  if (!response.ok) {
    throw new Error(response.status);
  }

  const result = await response.json();
  console.log(response.status, result);
}

gooeyAPI();
  1. Generate an api key below👇

  2. Install requests & add the GOOEY_API_KEY to your environment variables.
    Never store the api key in your code.

$ python3 -m pip install requests
$ export GOOEY_API_KEY=sk-xxxx
  1. Use this sample code to call the API.
    If you encounter any issues, write to us at [email protected] and make sure to include the full code snippet and the error message.
import os
import requests

payload = {
    "selected_models": ["veo-3"],
    "inputs": {
        "seed": 0,
        "prompt": '{\n  "shot": {\n    "composition": "tracking shot behind skateboarder weaving through fortress market alleys, villagers and stalls rushing past",\n    "lens": "handheld Steadicam with wide-angle medieval texture emphasis",\n    "frame_rate": "96fps with intermittent speed ramps",\n    "camera_movement": "fluid gliding pan following skateboarder, sudden whip-pans to capture near-collisions"\n  },\n  "subject": {\n    "description": "a young Tamil woman skillfully skateboarding, crouching low to accelerate and kick-turn between narrow market passages",\n    "wardrobe": "simple medieval tunic with practical wrap for mobility",\n    "props": "wooden skateboard stylized with carved Chola motifs"\n  },\n  "scene": {\n    "location": "labyrinthine fortress corridors of Thanjavur, lined with medieval Tamilnadu market stalls",\n    "time_of_day": "late afternoon golden light filtering through fortress arches",\n    "environment": "crowded with shopkeepers, pottery, spice sacks, silk rolls, and bronze idols; goats and children dart across paths"\n  },\n  "visual_details": {\n    "action": "skater dodges pottery carts, ollies over rope bundles, wall-rides briefly along stone rampart edges",\n    "special_effects": "motion blur on turns, dust motes swirling in sunlight, sparks when board scrapes stone"\n  },\n  "cinematography": {\n    "lighting": "warm golden-hour shafts through fortress openings, interplays of shadow and torchlight",\n    "color_palette": "earthy sandstone, turmeric yellow, indigo cloth, bronze gleam",\n    "tone": "fast-paced, daring, playful yet intense"\n  },\n  "audio": {\n    "music": "fast-paced Carnatic raga played with mridangam and veena, layered for adrenaline feel",\n    "ambient": "market chatter, clinking bronze, goats bleating faintly, wind whoosh",\n    "sound_effects": "board wheels scraping stone, whoops and gasps from villagers, occasional grunts from skater",\n    "mix_level": "dynamic surround with music dominant, market ambience woven underneath"\n  },\n  "dialogue": {\n    "character": "",\n    "line": "",\n    "subtitles": false\n  }\n}',
        "auto_fix": True,
        "duration": "8s",
        "resolution": "720p",
        "aspect_ratio": "16:9",
        "enhance_prompt": True,
        "generate_audio": True,
        "negative_prompt": "",
    },
}

response = requests.post(
    "https://test.api.gooey.ai/v2/video?example_id=8yw4xaby0ams",
    headers={
        "Authorization": "bearer " + os.environ["GOOEY_API_KEY"],
    },
    json=payload,
)
assert response.ok, response.content

result = response.json()
print(response.status_code, result)
  1. Generate an api key below👇

  2. Install curl & add the GOOEY_API_KEY to your environment variables.
    Never store the api key in your code.

export GOOEY_API_KEY=sk-xxxx
  1. Run the following curl command in your terminal.
    If you encounter any issues, write to us at [email protected] and make sure to include the full curl command and the error message.
curl 'https://test.api.gooey.ai/v2/video?example_id=8yw4xaby0ams' \
  -H "Authorization: bearer $GOOEY_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "selected_models": [
    "veo-3"
  ],
  "inputs": {
    "seed": 0,
    "prompt": "{\n  \"shot\": {\n    \"composition\": \"tracking shot behind skateboarder weaving through fortress market alleys, villagers and stalls rushing past\",\n    \"lens\": \"handheld Steadicam with wide-angle medieval texture emphasis\",\n    \"frame_rate\": \"96fps with intermittent speed ramps\",\n    \"camera_movement\": \"fluid gliding pan following skateboarder, sudden whip-pans to capture near-collisions\"\n  },\n  \"subject\": {\n    \"description\": \"a young Tamil woman skillfully skateboarding, crouching low to accelerate and kick-turn between narrow market passages\",\n    \"wardrobe\": \"simple medieval tunic with practical wrap for mobility\",\n    \"props\": \"wooden skateboard stylized with carved Chola motifs\"\n  },\n  \"scene\": {\n    \"location\": \"labyrinthine fortress corridors of Thanjavur, lined with medieval Tamilnadu market stalls\",\n    \"time_of_day\": \"late afternoon golden light filtering through fortress arches\",\n    \"environment\": \"crowded with shopkeepers, pottery, spice sacks, silk rolls, and bronze idols; goats and children dart across paths\"\n  },\n  \"visual_details\": {\n    \"action\": \"skater dodges pottery carts, ollies over rope bundles, wall-rides briefly along stone rampart edges\",\n    \"special_effects\": \"motion blur on turns, dust motes swirling in sunlight, sparks when board scrapes stone\"\n  },\n  \"cinematography\": {\n    \"lighting\": \"warm golden-hour shafts through fortress openings, interplays of shadow and torchlight\",\n    \"color_palette\": \"earthy sandstone, turmeric yellow, indigo cloth, bronze gleam\",\n    \"tone\": \"fast-paced, daring, playful yet intense\"\n  },\n  \"audio\": {\n    \"music\": \"fast-paced Carnatic raga played with mridangam and veena, layered for adrenaline feel\",\n    \"ambient\": \"market chatter, clinking bronze, goats bleating faintly, wind whoosh\",\n    \"sound_effects\": \"board wheels scraping stone, whoops and gasps from villagers, occasional grunts from skater\",\n    \"mix_level\": \"dynamic surround with music dominant, market ambience woven underneath\"\n  },\n  \"dialogue\": {\n    \"character\": \"\",\n    \"line\": \"\",\n    \"subtitles\": false\n  }\n}",
    "auto_fix": true,
    "duration": "8s",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "enhance_prompt": true,
    "generate_audio": true,
    "negative_prompt": ""
  }
}'

🎁 Example Response

{4 Items
"id"
:
string
"0zg12h2ry91b"
"url"
:
string
"https://test.gooey.ai/video/"
"created_at"
:
string
"2025-10-05T19:54:37.442559+00:00"
"output"
:
{1 Items
"output_videos"
:
{1 Items
"veo-3"
:
string
"https://v3b.fal.media/files/b/lion/-LVfpuXBq9OdJno"
}
}
}

Please Login to generate the $GOOEY_API_KEY