Яндекс.Метрика

API publique

Documentation développeur et exemples de requêtes.

URL de base

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

https://polyglotvoice.ru/api/v1

Autorisation

Toutes les requêtes exigent une clé API dans l'en-tête Authorization.

Authorization: Bearer sk_...

La clé est valable 30 jours et ne fonctionne que pour transcriptions/*.

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.

POST /api/v1/transcriptions/upload

Téléverser un fichier pour la transcription.

POST /api/v1/transcriptions/from-url

Transcrire depuis une URL média.

POST /api/v1/transcriptions/validate-url

Valider une URL média avant traitement.

GET /api/v1/transcriptions

Lister les tâches de transcription.

GET /api/v1/transcriptions/{task_id}

Détails de la tâche.

GET /api/v1/transcriptions/{task_id}/result

Résultat de transcription.

GET /api/v1/transcriptions/{task_id}/downloads/{kind}

Télécharger le fichier de résultat (srt/txt/json, etc.).

GET /api/v1/transcriptions/{task_id}/source

Diffuser le média source (Range).

POST /api/v1/transcriptions/convert-audio

Convertir l'audio et télécharger le résultat.

Exemples de requêtes

Exemples de base pour commencer.

curl

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

Python

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())

JavaScript

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.

Réponses et erreurs

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

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

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 :

GET https://polyglotvoice.ru/api/v1/developer/documentation

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.