> ## Documentation Index
> Fetch the complete documentation index at: https://docs.modellix.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Whisper 1

> [Core Function] OpenAI Whisper transcribes a single public audio URL into text via an async task. [Strengths] Multiple output formats (verbose_json with word/segment timestamps, plain text, SRT, VTT), optional language and prompt biasing. [Best For] Meeting notes, podcasts, captions, and batch audio-to-text. [Limitations] Do NOT use file upload; URL-only input (audio up to 25 MB). Prefer verbose_json when you need duration or timestamps. [Routing] Use whisper-1 for OpenAI Whisper quality with URL-based audio.



## OpenAPI

````yaml /media-model-api/openai/openai-s2t.json post /openai/whisper-1
openapi: 3.1.0
info:
  title: OpenAI Whisper Speech-to-Text API
  description: >-
    OpenAI Whisper speech-to-text. Submit a public audio URL as an async task;
    poll GET /api/v1/tasks/{task_id} for the transcription result.
  version: 1.0.0
  contact:
    name: Modellix Support
    email: support@modellix.ai
servers:
  - url: https://api.modellix.ai/api/v1
    description: OpenAI Whisper speech-to-text models API
security:
  - bearerAuth: []
paths:
  /openai/whisper-1:
    post:
      summary: Whisper 1
      description: >-
        [Core Function] OpenAI Whisper transcribes a single public audio URL
        into text via an async task. [Strengths] Multiple output formats
        (verbose_json with word/segment timestamps, plain text, SRT, VTT),
        optional language and prompt biasing. [Best For] Meeting notes,
        podcasts, captions, and batch audio-to-text. [Limitations] Do NOT use
        file upload; URL-only input (audio up to 25 MB). Prefer verbose_json
        when you need duration or timestamps. [Routing] Use whisper-1 for OpenAI
        Whisper quality with URL-based audio.
      operationId: openaiWhisperSTT
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WhisperSTTRequest'
            examples:
              basic:
                summary: Minimal request
                value:
                  url: https://cdn.example.com/meeting.mp3
              verbose:
                summary: Word and segment timestamps
                value:
                  url: https://cdn.example.com/meeting.mp3
                  response_format: verbose_json
                  timestamp_granularities:
                    - word
                    - segment
      responses:
        '200':
          description: >-
            Task submitted successfully. Poll GET /api/v1/tasks/{task_id} until
            the task completes; the transcription result is returned on the task
            result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AsyncTaskResponse'
              example:
                code: 0
                message: success
                data:
                  status: pending
                  task_id: task-whisper-001
                  model_id: openai/whisper-1
                  get_result:
                    method: GET
                    url: https://api.modellix.ai/api/v1/tasks/task-whisper-001
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    WhisperSTTRequest:
      type: object
      required:
        - url
      additionalProperties: false
      properties:
        url:
          type: string
          minLength: 1
          pattern: ^https?://
          description: Public http(s) URL of the audio file (max 25 MB).
        language:
          type: string
          description: ISO-639-1 language hint for transcription.
        prompt:
          type: string
          description: >-
            Optional text to guide the model's style or continue a previous
            segment.
        temperature:
          type: number
          minimum: 0
          maximum: 1
          default: 0
          description: Sampling temperature; higher values increase randomness.
        response_format:
          type: string
          enum:
            - json
            - text
            - srt
            - verbose_json
            - vtt
          default: verbose_json
          description: Output format. verbose_json recommended for duration and timestamps.
        timestamp_granularities:
          type: array
          items:
            type: string
            enum:
              - word
              - segment
          description: >-
            Timestamp detail levels. Requires response_format=verbose_json when
            non-empty.
    AsyncTaskResponse:
      description: Response object for asynchronous task submission.
      type: object
      required:
        - code
        - message
        - data
      properties:
        code:
          type: integer
          description: Response code, 0 indicates success
          example: 0
        message:
          type: string
          description: Response message
          example: success
        data:
          type: object
          required:
            - status
            - task_id
            - model_id
          description: >-
            Task submission details. Poll GET /api/v1/tasks/{task_id} until
            status is success; the transcription appears in result.resources.
            See Common API: Query Task Result.
          properties:
            status:
              type: string
              enum:
                - pending
                - processing
              description: Initial task status
              example: pending
            task_id:
              type: string
              description: Unique task identifier for polling
              example: task-whisper-001
            model_id:
              type: string
              description: Model ID in provider/model format
              example: openai/whisper-1
            get_result:
              type: object
              description: >-
                Endpoint to query the task result. See Common API: Query Task
                Result.
              properties:
                method:
                  type: string
                  example: GET
                url:
                  type: string
                  example: https://api.modellix.ai/api/v1/tasks/task-whisper-001
  responses:
    BadRequest:
      description: Invalid parameters
    Unauthorized:
      description: Missing or invalid API key
    TooManyRequests:
      description: Rate limited
    InternalServerError:
      description: Internal server error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````