> ## Documentation Index > Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt > Use this file to discover all available pages before exploring further. # Create Translation > Translates audio into English. ## OpenAPI ````yaml /openapi.json post /v1/audio/translations openapi: 3.1.0 info: title: AIHubMix Gateway API description: | Unified multi-protocol gateway. Exposes three native shapes side-by-side: - OpenAI (`/v1/chat/completions`, `/v1/responses`, ...) - Anthropic (`/v1/messages`) - Gemini (`/v1beta/models/{model}:generateContent`) Each vendor's native SDK connects directly. Gateway-only fields are marked with `x-source.authority: gateway`. contact: name: AIHubMix Team version: 2.1.1 x-upstream: vendorSpecs: packageVersion: 0.1.1 installedFrom: npm sources: openai/official: version: '2026-05-31' hash: >- sha256:a203971a0bc0cd3b903b9488e3ac40eaa161a274dfaf172c1da73eee029147a8 anthropic/official: version: '2026-05-31' hash: >- sha256:f9d488f9290d78a081bed62fa0c040476b5d009f3db92c06c8e279e69df73fc9 layers: - role: L0-base source: avs://openai/official protocol: openai authority: official - role: L0-base source: avs://anthropic/official protocol: anthropic authority: official - role: gateway-other source: gateway/anthropic-mappings.yml protocol: all authority: gateway - role: horizontal-auth source: gateway/auth.yml protocol: all authority: gateway - role: horizontal-errors source: gateway/errors.yml protocol: all authority: gateway - role: L3-gateway source: gateway/openai-gateway.yml protocol: openai authority: gateway - role: gateway-other source: gateway/openai-image-mappings.yml protocol: all authority: gateway - role: gateway-other source: gateway/openai-mappings.yml protocol: all authority: gateway - role: L2-passthrough source: gateway/openai-passthrough.yml protocol: openai authority: gateway servers: - url: https://aihubmix.com description: Production - url: https://api.inferera.com description: Backup (use when the primary domain is unreachable) security: - gatewayBearer: [] tags: - name: OpenAI Compatible description: >- OpenAI-compatible endpoints (chat, completions, embeddings, images, audio, videos, moderations). - name: Anthropic Compatible description: Anthropic-native endpoints (messages with Anthropic protocol). - name: Google Vertex AI Compatible description: Google Gemini / Vertex AI endpoints. paths: /v1/audio/translations: post: tags: - OpenAI Compatible summary: Create Translation description: Translates audio into English. operationId: createTranslation requestBody: required: true content: multipart/form-data: schema: $ref: '#/components/schemas/CreateTranslationRequest' responses: '200': description: OK content: application/json: schema: oneOf: - $ref: '#/components/schemas/CreateTranslationResponseJson' - $ref: '#/components/schemas/CreateTranslationResponseVerboseJson' '400': description: Invalid request content: application/json: schema: $ref: '#/components/schemas/GatewayError' '401': description: Authentication failed content: application/json: schema: $ref: '#/components/schemas/GatewayError' '403': description: Permission denied content: application/json: schema: $ref: '#/components/schemas/GatewayError' '404': description: Not found content: application/json: schema: $ref: '#/components/schemas/GatewayError' '429': description: Rate limited content: application/json: schema: $ref: '#/components/schemas/GatewayError' 5XX: description: Server / upstream error content: application/json: schema: $ref: '#/components/schemas/GatewayError' components: schemas: CreateTranslationRequest: type: object additionalProperties: false properties: file: description: > The audio file object (not file name) translate, in one of these formats: flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, or webm. type: string format: binary model: description: > ID of the model to use. Only `whisper-1` (which is powered by our open source Whisper V2 model) is currently available. example: whisper-1 anyOf: - type: string - type: string enum: - whisper-1 prompt: description: > An optional text to guide the model's style or continue a previous audio segment. The [prompt](https://developers.openai.com/api/docs/guides/speech-to-text#prompting) should be in English. type: string response_format: description: > The format of the output, in one of these options: `json`, `text`, `srt`, `verbose_json`, or `vtt`. type: string enum: - json - text - srt - verbose_json - vtt default: json temperature: description: > The sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use [log probability](https://en.wikipedia.org/wiki/Log_probability) to automatically increase the temperature until certain thresholds are hit. type: number default: 0 required: - file - model x-source: from: avs://openai/official authority: official CreateTranslationResponseJson: type: object properties: text: type: string required: - text x-source: from: avs://openai/official authority: official CreateTranslationResponseVerboseJson: type: object properties: language: type: string description: The language of the output translation (always `english`). duration: type: number format: double description: The duration of the input audio. text: type: string description: The translated text. segments: type: array description: Segments of the translated text and their corresponding details. items: $ref: '#/components/schemas/TranscriptionSegment' required: - language - duration - text x-source: from: avs://openai/official authority: official GatewayError: type: object description: | OpenAI-compatible error envelope. Top-level `error` object carrying `message` / `type` / `param` / `code`. `request_id` lives in the `X-Request-Id` response header, not in the body. The legacy `upstream` field is no longer emitted. x-source: from: gateway authority: gateway required: - error properties: error: type: object required: - message properties: message: type: string description: Human-readable error message. type: type: string nullable: true description: > Error category. OpenAI-compatible values include invalid_request_error / authentication_error / permission_error / not_found_error / rate_limit_error, etc. The upstream value is passed through verbatim; the enum is not fixed. param: type: string nullable: true description: Name of the offending field, when applicable. code: nullable: true description: | Sub-error code. May be a string or integer (the gateway treats `code` as an arbitrary type). TranscriptionSegment: type: object properties: id: type: integer description: Unique identifier of the segment. seek: type: integer description: Seek offset of the segment. start: type: number format: double description: Start time of the segment in seconds. end: type: number format: double description: End time of the segment in seconds. text: type: string description: Text content of the segment. tokens: type: array items: type: integer description: Array of token IDs for the text content. temperature: type: number format: float description: Temperature parameter used for generating the segment. avg_logprob: type: number format: float description: >- Average logprob of the segment. If the value is lower than -1, consider the logprobs failed. compression_ratio: type: number format: float description: >- Compression ratio of the segment. If the value is greater than 2.4, consider the compression failed. no_speech_prob: type: number format: float description: >- Probability of no speech in the segment. If the value is higher than 1.0 and the `avg_logprob` is below -1, consider this segment silent. required: - id - seek - start - end - text - tokens - temperature - avg_logprob - compression_ratio - no_speech_prob x-source: from: avs://openai/official authority: official securitySchemes: gatewayBearer: type: http scheme: bearer bearerFormat: API Key description: | Gateway-issued API key, formatted as `sk-gateway-xxxxxxxx`. Used by OpenAI-shaped endpoints (/v1/chat/completions, etc.). x-source: from: gateway authority: gateway ````