Skip to main content
audio-perception-1 takes audio and an instruction through POST /v1/chat/completions and returns text or JSON.

Request

  • model (string, required) — audio-perception-1.
  • messages (array, required) — system, user and assistant messages. User content is a string or an array of text and input_audio parts.
  • input_audio — {"data": "<base64>", "format": "wav" | "mp3"}. Up to 25 MB per part and 10 minutes per request.
  • response_format (object, optional) — {"type": "json_schema", "json_schema": {...}} or {"type": "json_object"}. Output is validated against the schema.
  • temperature (number, optional, default 0), top_p (number, optional), seed (integer, optional).
  • max_tokens or max_completion_tokens (integer, optional, default 1024, max 4096).

Response

Audio counts as input tokens, about 20 per second.

Limits

  • 8 requests per second. Over that: 429 rate_limit_exceeded with Retry-After.
  • An output that misses response_format after a retry: 422 response_format_mismatch.