ShareAI Platform Docs

Transcrire de l'audio

Fournissez l'audio en base64 dans input_audio.data et son format réel.

Voir en Markdown
Sur cette page
POST https://api.shareai.now/api/v1/audio/transcriptions

Transcrire de l'audio

URL de base
https://api.shareai.now
Authentification
Clé API Bearer ou jeton d'accès OAuth approuvé
Portée requise
inference or monetization_gateway

Fournissez l'audio en base64 dans input_audio.data et son format réel format. Les langues prises en charge, les invites, les formats de réponse et les options de timestamp dépendent du modèle. Ce point de terminaison JSON n'accepte pas les téléchargements de fichiers multipartites. La réponse contient la transcription et l'utilisation rapportée.

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/transcriptions" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_ENABLED_TRANSCRIPTION_MODEL",
  "input_audio": {
    "data": "UklGRsQAAABXQVZFZm10IBAAAAABAAEAQB8AAIA+AAACABAAZGF0YaAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
    "format": "wav"
  }
}'

L'exemple contient un petit fichier WAV silencieux uniquement pour montrer un transport base64 valide. Remplacez input_audio.data par le base64 standard de votre propre fichier audio ; pour Python, utilisez base64.b64encode(Path(“audio.wav”).read_bytes()).decode(“ascii”). Ne collez pas une URL audio dans ce champ.

Champs de la requête#

ChampTypeSignification et limites
model requischaîneIdentifiant exact du modèle public activé. Doit déclarer cette opération et être autorisé par vos identifiants.
input_audio requisobjetChamps requis pour les données et le format. data est le base64 standard des octets audio réels ; format doit correspondre. JSON uniquement ; multipart n'est pas pris en charge. Les tarifs de durée nécessitent WAV, MP3 ou FLAC avec une base temporelle connue, d'une durée combinée maximale de 600 secondes.
languagechaîneCode de langue pris en charge par le modèle (optionnel).
promptchaîneContexte de transcription pris en charge par le modèle (optionnel) ; ce n'est pas une invite de génération audio.
response_formatchaîneFormat de réponse pris en charge par le modèle, au maximum 100 caractères. L'opération détermine si le résultat est en JSON ou en binaire.
timestamp_granularitiestableauValeurs de granularité des timestamps prises en charge par le modèle (optionnel). La disponibilité dépend du format de réponse et du modèle.
providerobjetPré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#

En cas de succès, retourne HTTP 200 avec JSON. Fournissez l'audio en base64 dans input_audio.data et son format réel format. Les langues prises en charge, les invites, les formats de réponse et les options de timestamp dépendent du modèle. Ce point de terminaison JSON n'accepte pas les téléchargements de fichiers multipartites. La réponse contient la transcription et l'utilisation rapportée.

Unités de facturation#

La transcription utilise la durée publiée du modèle et/ou le tarif par jeton. Les secondes et les jetons rapportés par le Provider restent des mesures distinctes. La longueur du base64 n'est ni une durée audio ni un nombre de jetons. Les tarifs basés sur la durée d'entrée nécessitent des fichiers WAV, MP3 ou FLAC auto-descriptifs avec une durée combinée maximale de 600 secondes ; les bases temporelles PCM brutes ou inconnues ne sont pas admises pour la tarification basée sur la durée.

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

Documentation de la plateforme ShareAI
Toute la documentation

Rechercher par titre ou contenu.

Poser une question sur cette page

Choisissez un assistant pour explorer cette page. Vous pouvez également copier la page et la coller dans votre conversation.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI