Skip to main content

​
Base URL

Every endpoint lives under /v1. Requests and responses use HTTPS only.

​
Endpoints

​
Conventions

  • Authentication: Authorization: Bearer namu_sk_.... See authentication.
  • Bodies: JSON for text (/v1/speech, text translation); multipart with a file field, or the raw audio as the body, for audio.
  • Errors: always {"error": {"type", "message", "request_id"}}. See errors.
  • Request ids: every response has an X-Request-Id header.
  • No streaming yet: every response arrives whole.
  • Versioning: the version is in the path (/v1). Fields can be added to responses at any time; anything that would break an integration comes with notice in the changelog.

​
OpenAPI

The reference is generated from an OpenAPI 3.1 description of the API. Download it to generate a client in your language or import it into Postman, Insomnia or Bruno:

openapi.yaml

The Namu API in OpenAPI 3.1.