Referência de API

Gemini Omni Criar áudio

Use o endpoint create audio para receber um resultado na mesma resposta.

Ver Markdown

Visão geral

Use o endpoint create audio e leia o resultado na mesma resposta.

Início rápido

Crie uma Chave de API e defina-a como RUNAPI_API_KEY.
Envie uma requisição POST cujo corpo corresponda ao schema da requisição.
Leia o resultado do corpo da resposta bem-sucedida.

POST /api/v1/gemini_omni/create_audio

URL base: https://runapi.ai
Versão da API: v1
Autenticação: Authorization: Bearer YOUR_API_TOKEN

Modelos suportados

Abra uma página de modelo para ver preços atuais, limites de taxa e detalhes de uso comercial.

gemini-omni-audio

Esquema de solicitação

Corpo JSON

Envie apenas os campos declarados para este endpoint.

gemini-omni-audio4 campos

audio_idstring

Obrigatório

Identidade de voz usada para o preset de áudio.

example_dialoguestring

Opcional

Exemplo de diálogo demonstrando o estilo da voz.

Limite: 120

namestring

Obrigatório

Nome de exibição da predefinição de áudio.

Limite: 210

voice_descriptionstring

Opcional

Características da voz, como tom, timbre ou sotaque.

Limite: 20000

Resposta de sucesso

HTTP 200

POST /api/v1/gemini_omni/create_audio

Esquema de resposta

JSON

{
  "properties": {
    "audio": {
      "properties": {
        "id": {
          "description": "Identificador do preset de áudio criado.",
          "type": "string"
        },
        "name": {
          "description": "Nome de exibição da predefinição de áudio.",
          "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": "Identificador do preset de áudio criado.",
      "type": "string"
    }
  },
  "required": [
    "id",
    "audio",
    "billing"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Exemplo de resposta

JSON

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

Erros

HTTP 401

POST /api/v1/gemini_omni/create_audio

Esquema de resposta

JSON

{
  "properties": {
    "error": {
      "description": "Mensagem de erro legível por humanos.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Exemplo de resposta

JSON

{
  "error": "Authentication required"
}

Erros

HTTP 400

POST /api/v1/gemini_omni/create_audio

Esquema de resposta

JSON

{
  "oneOf": [
    {
      "properties": {
        "error": {
          "description": "Mensagem de erro legível por humanos.",
          "type": "string"
        }
      },
      "required": [
        "error"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    {
      "properties": {
        "error": {
          "description": "Resumo de validação legível por humanos.",
          "type": "string"
        },
        "errors": {
          "additionalProperties": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "description": "Mensagens de validação com chaves por campo de requisição público, com um array de strings legíveis por humanos para cada campo.",
          "type": "object"
        }
      },
      "required": [
        "error",
        "errors"
      ],
      "type": "object",
      "unevaluatedProperties": false
    }
  ]
}

Exemplo de resposta

JSON

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

Erros

HTTP 402

POST /api/v1/gemini_omni/create_audio

Esquema de resposta

JSON

{
  "properties": {
    "error": {
      "description": "Mensagem de erro legível por humanos.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Exemplo de resposta

JSON

{
  "error": "Insufficient balance"
}

Erros

HTTP 429

POST /api/v1/gemini_omni/create_audio

Esquema de resposta

JSON

{
  "properties": {
    "error": {
      "description": "Mensagem de erro legível por humanos.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Exemplo de resposta

JSON

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

Erros

HTTP 409

POST /api/v1/gemini_omni/create_audio

Esquema de resposta

JSON

{
  "properties": {
    "error": {
      "description": "Mensagem de erro legível por humanos.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Exemplo de resposta

JSON

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

Erros

HTTP 429

POST /api/v1/gemini_omni/create_audio

Esquema de resposta

JSON

{
  "properties": {
    "error": {
      "description": "Mensagem de erro legível por humanos.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Exemplo de resposta

JSON

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

Erros

HTTP 503

POST /api/v1/gemini_omni/create_audio

Esquema de resposta

JSON

{
  "properties": {
    "error": {
      "description": "Mensagem de erro legível por humanos.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Exemplo de resposta

JSON

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

Erros

HTTP 504

POST /api/v1/gemini_omni/create_audio

Esquema de resposta

JSON

{
  "properties": {
    "error": {
      "description": "Mensagem de erro legível por humanos.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Exemplo de resposta

JSON

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

Exemplos de Código Gerados

Use cURL diretamente ou instale um SDK para a sua linguagem. Cada exemplo submete a requisição validada mostrada nesta referência.

Instalar

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."
)

Instalar

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."}'

Instalar

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 Criar áudio

Visão geral

Início rápido

Endpoint

Modelos suportados

Esquema de solicitação

Resposta de sucesso

Exemplo de resposta

Erros

Exemplo de resposta

Erros

Exemplo de resposta

Erros

Exemplo de resposta

Erros

Exemplo de resposta

Erros

Exemplo de resposta

Erros

Exemplo de resposta

Erros

Exemplo de resposta

Erros

Exemplo de resposta

Exemplos de Código Gerados

Instalar

Guias Relacionados