Developer quickstart

Intégrer Scena en 10 minutes côté backend.

Le frontend du SaaS appelle son propre backend. Le backend appelle Scena avec la clé privée et vérifie les callbacks signés.

Créer une connexion SaaS

Lucas génère la connexion et remet la clé one-time sk_scena_....

Appeler generate

Le backend envoie le preset, le prompt et les URLs d’assets.

Vérifier le webhook

Le callback contient event_id, idempotency_key et X-Scena-Signature.

const res = await fetch('https://api.walter-ai.cloud/api/saas/generate', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${{process.env.SCENA_API_KEY}}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    preset: 'ugc_product_demo',
    input: { prompt, image_url }
  })
});

// webhook verifier:
// sha256(HMAC(secret, `${{timestamp}}.${{rawBody}}`))

Auth

Bearer API key

Clé privée backend, rotation et révocation admin.

Events

Idempotent webhooks

Retry-safe avec delivery id et idempotency key.

Limits

Quotas intégrés

Monthly credits et rate limit par connexion SaaS.