auto stud
APIAPI Rendu Vidéo

Produisez la vidéo finale
directement depuis votre code

Un POST met un rendu en file sur nos workers, et un webhook signé vous rend le mp4. Aucun ffmpeg à installer, aucun GPU à louer, aucune file à surveiller.

POSThttps://autostud.ai/api/v1/actions/renders.create

Trois appels, de la timeline au mp4

Créez la vidéo une fois, puis rendez-la autant de fois que nécessaire.

  1. 1

    Créez la vidéo

    Une vidéo porte la timeline : calques, audio, sous-titres, format. Créez-la en un appel, ou réutilisez celle que votre équipe a montée dans l'éditeur.

    export AUTOSTUD_API_KEY="sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    
    # A video is the timeline. Create one, or skip this step and reuse
    # a video your team already built in the editor.
    curl -X POST https://autostud.ai/api/v1/actions/videos.create \
      -H "Authorization: Bearer $AUTOSTUD_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "video_name": "Launch teaser",
        "video_format": "portrait",
        "video_lang": "en"
      }'
  2. 2

    Lancez le rendu

    Pointez renders.create sur l'identifiant de la vidéo, ajustez ce que ce job doit changer, et il part sur un worker immédiatement. La réponse, c'est le job, pas le fichier.

    # The Idempotency-Key makes this call safe to retry: send it twice
    # and you get the same render back, never a second job.
    curl -X POST https://autostud.ai/api/v1/actions/renders.create \
      -H "Authorization: Bearer $AUTOSTUD_API_KEY" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: launch-teaser-v3" \
      -d '{
        "video_id": "0f4c8b71-2d95-47a3-9e6c-15b8ad7f3c20",
        "render_settings": {
          "quality": "high"
        }
      }'
  3. 3

    Récupérez le mp4

    render.completed arrive avec l'URL de sortie. Si votre stack préfère le polling, relisez plutôt les rendus filtrés sur l'identifiant de la vidéo.

    # Register once. Every render reports itself from then on.
    curl -X POST https://autostud.ai/api/v1/webhooks \
      -H "Authorization: Bearer $AUTOSTUD_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "url": "https://your-app.com/hooks/autostud",
        "events": ["render.started", "render.completed", "render.failed"],
        "description": "Rendering"
      }'
    # The signing secret comes back once, in this response. Store it.

Ce que prend un rendu

Deux champs pour le lancer, un en-tête pour pouvoir réessayer sans risque, un identifiant pour le suivre.

video_id

La vidéo à rendre. Toute la composition vit déjà dessus.

render_settings

Surcharges facultatives pour ce job : format, qualité, plage de frames voulue.

Idempotency-Key

Un en-tête. Envoyez deux fois la même clé et vous récupérez le premier rendu, jamais un doublon.

render_id

Renvoyé par l'appel et transporté par chaque webhook : un mp4 terminé pointe toujours vers le job qui l'a demandé.

Ce qui sort

Les rendus sont des mp4 H.264, dans le format réglé sur la vidéo. Vertical pour TikTok et Reels, carré pour un fil, paysage pour YouTube : même timeline, sortie différente.

portrait 9:16square 1:1landscape 16:9mp4 / H.264

Arrêtez le polling

Un rendu prend des minutes, pas des millisecondes. Enregistrez un webhook et trois événements vous disent quand un worker a pris le job, quand le fichier est prêt, et quand quelque chose a cassé.

render.startedrender.completedrender.failed

Les questions que les développeurs posent en premier

Combien de temps prend un rendu ?

Des minutes, proportionnellement à la durée de la vidéo et au nombre de calques. L'appel répond dès que le job est en file : rien ne bloque dans votre application.

Combien coûte un rendu ?

Les rendus sont facturés en crédits et le journal est lisible via l'API. Une clé peut être limitée à renders:read seul, pour qu'un dashboard suive la dépense sans pouvoir lancer de job.

Peut-on réessayer un appel en échec sans risque ?

Oui. Envoyez un en-tête Idempotency-Key et un appel répété renvoie le rendu d'origine au lieu d'en mettre un second en file, la garantie que donne chaque action d'exécution de l'API.

Où le fichier est-il hébergé ?

Sur notre CDN, et l'URL figure sur la fiche du rendu comme dans la charge utile de render.completed. Téléchargez-le et stockez-le chez vous si vous en avez besoin pour toujours.

Prêt à créer ?

Commencez à générer des vidéos virales en quelques minutes. Pas de carte bancaire requise pour l'essai gratuit.

Paiements sécurisés
Accès instantané
Annulation à tout moment