{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/tunova-ai/json-schema/tunova-ai-generate-request-schema.json",
  "title": "GenerateRequest",
  "x-generated": "2026-10-31",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/tunova-ai-openapi.json#/components/schemas/GenerateRequest",
  "type": "object",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "type": "string",
      "description": "Free-text description of the song"
    },
    "make_instrumental": {
      "type": "boolean",
      "default": false
    },
    "model": {
      "type": "string",
      "enum": [
        "v6",
        "v5.5"
      ],
      "description": "Suno model: v6, or v5.5 as a compatibility alias for v6. Both generate v6 at the same token cost. Omitted model keeps the existing account default."
    },
    "callback_url": {
      "type": "string",
      "format": "uri",
      "description": "Public http(s) URL for the completion webhook"
    },
    "streaming_callback": {
      "type": "boolean",
      "default": false,
      "description": "Opt in to an additional signed `status: streaming` preview webhook. Requires callback_url; it may also be enabled as an account default. Terminal complete/failed webhooks are unchanged."
    }
  }
}