# Audio API

**POST** `https://api.oneover.com/functions/v1/api-v1-audio`

**Scope:** `audio`

Speech and music generation.

## Request body

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| model | string | yes | Audio model ID |
| prompt | string | yes | Text to speak or music description |
| audio_kind | string | no | `speech` (default) or `music` |
| voice | string | no | Voice ID for speech |
| speakers | array | no | Multi-speaker voice IDs |
| speed | number | no | Speech speed multiplier |
| music_style | string | no | Style hint for music |
| duration_seconds | number | no | Target duration for music |

## Response

```json
{
  "request_id": "uuid",
  "model": "gpt-4o-mini-tts",
  "audio_kind": "speech",
  "audio_url": "https://...",
  "credits_charged": 2,
  "balance": { "subscription": 14992, "anytime": 5000 }
}
```