Get API Key Get API
Docs

Inspiration generation (inspo)

- Generate a new song using 1–4 pieces of public audio as inspiration references (pass the audio URLs directly, not via task_id).

  • Async task: submitting returns a task_id; poll GET /v1/music/tasks/:task_id for the result

Request example

curl -X POST https://api.openveer.com/v1/music/generations/inspo \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "suno",
    "audio_urls": [
      "https://a/1.mp3",
      "https://a/2.mp3"
    ],
    "version": "v6",
    "tags": "dreamy pop"
  }'

Response example

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

Authorizations

Authorization string

All endpoints require authentication using a Bearer Token

Get an API Key:

Visit the API Key management page to get your API Key

Add the following to the request headers when using it:

Authorization: Bearer YOUR_API_KEY

Body

model string

Audio model. Currently pass suno (defaults to suno if omitted).

audio_urls array

An array of 1–4 publicly accessible audio URLs.

version string

Public version: v6 / v6-wild / v6-mini. Defaults to v6; omit this field when using custom_model_id.

custom_model_id string

The full UUID returned by the model-creation task. Mutually exclusive with version.

prompt string

Lyrics / content.

title string

Title.

tags string

Style tags.

negative_tags string

Style tags to exclude.

style_weight number

Style weight, 0.00–1.00.

weirdness number

Creativity weight, 0.00 – 1.00. Compatible with the old name weirdness_constraint; new requests should use weirdness.

audio_weight number

Audio weight, 0.00–1.00.

vocal_gender string

Vocal gender: Male / Female.

auto_lyrics boolean

true=rewrite the provided lyrics creatively.

variety string

Style variation: off / normal / high / extra / max. Optional.

max_mode boolean

Enables Max mode and is billed at twice the standard price.

audio_format string

Output audio format: mp3 / m4a / wav.

Note

This interface accepts 1–4 publicly accessible audio links, and does not send the custom, instrumental, gpt_description, persona_id tokens or the duration field.

Note

Get Result: This is an asynchronous task. After submission, you will receive task_id and then poll GET /v1/music/tasks/{task_id} every 3–5 seconds until status becomes completed or failed (music generation usually takes 30–120 seconds; while generation is in progress, status may be pending or processing, and progress is an integer from 0 to 100 and is not guaranteed to change at fixed intervals). Once completed, read audio_url from data.result.music[]. In case of failure, data.error.message provides the reason and the deducted amount will be automatically refunded.

Response

code integer

Response status code

data array
Returned data array
status string

Task status

  * submitted - Submitted
task_id string

Unique task identifier (used to poll GET /v1/music/tasks/{task_id} for the result)

This documentation is built and hosted on Mintlify, a developer documentation platform.