Referencia de API

Gemini Omni Crear audio

Crea una configuración de voz reutilizable a partir de una descripción y un diálogo de ejemplo.

Ver Markdown

Descripción general

Usa el endpoint de creación de audio y lee el resultado de la misma respuesta.

Inicio rápido

Cree una Clave de API y establézcala como RUNAPI_API_KEY.
Envíe una solicitud POST cuyo cuerpo coincida con el esquema de la solicitud.
Lea el resultado en el cuerpo de la respuesta exitosa.

POST /api/v1/gemini_omni/create_audio

URL base: https://runapi.ai
Versión de la API: v1
Autenticación: Authorization: Bearer YOUR_API_TOKEN

Modelos compatibles

Abra una página de modelo para conocer los precios actuales, los límites de velocidad y los detalles de uso comercial.

gemini-omni-audio

Esquema de solicitud

Cuerpo JSON

Envíe únicamente los campos declarados para este endpoint.

gemini-omni-audio4 campos

audio_idstring

Obligatorio

Identidad de voz utilizada para el preset de audio.

example_dialoguestring

Opcional

Ejemplo de diálogo que demuestra el estilo de voz.

Límite: 120

namestring

Obligatorio

Nombre de visualización del preajuste de audio.

Límite: 210

voice_descriptionstring

Opcional

Características de la voz como tono, timbre o acento.

Límite: 20000

Respuesta de éxito

HTTP 200

POST /api/v1/gemini_omni/create_audio

Esquema de respuesta

JSON

{
  "properties": {
    "audio": {
      "properties": {
        "id": {
          "description": "Identificador del preset de audio creado.",
          "type": "string"
        },
        "name": {
          "description": "Nombre de visualización del preajuste de audio.",
          "type": "string"
        }
      },
      "required": [
        "id"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    "id": {
      "description": "Identificador del preset de audio creado.",
      "type": "string"
    }
  },
  "required": [
    "id",
    "audio"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Ejemplo de respuesta

JSON

{
  "audio": {
    "id": "aud_reference_narrator",
    "name": "Studio Narrator"
  },
  "id": "aud_reference_narrator"
}

Errores

HTTP 401

POST /api/v1/gemini_omni/create_audio

Esquema de respuesta

JSON

{
  "properties": {
    "error": {
      "description": "Mensaje de error legible por personas.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Ejemplo de respuesta

JSON

{
  "error": "Authentication required"
}

Errores

HTTP 400

POST /api/v1/gemini_omni/create_audio

Esquema de respuesta

JSON

{
  "oneOf": [
    {
      "properties": {
        "error": {
          "description": "Mensaje de error legible por personas.",
          "type": "string"
        }
      },
      "required": [
        "error"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    {
      "properties": {
        "error": {
          "description": "Resumen de validación legible por personas.",
          "type": "string"
        },
        "errors": {
          "additionalProperties": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "description": "Mensajes de validación con clave por campo de solicitud público, con un array de cadenas legibles por personas para cada campo.",
          "type": "object"
        }
      },
      "required": [
        "error",
        "errors"
      ],
      "type": "object",
      "unevaluatedProperties": false
    }
  ]
}

Ejemplo de respuesta

JSON

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

Errores

HTTP 402

POST /api/v1/gemini_omni/create_audio

Esquema de respuesta

JSON

{
  "properties": {
    "error": {
      "description": "Mensaje de error legible por personas.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Ejemplo de respuesta

JSON

{
  "error": "Insufficient balance"
}

Errores

HTTP 429

POST /api/v1/gemini_omni/create_audio

Esquema de respuesta

JSON

{
  "properties": {
    "error": {
      "description": "Mensaje de error legible por personas.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Ejemplo de respuesta

JSON

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

Errores

HTTP 409

POST /api/v1/gemini_omni/create_audio

Esquema de respuesta

JSON

{
  "properties": {
    "error": {
      "description": "Mensaje de error legible por personas.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Ejemplo de respuesta

JSON

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

Errores

HTTP 429

POST /api/v1/gemini_omni/create_audio

Esquema de respuesta

JSON

{
  "properties": {
    "error": {
      "description": "Mensaje de error legible por personas.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Ejemplo de respuesta

JSON

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

Errores

HTTP 503

POST /api/v1/gemini_omni/create_audio

Esquema de respuesta

JSON

{
  "properties": {
    "error": {
      "description": "Mensaje de error legible por personas.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Ejemplo de respuesta

JSON

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

Errores

HTTP 504

POST /api/v1/gemini_omni/create_audio

Esquema de respuesta

JSON

{
  "properties": {
    "error": {
      "description": "Mensaje de error legible por personas.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Ejemplo de respuesta

JSON

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

Ejemplos de código generados

Usa cURL directamente o instala un SDK para tu lenguaje. Cada muestra envía la solicitud validada que se muestra en esta referencia.

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 }

Gemini Omni Crear audio

Descripción general

Inicio rápido

Endpoint

Modelos compatibles

Esquema de solicitud

Respuesta de éxito

Ejemplo de respuesta

Errores

Ejemplo de respuesta

Errores

Ejemplo de respuesta

Errores

Ejemplo de respuesta

Errores

Ejemplo de respuesta

Errores

Ejemplo de respuesta

Errores

Ejemplo de respuesta

Errores

Ejemplo de respuesta

Errores

Ejemplo de respuesta

Ejemplos de código generados

Instalar

Guías relacionadas