Générer du discours
La réponse réussie est un audio binaire, pas du JSON.
Sur cette page
https://api.shareai.now/api/v1/audio/speechGénérer du discours
- URL de base
https://api.shareai.now- Authentification
- Clé API Bearer ou jeton d'accès OAuth approuvé
- Portée requise
inferenceormonetization_gateway
La réponse réussie est un audio binaire, pas du JSON. Enregistrez-le en utilisant curl --output speech.mp3 ou lisez les octets de réponse dans votre SDK. Choisissez une voix de modèle prise en charge et un format de sortie ; la vitesse est limitée entre 0,25 et 4. La limite d'entrée est de 256 KiB et la limite de réponse synchrone est de 2 MiB.
Avant de commencer#
Configurez SHAREAI_API_KEY sur votre serveur et remplacez l'espace réservé du modèle par un modèle actuellement activé. Ne jamais exposer la clé API dans le code du navigateur. Le modèle, le compte, les identifiants et le fournisseur doivent tous autoriser cette opération. Les paramètres optionnels ci-dessous nécessitent la prise en charge du modèle ; les limites de sécurité de l'API ne garantissent pas que chaque modèle prend en charge chaque valeur.
Envoyez une requête#
cURL
curl --fail-with-body --request POST "https://api.shareai.now/api/v1/audio/speech" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_ENABLED_SPEECH_MODEL",
"input": "Hello from ShareAI.",
"response_format": "mp3"
}' --output speech.mp3Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_SPEECH_MODEL',
'input': 'Hello from ShareAI.',
'response_format': 'mp3'}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/audio/speech', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
with open("speech.mp3", "wb") as output:
output.write(response.read())TypeScript
import { writeFile } from "node:fs/promises";
const response = await fetch("https://api.shareai.now/api/v1/audio/speech", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_SPEECH_MODEL",
"input": "Hello from ShareAI.",
"response_format": "mp3"
}),
});
if (!response.ok) throw new Error(await response.text());
await writeFile("speech.mp3", Buffer.from(await response.arrayBuffer()));Champs de la requête#
| Champ | Type | Signification et limites |
|---|---|---|
model requis | chaîne | Identifiant exact du modèle public activé. Doit déclarer cette opération et être autorisé par vos identifiants. |
input requis | chaîne | Texte vocal requis non vide, au maximum 256 KiB en UTF-8. Les tarifs par caractère comptent les caractères Unicode, et non les octets encodés. |
voice | chaîne | Voix optionnelle prise en charge par le modèle vocal sélectionné, au maximum 100 caractères. |
response_format | chaîne | Encodage audio optionnel pris en charge, tel que mp3. Une réponse réussie est binaire, pas du JSON. Les routes tarifées par durée nécessitent un MP3, WAV ou FLAC auto-descriptif. |
speed | nombre | Vitesse de parole optionnelle de 0,25 à 4 ; le modèle peut imposer des limites plus étroites. |
provider | objet | Préférences d'acheminement des fournisseurs facultatives. Utilisez provider.only pour les balises de fournisseurs acceptées, pas un préfixe dans l'ID du modèle. Les restrictions de compte et d'identifiants s'appliquent toujours. |
Lire le résultat#
Une réussite retourne un HTTP 200 avec un audio binaire. La réponse réussie est un audio binaire, pas du JSON. Enregistrez-le en utilisant curl --output speech.mp3 ou lisez les octets de réponse dans votre SDK. Choisissez une voix de modèle prise en charge et un format de sortie ; la vitesse est limitée entre 0,25 et 4. La limite d'entrée est de 256 KiB et la limite de réponse synchrone est de 2 MiB.
Unités de facturation#
La parole peut être tarifée par caractère d'entrée, jeton rapporté par le fournisseur ou seconde générée, selon le modèle. Les comptes de caractères utilisent les caractères Unicode. La tarification par durée nécessite un résultat MP3, WAV ou FLAC auto-descriptif pris en charge. Un résultat PCM brut n'a pas de fréquence d'échantillonnage supposée. Les routes tarifées par jeton nécessitent un reçu d'utilisation fiable.
Choisissez l'identifiant exact du modèle activé depuis la Console. Son opération déclarée et ses capacités d'entrée/sortie doivent correspondre à ce point de terminaison ; un modèle de chat texte ne peut pas être substitué pour une autre opération. Vos restrictions d'identifiants, de fournisseur et de compte s'appliquent toujours.
Tarification et utilisation#
Les tarifs sont publiés en crédits IA EUR pour le modèle, le fournisseur, les unités et les variantes sélectionnés. Seules les dimensions de son tarif actif sont facturées. Une estimation réserve des crédits avant l'exécution ; les frais finaux sont basés sur l'utilisation mesurée. Les prix peuvent dépendre de la résolution, du format de sortie ou d'une tranche d'utilisation. Consultez l'onglet Utilisation dans la Console pour vérifier le débit final de ShareAI. Les champs de coûts en amont et les octets multimédias ne sont pas convertis en nombres de jetons inventés.
Accès et erreurs#
Utiliser inference pour une inférence approuvée avec coût réseau ou monetization_gateway pour une majoration approuvée par le Builder et des conditions de facturation acceptées. Un accès basé uniquement sur l'identité n'autorise pas les dépenses. La validation, l'autorisation du modèle, les crédits insuffisants, les limites de taux et les échecs d'exécution renvoient une structure error. Après un délai d'attente ou une soumission incertaine, vérifiez l'onglet Utilisation ou le travail vidéo avant de créer une autre demande potentiellement payante.
Dernière mise à jour le 3 novembre 2026