> ## Documentation Index > Fetch the complete documentation index at: https://phaseo.app/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Phaseo Gateway base URL: https://api.phaseo.app/v1. Send `Authorization: Bearer $PHASEO_API_KEY` with every request. > Model IDs look like `provider/model`, for example `openai/gpt-6-astra`. Do not guess IDs: list them with `GET /v1/models` or check https://phaseo.app/models. `phaseo/free` routes to an available free model and needs no wallet balance. > For new text integrations prefer `POST /v1/responses`. `POST /v1/chat/completions` (OpenAI format) and `POST /v1/messages` (Anthropic format) suit existing code. > The full API contract is https://phaseo.app/docs/openapi/v1/openapi.yaml. Official SDKs: `@phaseo/sdk` (TypeScript) and `phaseo` (Python), plus Go, C#, PHP, Ruby and Rust. > Search these docs over MCP at https://phaseo.app/docs/mcp, and install Phaseo skills with `npx skills add https://phaseo.app/docs`. If a page is wrong or out of date, report it with the MCP `submit_feedback` tool. > Manage Phaseo accounts with the `phaseo` CLI (`npm install -g @phaseo/cli`, then `phaseo login` or `phaseo login --device-code`), the `/v1` Management API or the MCP server at `https://mcp.phaseo.app/mcp?access=manage`. Do not send users to the dashboard for account tasks. A person is still needed for sign-up, approving a sign-in, paying the first top-up on the checkout link that `phaseo credits add` returns when no card is saved, confirming each saved-card top-up from the emailed link, and account security (password, MFA, passkeys). Create API keys with `phaseo keys create --name --json`; never guess one. Credit top-ups need `phaseo login --scopes billing:write` first. Task map: https://phaseo.app/docs/v1/developers/manage-from-an-agent.md. # Create a transcription > Convert audio to text (STT) with the selected transcription model. ## OpenAPI ````yaml openapi/v1/openapi.yaml POST /audio/transcriptions openapi: 3.0.3 info: title: Phaseo Gateway API description: >- A gateway API for accessing various AI models with OpenAI-compatible endpoints. version: 1.0.0 contact: name: Phaseo url: https://phaseo.app email: danielbutler500@gmail.com servers: - url: https://api.phaseo.app/v1 description: Global routing security: - BearerAuth: [] tags: - name: Gateway description: Core Phaseo Gateway operations. paths: /audio/transcriptions: post: tags: - Gateway summary: Create transcription description: Transcribes audio into the input language. operationId: createTranscription requestBody: required: true content: multipart/form-data: schema: $ref: '#/components/schemas/AudioTranscriptionRequest' responses: '200': description: Transcription response content: application/json: schema: $ref: '#/components/schemas/AudioTranscriptionResponse' components: schemas: AudioTranscriptionRequest: type: object required: - model properties: model: type: string models: $ref: '#/components/schemas/ModelFallbacks' audio_url: type: string format: uri audio_b64: type: string language: type: string chunking_strategy: oneOf: - type: string enum: - auto - type: object required: - type properties: type: type: string enum: - server_vad prefix_padding_ms: type: integer minimum: 0 silence_duration_ms: type: integer minimum: 0 threshold: type: number minimum: 0 maximum: 1 known_speaker_names: type: array maxItems: 4 items: type: string known_speaker_references: type: array maxItems: 4 items: type: string provider: $ref: '#/components/schemas/ProviderRoutingOptions' AudioTranscriptionResponse: type: object properties: text: type: string ModelFallbacks: type: array minItems: 1 maxItems: 25 items: type: string minLength: 1 description: >- Optional ordered fallback models tried after `model`. `model` is required and is always the primary model. When an attempt fails with `429`, `500`, `502`, `503`, or `504`, the next entry is tried; other errors are returned unchanged. Accepts up to 25 model IDs or presets; duplicates and entries equal to `model` are ignored. Each attempt is validated, logged, and billed as its own request, and the response `model` field and routing trace show the model that served the request. Streaming requests fall back only before the first byte, and video and music jobs fall back only at submission. Batch, realtime, and council requests reject `models`. Fallbacks set on a dynamic route take precedence, and `phaseo/auto` cannot be combined with `models`. example: - anthropic/claude-sonnet-5-5 - google/gemini-2.5-flash ProviderRoutingOptions: type: object description: Provider routing preferences for gateway selection. properties: order: type: array items: type: string only: type: array items: type: string ignore: type: array items: type: string include_alpha: type: boolean description: Include alpha providers in routing (off by default). allow_fallbacks: type: boolean nullable: true description: Allow fallback to another eligible provider after failure. require_parameters: type: boolean nullable: true description: Require provider support for requested parameters before routing. required_execution_region: type: string nullable: true description: Restrict routing to providers with the requested execution region. required_data_region: type: string nullable: true description: Restrict routing to providers with the requested data region. require_zero_data_retention: type: boolean nullable: true description: Restrict routing to providers that support zero data retention. data_collection: type: string nullable: true description: >- `allow` (the default) filters nothing. `deny` is not supported yet and returns 400 unsupported_routing_filter. enum: - allow - deny zdr: type: boolean nullable: true enforce_distillable_text: type: boolean nullable: true description: >- `false` (the default) filters nothing. `true` is not supported yet and returns 400 unsupported_routing_filter. quantizations: type: array nullable: true items: type: string sort: oneOf: - type: string - type: object additionalProperties: true description: >- Rank providers for this request, for example by price, latency, or throughput. max_price: type: object properties: prompt: oneOf: - type: number - type: string completion: oneOf: - type: number - type: string image: oneOf: - type: number - type: string audio: oneOf: - type: number - type: string request: oneOf: - type: number - type: string preferred_min_throughput: oneOf: - type: number - type: object additionalProperties: type: number preferred_max_latency: oneOf: - type: number - type: object additionalProperties: type: number securitySchemes: BearerAuth: type: http scheme: bearer description: Bearer token authentication ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.