Édition Markdown

AI-translated from English; not yet reviewed by a fluent editor.

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

> L’API vocale Eleven v4 de Runway accepte des scripts de 2 500 caractères maximum. Ce guide fondé sur la documentation explique la requête, le résultat de la tâche, la configuration du compte et le changement de tarif du 12 octobre.

By BIG CHANGE Editorial

Published: 2026-10-06T06:30:01.909Z
Updated: 2026-10-06T06:30:01.909Z
Canonical: https://bigchange.ai/blog/runway-eleven-v4-text-to-speech-api-price-change

![Conceptual charcoal illustration of unbranded headphones resting beside a loose script sheet with abstract text strokes.](https://bigchange.ai/api/media/file/runway-eleven-script-audio-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE. A written script and headphones represent text-to-speech; no API test or audio assessment is depicted.

Runway a ajouté Eleven v4 à son API pour développeurs le 30 septembre. La [note de version](https://docs.dev.runwayml.com/api-details/api_changelog/) 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](https://docs.dev.runwayml.com/guides/setup/) 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](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/types/text_to_speech_create_params.py) 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](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/resources/text_to_speech.py) envoie cette requête à `/v1/text_to_speech` et renvoie une nouvelle réponse de tâche. Le [guide de l’API](https://docs.dev.runwayml.com/guides/using-the-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é :

```json
{
  "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](https://docs.dev.runwayml.com/api-details/api_changelog/) 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](https://docs.dev.runwayml.com/assets/outputs/) 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](https://docs.dev.runwayml.com/guides/models/) 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](https://docs.dev.runwayml.com/guides/pricing/) 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](https://docs.dev.runwayml.com/api-details/api_changelog/) 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](https://docs.dev.runwayml.com/guides/setup/) 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](https://docs.dev.runwayml.com/guides/pricing/) 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](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/types/text_to_speech_create_params.py) et son [implémentation de service](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/resources/text_to_speech.py) é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](https://docs.dev.runwayml.com/guides/using-the-api/), [liste des modèles](https://docs.dev.runwayml.com/guides/models/) et le [guide de sortie](https://docs.dev.runwayml.com/assets/outputs/) 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.

## Sources

- [Runway Dev API, journal des modifications : Eleven v4](https://docs.dev.runwayml.com/api-details/api_changelog/) — L’entrée de Runway du 30 septembre annonce eleven_v4, la limite de 2 500 caractères, trois exemples de balises audio, les voix prédéfinies Runway et le passage, le 12 octobre heure du Pacifique, de 2,2 à 5 crédits par tranche de 1 000 caractères, avec un minimum d’un crédit. Elle n’établit ni la qualité audio ni la réussite d’un appel de BIG CHANGE.
- [Runway Dev API, configuration](https://docs.dev.runwayml.com/guides/setup/) — Documente les prérequis de compte, de projet, de clé API et de rôle ; la variable d’environnement secrète du SDK ; et l’achat initial minimum de 10 $ de crédits à 0,01 $ par crédit. Ce sont des consignes du fournisseur, pas des étapes testées dans cet article.
- [Runway Dev API, tarifs](https://docs.dev.runwayml.com/guides/pricing/) — Répertorie les deux tarifs datés d’Eleven v4 en crédits et le prix de 0,01 $ par crédit. L’exemple de 0,22 $ et 0,50 $ de l’article est le calcul de dix requêtes de 1 000 caractères, pas une facture observée ; une taxe de vente peut s’appliquer.
- [Runway Python SDK : schéma de requête de synthèse vocale](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/types/text_to_speech_create_params.py) — La branche principale actuelle du SDK officiel définit ElevenV4 comme modèle requis, promptText comme alias et une voix prédéfinie Runway avec presetId ; Bernard figure dans la liste. La branche main est mutable et la requête n’a pas été exécutée.
- [Runway Python SDK : service de synthèse vocale](https://github.com/runwayml/sdk-python/blob/main/src/runwayml/resources/text_to_speech.py) — Le service actuel du SDK officiel envoie les requêtes à /v1/text_to_speech et renvoie une réponse de nouvelle tâche. Il ne démontre pas de réponse observée d’Eleven v4.
- [Runway Dev : utiliser l’API](https://docs.dev.runwayml.com/guides/using-the-api/) — Documente l’hôte de l’API, la clé bearer, l’en-tête X-Runway-Version 2024-11-06 et le format d’identifiant de tâche dans les exemples de génération. Les exemples examinés ne sont pas des appels Eleven v4.
- [Runway Dev : formats de sortie](https://docs.dev.runwayml.com/assets/outputs/) — Décrit GET /v1/tasks/:id, les tableaux d’URL de sortie des tâches réussies et l’expiration des URL après 24 à 48 heures. L’exemple affiché concerne une tâche vidéo ; aucun format audio d’Eleven v4 n’en est déduit.
- [Runway Dev : modèles disponibles](https://docs.dev.runwayml.com/guides/models/) — Répertorie eleven_v4 avec une entrée textuelle et une sortie audio. Il s’agit d’une classification du modèle, pas d’une inspection audio indépendante.