curl --request POST \
  --url https://api.aihubmax.com/v1beta/models/{model}:generateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Create a 30-second upbeat folk song using guitar and harmonica."
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "AUDIO",
      "TEXT"
    ]
  }
}
'

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "Here is an upbeat folk song featuring guitar and harmonica.",
            "inlineData": {
              "mimeType": "audio/mpeg",
              "data": "SUQzBAAAAAAAI1RTU0UAAAAPAAADTGF2ZjU4..."
            }
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP",
      "safetyRatings": [
        {
          "category": "<string>",
          "probability": "<string>"
        }
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 15,
    "candidatesTokenCount": 200,
    "totalTokenCount": 215
  }
}

{
  "error": {
    "message": "Invalid request parameters",
    "type": "http_error",
    "code": 400,
    "status": "INVALID_ARGUMENT"
  }
}

{
  "error": {
    "message": "Invalid API Key",
    "type": "authentication_error",
    "code": 401,
    "status": "UNAUTHENTICATED"
  }
}

{
  "error": {
    "message": "Invalid request parameters",
    "type": "http_error",
    "code": 400,
    "status": "INVALID_ARGUMENT"
  }
}

{
  "error": {
    "message": "Access denied",
    "type": "permission_error",
    "code": 403,
    "status": "PERMISSION_DENIED"
  }
}

{
  "error": {
    "message": "Rate limit exceeded",
    "type": "rate_limit_error",
    "code": 429,
    "status": "RESOURCE_EXHAUSTED"
  }
}

{
  "error": {
    "message": "Internal server error",
    "type": "server_error",
    "code": 500,
    "status": "UNKNOWN"
  }
}

Gemini Format

Gemini Format - Music Generation

Uses the Gemini native format generateContent endpoint to generate music via the Lyria 3 model
Enable audio output by including AUDIO in generationConfig.responseModalities; if TEXT is also included, the response will additionally return text descriptions (lyrics/structure)
Supports text prompts and image input (up to 10 images); images are used to inspire visually-driven music creation
Duration, structure (verse/chorus/bridge), style, etc. are primarily controlled via text prompts
lyria-3-clip-preview: generates fixed 30-second clips, returns MP3 by default (audio/mpeg)
lyria-3-pro-preview: generates full songs; you can request audio/mpeg or audio/wav via responseMimeType, but the actual output format should be determined by the inlineData.mimeType in the response
For SSE streaming output, use /v1beta/models/{model}:streamGenerateContent?alt=sse
Music generation is a single-turn process; multi-turn iterative editing is not supported

POST

v1beta

models

{model}

:generateContent

curl --request POST \
  --url https://api.aihubmax.com/v1beta/models/{model}:generateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Create a 30-second upbeat folk song using guitar and harmonica."
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "AUDIO",
      "TEXT"
    ]
  }
}
'

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "Here is an upbeat folk song featuring guitar and harmonica.",
            "inlineData": {
              "mimeType": "audio/mpeg",
              "data": "SUQzBAAAAAAAI1RTU0UAAAAPAAADTGF2ZjU4..."
            }
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP",
      "safetyRatings": [
        {
          "category": "<string>",
          "probability": "<string>"
        }
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 15,
    "candidatesTokenCount": 200,
    "totalTokenCount": 215
  }
}

{
  "error": {
    "message": "Invalid request parameters",
    "type": "http_error",
    "code": 400,
    "status": "INVALID_ARGUMENT"
  }
}

{
  "error": {
    "message": "Invalid API Key",
    "type": "authentication_error",
    "code": 401,
    "status": "UNAUTHENTICATED"
  }
}

{
  "error": {
    "message": "Invalid request parameters",
    "type": "http_error",
    "code": 400,
    "status": "INVALID_ARGUMENT"
  }
}

{
  "error": {
    "message": "Access denied",
    "type": "permission_error",
    "code": 403,
    "status": "PERMISSION_DENIED"
  }
}

{
  "error": {
    "message": "Rate limit exceeded",
    "type": "rate_limit_error",
    "code": 429,
    "status": "RESOURCE_EXHAUSTED"
  }
}

{
  "error": {
    "message": "Internal server error",
    "type": "server_error",
    "code": 500,
    "status": "UNKNOWN"
  }
}

Authorizations

Authorization

string

header

required

All endpoints require Bearer Token authentication

Add the following to your request headers:

Authorization: Bearer YOUR_API_KEY

Path Parameters

model

enum<string>

required

Model name. lyria-3-clip-preview generates 30-second clips (default MP3 / audio/mpeg). lyria-3-pro-preview generates full songs; you can request audio/mpeg or audio/wav, but the actual output format should be determined by the returned inlineData.mimeType

Available options:

lyria-3-clip-preview,

lyria-3-pro-preview

Example:

"lyria-3-clip-preview"

Body

application/json

contents

object[]

required

Content list. Music generation is a single-turn process; multi-turn iterative editing is not supported

Show child attributes

generationConfig

object

required

Generation config; responseModalities must include AUDIO for music generation requests

Show child attributes

systemInstruction

object

System instruction. Lyria 3 model support for this field is not confirmed by official documentation; it may not take effect

Show child attributes

safetySettings

object[]

Content safety filter settings

Show child attributes

Response

Music generation response

candidates

object[]

List of generation result candidates

Show child attributes

usageMetadata

object

Token usage statistics

Show child attributes

Image Series

Video Series

Audio Series

Text Series

Document Processing

Task Management

File Management

Gemini Format - Music Generation

Authorizations

All endpoints require Bearer Token authentication

Path Parameters

Body

Response