Référence API

Gemini Omni Créer de l'audio

Utilisez le point de terminaison create audio pour recevoir un résultat dans la même réponse.

Voir en Markdown

Vue d'ensemble

Utilisez le point de terminaison create audio et lisez le résultat dans la même réponse.

Démarrage rapide

Créez une clé API et définissez-la comme RUNAPI_API_KEY.
Envoyer une requête POST dont le corps correspond au schéma de requête.
Lisez le résultat dans le corps de la réponse réussie.

POST /api/v1/gemini_omni/create_audio

URL de base: https://runapi.ai
Version de l'API: v1
Authentification: Authorization: Bearer YOUR_API_TOKEN

Modèles pris en charge

Ouvrez une page de modèle pour consulter la tarification actuelle, les limites de débit et les conditions d'utilisation commerciale.

gemini-omni-audio

Schéma de requête

Corps JSON

Envoyez uniquement les champs déclarés pour cet endpoint.

gemini-omni-audio4 champs

audio_idstring

Requis

Identité vocale utilisée pour le préréglage audio.

example_dialoguestring

Optionnel

Exemple de dialogue illustrant le style de voix.

Limite: 120

namestring

Requis

Nom d'affichage du préréglage audio.

Limite: 210

voice_descriptionstring

Optionnel

Caractéristiques vocales telles que la hauteur, le timbre ou l'accent.

Limite: 20000

Réponse de succès

HTTP 200

POST /api/v1/gemini_omni/create_audio

Schéma de réponse

JSON

{
  "properties": {
    "audio": {
      "properties": {
        "id": {
          "description": "Identifiant du préréglage audio créé.",
          "type": "string"
        },
        "name": {
          "description": "Nom d'affichage du préréglage audio.",
          "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": "Identifiant du préréglage audio créé.",
      "type": "string"
    }
  },
  "required": [
    "id",
    "audio",
    "billing"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Exemple de réponse

JSON

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

Erreurs

HTTP 401

POST /api/v1/gemini_omni/create_audio

Schéma de réponse

JSON

{
  "properties": {
    "error": {
      "description": "Message d'erreur lisible par l'humain.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Exemple de réponse

JSON

{
  "error": "Authentication required"
}

Erreurs

HTTP 400

POST /api/v1/gemini_omni/create_audio

Schéma de réponse

JSON

{
  "oneOf": [
    {
      "properties": {
        "error": {
          "description": "Message d'erreur lisible par l'humain.",
          "type": "string"
        }
      },
      "required": [
        "error"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    {
      "properties": {
        "error": {
          "description": "Résumé de validation lisible par l'humain.",
          "type": "string"
        },
        "errors": {
          "additionalProperties": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "description": "Messages de validation indexés par champ de requête public, avec un tableau de chaînes lisibles par l'humain pour chaque champ.",
          "type": "object"
        }
      },
      "required": [
        "error",
        "errors"
      ],
      "type": "object",
      "unevaluatedProperties": false
    }
  ]
}

Exemple de réponse

JSON

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

Erreurs

HTTP 402

POST /api/v1/gemini_omni/create_audio

Schéma de réponse

JSON

{
  "properties": {
    "error": {
      "description": "Message d'erreur lisible par l'humain.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Exemple de réponse

JSON

{
  "error": "Insufficient balance"
}

Erreurs

HTTP 429

POST /api/v1/gemini_omni/create_audio

Schéma de réponse

JSON

{
  "properties": {
    "error": {
      "description": "Message d'erreur lisible par l'humain.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Exemple de réponse

JSON

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

Erreurs

HTTP 409

POST /api/v1/gemini_omni/create_audio

Schéma de réponse

JSON

{
  "properties": {
    "error": {
      "description": "Message d'erreur lisible par l'humain.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Exemple de réponse

JSON

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

Erreurs

HTTP 429

POST /api/v1/gemini_omni/create_audio

Schéma de réponse

JSON

{
  "properties": {
    "error": {
      "description": "Message d'erreur lisible par l'humain.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Exemple de réponse

JSON

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

Erreurs

HTTP 503

POST /api/v1/gemini_omni/create_audio

Schéma de réponse

JSON

{
  "properties": {
    "error": {
      "description": "Message d'erreur lisible par l'humain.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Exemple de réponse

JSON

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

Erreurs

HTTP 504

POST /api/v1/gemini_omni/create_audio

Schéma de réponse

JSON

{
  "properties": {
    "error": {
      "description": "Message d'erreur lisible par l'humain.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Exemple de réponse

JSON

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

Exemples de code générés

Utilisez directement cURL, ou installez un SDK pour votre langage. Chaque exemple soumet la requête validée indiquée dans cette référence.

Installer

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

Installer

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

Installer

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 Créer de l'audio

Vue d'ensemble

Démarrage rapide

Point de terminaison

Modèles pris en charge

Schéma de requête

Réponse de succès

Exemple de réponse

Erreurs

Exemple de réponse

Erreurs

Exemple de réponse

Erreurs

Exemple de réponse

Erreurs

Exemple de réponse

Erreurs

Exemple de réponse

Erreurs

Exemple de réponse

Erreurs

Exemple de réponse

Erreurs

Exemple de réponse

Exemples de code générés

Installer

Guides associés