popnow
ConnexionCommencer à créer

Chatterbox API

resemble-ai/chatterbox-v1/text-to-speechÀ partir de 6 crédits par génération

Chatterbox, le modèle open source de synthèse vocale de Resemble AI : envoyez jusqu’à 1 000 caractères d’anglais et récupérez un fichier WAV lu dans sa voix intégrée, avec des curseurs pour l’expressivité et la variation.

Appelez-le avec le nom de modèle resemble-ai/chatterbox-v1/text-to-speech sur POST /jobs/createTask, à partir de 6 crédits par génération (0,06 $US). Les nouveaux comptes reçoivent 30 crédits gratuits pour l’essayer d’abord dans le Playground.

  • Synthèse vocale
par Resemble AIObtenir une clé APIExemples et prompts Chatterbox →

Ce guide n'est disponible qu'en anglais pour le moment. →

Paramètres de requête

ParamètreRequisDescription
exaggerationNonHow emotional the reading is, from 0 (flat) to 1 (dramatic). ≥ 0 · ≤ 1 · Par défaut: 0.5
guidance_scaleNonÀ quel point le modèle suit le prompt à la lettre. ≥ 0.1 · ≤ 1 · Par défaut: 0.5
reference_audio_urlNonOptional clip of the voice to imitate; the reading takes on its timbre.
temperatureNonVariation between takes, from 0.05 to 2. ≥ 0.05 · ≤ 2 · Par défaut: 0.7
textOuiUp to 1,000 characters of English, read exactly as written. Spell sounds out; tags are read aloud.

Tarifs

Les prix sont en crédits, les mêmes que ceux que vous utilisez sur le site (1 crédit = 0,01 $). Le montant est réservé à l'acceptation de la tâche, puis réglé au coût réel à la fin ; les tâches en échec sont remboursées.

OptionCrédits par génération≈ USD
Standard5,40,054 $US

Chaque tâche est arrondie au crédit entier supérieur : une exécution au palier le plus bas coûte donc 6 crédits par génération (0,06 $US).

Pour obtenir un montant exact avant de lancer, envoyez le même corps à POST /jobs/quote.

Démarrage rapide de l'API

Appeler l’API Chatterbox en trois étapes

  1. Créer une clé API. Connectez-vous à PopNow et créez une clé dans la console API. Les clés commencent par sk-popnow- et utilisent les mêmes crédits que le site.
  2. Envoyer la requête. Envoyez POST /jobs/createTask avec model resemble-ai/chatterbox-v1/text-to-speech et un objet input conforme au tableau des paramètres. La réponse renvoie aussitôt un ID de tâche.
  3. Récupérer le résultat. Interrogez GET /jobs/recordInfo avec l’ID de tâche, ou passez une callBackUrl et nous y envoyons le résultat. Téléchargez les liens de sortie quand la tâche réussit.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "resemble-ai/chatterbox-v1/text-to-speech",
  "input": {
    "text": "Welcome back. Your files finished rendering a minute ago and are ready to download."
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Remplacez le prompt et les liens par les vôtres. L'onglet API contient la référence pour la réponse, le polling et le callback.

Questions sur l’API Chatterbox

Combien coûte l’API Chatterbox ?

Chatterbox coûte 6 crédits (0,06 $US) par génération. Les crédits sont les mêmes que sur le site (1 crédit = 0,01 $), les nouveaux comptes reçoivent 30 crédits offerts et les tâches échouées sont remboursées.

Quel est le nom de modèle de Chatterbox dans l’API ?

Indiquez resemble-ai/chatterbox-v1/text-to-speech pour Synthèse vocale dans le champ model de POST /jobs/createTask.

Puis-je choisir une voix ?

Il n’y a pas de liste de voix, mais vous pouvez en cloner une : envoyez un court extrait MP3 ou WAV dans reference_audio_url et la lecture reprend le timbre de cette voix. Sans extrait, chaque requête utilise la voix intégrée de Chatterbox. Les curseurs changent la façon dont la voix interprète, pas son identité. N’utilisez que des voix que vous avez le droit d’utiliser.

Les balises comme <laugh> ou [sigh] fonctionnent-elles ?

Non. Lors de nos tests, le modèle a lu ces balises à voix haute comme des mots. Écrivez plutôt les sons en toutes lettres — « ha… », « mmm… », « ahh… » — et augmentez exaggeration pour une lecture plus émotionnelle.

Quelles langues peut-il lire ?

L’anglais. Les autres langues ne sont pas prises en charge par ce modèle.

Quelles sont les limites de l’API Chatterbox ?

Longueur du texte (caractères): 1,000; Taille maximale d’envoi: 90 MB. Les requêtes hors de ces limites sont refusées avant tout débit.

Puis-je essayer Chatterbox sans écrire de code ?

Oui. Le Playground lance Chatterbox avec vos crédits PopNow, sans clé API, et affiche le code correspondant à chaque génération.

En savoir plus sur Chatterbox