curl -X POST "https://api.hooked.so/v1/project/create/pdf-to-video" \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "pdfUrl": "https://example.com/reports/annual-report-2025.pdf",
    "voiceId": "1004",
    "summaryType": "summarize",
    "targetDuration": 60,
    "customPrompt": "Focus on the three biggest numbers",
    "mediaType": "ai-images",
    "presetSettings": { "preset": "cinematic" },
    "aspectRatio": "ratio_9_16",
    "caption": { "preset": "tiktok" },
    "webhook": "https://example.com/hooked/webhook?token=YOUR_SECRET",
    "metadata": { "reportId": "2025-annual" }
  }'

const response = await fetch("https://api.hooked.so/v1/project/create/pdf-to-video", {
  method: "POST",
  headers: {
    "x-api-key": "your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    pdfUrl: "https://example.com/reports/annual-report-2025.pdf",
    voiceId: "1004",
    summaryType: "summarize",
    targetDuration: 60,
    customPrompt: "Focus on the three biggest numbers",
    mediaType: "ai-images",
    presetSettings: { preset: "cinematic" },
    aspectRatio: "ratio_9_16",
    caption: { preset: "tiktok" },
    webhook: "https://example.com/hooked/webhook?token=YOUR_SECRET",
    metadata: { reportId: "2025-annual" },
  }),
});

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

import requests

response = requests.post(
    "https://api.hooked.so/v1/project/create/pdf-to-video",
    headers={"x-api-key": "your_api_key_here"},
    json={
        "pdfUrl": "https://example.com/reports/annual-report-2025.pdf",
        "voiceId": "1004",
        "summaryType": "summarize",
        "targetDuration": 60,
        "customPrompt": "Focus on the three biggest numbers",
        "mediaType": "ai-images",
        "presetSettings": {"preset": "cinematic"},
        "aspectRatio": "ratio_9_16",
        "caption": {"preset": "tiktok"},
        "webhook": "https://example.com/hooked/webhook?token=YOUR_SECRET",
        "metadata": {"reportId": "2025-annual"},
    },
)

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

{
  "success": true,
  "data": {
    "projectId": "cm4x9k2p10001ab12cd34ef56",
    "status": "processing"
  },
  "message": "PDF to Video successfully created"
}

{
  "success": false,
  "message": "pdf: The PDF has no readable text. Scanned or image-only PDFs are not supported: export it with a text layer (OCR) first."
}

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

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

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

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