{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/finevoice/main/json-schema/finevoice-music-generation-by-prompt-request-schema.json",
  "title": "MusicGenerationByPromptRequest",
  "description": "The prompt-based music generation request payload.",
  "x-generated": "2026-10-22",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_original/finevoice-openapi-openapi.json#/components/schemas/MusicGenerationByPromptRequest",
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "description": "The generation prompt describing the desired music."
    },
    "instrumental": {
      "type": "boolean",
      "description": "Whether to generate instrumental-only music (no vocals)."
    },
    "duration": {
      "type": "integer",
      "format": "int32",
      "description": "The target duration in seconds."
    },
    "continuation": {
      "type": "boolean",
      "description": "Whether this generation continues a previous clip."
    },
    "title": {
      "type": "string",
      "description": "The generated song title."
    },
    "modelVersion": {
      "type": "string",
      "description": "The model version to use."
    },
    "audioId": {
      "type": "string",
      "description": "Source audio identifier for continuation or reference."
    },
    "prompt_type": {
      "type": "string",
      "description": "The prompt input type."
    },
    "input_audio": {
      "type": "string",
      "description": "Optional input audio reference URL."
    },
    "thumbnail_url": {
      "type": "string",
      "description": "The thumbnail image URL."
    }
  }
}