Cinematic Studio Example

const response = await fetch('https://api.hooked.so/v1/project/create/cinematic', {
  method: 'POST',
  headers: {
    'x-api-key': process.env.HOOKED_API_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'The Lighthouse',
    storyBrief: 'A lighthouse keeper finds a message in a bottle during a storm. She reads it aloud, hesitates, then writes an answer and throws the bottle back into the sea.',
    durationSeconds: 30,
    model: 'grok_imagine_video',
    storyTone: 'drama',
    presetId: 'cinematic',
    aspectRatio: 'ratio_16_9',
    musicId: '1',
    webhook: 'https://yoursite.com/hooked-webhook?token=YOUR_SECRET',
    metadata: { campaign: 'storm-teaser' }
  })
});

const { data } = await response.json();
console.log('Project ID:', data.projectId); // status: "processing"

import os
import requests

response = requests.post(
    "https://api.hooked.so/v1/project/create/cinematic",
    headers={"x-api-key": os.environ["HOOKED_API_KEY"]},
    json={
        "storyBrief": "Two rival street racers have to team up when their cars break down in the middle of the desert.",
        "durationSeconds": 45,
        "model": "kling_3_0",
        "storyTone": "action",
        "presetId": "anime",
        "aspectRatio": "ratio_9_16",
        "webhook": "https://yoursite.com/hooked-webhook?token=YOUR_SECRET",
    },
)

print(response.json()["data"]["projectId"])

curl -X POST "https://api.hooked.so/v1/project/create/cinematic" \
  -H "x-api-key: $HOOKED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "storyBrief": "Lucía mira por la ventana y dice: \"Mañana me voy\". Su abuelo sonríe y responde: \"Ya lo sabía\".",
    "durationSeconds": 15,
    "model": "veo_3_fast",
    "presetId": "pixar",
    "language": "es",
    "preserveExactStoryText": true
  }'

{
  "success": true,
  "data": { "projectId": "clx9p2k4m0001abcd1234efgh", "status": "processing" },
  "message": "Cinematic successfully created"
}

async function waitForFilm(projectId) {
  while (true) {
    const res = await fetch(`https://api.hooked.so/v1/project/${projectId}`, {
      headers: { 'x-api-key': process.env.HOOKED_API_KEY }
    });
    const { data } = await res.json();

    if (data.video?.status === 'COMPLETED') return data.video.url;
    if (data.status === 'failed' || data.video?.status === 'FAILED') {
      throw new Error(data.video?.message || data.message || 'Video failed');
    }

    await new Promise((resolve) => setTimeout(resolve, 30000)); // every ~30 s
  }
}