curl -X POST "https://api.hooked.so/v1/project/create/cinematic" \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "storyBrief": "A lighthouse keeper finds a message in a bottle during a storm and decides to answer it.",
    "durationSeconds": 30,
    "model": "grok_imagine_video",
    "storyTone": "drama",
    "presetId": "cinematic",
    "webhook": "https://example.com/hooked/webhook?token=YOUR_SECRET"
  }'

const response = await fetch("https://api.hooked.so/v1/project/create/cinematic", {
  method: "POST",
  headers: {
    "x-api-key": "your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    storyBrief: "A lighthouse keeper finds a message in a bottle during a storm and decides to answer it.",
    durationSeconds: 30,
    model: "grok_imagine_video",
    storyTone: "drama",
    presetId: "cinematic",
    webhook: "https://example.com/hooked/webhook?token=YOUR_SECRET",
  }),
});

const { data } = await response.json();
console.log(data.projectId);

import requests

response = requests.post(
    "https://api.hooked.so/v1/project/create/cinematic",
    headers={"x-api-key": "your_api_key_here"},
    json={
        "storyBrief": "A lighthouse keeper finds a message in a bottle during a storm and decides to answer it.",
        "durationSeconds": 30,
        "model": "grok_imagine_video",
        "storyTone": "drama",
        "presetId": "cinematic",
        "webhook": "https://example.com/hooked/webhook?token=YOUR_SECRET",
    },
)

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

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

{
  "success": false,
  "message": "model: Invalid model \"sora\". Allowed values are: veo_3_fast, veo_3, gemini_omni_flash, grok_imagine_video, kling_3_0, seedance_2_0, seedance_2_0_fast, veo_3_1_lite, seedance_2_0_mini"
}

{
  "code": "not_authenticated",
  "message": "Not authenticated",
  "errorCode": "NOT_AUTHENTICATED",
  "details": { "x-api-key": "Header not provided or API Key invalid" }
}

{
  "success": false,
  "errorCode": "INSUFFICIENT_CREDITS",
  "message": "Not enough credits. Needed: 260, Available: 100",
  "creditsNeeded": 260,
  "creditsAvailable": 100
}

{
  "code": "missing_credentials",
  "message": "Your team uses its own provider keys (BYOK) and these are missing or invalid: OpenRouter. Add them in Settings → AI keys.",
  "errorCode": "MISSING_CREDENTIALS",
  "missingProviders": ["openrouter"],
  "details": {}
}

{
  "code": "entitlement_required",
  "error": "entitlement_required",
  "message": "This endpoint requires the \"app\" product.",
  "product": "app"
}

{
  "success": false,
  "code": "feature_not_available",
  "error": "feature_not_available",
  "message": "Cinematic videos are not available on this platform."
}