Async Jobs + Webhooks

import requests

resp = requests.post(
    "https://api.creativeai.run/v1/video/generations",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "model": "kling-v3",
        "prompt": "Product reveal animation on white background",
        "duration": "5s",
        "aspect_ratio": "16:9",
        "webhook_url": "https://your-app.com/webhooks/creativeai"
    },
)

job = resp.json()
print(job["id"])       # "vgen_abc123"
print(job["status"])   # "pending"
# Done — no polling loop needed. Your webhook gets called.

Returns 202 Accepted with a job ID. Your webhook_url receives the result when processing completes.

import crypto from 'crypto';

export function verifyCreativeAiWebhook(
  rawBody: string,
  signatureHeader: string,
  apiKey: string
): boolean {
  const expected = crypto
    .createHmac('sha256', apiKey)
    .update(rawBody)
    .digest('hex');
  const received = signatureHeader.replace('sha256=', '');
  return crypto.timingSafeEqual(
    Buffer.from(expected),
    Buffer.from(received)
  );
}

// In your Express/Next.js handler:
app.post('/webhooks/creativeai', (req, res) => {
  const sig = req.headers['x-creativeai-signature'];
  if (!verifyCreativeAiWebhook(req.rawBody, sig, API_KEY)) {
    return res.status(401).send('Invalid signature');
  }

  const event = req.body;
  if (event.status === 'completed') {
    // Save output_url, notify user, trigger next step...
  }
  res.status(200).send('ok');
});