API vocale Eleven v4 de Runway : format de requête et tarifs d’octobre

Runway a ajouté Eleven v4 à son API pour développeurs le 30 septembre. La note de version identifie le modèle comme eleven_v4, limite chaque script à 2 500 caractères et indique que le tarif en crédits augmentera le 12 octobre 2026, heure du Pacifique. Pour les développeurs qui intègrent la génération vocale à un flux de production, la question pratique est de savoir ce qu’exige une requête valide et à combien correspond le tarif documenté en dollars. Ce guide s’appuie sur la documentation de Runway consultée le 6 octobre ; BIG CHANGE n’a pas effectué d’appel API payant ni évalué l’audio.

Le grand changement

• Ce qui a changé :Runway répertorie désormais Eleven v4 comme modèle de synthèse vocale derrière son API de tâches existante. Un script peut inclure des balises audio documentées, telles que [laughs] , [whispers] et [pause] , dans la limite de 2 500 caractères.
• Pourquoi c’est important :Une équipe disposant d’un projet développeur Runway peut demander une génération vocale avec une voix prédéfinie et récupérer l’URL audio de la tâche terminée. L’intégration et la planification budgétaire peuvent s’appuyer sur un format de requête documenté et un calendrier tarifaire daté.
• À suivre :Runway indique que le tarif passera de 2,2 à 5 crédits par tranche de 1 000 caractères le 12 octobre 2026, heure du Pacifique. Toute estimation de générations répétées doit tenir compte du tarif en vigueur à la facturation de la requête et vérifier le prix actualisé avant d’arrêter un budget.

Créer un projet et une clé

Le guide de configuration de Runway conseille de créer un compte et un projet dans le portail développeur, puis une clé API de projet dans API Keys. Le rôle Admin ou Developer est nécessaire pour créer ou désactiver une clé. Celle-ci n’apparaît en clair qu’une seule fois : il faut donc la conserver en lieu sûr. Pour utiliser le SDK, Runway recommande de définir RUNWAYML_API_SECRET ; le SDK lit automatiquement cette variable. Ne placez pas le secret dans le code source.

Le projet doit également disposer de crédits avant de pouvoir utiliser l’API. Runway indique que le paiement initial minimum est de 10 $, au tarif de 0,01 $ par crédit, depuis l’onglet de facturation du projet. Le rôle Admin ou Billing admin est nécessaire pour ajouter des crédits. Il s’agit d’un achat minimal de crédits, pas du prix d’une requête vocale. La page de configuration ne décrit pas de premier appel gratuit.

Envoyer une requête de synthèse vocale

Le type de requête actuel du SDK Python de Runway exige model, prompt_text et un voice objet pour Eleven v4. Sur le réseau, les champs JSON correspondants sont model, promptText et voice, avec voice.type défini à runway-preset et un objet presetId. Bernard est l’une des voix prédéfinies répertoriées. Le service du SDK envoie cette requête à /v1/text_to_speech et renvoie une nouvelle réponse de tâche. Le guide de l’API de Runway documente l’hôte, la clé bearer et l’en-tête X-Runway-Version: 2024-11-06 utilisés pour les appels HTTP directs.

Voici un corps de requête déduit de la documentation, et non un appel que nous avons exécuté :

{
  "model": "eleven_v4",
  "promptText": "The recording begins now. [pause] Welcome.",
  "voice": {
    "type": "runway-preset",
    "presetId": "Bernard"
  }
}

L’entrée du journal des modifications du 30 septembre de Runway cite [laughs], [whispers] et [pause] comme exemples pris en charge et indique qu’Eleven v4 utilise les mêmes voix prédéfinies Runway qu’Eleven v3. Les balises font partie du script ; il faut leur réserver de la place dans la limite annoncée de 2 500 caractères. Le SDK répertorie aussi des réglages vocaux facultatifs, la langue et des champs de texte voisins. Son schéma ne prouve pas qu’un réglage garantit une interprétation particulière, et cet article ne formule aucune affirmation sur la qualité vocale ou la latence.

La réponse initiale est une tâche, et non des octets audio. Le guide de sortie de Runway recommande d’interroger GET /v1/tasks/:id ; une tâche réussie contient un tableau output d’URL de résultats. Ces URL expirent dans les 24 à 48 heures suivant l’accès à l’API : téléchargez donc le résultat dans votre propre stockage plutôt que d’utiliser l’URL temporaire dans un produit. L’exemple général de sortie est une tâche vidéo ; il montre la structure de réponse d’une tâche, tandis que la liste des modèles classe la sortie d’Eleven v4 comme audio. Nous n’avons pas observé de réponse d’Eleven v4 ni vérifié le format de son fichier audio.

Calculer le tarif selon la date

La page tarifaire et la note de version de Runway indiquent 2,2 crédits par tranche de 1 000 caractères jusqu’au 12 octobre 2026, heure du Pacifique, puis 5 crédits par tranche de 1 000 caractères, avec un minimum d’un crédit. Au tarif publié de 0,01 $ par crédit, cela correspond à 0,022 $ et 0,05 $ par tranche de 1 000 caractères, avant les taxes applicables. Le nouveau tarif est environ 2,27 fois plus élevé que l’ancien.

Exemple transparent de planification : dix scripts distincts de 1 000 caractères facturables exactement totalisent 10 000 caractères. Le calcul aux tarifs publiés donne 22 crédits, soit 0,22 $, à l’ancien tarif et 50 crédits, soit 0,50 $, au nouveau. Chaque script reste sous la limite de 2 500 caractères et chaque requête calculée dépasse le minimum d’un crédit. Il s’agit d’un calcul fondé sur les tarifs publiés par Runway, pas d’une facture observée. Les pages citées ne précisent ni comment les balises sont comptées parmi les caractères facturables ni si les frais fractionnaires par requête sont arrondis ; pour établir une estimation de production, il faut donc vérifier les données d’utilisation réelles et les conditions en vigueur.

Sources et lectures complémentaires

L’historique des modifications de l’API du 30 septembre de Runway établit la date de sortie, l’identifiant du modèle, les exemples de balises, la limite du script et l’annonce tarifaire datée. Le guide de configuration explique les prérequis du projet, de la clé et des crédits, y compris les droits des rôles et le paiement initial de 10 $. La page tarifaire fournit la conversion des crédits en dollars et les tarifs indiqués pour Eleven v4.

Le schéma de requête du SDK Python et son implémentation de service établissent les noms des champs, la forme de la voix prédéfinie, le chemin du point de terminaison et la réponse de création de tâche examinés pour ce guide. Le guide de démarrage, liste des modèles et le guide de sortie de Runway fournissent l’en-tête de version HTTP, la classification de la sortie audio et le fonctionnement de récupération des tâches. Ce sont des documents du fournisseur, pas un test indépendant de performance. Consultés le 6 octobre 2026.