> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omniall.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Google native format

> Generate music with Google Lyria using Gemini `generateContent`.

**Path:** `POST https://api.omniall.ai/v1beta/models/{model}:generateContent`

Text-to-music or image-to-music. Response parts may include lyrics (`text`) and audio (`inlineData` Base64 MP3).

Auth: `Authorization: Bearer sk-...`



## OpenAPI

````yaml openapi/lyria-audio.yaml POST /v1beta/models/{model}:generateContent
openapi: 3.1.0
info:
  title: Omniall AI — Google Lyria
  version: 1.0.0
  description: >-
    Google Lyria music via Gemini native `generateContent`.


    **Path:** `POST
    https://api.omniall.ai/v1beta/models/{model}:generateContent`


    Examples: `lyria-3.5`, `lyria-3-clip-preview` (see [Model
    Square](https://omniall.ai/pricing)).


    Include `AUDIO` (and usually `TEXT` for lyrics) in
    `generationConfig.responseModalities`.


    Auth: `Authorization: Bearer sk-...`
servers:
  - url: https://api.omniall.ai
security: []
paths:
  /v1beta/models/{model}:generateContent:
    post:
      tags:
        - Lyria
      summary: Google native format
      description: >-
        Generate music with Google Lyria using Gemini `generateContent`.


        **Path:** `POST
        https://api.omniall.ai/v1beta/models/{model}:generateContent`


        Text-to-music or image-to-music. Response parts may include lyrics
        (`text`) and audio (`inlineData` Base64 MP3).


        Auth: `Authorization: Bearer sk-...`
      operationId: lyriaGenerateContent
      parameters:
        - name: model
          in: path
          required: true
          schema:
            type: string
            example: lyria-3.5
          description: >-
            Lyria model id. Examples: `lyria-3.5` (full song),
            `lyria-3-clip-preview` (~30s clip).
        - name: Authorization
          in: header
          required: true
          schema:
            type: string
            example: Bearer sk-...
          description: Bearer API key.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - contents
              properties:
                contents:
                  type: array
                  description: >-
                    Prompt turns. Text-only for text-to-music; add image
                    `inlineData` for image-to-music.
                  items:
                    type: object
                    properties:
                      role:
                        type: string
                        example: user
                      parts:
                        type: array
                        items:
                          type: object
                          properties:
                            text:
                              type: string
                            inlineData:
                              type: object
                              properties:
                                mimeType:
                                  type: string
                                  example: image/jpeg
                                data:
                                  type: string
                                  description: Base64 image bytes.
                generationConfig:
                  type: object
                  description: >-
                    Set `responseModalities` to include `AUDIO` (and `TEXT` for
                    lyrics).
                  properties:
                    responseModalities:
                      type: array
                      items:
                        type: string
                        enum:
                          - AUDIO
                          - TEXT
                      example:
                        - AUDIO
                        - TEXT
                    response_format:
                      type: string
                      description: >-
                        Optional audio container (e.g. `mp3`, `wav`) when
                        supported.
            examples:
              text_to_music_clip:
                summary: Text-to-music (30s clip)
                value:
                  contents:
                    - role: user
                      parts:
                        - text: >-
                            Create a 30-second cheerful acoustic folk song with
                            guitar and harmonica.
                  generationConfig:
                    responseModalities:
                      - AUDIO
                      - TEXT
              text_to_music_full:
                summary: Text-to-music (full song)
                value:
                  contents:
                    - role: user
                      parts:
                        - text: >
                            Create a 2-minute cinematic indie pop song about
                            walking through neon rain. Include verses, chorus,
                            and bridge with soft female vocals.
                  generationConfig:
                    responseModalities:
                      - AUDIO
                      - TEXT
              image_to_music:
                summary: Image-to-music
                value:
                  contents:
                    - role: user
                      parts:
                        - text: >-
                            Compose a track inspired by this moodboard image;
                            keep it atmospheric and hopeful.
                        - inlineData:
                            mimeType: image/jpeg
                            data: /9j/4AAQSkZJRgABAQAAAQABAAD...
                  generationConfig:
                    responseModalities:
                      - AUDIO
                      - TEXT
      responses:
        '200':
          description: Music + optional lyrics
          content:
            application/json:
              schema:
                type: object
                properties:
                  candidates:
                    type: array
                    items:
                      type: object
              example:
                candidates:
                  - content:
                      parts:
                        - text: |-
                            [Verse]
                            City lights...
                        - inlineData:
                            mimeType: audio/mpeg
                            data: SUQzBAAAAAAAI1RTU0UAAAAPAAADTGF2ZjU4Ljc2...

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.