v1

latestOpenAPI 3.0.3MIT2026-07-132953108.7 KB
Audio

Create Transcription (Speech-to-Text)

Transcribes audio files to text using AI speech recognition. Supports multiple audio formats, languages, and detailed timing information.

post/v1/audio/transcriptions

Response

Transcription result or streaming response

idstring

Unique response identifier

object'chat.completion' | 'text.completion'

Response type

modelstring

Model used for generation

createdinteger

Unix timestamp of creation

service_tierstring

Service tier used

system_fingerprintstring

System fingerprint

Example response

{
  "id": "chatcmpl-123",
  "object": "chat.completion",
  "choices": [
    {
      "message": {
        "role": "user",
        "content": "Hello, how are you?",
        "tool_calls": [
          {
            "id": "tool_123",
            "type": "function",
            "function": {
              "name": "get_weather",
              "arguments": "{\"location\": \"San Francisco, CA\"}"
            }
          }
        ]
      },
      "finish_reason": "stop",
      "log_probs": {
        "content": [
          {
            "logprob": -0.123,
            "token": "hello",
            "top_logprobs": [
              {
                "logprob": -0.456,
                "token": "world"
              }
            ]
          }
        ],
        "refusal": [
          {
            "logprob": -0.456,
            "token": "world"
          }
        ]
      }
    }
  ],
  "model": "gpt-4o",
  "created": 1677652288,
  "usage": {
    "prompt_tokens": 56,
    "completion_tokens": 31,
    "total_tokens": 87
  },
  "extra_fields": {
    "provider": "openai",
    "model_params": {
      "temperature": 0.7,
      "top_p": 0.9,
      "top_k": 40,
      "max_tokens": 1000,
      "stop_sequences": [
        "\n\n",
        "END"
      ],
      "tools": [
        {
          "type": "function",
          "function": {
            "name": "get_weather",
            "description": "Get current weather for a location",
            "parameters": {
              "type": "object"
            }
          }
        }
      ],
      "tool_choice": {
        "type": "auto",
        "function": {
          "name": "get_weather"
        }
      },
      "parallel_tool_calls": true
    },
    "latency": 1.234,
    "chat_history": [
      {
        "role": "user",
        "content": "Hello, how are you?",
        "tool_calls": [
          {
            "id": "tool_123",
            "type": "function",
            "function": {
              "name": "get_weather",
              "arguments": "{\"location\": \"San Francisco, CA\"}"
            }
          }
        ]
      }
    ]
  }
}