API publique

What is a API Parole-to-Text

A API Parole-to-Text turns audio and vidéo into text programmatically—without manual téléversers in the browser. The Polyglot Voice API fits bots, CRMs, call centers, edtech, and media produits: send a file or URL, poll status or use a webhook, then fetch the transcription, traduction, and export files (SRT, TXT, JSON). Traitement runs in the Polyglot Voice cloud—you do not deploy or télécharger recognition models on your side.

Capacités API

• Parole recognition to text (98+ langues)
• Transcript and vidéo content traduction
• Automatic sous-titres and SRT/TXT export
• Entretien, cours, and call transcriptionion
• Webhooks à la fin et interrogation d'état

Fast integration path

1. Étape 1Create API key
2. Étape 2POST upload/from-url
3. Étape 3Receive webhook or poll status
4. Étape 4GET result/download

URL de base

Utilisez l'URL de base pour toutes les requêtes API.

https://polyglotvoice.ru/api/v1

Autorisation

Les endpoints ci-dessous acceptent Authorization: Bearer avec le JWT de session du site ou une clé API sk_….

Authorization: Bearer sk_...

La clé sk_… est créée dans le profil, est valable 30 jours et ne s'applique qu'aux chemins transcriptions/* ; le reste du site utilise le JWT. Les deux conviennent pour ces routes.

Comment obtenir une clé API

1. Connectez-vous à votre compte.
2. Ouvrez Profil → « Clés API ».
3. Créez une clé et sauvegardez-la (affichée une seule fois).
4. Utilisez la clé dans vos requêtes.

Points d’accès

Endpoints principaux pour les transcriptions.

Exemples de requêtes

Exemples de base pour commencer.

curl -X POST "https://polyglotvoice.ru/api/v1/transcriptions/upload" \
  -H "Authorization: Bearer sk_..." \
  -F "file=@audio.mp3"

import requests

url = "https://polyglotvoice.ru/api/v1/transcriptions/upload"
headers = {"Authorization": "Bearer sk_..."}
files = {"file": open("audio.mp3", "rb")}

response = requests.post(url, headers=headers, files=files)
print(response.json())

const formData = new FormData();
formData.append("file", file);

fetch("https://polyglotvoice.ru/api/v1/transcriptions/upload", {
  method: "POST",
  headers: { Authorization: "Bearer sk_..." },
  body: formData
})
  .then((res) => res.json())
  .then(console.log);

Formats de fichiers

Les formats audio et vidéo courants sont pris en charge.

Par exemple : mp3, wav, m4a, ogg, mp4, webm.

Statuts des tâches

A transcriptionion task moves through these statuses:

• en file d'attente - accepté, en attente de traitement
• traitement — media is being processed
• completed — result ready; fetch text and téléchargers
• failed — traitement error (see failure_reason)
• annulé — annulé par l'utilisateur

Réponses et erreurs

Exemple de création de tâche et d'erreur d'auth.

{ "task_id": "9b9c1b9a-....", "status": "queued" }

{
  "task_id": "9b9c1b9a-....",
  "status": "completed",
  "model": "fast",
  "input_language": "en",
  "output_language": "ru",
  "audio_duration_seconds": 125.4,
  "confidence": 0.94,
  "transcript_preview": "Hello, this is a sample transcript..."
}

{
  "task_id": "9b9c1b9a-....",
  "transcript": "Hello, this is a sample transcript...",
  "translation": "Привет, это пример транскрипта...",
  "segments": [{ "start": 0.0, "end": 2.4, "text": "Hello..." }],
  "confidence": 0.94,
  "updated_at": "2026-05-24T12:00:00Z"
}

{ "detail": "Invalid token." }

Webhook

Set a webhook URL in your profil for the sk_ API key. When a task reaches a final status, Polyglot Voice sends an HTTP POST to your URL. Headers: Content-Type: application/json, X-Polyglot-Timestamp, X-Polyglot-Signature (HMAC-SHA256 over the body). Fetch the full transcription via GET /transcriptionions/{task_id}/result.

Exemple de corps de webhook

POST https://client.example.com/webhook

{
  "event": "transcription.completed",
  "task_id": "9b9c1b9a-....",
  "status": "completed",
  "model": "fast",
  "failure_reason": null,
  "has_transcript": true,
  "has_translation": true,
  "transcript_preview": "Hello, this is a sample..."
}

Codes d'erreur HTTP

Réponses d'erreur typiques de l'API :

• 400 — mauvaise requête (paramètres, format, URL)
• 401 — clé/jeton invalide ou manquant
• 403 — accès refusé
• 404 — tâche ou fichier introuvable
• 429 — limite de débit dépassée (voir Limites)
• 500 — erreur de serveur interne

Limites

Ces valeurs sont appliquées par l’API. Les plafonds courts (burst) s’appliquent par utilisateur connecté — le même compte avec un JWT de session ou une clé sk_. Les compteurs journaliers et mensuels comptent chaque requête faite avec l’une de vos clés sk_ (jour et mois civils UTC). Au dépassement, l’API renvoie HTTP 429.

Le champ JSON à jour rate_limits est renvoyé par :

Chargement des limites…

En outre, chaque forfait limite la durée audio max. par fichier, la taille d’envoi, les tâches simultanées et (sur le site) les envois quotidiens — voir votre abonnement dans le tableau de bord.

FAQ

Pages associées