curl -X POST "https://api.hooked.so/v1/project/create/talking-avatar" \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "script": "I tried every budgeting app out there. This is the first one I actually kept using. It just tells me what I can spend today.",
    "avatarId": "cm4x9k2p10001ab12cd34ef56",
    "language": "en",
    "caption": { "preset": "tiktok", "alignment": "bottom" },
    "videoStyle": { "cameras": ["static-shot", "slow-zoom-to-the-face"] },
    "webhook": "https://example.com/hooks/hooked?token=YOUR_SECRET",
    "metadata": { "campaign": "fall-launch" }
  }'

const response = await fetch("https://api.hooked.so/v1/project/create/talking-avatar", {
  method: "POST",
  headers: {
    "x-api-key": "your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    script:
      "I tried every budgeting app out there. This is the first one I actually kept using. It just tells me what I can spend today.",
    avatarId: "cm4x9k2p10001ab12cd34ef56",
    language: "en",
    caption: { preset: "tiktok", alignment: "bottom" },
    videoStyle: { cameras: ["static-shot", "slow-zoom-to-the-face"] },
    webhook: "https://example.com/hooks/hooked?token=YOUR_SECRET",
    metadata: { campaign: "fall-launch" },
  }),
});

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

import requests

response = requests.post(
    "https://api.hooked.so/v1/project/create/talking-avatar",
    headers={"x-api-key": "your_api_key_here"},
    json={
        "script": "I tried every budgeting app out there. This is the first one I actually kept using. It just tells me what I can spend today.",
        "avatarId": "cm4x9k2p10001ab12cd34ef56",
        "language": "en",
        "caption": {"preset": "tiktok", "alignment": "bottom"},
        "videoStyle": {"cameras": ["static-shot", "slow-zoom-to-the-face"]},
        "webhook": "https://example.com/hooks/hooked?token=YOUR_SECRET",
        "metadata": {"campaign": "fall-launch"},
    },
)

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

{
  "success": true,
  "data": {
    "projectId": "cm4xa1b2c0002ab12cd34ef56",
    "status": "processing"
  },
  "message": "UGC video successfully created"
}

{
  "success": false,
  "message": "avatarId: Avatar \"cm4x9k2p10001ab12cd34ef99\" not found."
}

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

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

{
  "success": false,
  "code": "subscription_required",
  "errorCode": "SUBSCRIPTION_REQUIRED",
  "message": "Your team generates with Hooked's keys, which are paid by your plan. Subscribe to keep generating."
}

{
  "success": false,
  "errorCode": "INSUFFICIENT_CREDITS",
  "message": "Not enough credits for UGC video creation. Estimated: 100, Available: 40",
  "creditsNeeded": 100,
  "creditsAvailable": 40
}

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