Créations

Décrivez ce que vous voulez voir, récupérez le fichier. Deux types : une image, ou une vidéo de 5, 10 ou 15 secondes avec sa bande son. Le fichier est hébergé sur media.kreatoai.com et se publie directement avec POST /v1/posts, sans passer par /v1/media.

La création est asynchrone : l'appel répond 202 immédiatement, puis vous interrogez son état — ou vous laissez un webhook vous prévenir. Comptez quelques secondes pour une image, une à deux minutes pour une vidéo.

Endpoints

Scope requis : generations:write pour créer et supprimer, generations:write ou videos:read pour lire. Un abonnement en cours est nécessaire.

Lancer une création

curl -X POST https://api.kreatoai.com/v1/generations \
  -H "x-api-key: sk-kre-v1-votre_cle" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "video",
    "prompt": "Un plat qui sort du four, vapeur, lumière chaude, gros plan",
    "aspectRatio": "9:16"
  }'

// 202 Accepted
{
  "id": "9f1c8b2e-4a7d-4c31-9e05-6b2f8a1d3c47",
  "type": "video",
  "status": "pending",
  "prompt": "Un plat qui sort du four, vapeur, lumière chaude, gros plan",
  "aspectRatio": "9:16",
  "durationSec": 5,
  "sourceUrls": [],
  "mediaUrl": null,
  "mimeType": null,
  "error": null,
  "creditsCost": 15,
  "createdAt": "2026-09-05T14:22:10.000Z",
  "completedAt": null
}

Suivre son avancement

Deux façons, au choix. La plus économique : abonnez un endpoint webhook et attendez generation.completed ou generation.failed — le corps de l'événement est exactement l'objet ci-dessous. Sinon, interrogez l'état toutes les dix secondes :

GET /v1/generations/9f1c8b2e-4a7d-4c31-9e05-6b2f8a1d3c47

// 200 OK
{
  "id": "9f1c8b2e-4a7d-4c31-9e05-6b2f8a1d3c47",
  "type": "video",
  "status": "completed",
  "mediaUrl": "https://media.kreatoai.com/generation-video-1788….mp4",
  "mimeType": "video/mp4",
  "error": null,
  "creditsCost": 15,
  "completedAt": "2026-09-05T14:23:47.000Z"
}

Publier le résultat

mediaUrl se passe directement dans mediaUrls — inutile de l'ingérer avec /v1/media, le fichier est déjà chez nous.

curl -X POST https://api.kreatoai.com/v1/posts \
  -H "x-api-key: sk-kre-v1-votre_cle" \
  -H "Content-Type: application/json" \
  -d '{
    "targets": ["tiktok", "youtube"],
    "content": "Trois dîners prêts en 10 minutes",
    "mediaUrls": ["https://media.kreatoai.com/generation-video-1788….mp4"]
  }'

Sur YouTube, déclarez le contenu généré : options.youtube.containsSyntheticMedia = true.

Crédits

Le solde vit sur l'espace, pas sur la clé : GET /v1/workspace et GET /v1/generations le renvoient tous les deux dans credits. Un appel refusé pour solde insuffisant ne débite rien, et une création qui échoue est intégralement remboursée — y compris lorsqu'une mise à jour de nos serveurs l'interrompt.

Champs de la réponse

Les fichiers produits vous appartiennent : contrairement aux médias ingérés via /v1/media, ils ne sont soumis à aucune durée de conservation tant que vous ne supprimez pas la création.

Erreurs

Une création peut aussi aboutir en failed après avoir été acceptée : une demande refusée par nos garde-fous de contenu, ou une indisponibilité passagère. Dans les deux cas, error dit quoi faire et les crédits reviennent.