URL de base
/v1. Les requêtes et les réponses passent uniquement par HTTPS.
Points d’accès
Conventions
- Authentification :
Authorization: Bearer namu_sk_.... Voir Authentification. - Corps : du JSON pour le texte (
/v1/speech, traduction de texte) ; pour l’audio, du multipart avec un champfile, ou l’audio brut comme corps. - Erreurs : toujours
{"error": {"type", "message", "request_id"}}. Voir Erreurs. - Identifiants de requête : chaque réponse porte un en-tête
X-Request-Id. - Pas encore de diffusion en continu : chaque réponse arrive en entier.
- Versions : la version figure dans le chemin (
/v1). Des champs peuvent être ajoutés aux réponses à tout moment ; tout ce qui casserait une intégration est annoncé à l’avance dans l’historique des versions.
OpenAPI
La référence est générée à partir d’une description OpenAPI 3.1 de l’API. Téléchargez-la pour générer un client dans votre langage, ou importez-la dans Postman, Insomnia ou Bruno :openapi.yaml
L’API Namu en OpenAPI 3.1.