curl -X POST "https://api.hooked.so/v1/project/create/tiktok-slideshow" \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "5 morning habits",
    "aspectRatio": "ratio_9_16",
    "slides": [
      {
        "media": "cm8w1r7d20001l708x9y8z7w6",
        "duration": 3,
        "texts": [
          { "text": "5 morning habits that changed my life", "x": 100, "y": 760, "width": 880, "height": 400, "fontSize": 88 }
        ]
      },
      {
        "media": "cm8w1s0aa0002l708q1w2e3r4",
        "duration": 4,
        "texts": [
          { "text": "1. No phone for the first hour", "x": 100, "y": 1400, "width": 880, "height": 240, "fontSize": 72 }
        ]
      }
    ],
    "musicId": "cm7m2u5ic0000l708h3k4m5n6"
  }'

const response = await fetch("https://api.hooked.so/v1/project/create/tiktok-slideshow", {
  method: "POST",
  headers: {
    "x-api-key": "your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    slides: [
      {
        media: "cm8w1r7d20001l708x9y8z7w6",
        texts: [{ text: "5 morning habits", x: 100, y: 760, width: 880, height: 400, fontSize: 88 }],
      },
      { media: "cm8w1s0aa0002l708q1w2e3r4", duration: 4 },
    ],
    // Optional narration:
    avatarId: "2",
    script: "Here are five morning habits that changed my life.",
    webhook: "https://example.com/hooks/hooked?token=YOUR_SECRET",
  }),
});

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

import requests

response = requests.post(
    "https://api.hooked.so/v1/project/create/tiktok-slideshow",
    headers={"x-api-key": "your_api_key_here"},
    json={
        "slides": [
            {
                "media": "cm8w1r7d20001l708x9y8z7w6",
                "texts": [{"text": "5 morning habits", "x": 100, "y": 760,
                           "width": 880, "height": 400, "fontSize": 88}],
            },
            {"media": "cm8w1s0aa0002l708q1w2e3r4", "duration": 4},
        ],
    },
)
print(response.json()["data"]["projectId"])

{
  "success": true,
  "projectId": "cm8x4f2qk0007l708a1b2c3d4",
  "data": {
    "projectId": "cm8x4f2qk0007l708a1b2c3d4",
    "status": "processing"
  },
  "message": "TikTok Slideshow successfully created"
}

{
  "success": false,
  "message": "slides.0.texts.0: The text box must fit the 1080x1920 canvas (x + width <= 1080, y + height <= 1920)"
}

{
  "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": ["gemini", "bria"],
  "message": "Your team uses its own provider keys (BYOK) and these are missing or invalid: Google AI (Gemini), Bria. 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 TikTok Slideshow creation. Required: 7, Available: 3",
  "creditsNeeded": 7,
  "creditsAvailable": 3
}

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