{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/pipeshub/json-schema/pipeshub-speak-request-schema.json",
  "title": "SpeakRequest",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/pipeshub-conversational-speech-api-openapi.yml#/components/schemas/SpeakRequest",
  "type": "object",
  "required": [
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096,
      "description": "UTF-8 text to synthesize. Capped at 4096 characters to match the\nunderlying provider limit (OpenAI TTS) and avoid unbounded cost.\n"
    },
    "voice": {
      "type": [
        "string",
        "null"
      ],
      "description": "Provider voice override. If omitted, the voice configured by the\nadmin for the active TTS provider is used. For OpenAI: one of\n`alloy`, `echo`, `fable`, `onyx`, `nova`, `shimmer`.\n"
    },
    "format": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "mp3",
        "opus",
        "aac",
        "flac",
        "wav",
        "pcm"
      ],
      "description": "Audio response format. Unknown values are silently coerced to\n`mp3` server-side.\n"
    },
    "speed": {
      "type": [
        "number",
        "null"
      ],
      "format": "float",
      "minimum": 0.25,
      "maximum": 4.0,
      "description": "Playback speed multiplier. Values outside the documented range\nare clamped server-side.\n"
    }
  }
}