{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/viewmax-studio/json-schema/viewmax-studio-create-speech-request-schema.json",
  "title": "CreateSpeechRequest",
  "x-generated": "2026-11-03",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/viewmax-studio-openapi.json#/components/schemas/CreateSpeechRequest",
  "type": "object",
  "required": [
    "text",
    "voice_id"
  ],
  "properties": {
    "text": {
      "type": "string",
      "minLength": 1,
      "description": "Trimmed text to speak. Cost: `max(1, ceil(characters / 20))` credits."
    },
    "voice_id": {
      "type": "string",
      "description": "Voice `id` from GET /api/v1/voices."
    },
    "options": {
      "type": "object",
      "additionalProperties": true,
      "description": "Out-of-range numbers are clamped, not rejected.",
      "properties": {
        "model_id": {
          "type": "string",
          "description": "Default: the voice's `recommended_model`."
        },
        "speed": {
          "type": "number",
          "minimum": 0.25,
          "maximum": 4
        },
        "stability": {
          "type": "number",
          "minimum": 0,
          "maximum": 1
        },
        "similarity_boost": {
          "type": "number",
          "minimum": 0,
          "maximum": 1
        }
      }
    }
  }
}