API docsAPI reference

Suno V6 · Get one model

Model objects with slug, name, type, vendor, params and providers. Provider entries include their effective params and price tiers.

GET/api/v1/models/{slug}Public · No API key

suno-v6Audio · SunoModel details & pricing

Endpoints for this model

POST/generationsCreate a generation GET/generations/{id}Get the result POST/generations/{id}/cancelCancel a task POST/quoteQuote GET/models/{slug}Get one model

Parameter scope

Select a provider to see its effective parameter limits. Automatic routing chooses a provider that supports your input. Examples include defaults and required inputs; replace example media URLs with accessible files.

Request

cURL

curl 'https://01router.com/api/v1/models/suno-v6'

Input parameters

Query / path parameters

slug string · pathRequired: Model slug from the catalog. Project keys may use a project-specific model slug.
Allowed values:"suno-v6"

Response example

200 · application/json

{
  "slug": "suno-v6",
  "name": "Suno V6",
  "type": "audio",
  "vendor": "Suno",
  "description": "Suno V6 music generation: full songs with vocals or instrumentals from a description, or your own lyrics and style in custom mode. Each request returns two tracks.",
  "tags": [
    "music",
    "lyrics",
    "text-to-music"
  ],
  "coverUrl": "",
  "params": [
    {
      "name": "prompt",
      "type": "text",
      "label": "Prompt / lyrics",
      "description": "Song description (simple mode) or lyrics (custom mode)"
    },
    {
      "name": "custom_mode",
      "type": "boolean",
      "label": "Custom mode",
      "description": "Use your own lyrics, style and title",
      "default": false
    },
    {
      "name": "instrumental",
      "type": "boolean",
      "label": "Instrumental",
      "default": false
    },
    {
      "name": "style",
      "type": "string",
      "label": "Style",
      "description": "Custom mode only, e.g. \"dream pop, female vocals\""
    },
    {
      "name": "title",
      "type": "string",
      "label": "Title",
      "description": "Custom mode only"
    },
    {
      "name": "negative_tags",
      "type": "string",
      "label": "Exclude styles"
    },
    {
      "name": "vocal_gender",
      "type": "enum",
      "label": "Vocal gender",
      "options": [
        "m",
        "f"
      ]
    },
    {
      "name": "duration",
      "type": "integer",
      "label": "Duration (s)",
      "description": "Custom mode only",
      "min": 10,
      "max": 360
    }
  ],
  "providers": [
    {
      "provider": "kie",
      "providerName": "KIE AI",
      "discount": 90,
      "preferred": false,
      "params": [
        {
          "name": "prompt",
          "type": "text",
          "label": "Prompt / lyrics",
          "description": "Song description (simple mode) or lyrics (custom mode)",
          "maxLength": 5000
        },
        {
          "name": "custom_mode",
          "type": "boolean",
          "label": "Custom mode",
          "description": "Use your own lyrics, style and title",
          "default": false
        },
        {
          "name": "instrumental",
          "type": "boolean",
          "label": "Instrumental",
          "default": false
        },
        {
          "name": "style",
          "type": "string",
          "label": "Style",
          "description": "Custom mode only, e.g. \"dream pop, female vocals\"",
          "maxLength": 1000
        },
        {
          "name": "title",
          "type": "string",
          "label": "Title",
          "description": "Custom mode only",
          "maxLength": 80
        },
        {
          "name": "negative_tags",
          "type": "string",
          "label": "Exclude styles"
        },
        {
          "name": "vocal_gender",
          "type": "enum",
          "label": "Vocal gender",
          "options": [
            "m",
            "f"
          ]
        },
        {
          "name": "duration",
          "type": "integer",
          "label": "Duration (s)",
          "description": "Custom mode only",
          "min": 10,
          "max": 360
        }
      ],
      "prices": [
        {
          "unit": "request",
          "conditions": {},
          "priceMicros": 54000,
          "originalMicros": 60000,
          "credits": 6
        }
      ]
    },
    {
      "provider": "apimart",
      "providerName": "APIMart",
      "discount": 90,
      "preferred": false,
      "params": [
        {
          "name": "prompt",
          "type": "text",
          "label": "Prompt / lyrics",
          "description": "Song description (simple mode) or lyrics (custom mode)",
          "maxLength": 5000
        },
        {
          "name": "custom_mode",
          "type": "boolean",
          "label": "Custom mode",
          "description": "Use your own lyrics, style and title",
          "default": false
        },
        {
          "name": "instrumental",
          "type": "boolean",
          "label": "Instrumental",
          "default": false
        },
        {
          "name": "style",
          "type": "string",
          "label": "Style",
          "description": "Custom mode only, e.g. \"dream pop, female vocals\"",
          "maxLength": 1000
        },
        {
          "name": "title",
          "type": "string",
          "label": "Title",
          "description": "Custom mode only",
          "maxLength": 80
        },
        {
          "name": "negative_tags",
          "type": "string",
          "label": "Exclude styles"
        },
        {
          "name": "vocal_gender",
          "type": "enum",
          "label": "Vocal gender",
          "options": [
            "m",
            "f"
          ]
        },
        {
          "name": "duration",
          "type": "integer",
          "label": "Duration (s)",
          "description": "Custom mode only",
          "min": 10,
          "max": 360
        }
      ],
      "prices": [
        {
          "unit": "request",
          "conditions": {},
          "priceMicros": 45000,
          "originalMicros": 50000,
          "credits": 5
        }
      ]
    },
    {
      "provider": "evolink",
      "providerName": "EvoLink",
      "discount": 90,
      "preferred": false,
      "params": [
        {
          "name": "prompt",
          "type": "text",
          "label": "Prompt / lyrics",
          "description": "Song description (simple mode) or lyrics (custom mode)"
        },
        {
          "name": "custom_mode",
          "type": "boolean",
          "label": "Custom mode",
          "description": "Use your own lyrics, style and title",
          "default": false
        },
        {
          "name": "instrumental",
          "type": "boolean",
          "label": "Instrumental",
          "default": false
        },
        {
          "name": "style",
          "type": "string",
          "label": "Style",
          "description": "Custom mode only, e.g. \"dream pop, female vocals\""
        },
        {
          "name": "title",
          "type": "string",
          "label": "Title",
          "description": "Custom mode only"
        },
        {
          "name": "negative_tags",
          "type": "string",
          "label": "Exclude styles"
        },
        {
          "name": "vocal_gender",
          "type": "enum",
          "label": "Vocal gender",
          "options": [
            "m",
            "f"
          ]
        },
        {
          "name": "duration",
          "type": "integer",
          "label": "Duration (s)",
          "description": "Custom mode only",
          "min": 10,
          "max": 360
        }
      ],
      "prices": [
        {
          "unit": "request",
          "conditions": {},
          "priceMicros": 106200,
          "originalMicros": 118000,
          "credits": 11
        }
      ]
    },
    {
      "provider": "atlascloud",
      "providerName": "AtlasCloud",
      "discount": 90,
      "preferred": false,
      "params": [
        {
          "name": "prompt",
          "type": "text",
          "label": "Prompt / lyrics",
          "description": "Song description (simple mode) or lyrics (custom mode)",
          "maxLength": 3000
        },
        {
          "name": "custom_mode",
          "type": "boolean",
          "label": "Custom mode",
          "description": "Use your own lyrics, style and title",
          "default": false
        },
        {
          "name": "instrumental",
          "type": "boolean",
          "label": "Instrumental",
          "default": false
        },
        {
          "name": "style",
          "type": "string",
          "label": "Style",
          "description": "Custom mode only, e.g. \"dream pop, female vocals\"",
          "maxLength": 500
        },
        {
          "name": "title",
          "type": "string",
          "label": "Title",
          "description": "Custom mode only",
          "maxLength": 200
        },
        {
          "name": "negative_tags",
          "type": "string",
          "label": "Exclude styles",
          "maxLength": 500
        },
        {
          "name": "vocal_gender",
          "type": "enum",
          "label": "Vocal gender",
          "options": [
            "m",
            "f"
          ]
        },
        {
          "name": "duration",
          "type": "integer",
          "label": "Duration (s)",
          "description": "Custom mode only",
          "min": 10,
          "max": 360
        }
      ],
      "prices": [
        {
          "unit": "request",
          "conditions": {},
          "priceMicros": 118800,
          "originalMicros": 132000,
          "credits": 12
        }
      ]
    }
  ],
  "fromMicros": 45000,
  "fromOriginalMicros": 50000,
  "fromUnit": "request"
}

Responses are illustrative. IDs, usage, prices and results depend on the actual request.

Response fields

slug string: Model slug from the catalog. Project keys may use a project-specific model slug.
params array: Parameter definitions: name, type, required, default, options, min, max, maxItems and maxLength when configured.
providers array: Available providers with their parameter constraints and public price tiers.

Use with AI

Give your coding assistant the documentation index or the full API reference, including live model parameters.

llms.txt llms-full.txt This page as Markdown