API-Referenz

Gemini Omni Audio erstellen

Verwende den Create Audio-Endpunkt, um ein Ergebnis in derselben Antwort zu erhalten.

Markdown anzeigen

Übersicht

Verwende den Create Audio-Endpunkt und lies das Ergebnis aus derselben Antwort.

Schnellstart

Erstellen Sie einen API-Schlüssel und setzen Sie ihn als RUNAPI_API_KEY.
Eine POST-Anfrage senden, deren Körper dem Anfrage-Schema entspricht.
Das Ergebnis aus dem erfolgreichen Antwortkörper lesen.

POST /api/v1/gemini_omni/create_audio

Basis-URL: https://runapi.ai
API-Version: v1
Authentifizierung: Authorization: Bearer YOUR_API_TOKEN

Unterstützte Modelle

Öffnen Sie eine Modellseite für aktuelle Preise, Ratenlimits und Details zur kommerziellen Nutzung.

gemini-omni-audio

Anfrage-Schema

JSON-Body

Nur die für diesen Endpunkt deklarierten Felder senden.

gemini-omni-audio4 Felder

audio_idstring

Erforderlich

Für das Audio-Preset verwendete Stimmenidentität.

example_dialoguestring

Optional

Beispieldialog zur Demonstration des Sprachstils.

Grenzwert: 120

namestring

Erforderlich

Anzeigename des Audio-Presets.

Grenzwert: 210

voice_descriptionstring

Optional

Stimmliche Eigenschaften wie Tonhöhe, Klang oder Akzent.

Grenzwert: 20000

Erfolgsantwort

HTTP 200

POST /api/v1/gemini_omni/create_audio

Antwort-Schema

JSON

{
  "properties": {
    "audio": {
      "properties": {
        "id": {
          "description": "Bezeichner des erstellten Audio-Presets.",
          "type": "string"
        },
        "name": {
          "description": "Anzeigename des Audio-Presets.",
          "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": "Bezeichner des erstellten Audio-Presets.",
      "type": "string"
    }
  },
  "required": [
    "id",
    "audio",
    "billing"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Antwortbeispiel

JSON

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

Fehler

HTTP 401

POST /api/v1/gemini_omni/create_audio

Antwort-Schema

JSON

{
  "properties": {
    "error": {
      "description": "Für Menschen lesbare Fehlermeldung.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Antwortbeispiel

JSON

{
  "error": "Authentication required"
}

Fehler

HTTP 400

POST /api/v1/gemini_omni/create_audio

Antwort-Schema

JSON

{
  "oneOf": [
    {
      "properties": {
        "error": {
          "description": "Für Menschen lesbare Fehlermeldung.",
          "type": "string"
        }
      },
      "required": [
        "error"
      ],
      "type": "object",
      "unevaluatedProperties": false
    },
    {
      "properties": {
        "error": {
          "description": "Menschenlesbare Validierungszusammenfassung.",
          "type": "string"
        },
        "errors": {
          "additionalProperties": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "description": "Validierungsmeldungen nach öffentlichem Anforderungsfeld gegliedert, mit einem Array menschenlesbarer Zeichenketten für jedes Feld.",
          "type": "object"
        }
      },
      "required": [
        "error",
        "errors"
      ],
      "type": "object",
      "unevaluatedProperties": false
    }
  ]
}

Antwortbeispiel

JSON

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

Fehler

HTTP 402

POST /api/v1/gemini_omni/create_audio

Antwort-Schema

JSON

{
  "properties": {
    "error": {
      "description": "Für Menschen lesbare Fehlermeldung.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Antwortbeispiel

JSON

{
  "error": "Insufficient balance"
}

Fehler

HTTP 429

POST /api/v1/gemini_omni/create_audio

Antwort-Schema

JSON

{
  "properties": {
    "error": {
      "description": "Für Menschen lesbare Fehlermeldung.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Antwortbeispiel

JSON

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

Fehler

HTTP 409

POST /api/v1/gemini_omni/create_audio

Antwort-Schema

JSON

{
  "properties": {
    "error": {
      "description": "Für Menschen lesbare Fehlermeldung.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Antwortbeispiel

JSON

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

Fehler

HTTP 429

POST /api/v1/gemini_omni/create_audio

Antwort-Schema

JSON

{
  "properties": {
    "error": {
      "description": "Für Menschen lesbare Fehlermeldung.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Antwortbeispiel

JSON

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

Fehler

HTTP 503

POST /api/v1/gemini_omni/create_audio

Antwort-Schema

JSON

{
  "properties": {
    "error": {
      "description": "Für Menschen lesbare Fehlermeldung.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Antwortbeispiel

JSON

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

Fehler

HTTP 504

POST /api/v1/gemini_omni/create_audio

Antwort-Schema

JSON

{
  "properties": {
    "error": {
      "description": "Für Menschen lesbare Fehlermeldung.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

Antwortbeispiel

JSON

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

Generierte Code-Beispiele

Verwende cURL direkt oder installiere ein SDK für deine Programmiersprache. Jedes Beispiel übermittelt die in dieser Referenz gezeigte validierte Anfrage.

Installieren

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

Installieren

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

Installieren

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 Audio erstellen

Übersicht

Schnellstart

Endpunkt

Unterstützte Modelle

Anfrage-Schema

Erfolgsantwort

Antwortbeispiel

Fehler

Antwortbeispiel

Fehler

Antwortbeispiel

Fehler

Antwortbeispiel

Fehler

Antwortbeispiel

Fehler

Antwortbeispiel

Fehler

Antwortbeispiel

Fehler

Antwortbeispiel

Fehler

Antwortbeispiel

Generierte Code-Beispiele

Installieren

Verwandte Anleitungen