API Reference

Gemini Omni Create-Audio

Use the create audio endpoint to receive a result in the same response.

View Markdown

Overview

Use the create audio endpoint and read the result from the same response.

Quick start

Create an API key and set it as RUNAPI_API_KEY.
Send a POST request whose body matches the request schema.
Read the result from the successful response body.

POST /api/v1/gemini_omni/create_audio

Base URL: https://runapi.ai
API version: v1
Authentication: Authorization: Bearer YOUR_API_TOKEN

Supported models

Open a model page for current pricing, rate limits, and commercial-usage details.

gemini-omni-audio

Request schema

JSON body

Send only the fields declared for this endpoint.

gemini-omni-audio4 fields

audio_idstring

Required

Voice identity used for the audio preset.

example_dialoguestring

Optional

Example dialogue demonstrating the voice style.

Bound: 120

namestring

Required

Audio preset display name.

Bound: 210

voice_descriptionstring

Optional

Voice characteristics such as pitch, tone, or accent.

Bound: 20000

Success response

HTTP 200

POST /api/v1/gemini_omni/create_audio

Response schema

JSON

{
  "properties": {
    "audio": {
      "properties": {
        "id": {
          "description": "Created audio preset identifier.",
          "type": "string"
        },
        "name": {
          "description": "Audio preset display name.",
          "type": "string"
        }
      },
      "required": [
        "id"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    "billing": {
      "properties": {
        "refund": {
          "oneOf": [
            {
              "properties": {
                "refunded_at": {
                  "type": "string"
                }
              },
              "required": [
                "refunded_at"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "reservation": {
          "oneOf": [
            {
              "properties": {
                "amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "amount_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        },
        "settlement": {
          "oneOf": [
            {
              "properties": {
                "amount_micro_cents": {
                  "type": "integer"
                },
                "charged_amount_cents": {
                  "type": "integer"
                }
              },
              "required": [
                "charged_amount_cents",
                "amount_micro_cents"
              ],
              "type": "object",
              "unevaluatedProperties": false
            },
            {
              "enum": [
                null
              ]
            }
          ]
        }
      },
      "required": [
        "reservation",
        "settlement",
        "refund"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    "id": {
      "description": "Created audio preset identifier.",
      "type": "string"
    }
  },
  "required": [
    "id",
    "audio",
    "billing"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Response example

JSON

{
  "audio": {
    "id": "aud_reference_narrator",
    "name": "Studio Narrator"
  },
  "billing": {
    "refund": null,
    "reservation": null,
    "settlement": null
  },
  "id": "aud_reference_narrator"
}

Errors

HTTP 401

POST /api/v1/gemini_omni/create_audio

Response schema

JSON

{
  "properties": {
    "error": {
      "description": "Human-readable error message.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Response example

JSON

{
  "error": "Authentication required"
}

Errors

HTTP 400

POST /api/v1/gemini_omni/create_audio

Response schema

JSON

{
  "oneOf": [
    {
      "properties": {
        "error": {
          "description": "Human-readable error message.",
          "type": "string"
        }
      },
      "required": [
        "error"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    {
      "properties": {
        "error": {
          "description": "Human-readable validation summary.",
          "type": "string"
        },
        "errors": {
          "additionalProperties": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "description": "Validation messages keyed by public request field, with an array of human-readable strings for each field.",
          "type": "object"
        }
      },
      "required": [
        "error",
        "errors"
      ],
      "type": "object",
      "unevaluatedProperties": false
    }
  ]
}

Response example

JSON

{
  "error": "Validation failed",
  "errors": {
    "audio_id": [
      "is required"
    ]
  }
}

Errors

HTTP 402

POST /api/v1/gemini_omni/create_audio

Response schema

JSON

{
  "properties": {
    "error": {
      "description": "Human-readable error message.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Response example

JSON

{
  "error": "Insufficient balance"
}

Errors

HTTP 429

POST /api/v1/gemini_omni/create_audio

Response schema

JSON

{
  "properties": {
    "error": {
      "description": "Human-readable error message.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Response example

JSON

{
  "error": "API key credit limit exceeded"
}

Errors

HTTP 409

POST /api/v1/gemini_omni/create_audio

Response schema

JSON

{
  "properties": {
    "error": {
      "description": "Human-readable error message.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Response example

JSON

{
  "error": "The request uses features that are not supported for the selected model"
}

Errors

HTTP 429

POST /api/v1/gemini_omni/create_audio

Response schema

JSON

{
  "properties": {
    "error": {
      "description": "Human-readable error message.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Response example

JSON

{
  "error": "Rate limit reached. Please retry later."
}

Errors

HTTP 503

POST /api/v1/gemini_omni/create_audio

Response schema

JSON

{
  "properties": {
    "error": {
      "description": "Human-readable error message.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Response example

JSON

{
  "error": "Service under maintenance, please try again later"
}

Errors

HTTP 504

POST /api/v1/gemini_omni/create_audio

Response schema

JSON

{
  "properties": {
    "error": {
      "description": "Human-readable error message.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Response example

JSON

{
  "error": "The request timed out"
}

Generated Code Samples

Use cURL directly, or install an SDK for your language. Each sample submits the validated request shown in this reference.

Install

Shell

pip install runapi-gemini-omni

PYTHON

import os
from runapi.gemini_omni import GeminiOmniClient

client = GeminiOmniClient(api_key=os.environ["RUNAPI_API_KEY"])
result = client.create_audio.run(
  audio_id="achernar",
  name="Studio Narrator",
  voice_description="A calm and clear narration voice.",
  example_dialogue="Welcome to the studio."
)

Install

Shell

npm install @runapi.ai/gemini-omni

JAVASCRIPT

import { GeminiOmniClient } from "@runapi.ai/gemini-omni";

const client = new GeminiOmniClient({ apiKey: process.env.RUNAPI_API_KEY });
const result = await client.createAudio.run({
  "audio_id": "achernar",
  "name": "Studio Narrator",
  "voice_description": "A calm and clear narration voice.",
  "example_dialogue": "Welcome to the studio."
});

CURL

curl -X POST https://runapi.ai/api/v1/gemini_omni/create_audio \
  -H 'Authorization: Bearer YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"audio_id":"achernar","name":"Studio Narrator","voice_description":"A calm and clear narration voice.","example_dialogue":"Welcome to the studio."}'

Install

Shell

go get github.com/runapi-ai/gemini-omni-sdk/go@latest

package main

import (
  "context"
  "log"
  "os"

  "github.com/runapi-ai/core-sdk/go/option"
  geminiomni "github.com/runapi-ai/gemini-omni-sdk/go/geminiomni"
)

func main() {
  client, err := geminiomni.NewClient(option.WithAPIKey(os.Getenv("RUNAPI_API_KEY")))
  if err != nil {
    log.Fatal(err)
  }

  result, err := client.CreateAudio.Run(context.Background(), geminiomni.CreateAudioParams{
    AudioID: geminiomni.AudioVoice("achernar"),
    Name: "Studio Narrator",
    VoiceDescription: "A calm and clear narration voice.",
    ExampleDialogue: "Welcome to the studio.",
  })
  if err != nil {
    log.Fatal(err)
  }
  _ = result
}

import os from runapi.gemini_omni import GeminiOmniClient client = GeminiOmniClient(api_key=os.environ["RUNAPI_API_KEY"]) result = client.create_audio.run( audio_id="achernar", name="Studio Narrator", voice_description="A calm and clear narration voice.", example_dialogue="Welcome to the studio." )

import { GeminiOmniClient } from "@runapi.ai/gemini-omni"; const client = new GeminiOmniClient({ apiKey: process.env.RUNAPI_API_KEY }); const result = await client.createAudio.run({ "audio_id": "achernar", "name": "Studio Narrator", "voice_description": "A calm and clear narration voice.", "example_dialogue": "Welcome to the studio." });

curl -X POST https://runapi.ai/api/v1/gemini_omni/create_audio \ -H 'Authorization: Bearer YOUR_API_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"audio_id":"achernar","name":"Studio Narrator","voice_description":"A calm and clear narration voice.","example_dialogue":"Welcome to the studio."}'

package main import ( "context" "log" "os" "github.com/runapi-ai/core-sdk/go/option" geminiomni "github.com/runapi-ai/gemini-omni-sdk/go/geminiomni" ) func main() { client, err := geminiomni.NewClient(option.WithAPIKey(os.Getenv("RUNAPI_API_KEY"))) if err != nil { log.Fatal(err) } result, err := client.CreateAudio.Run(context.Background(), geminiomni.CreateAudioParams{ AudioID: geminiomni.AudioVoice("achernar"), Name: "Studio Narrator", VoiceDescription: "A calm and clear narration voice.", ExampleDialogue: "Welcome to the studio.", }) if err != nil { log.Fatal(err) } _ = result }

{ "audio": { "id": "aud_reference_narrator", "name": "Studio Narrator" }, "billing": { "refund": null, "reservation": null, "settlement": null }, "id": "aud_reference_narrator" }

Gemini Omni Create-Audio

Overview

Quick start

Endpoint

Supported models

Request schema

Success response

Response example

Errors

Response example

Errors

Response example

Errors

Response example

Errors

Response example

Errors

Response example

Errors

Response example

Errors

Response example

Errors

Response example

Generated Code Samples

Install

Related Guides