Vídeos con IA desde tus propios sistemas

Verifica la firma

Cada aviso trae X-AIVS-Timestamp y X-AIVS-Signature = hex(HMAC-SHA256(secreto, timestamp + "." + cuerpo)). Verifica sobre el cuerpo crudo, en tiempo constante, y rechaza marcas de tiempo de más de 5 minutos. Mientras rotas el secreto, el anterior firma en X-AIVS-Signature-Previous.

# Without the SDK (Python standard library)
import hashlib, hmac, time

def valid(body: bytes, ts: str, signature: str, secret: str) -> bool:
    if abs(time.time() - int(ts)) > 300:
        return False
    good = hmac.new(secret.encode(), ts.encode() + b"." + body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(good, signature)

Entregas y reintentos

• Responde 2xx en menos de 10 s; procesa en segundo plano si tarda.
• Si falla, reintentamos con espera creciente (10 s … 1 h) hasta 8 veces, durante cerca de un día.
• X-AIVS-Delivery trae el id del evento (el mismo en cada reintento): úsalo para ignorar duplicados.
• Si respondes 410 Gone, pausamos el webhook. Ves cada entrega, su respuesta y la reenvías desde Integraciones o la API.

import { CreaVideos, verifyWebhook, WebhookError } from "creavideosconia";

const api = new CreaVideos({ apiKey: process.env.AIVS_API_KEY! });
const job = await api.jobs.create({ kind: "idea", idea: "3 errores al elegir zapatillas", channels: ["tiktok"] });

// Next.js route handler (any Fetch-API runtime)
export async function POST(req: Request) {
  const raw = await req.text();                     // RAW body, before JSON.parse
  try {
    const event = await verifyWebhook(raw, req.headers, process.env.AIVS_WEBHOOK_SECRET!);
    if (event.type === "job.succeeded") { /* event.data.videos … */ }
    return new Response("ok");
  } catch (e) {
    if (e instanceof WebhookError) return new Response("bad signature", { status: 400 });
    throw e;
  }
}

from creavideosconia import Client, verify_webhook, WebhookError

api = Client("https://api.creavideosconia.com", "aivs_…")
job = api.create_job({"kind": "idea", "idea": "3 errores al elegir zapatillas", "channels": ["tiktok"]})

# Flask / FastAPI / Django: pass the RAW body and the headers
def webhook(body: bytes, headers) -> int:
    try:
        event = verify_webhook(body, headers, "whsec_…")
    except WebhookError:
        return 400
    if event["type"] == "job.succeeded":
        ...
    return 200