CustomGenerateRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/tunova-ai/json-schema/tunova-ai-custom-generate-request-schema.json",
  "title": "CustomGenerateRequest",
  "x-generated": "2026-10-31",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/tunova-ai-openapi.json#/components/schemas/CustomGenerateRequest",
  "type": "object",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "type": "string",
      "description": "Your lyrics. CRLF/CR line endings are normalized to LF and outer whitespace is trimmed; interior whitespace is preserved."
    },
    "tags": {
      "type": "string",
      "description": "Style / genre tags"
    },
    "title": {
      "type": "string"
    },
    "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. Preview audio is transient and not yet quality-verified."
    }
  }
}