--url https://api.omnimux.ai/v1/video/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "suno",
"prompt": "An upbeat acoustic folk song about mountain travel at sunrise",
"tags": "folk acoustic positive"
}'
{
"task_id": "task_suno_01HXYZABCDEF",
"status": "queued"
}
{ "error": { "message": "Invalid request", "type": "invalid_request_error", "code": "bad_request" } }
{ "error": { "message": "Invalid token", "type": "authentication_error", "code": "unauthorized" } }
{
"error": {
"message": "Insufficient quota. Please top up your account.",
"type": "insufficient_quota",
"code": "insufficient_quota"
}
}
{ "error": { "message": "Rate limit exceeded", "type": "rate_limit_error", "code": "rate_limit_exceeded" } }
{ "error": { "message": "Internal server error", "type": "server_error", "code": "internal_error" } }
--url https://api.omnimux.ai/v1/video/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "suno",
"prompt": "An upbeat acoustic folk song about mountain travel at sunrise",
"tags": "folk acoustic positive"
}'
{
"task_id": "task_suno_01HXYZABCDEF",
"status": "queued"
}
{ "error": { "message": "Invalid request", "type": "invalid_request_error", "code": "bad_request" } }
{ "error": { "message": "Invalid token", "type": "authentication_error", "code": "unauthorized" } }
{
"error": {
"message": "Insufficient quota. Please top up your account.",
"type": "insufficient_quota",
"code": "insufficient_quota"
}
}
{ "error": { "message": "Rate limit exceeded", "type": "rate_limit_error", "code": "rate_limit_exceeded" } }
{ "error": { "message": "Internal server error", "type": "server_error", "code": "internal_error" } }
Suno
Suno Music Generation
Suno Music Generation · model suno
--url https://api.omnimux.ai/v1/video/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "suno",
"prompt": "An upbeat acoustic folk song about mountain travel at sunrise",
"tags": "folk acoustic positive"
}'
{
"task_id": "task_suno_01HXYZABCDEF",
"status": "queued"
}
{ "error": { "message": "Invalid request", "type": "invalid_request_error", "code": "bad_request" } }
{ "error": { "message": "Invalid token", "type": "authentication_error", "code": "unauthorized" } }
{
"error": {
"message": "Insufficient quota. Please top up your account.",
"type": "insufficient_quota",
"code": "insufficient_quota"
}
}
{ "error": { "message": "Rate limit exceeded", "type": "rate_limit_error", "code": "rate_limit_exceeded" } }
{ "error": { "message": "Internal server error", "type": "server_error", "code": "internal_error" } }
POST
/
v1
/
video
/
generations
--url https://api.omnimux.ai/v1/video/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "suno",
"prompt": "An upbeat acoustic folk song about mountain travel at sunrise",
"tags": "folk acoustic positive"
}'
{
"task_id": "task_suno_01HXYZABCDEF",
"status": "queued"
}
{ "error": { "message": "Invalid request", "type": "invalid_request_error", "code": "bad_request" } }
{ "error": { "message": "Invalid token", "type": "authentication_error", "code": "unauthorized" } }
{
"error": {
"message": "Insufficient quota. Please top up your account.",
"type": "insufficient_quota",
"code": "insufficient_quota"
}
}
{ "error": { "message": "Rate limit exceeded", "type": "rate_limit_error", "code": "rate_limit_exceeded" } }
{ "error": { "message": "Internal server error", "type": "server_error", "code": "internal_error" } }
- Create:
POST /v1/video/generationswithmodelsuno(music generation) orsuno-sounds(sound effects generation) - Async: poll Video task with returned
task_id - Music and sound effect generations share the unified media task endpoint and task polling contract
Identity
| Field | Value |
|---|---|
| Series | Audio series |
| Brand | Suno |
| model | suno, suno-sounds |
Endpoint
| Method | Path |
|---|---|
POST | /v1/video/generations |
GET | /v1/video/generations/{task_id} |
https://api.omnimux.ai
Authorizations
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Authorization | header | string | yes | Bearer sk-... (API key) |
Body
| Field | Type | Required | Description |
|---|---|---|---|
model | string | yes | Must be suno |
prompt | string | yes | Song lyrics, genre description, or musical style |
title | string | no | Song title |
tags / style | string | no | Musical style tags (e.g. acoustic pop, electronic synth) |
instrumental | boolean | no | Set true to generate instrumental music without vocals |
Response
200 (create)
| Field | Type | Description |
|---|---|---|
task_id | string | Task id for polling |
status | string | queued / processing / completed |