Gemini Voices API

Voices API, doğal dil istemlerinden (Ses Tasarımı) veya referans ses ve konuşmacı izni kayıtlarından (Ses Kopyalama) özel sesler oluşturmanıza, ayrıca metin okuma (TTS) sentezi için özel ve önceden oluşturulmuş sesleri listelemenize, almanıza ve yönetmenize olanak tanır.

Markdown olarak görüntüle OpenAPI Spesifikasyonu'nu görüntüleme

CreateVoice

post https://generativelanguage.googleapis.com/v1beta/voices

Doğal dil isteminden (`VOICE_TYPE_PROMPTED`) veya referans ve izin ses kayıtlarından (`VOICE_TYPE_REPLICATED`) özel bir ses oluşturur.

İstek metni

İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:

store boolean  (isteğe bağlı)

İsteğe bağlıdır. Oluşturulan sesin Google tarafından saklanıp yönetilip yönetilmediği. * "Doğru" olduğunda Google, sesi saklar ve `Voice.id` değerini (ör. `voice_abc123def456`) döndürür. Bu değer, `GetVoice`, `ListVoices` ve `DeleteVoice` üzerinden yönetilebilir ve sentez isteklerinde kimliğe göre referans verilebilir. Projeler, maksimum etkin saklanan ses kotasına tabidir. Kotanın aşılması durumunda `RESOURCE_EXHAUSTED` hatası döndürülür. * `false` (varsayılan) olduğunda ses, Google tarafından saklanmaz ve istemci tarafında depolama ve sentez için `Voice.key` (ör. `voicekey_...`) döndürülür. `voice` üzerindeki isteğe bağlı keşif meta verileri, `store` değeri `false` olduğunda kalıcı hale getirilmez veya döndürülmez. * `voice.type` değeri `"prompted"` olduğunda `true` olması gerekir (aksi takdirde `INVALID_ARGUMENT` ile başarısız olur).

voice Voice  (zorunlu)

Zorunlu. Oluşturmak için kullanılacak ses. `voice.model` isteğe bağlıdır. Atlanırsa hizmet, varsayılan ses oluşturma modelini seçer. "Voice" üzerindeki yalnızca çıkış alanları ("id", "key", "expire_time", "usage") ayarlanırsa yoksayılır.

Yanıt

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

accent string  (isteğe bağlı)

İsteğe bağlıdır. Bölgesel aksan tanımlayıcısı (ör. "Amerikan", "İngiliz").

context string  (isteğe bağlı)

İsteğe bağlıdır. En uygun kullanım bağlamı veya alan (ör. "Sohbet", "Sesli Kitap", "Haber").

description string  (isteğe bağlı)

İsteğe bağlıdır. Vokal tınısı, kişiliği ve tonunun açıklayıcı özeti.

display_name string  (isteğe bağlı)

İsteğe bağlıdır. Kayıtlı bir ses için kullanıcı tarafından sağlanan görünen ad (`store = true`) veya önceden oluşturulmuş bir ses için katalog adı.

expire_time string  (isteğe bağlı)

Yalnızca çıkış. Depolanmış özel sesin (`store = true`) veya kopyalanmış ses anahtarının (`store = false`) geçerliliğinin sona erdiği zaman damgası. Önceden oluşturulmuş katalog sesleri (`"prebuilt"`) için geçerliliği kaldırılır. Bu seslerin geçerlilik süresi dolmaz.

gender string  (isteğe bağlı)

İsteğe bağlıdır. Algılanan sesin cinsiyet sunumu (ör. "kadın", "erkek", "nötr").

id dize  (isteğe bağlı)

Yalnızca çıkış. Sesin benzersiz tanımlayıcısı. * Google tarafından yönetilen özel sesler (`store = true`) için bu, `voice_` önekiyle oluşturulan bir kimliktir (örneğin, `voice_abc123def456`). `GetVoice` ve `DeleteVoice` içinde `voices/{id}` değerini `name` olarak, konuşma sentezi sırasında ise `{id}` değerini doğrudan `SpeechConfig.voice_config.voice` (veya `SpeechConfig.voice`) olarak iletin. * Önceden oluşturulmuş katalog sesleri (`ListVoices` tarafından döndürülen `"prebuilt"`) için bu, konuşmacı adıdır (örneğin, `Puck` veya `Charon`). * `CreateVoice`, `store = false` ile çağrıldığında ayarlanmaz.

key string  (isteğe bağlı)

Yalnızca çıkış. İstemci tarafından yönetilen ses kopyalama anahtarı (ön ekli `voicekey_`). Yalnızca `type` değeri `"replicated"` ve `store` değeri `false` olduğunda `CreateVoice` tarafından döndürülür. Bu anahtarı konuşma sentezi sırasında `SpeechConfig.voice_config.voice` (veya `SpeechConfig.voice`) öğesine iletin.

language_code string  (isteğe bağlı)

İsteğe bağlıdır. Birincil BCP-47 dil etiketi (ör. "en-US", "fr-FR").

model string  (isteğe bağlı)

İsteğe bağlıdır. Sesi tasarlamak veya kopyalamak için kullanılan model. `CreateVoice` içinde atlanırsa varsayılan olarak desteklenen en yeni ses tasarımı modeli kullanılır. Özel sesler (`"prompted"` ve `"replicated"`) için `CreateVoice`, `GetVoice` ve `ListVoices` yanıtlarında döndürülür. `"prebuilt"` sesler için ayarlanmamıştır. Oluşturulan sesler, desteklenen tüm TTS sentez modellerinde sentezlenebilir.

persona string  (isteğe bağlı)

İsteğe bağlıdır. Hedeflenen karakter veya karakter arketipi (ör. "Sıcakkanlı, Arkadaş Canlısı", "Anlatıcı").

pitch Pitch  (isteğe bağlı)

İsteğe bağlıdır. Ses perdesi sınıflandırması.

Olası değerler

  • low

    Daha düşük perdede ses.

  • medium

    Orta incelikte ses.

  • high

    Daha yüksek perdede ses

prompted PromptedVoice  (isteğe bağlı)

İstemli ses üretimi için parametreler. `type` değeri `"prompted"` olduğunda `CreateVoice` içinde zorunludur. İstemli sesler için `CreateVoice`, `GetVoice` ve `ListVoices` yanıtlarında döndürülür.

İstemli ses üretimi için parametreler. `type` değeri `"prompted"` olduğunda `CreateVoice` içinde zorunludur. İstemli sesler için `CreateVoice`, `GetVoice` ve `ListVoices` yanıtlarında döndürülür.

Alanlar

input string  (isteğe bağlı)

Zorunlu. İstenen sesi açıklayan doğal dil istemi (ör. "Orta yaşlarındaki devasa bir kötü canavarın derin ve gürleyen erkek sesi.")

region_code string  (isteğe bağlı)

İsteğe bağlıdır. ISO 3166-1 alfa-2 veya UN M.49 coğrafi bölge kodu (ör. "US", "GB", "001").

sample_audio AudioData  (isteğe bağlı)

Yalnızca çıkış. İstemli ses için oluşturulan örnek ses (sentezleyici istem sesi). Yalnızca `type` değeri `"prompted"` olduğunda `CreateVoice` ve `GetVoice` yanıtlarında doldurulur. `ListVoices` yanıtlarında ve `"replicated"` veya `"prebuilt"` sesler için ayarlanmamıştır.

Ses oluşturmak için kullanılan ses yükü.

Alanlar

data string  (isteğe bağlı)

Zorunlu. Ham ses baytları.

mime_type dize  (isteğe bağlı)

Zorunlu. Ses verilerinin IANA MIME türü (örneğin, "audio/wav" veya "audio/mpeg").

type VoiceType  (isteğe bağlı)

Zorunlu. Sesin türü. `CreateVoice` içinde `"replicated"` veya `"prompted"` olmalıdır. `ListVoices` yanıtlarında `"prebuilt"` de olabilir.

Olası değerler

  • replicated

    Referans ses örneği ve konuşmacı izni kaydından kopyalanan özel ses.

  • prompted

    Doğal dil metni isteminden oluşturulan özel ses.

  • prebuilt

    Google'ın ses kataloğundaki yerleşik bir sistem sesi (ör.`Puck`, `Charon`). Yanıtlarda döndürülür. `CreateVoice` içinde tür olarak belirtilemez.

usage Kullanım  (isteğe bağlı)

Yalnızca çıkış. Ses oluşturma isteğiyle ilgili jeton kullanım istatistikleri. Yalnızca `type` değeri `"prompted"` olduğunda `CreateVoice` yanıtında doldurulur; `"replicated"` için ve `GetVoice` ile `ListVoices` yanıtlarında ayarlanmamıştır.

Etkileşim isteğinin jeton kullanımıyla ilgili istatistikler.

Alanlar

cached_tokens_by_modality array (ModalityTokens)  (isteğe bağlı)

Önbelleğe alınmış jeton kullanımının modaliteye göre dökümü.

Tek bir yanıt biçiminin jeton sayısı.

Alanlar

modality<0xx0A> ResponseModality  (isteğe bağlı)

Jeton sayısıyla ilişkili yöntem.

Olası değerler

  • text

    Modelin metin döndürmesi gerektiğini belirtir.

  • image

    Modelin resim döndürmesi gerektiğini belirtir.

  • audio

    Modelin ses döndürmesi gerektiğini belirtir.

  • video

    Modelin video döndürmesi gerektiğini belirtir.

  • document

    Modelin doküman döndürmesi gerektiğini belirtir.

tokens integer  (isteğe bağlı)

Modalite için jeton sayısı.

grounding_tool_count array (GroundingToolCount)  (isteğe bağlı)

Topraklama aracı sayısı.

Topraklama aracı sayısı.

Alanlar

count integer  (isteğe bağlı)

Topraklama aracı sayısı.

type enum (string)  (isteğe bağlı)

Sayımla ilişkili temellendirme aracı türü.

Olası değerler:

  • google_search

    Google Web Arama ve Görsel Arama ile Temellendirme ve Kurumsal Web Temellendirme.

  • google_maps

    Google Haritalar ile temellendirme

input_tokens_by_modality array (ModalityTokens)  (isteğe bağlı)

Giriş jetonu kullanımının modaliteye göre dökümü.

Tek bir yanıt biçiminin jeton sayısı.

Alanlar

modality<0xx0A> ResponseModality  (isteğe bağlı)

Jeton sayısıyla ilişkili yöntem.

Olası değerler

  • text

    Modelin metin döndürmesi gerektiğini belirtir.

  • image

    Modelin resim döndürmesi gerektiğini belirtir.

  • audio

    Modelin ses döndürmesi gerektiğini belirtir.

  • video

    Modelin video döndürmesi gerektiğini belirtir.

  • document

    Modelin doküman döndürmesi gerektiğini belirtir.

tokens integer  (isteğe bağlı)

Modalite için jeton sayısı.

output_tokens_by_modality array (ModalityTokens)  (isteğe bağlı)

Çıkış jetonu kullanımının modaliteye göre dökümü.

Tek bir yanıt biçiminin jeton sayısı.

Alanlar

modality<0xx0A> ResponseModality  (isteğe bağlı)

Jeton sayısıyla ilişkili yöntem.

Olası değerler

  • text

    Modelin metin döndürmesi gerektiğini belirtir.

  • image

    Modelin resim döndürmesi gerektiğini belirtir.

  • audio

    Modelin ses döndürmesi gerektiğini belirtir.

  • video

    Modelin video döndürmesi gerektiğini belirtir.

  • document

    Modelin doküman döndürmesi gerektiğini belirtir.

tokens integer  (isteğe bağlı)

Modalite için jeton sayısı.

tool_use_tokens_by_modality array (ModalityTokens)  (isteğe bağlı)

Aracı kullanma jetonlarının kullanımının, modaliteye göre dökümü.

Tek bir yanıt biçiminin jeton sayısı.

Alanlar

modality<0xx0A> ResponseModality  (isteğe bağlı)

Jeton sayısıyla ilişkili yöntem.

Olası değerler

  • text

    Modelin metin döndürmesi gerektiğini belirtir.

  • image

    Modelin resim döndürmesi gerektiğini belirtir.

  • audio

    Modelin ses döndürmesi gerektiğini belirtir.

  • video

    Modelin video döndürmesi gerektiğini belirtir.

  • document

    Modelin doküman döndürmesi gerektiğini belirtir.

tokens integer  (isteğe bağlı)

Modalite için jeton sayısı.

total_cached_tokens integer  (isteğe bağlı)

İstemdeki önbelleğe alınmış bölümdeki (önbelleğe alınmış içerik) jeton sayısı.

total_input_tokens integer  (isteğe bağlı)

İstemdeki (bağlam) jeton sayısı.

total_output_tokens integer  (isteğe bağlı)

Oluşturulan tüm yanıtlardaki toplam jeton sayısı.

total_thought_tokens integer  (isteğe bağlı)

Düşünen modeller için düşünce jetonlarının sayısı.

total_tokens integer  (isteğe bağlı)

Etkileşim isteği için toplam jeton sayısı (istem + yanıtlar + diğer dahili jetonlar).

total_tool_use_tokens integer  (isteğe bağlı)

Araç kullanma istemlerinde bulunan jeton sayısı.

Örnek

Örnek Yanıt

{
  "accent": "string",
  "context": "string",
  "description": "string",
  "display_name": "string",
  "expire_time": "string",
  "gender": "string",
  "id": "string",
  "key": "string",
  "language_code": "string",
  "model": "string",
  "persona": "string",
  "pitch": "low",
  "prompted": {
    "input": "string"
  },
  "region_code": "string",
  "replicated": {
    "consent_audio": {
      "data": "string",
      "mime_type": "string"
    },
    "source_audio": {
      "data": "string",
      "mime_type": "string"
    }
  },
  "sample_audio": {
    "data": "string",
    "mime_type": "string"
  },
  "type": "replicated",
  "usage": {
    "cached_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 0
      }
    ],
    "grounding_tool_count": [
      {
        "count": 0,
        "type": "google_search"
      }
    ],
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 0
      }
    ],
    "output_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 0
      }
    ],
    "tool_use_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 0
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 0,
    "total_output_tokens": 0,
    "total_thought_tokens": 0,
    "total_tokens": 0,
    "total_tool_use_tokens": 0
  }
}

ListVoices

get https://generativelanguage.googleapis.com/v1beta/voices

Arayan kişiye ait özel olarak saklanan sesleri (en yeni önce olacak şekilde sıralanır) ve Google'ın ses kataloğundaki önceden oluşturulmuş sistem seslerini listeler.

Yol / Sorgu Parametreleri

accent array (string)  (isteğe bağlı)

İsteğe bağlıdır. Aksan açıklamasına göre filtreleyin (ör. "Amerikan", "İngiliz"). Büyük/küçük harfe duyarlı olmayan tam eşleşme. Birden fazla değer belirtilirse belirtilen aksanlardan herhangi birine sahip seslerle eşleşir (VEYA).

context array (string)  (isteğe bağlı)

İsteğe bağlıdır. Amaçlanan bağlama veya alana göre filtreleyin (ör. "Haber, Ticari"). Büyük/küçük harfe duyarlı olmayan tam eşleşme. Birden fazla değer belirtilirse sesler, belirtilen bağlamlardan herhangi biriyle (VEYA) eşleşir.

gender array (string)  (isteğe bağlı)

İsteğe bağlıdır. Cinsiyet sunumuna göre filtreleyin (ör. "kadın", "erkek", "nötr"). Büyük/küçük harfe duyarlı olmayan tam eşleşme. Birden fazla değer belirtilirse belirtilen cinsiyetlerden herhangi biriyle (OR) eşleşen sesler döndürülür.

language_code array (string)  (isteğe bağlı)

İsteğe bağlıdır. BCP-47 dil koduna (ör. "en-US") göre filtreleyin. Büyük/küçük harfe duyarlı olmayan tam eşleşme. Birden fazla değer belirtilirse belirtilen dil kodlarından herhangi biriyle (VEYA) eşleşen sesler bulunur.

page_size tam sayı  (isteğe bağlı)

İsteğe bağlıdır. Sayfa başına döndürülecek maksimum ses sayısı. Hizmet, bu değerden daha az sonuç döndürebilir. Belirtilmezse en fazla 50 ses döndürülür. Maksimum değer 1.000'dir. 1.000'den yüksek değerler 1.000 olarak kabul edilir.

page_token dize  (isteğe bağlı)

İsteğe bağlıdır. Önceki bir "ListVoices" çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın. Sayfalama yapılırken tüm filtre sorgusu parametreleri (`language_code`, `region_code`, `accent`, `persona`, `context`, `gender`, `pitch`, `type` ve `search`) bu jetonu döndüren çağrıyla eşleşmelidir. Aksi takdirde istek, "INVALID_ARGUMENT" ile başarısız olur. "page_size" sayfalar arasında değişebilir.

persona array (string)  (isteğe bağlı)

İsteğe bağlıdır. Vokal karakterine göre filtreleyin (ör. "Sıcak, Samimi"). Büyük/küçük harfe duyarlı olmayan tam eşleşme. Birden fazla değer belirtilirse sesler, belirtilen karakterlerden herhangi biriyle (VEYA) eşleşir.

pitch array (string)  (isteğe bağlı)

İsteğe bağlıdır. Vokal perdesine göre filtreleme "low", "medium", "high" veya "PITCH_LOW", "PITCH_MEDIUM", "PITCH_HIGH" değerlerini kabul eder (büyük/küçük harfe duyarsız). Birden fazla değer belirtilirse belirtilen tonlardan herhangi biriyle eşleşen sesler (VEYA) bulunur.

region_code array (string)  (isteğe bağlı)

İsteğe bağlıdır. ISO 3166-1 alfa-2 veya UN M.49 bölge koduna göre filtreleyin (ör. "US", "001"). Büyük/küçük harfe duyarlı olmayan tam eşleşme. Birden fazla değer belirtilirse sesler, belirtilen bölge kodlarından herhangi biriyle (VEYA) eşleşir.

search string  (isteğe bağlı)

İsteğe bağlıdır. Serbest metin alt dizesi arama sorgusu, büyük/küçük harfe duyarlı olmadan hem "display_name" hem de "description" ile eşleştirilir. Maksimum 2.048 bayt.

type array (string)  (isteğe bağlı)

İsteğe bağlıdır. Ses türüne göre filtreleme "prebuilt", "replicated", "prompted" veya "VOICE_TYPE_PREBUILT", "VOICE_TYPE_REPLICATED", "VOICE_TYPE_PROMPTED" (büyük/küçük harfe duyarsız) değerlerini kabul eder. Birden fazla değer belirtilirse, belirtilen türlerden herhangi biriyle eşleşen sesler (VEYA) döndürülür.

Yanıt

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

next_page_token dize  (isteğe bağlı)

Sonraki sayfayı almak için "page_token" olarak gönderilebilen bir jeton. Boşsa sonraki sayfa yoktur.

voices array (Voice)  (isteğe bağlı)

Belirtilen koleksiyondaki sesler.

Örnek

Örnek Yanıt

{
  "next_page_token": "string",
  "voices": [
    {
      "accent": "string",
      "context": "string",
      "description": "string",
      "display_name": "string",
      "expire_time": "string",
      "gender": "string",
      "id": "string",
      "key": "string",
      "language_code": "string",
      "model": "string",
      "persona": "string",
      "pitch": "low",
      "prompted": {
        "input": "string"
      },
      "region_code": "string",
      "replicated": {
        "consent_audio": {
          "data": "string",
          "mime_type": "string"
        },
        "source_audio": {
          "data": "string",
          "mime_type": "string"
        }
      },
      "sample_audio": {
        "data": "string",
        "mime_type": "string"
      },
      "type": "replicated",
      "usage": {
        "cached_tokens_by_modality": [
          {
            "modality": "...",
            "tokens": 0
          }
        ],
        "grounding_tool_count": [
          {
            "count": 0,
            "type": "google_search"
          }
        ],
        "input_tokens_by_modality": [
          {
            "modality": "...",
            "tokens": 0
          }
        ],
        "output_tokens_by_modality": [
          {
            "modality": "...",
            "tokens": 0
          }
        ],
        "tool_use_tokens_by_modality": [
          {
            "modality": "...",
            "tokens": 0
          }
        ],
        "total_cached_tokens": 0,
        "total_input_tokens": 0,
        "total_output_tokens": 0,
        "total_thought_tokens": 0,
        "total_tokens": 0,
        "total_tool_use_tokens": 0
      }
    }
  ]
}

GetVoice

get https://generativelanguage.googleapis.com/v1beta/voices/{voicesId}

Kaynak adına göre özel olarak saklanan bir ses alır (`store = true`). Önceden oluşturulmuş katalog sesleri (`VOICE_TYPE_PREBUILT`), `GetVoice` ile alınamaz. Bunun yerine `ListVoices` kullanılmalıdır.

Yol / Sorgu Parametreleri

voicesId dize  (zorunlu)

Zorunlu. Alınacak özel kayıtlı sesin kaynak adı (örneğin, "voices/voice_abc123def456").

Yanıt

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

accent string  (isteğe bağlı)

İsteğe bağlıdır. Bölgesel aksan tanımlayıcısı (ör. "Amerikan", "İngiliz").

context string  (isteğe bağlı)

İsteğe bağlıdır. En uygun kullanım bağlamı veya alan (ör. "Sohbet", "Sesli Kitap", "Haber").

description string  (isteğe bağlı)

İsteğe bağlıdır. Vokal tınısı, kişiliği ve tonunun açıklayıcı özeti.

display_name string  (isteğe bağlı)

İsteğe bağlıdır. Kayıtlı bir ses için kullanıcı tarafından sağlanan görünen ad (`store = true`) veya önceden oluşturulmuş bir ses için katalog adı.

expire_time string  (isteğe bağlı)

Yalnızca çıkış. Depolanmış özel sesin (`store = true`) veya kopyalanmış ses anahtarının (`store = false`) geçerliliğinin sona erdiği zaman damgası. Önceden oluşturulmuş katalog sesleri (`"prebuilt"`) için geçerliliği kaldırılır. Bu seslerin geçerlilik süresi dolmaz.

gender string  (isteğe bağlı)

İsteğe bağlıdır. Algılanan sesin cinsiyet sunumu (ör. "kadın", "erkek", "nötr").

id dize  (isteğe bağlı)

Yalnızca çıkış. Sesin benzersiz tanımlayıcısı. * Google tarafından yönetilen özel sesler (`store = true`) için bu, `voice_` önekiyle oluşturulan bir kimliktir (örneğin, `voice_abc123def456`). `GetVoice` ve `DeleteVoice` içinde `voices/{id}` değerini `name` olarak, konuşma sentezi sırasında ise `{id}` değerini doğrudan `SpeechConfig.voice_config.voice` (veya `SpeechConfig.voice`) olarak iletin. * Önceden oluşturulmuş katalog sesleri (`ListVoices` tarafından döndürülen `"prebuilt"`) için bu, konuşmacı adıdır (örneğin, `Puck` veya `Charon`). * `CreateVoice`, `store = false` ile çağrıldığında ayarlanmaz.

key string  (isteğe bağlı)

Yalnızca çıkış. İstemci tarafından yönetilen ses kopyalama anahtarı (ön ekli `voicekey_`). Yalnızca `type` değeri `"replicated"` ve `store` değeri `false` olduğunda `CreateVoice` tarafından döndürülür. Bu anahtarı konuşma sentezi sırasında `SpeechConfig.voice_config.voice` (veya `SpeechConfig.voice`) öğesine iletin.

language_code string  (isteğe bağlı)

İsteğe bağlıdır. Birincil BCP-47 dil etiketi (ör. "en-US", "fr-FR").

model string  (isteğe bağlı)

İsteğe bağlıdır. Sesi tasarlamak veya kopyalamak için kullanılan model. `CreateVoice` içinde atlanırsa varsayılan olarak desteklenen en yeni ses tasarımı modeli kullanılır. Özel sesler (`"prompted"` ve `"replicated"`) için `CreateVoice`, `GetVoice` ve `ListVoices` yanıtlarında döndürülür. `"prebuilt"` sesler için ayarlanmamıştır. Oluşturulan sesler, desteklenen tüm TTS sentez modellerinde sentezlenebilir.

persona string  (isteğe bağlı)

İsteğe bağlıdır. Hedeflenen karakter veya karakter arketipi (ör. "Sıcakkanlı, Arkadaş Canlısı", "Anlatıcı").

pitch Pitch  (isteğe bağlı)

İsteğe bağlıdır. Ses perdesi sınıflandırması.

Olası değerler

  • low

    Daha düşük perdede ses.

  • medium

    Orta incelikte ses.

  • high

    Daha yüksek perdede ses

prompted PromptedVoice  (isteğe bağlı)

İstemli ses üretimi için parametreler. `type` değeri `"prompted"` olduğunda `CreateVoice` içinde zorunludur. İstemli sesler için `CreateVoice`, `GetVoice` ve `ListVoices` yanıtlarında döndürülür.

İstemli ses üretimi için parametreler. `type` değeri `"prompted"` olduğunda `CreateVoice` içinde zorunludur. İstemli sesler için `CreateVoice`, `GetVoice` ve `ListVoices` yanıtlarında döndürülür.

Alanlar

input string  (isteğe bağlı)

Zorunlu. İstenen sesi açıklayan doğal dil istemi (ör. "Orta yaşlarındaki devasa bir kötü canavarın derin ve gürleyen erkek sesi.")

region_code string  (isteğe bağlı)

İsteğe bağlıdır. ISO 3166-1 alfa-2 veya UN M.49 coğrafi bölge kodu (ör. "US", "GB", "001").

sample_audio AudioData  (isteğe bağlı)

Yalnızca çıkış. İstemli ses için oluşturulan örnek ses (sentezleyici istem sesi). Yalnızca `type` değeri `"prompted"` olduğunda `CreateVoice` ve `GetVoice` yanıtlarında doldurulur. `ListVoices` yanıtlarında ve `"replicated"` veya `"prebuilt"` sesler için ayarlanmamıştır.

Ses oluşturmak için kullanılan ses yükü.

Alanlar

data string  (isteğe bağlı)

Zorunlu. Ham ses baytları.

mime_type dize  (isteğe bağlı)

Zorunlu. Ses verilerinin IANA MIME türü (örneğin, "audio/wav" veya "audio/mpeg").

type VoiceType  (isteğe bağlı)

Zorunlu. Sesin türü. `CreateVoice` içinde `"replicated"` veya `"prompted"` olmalıdır. `ListVoices` yanıtlarında `"prebuilt"` de olabilir.

Olası değerler

  • replicated

    Referans ses örneği ve konuşmacı izni kaydından kopyalanan özel ses.

  • prompted

    Doğal dil metni isteminden oluşturulan özel ses.

  • prebuilt

    Google'ın ses kataloğundaki yerleşik bir sistem sesi (ör.`Puck`, `Charon`). Yanıtlarda döndürülür. `CreateVoice` içinde tür olarak belirtilemez.

usage Kullanım  (isteğe bağlı)

Yalnızca çıkış. Ses oluşturma isteğiyle ilgili jeton kullanım istatistikleri. Yalnızca `type` değeri `"prompted"` olduğunda `CreateVoice` yanıtında doldurulur; `"replicated"` için ve `GetVoice` ile `ListVoices` yanıtlarında ayarlanmamıştır.

Etkileşim isteğinin jeton kullanımıyla ilgili istatistikler.

Alanlar

cached_tokens_by_modality array (ModalityTokens)  (isteğe bağlı)

Önbelleğe alınmış jeton kullanımının modaliteye göre dökümü.

Tek bir yanıt biçiminin jeton sayısı.

Alanlar

modality<0xx0A> ResponseModality  (isteğe bağlı)

Jeton sayısıyla ilişkili yöntem.

Olası değerler

  • text

    Modelin metin döndürmesi gerektiğini belirtir.

  • image

    Modelin resim döndürmesi gerektiğini belirtir.

  • audio

    Modelin ses döndürmesi gerektiğini belirtir.

  • video

    Modelin video döndürmesi gerektiğini belirtir.

  • document

    Modelin doküman döndürmesi gerektiğini belirtir.

tokens integer  (isteğe bağlı)

Modalite için jeton sayısı.

grounding_tool_count array (GroundingToolCount)  (isteğe bağlı)

Topraklama aracı sayısı.

Topraklama aracı sayısı.

Alanlar

count integer  (isteğe bağlı)

Topraklama aracı sayısı.

type enum (string)  (isteğe bağlı)

Sayımla ilişkili temellendirme aracı türü.

Olası değerler:

  • google_search

    Google Web Arama ve Görsel Arama ile Temellendirme ve Kurumsal Web Temellendirme.

  • google_maps

    Google Haritalar ile temellendirme

input_tokens_by_modality array (ModalityTokens)  (isteğe bağlı)

Giriş jetonu kullanımının modaliteye göre dökümü.

Tek bir yanıt biçiminin jeton sayısı.

Alanlar

modality<0xx0A> ResponseModality  (isteğe bağlı)

Jeton sayısıyla ilişkili yöntem.

Olası değerler

  • text

    Modelin metin döndürmesi gerektiğini belirtir.

  • image

    Modelin resim döndürmesi gerektiğini belirtir.

  • audio

    Modelin ses döndürmesi gerektiğini belirtir.

  • video

    Modelin video döndürmesi gerektiğini belirtir.

  • document

    Modelin doküman döndürmesi gerektiğini belirtir.

tokens integer  (isteğe bağlı)

Modalite için jeton sayısı.

output_tokens_by_modality array (ModalityTokens)  (isteğe bağlı)

Çıkış jetonu kullanımının modaliteye göre dökümü.

Tek bir yanıt biçiminin jeton sayısı.

Alanlar

modality<0xx0A> ResponseModality  (isteğe bağlı)

Jeton sayısıyla ilişkili yöntem.

Olası değerler

  • text

    Modelin metin döndürmesi gerektiğini belirtir.

  • image

    Modelin resim döndürmesi gerektiğini belirtir.

  • audio

    Modelin ses döndürmesi gerektiğini belirtir.

  • video

    Modelin video döndürmesi gerektiğini belirtir.

  • document

    Modelin doküman döndürmesi gerektiğini belirtir.

tokens integer  (isteğe bağlı)

Modalite için jeton sayısı.

tool_use_tokens_by_modality array (ModalityTokens)  (isteğe bağlı)

Aracı kullanma jetonlarının kullanımının, modaliteye göre dökümü.

Tek bir yanıt biçiminin jeton sayısı.

Alanlar

modality<0xx0A> ResponseModality  (isteğe bağlı)

Jeton sayısıyla ilişkili yöntem.

Olası değerler

  • text

    Modelin metin döndürmesi gerektiğini belirtir.

  • image

    Modelin resim döndürmesi gerektiğini belirtir.

  • audio

    Modelin ses döndürmesi gerektiğini belirtir.

  • video

    Modelin video döndürmesi gerektiğini belirtir.

  • document

    Modelin doküman döndürmesi gerektiğini belirtir.

tokens integer  (isteğe bağlı)

Modalite için jeton sayısı.

total_cached_tokens integer  (isteğe bağlı)

İstemdeki önbelleğe alınmış bölümdeki (önbelleğe alınmış içerik) jeton sayısı.

total_input_tokens integer  (isteğe bağlı)

İstemdeki (bağlam) jeton sayısı.

total_output_tokens integer  (isteğe bağlı)

Oluşturulan tüm yanıtlardaki toplam jeton sayısı.

total_thought_tokens integer  (isteğe bağlı)

Düşünen modeller için düşünce jetonlarının sayısı.

total_tokens integer  (isteğe bağlı)

Etkileşim isteği için toplam jeton sayısı (istem + yanıtlar + diğer dahili jetonlar).

total_tool_use_tokens integer  (isteğe bağlı)

Araç kullanma istemlerinde bulunan jeton sayısı.

Örnek

Örnek Yanıt

{
  "accent": "string",
  "context": "string",
  "description": "string",
  "display_name": "string",
  "expire_time": "string",
  "gender": "string",
  "id": "string",
  "key": "string",
  "language_code": "string",
  "model": "string",
  "persona": "string",
  "pitch": "low",
  "prompted": {
    "input": "string"
  },
  "region_code": "string",
  "replicated": {
    "consent_audio": {
      "data": "string",
      "mime_type": "string"
    },
    "source_audio": {
      "data": "string",
      "mime_type": "string"
    }
  },
  "sample_audio": {
    "data": "string",
    "mime_type": "string"
  },
  "type": "replicated",
  "usage": {
    "cached_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 0
      }
    ],
    "grounding_tool_count": [
      {
        "count": 0,
        "type": "google_search"
      }
    ],
    "input_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 0
      }
    ],
    "output_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 0
      }
    ],
    "tool_use_tokens_by_modality": [
      {
        "modality": "text",
        "tokens": 0
      }
    ],
    "total_cached_tokens": 0,
    "total_input_tokens": 0,
    "total_output_tokens": 0,
    "total_thought_tokens": 0,
    "total_tokens": 0,
    "total_tool_use_tokens": 0
  }
}

DeleteVoice

delete https://generativelanguage.googleapis.com/v1beta/voices/{voicesId}

Kaynak adına göre özel olarak depolanmış bir sesi (`store = true`) siler. Önceden oluşturulmuş katalog sesleri (`VOICE_TYPE_PREBUILT`) silinemez.

Yol / Sorgu Parametreleri

voicesId dize  (zorunlu)

Zorunlu. Silinecek özel kayıtlı sesin kaynak adı (ör. "voices/voice_abc123def456").

Yanıt

Başarılı olursa yanıt boş olur.

Örnek

Kaynaklar

Ses

Özel bir sesi (`CreateVoice` ile oluşturulur) veya önceden oluşturulmuş bir sistem sesini (`ListVoices` tarafından döndürülür) temsil eden bir ses kaynağı.

Alanlar

accent string  (isteğe bağlı)

İsteğe bağlıdır. Bölgesel aksan tanımlayıcısı (ör. "Amerikan", "İngiliz").

context string  (isteğe bağlı)

İsteğe bağlıdır. En uygun kullanım bağlamı veya alan (ör. "Sohbet", "Sesli Kitap", "Haber").

description string  (isteğe bağlı)

İsteğe bağlıdır. Vokal tınısı, kişiliği ve tonunun açıklayıcı özeti.

display_name string  (isteğe bağlı)

İsteğe bağlıdır. Kayıtlı bir ses için kullanıcı tarafından sağlanan görünen ad (`store = true`) veya önceden oluşturulmuş bir ses için katalog adı.

expire_time string  (isteğe bağlı)

Yalnızca çıkış. Depolanmış özel sesin (`store = true`) veya kopyalanmış ses anahtarının (`store = false`) geçerliliğinin sona erdiği zaman damgası. Önceden oluşturulmuş katalog sesleri (`"prebuilt"`) için geçerliliği kaldırılır. Bu seslerin geçerlilik süresi dolmaz.

gender string  (isteğe bağlı)

İsteğe bağlıdır. Algılanan sesin cinsiyet sunumu (ör. "kadın", "erkek", "nötr").

id dize  (isteğe bağlı)

Yalnızca çıkış. Sesin benzersiz tanımlayıcısı. * Google tarafından yönetilen özel sesler (`store = true`) için bu, `voice_` önekiyle oluşturulan bir kimliktir (örneğin, `voice_abc123def456`). `GetVoice` ve `DeleteVoice` içinde `voices/{id}` değerini `name` olarak, konuşma sentezi sırasında ise `{id}` değerini doğrudan `SpeechConfig.voice_config.voice` (veya `SpeechConfig.voice`) olarak iletin. * Önceden oluşturulmuş katalog sesleri (`ListVoices` tarafından döndürülen `"prebuilt"`) için bu, konuşmacı adıdır (örneğin, `Puck` veya `Charon`). * `CreateVoice`, `store = false` ile çağrıldığında ayarlanmaz.

key string  (isteğe bağlı)

Yalnızca çıkış. İstemci tarafından yönetilen ses kopyalama anahtarı (ön ekli `voicekey_`). Yalnızca `type` değeri `"replicated"` ve `store` değeri `false` olduğunda `CreateVoice` tarafından döndürülür. Bu anahtarı konuşma sentezi sırasında `SpeechConfig.voice_config.voice` (veya `SpeechConfig.voice`) öğesine iletin.

language_code string  (isteğe bağlı)

İsteğe bağlıdır. Birincil BCP-47 dil etiketi (ör. "en-US", "fr-FR").

model string  (isteğe bağlı)

İsteğe bağlıdır. Sesi tasarlamak veya kopyalamak için kullanılan model. `CreateVoice` içinde atlanırsa varsayılan olarak desteklenen en yeni ses tasarımı modeli kullanılır. Özel sesler (`"prompted"` ve `"replicated"`) için `CreateVoice`, `GetVoice` ve `ListVoices` yanıtlarında döndürülür. `"prebuilt"` sesler için ayarlanmamıştır. Oluşturulan sesler, desteklenen tüm TTS sentez modellerinde sentezlenebilir.

persona string  (isteğe bağlı)

İsteğe bağlıdır. Hedeflenen karakter veya karakter arketipi (ör. "Sıcakkanlı, Arkadaş Canlısı", "Anlatıcı").

pitch Pitch  (isteğe bağlı)

İsteğe bağlıdır. Ses perdesi sınıflandırması.

Olası değerler

  • low

    Daha düşük perdede ses.

  • medium

    Orta incelikte ses.

  • high

    Daha yüksek perde ses

prompted PromptedVoice  (isteğe bağlı)

İstemli ses üretimi için parametreler. `type` değeri `"prompted"` olduğunda `CreateVoice` içinde zorunludur. İstemli sesler için `CreateVoice`, `GetVoice` ve `ListVoices` yanıtlarında döndürülür.

İstemli ses üretimi için parametreler. `type` değeri `"prompted"` olduğunda `CreateVoice` içinde zorunludur. İstemli sesler için `CreateVoice`, `GetVoice` ve `ListVoices` yanıtlarında döndürülür.

Alanlar

input string  (isteğe bağlı)

Zorunlu. İstenen sesi açıklayan doğal dil istemi (ör. "Orta yaşlarındaki devasa bir kötü canavarın derin ve gürleyen erkek sesi.")

region_code string  (isteğe bağlı)

İsteğe bağlıdır. ISO 3166-1 alfa-2 veya UN M.49 coğrafi bölge kodu (ör. "US", "GB", "001").

sample_audio AudioData  (isteğe bağlı)

Yalnızca çıkış. İstemli ses için oluşturulan örnek ses (sentezleyici istem sesi). Yalnızca `type` değeri `"prompted"` olduğunda `CreateVoice` ve `GetVoice` yanıtlarında doldurulur. `ListVoices` yanıtlarında ve `"replicated"` veya `"prebuilt"` sesler için ayarlanmamıştır.

Ses oluşturmak için kullanılan ses yükü.

Alanlar

data string  (isteğe bağlı)

Zorunlu. Ham ses baytları.

mime_type dize  (isteğe bağlı)

Zorunlu. Ses verilerinin IANA MIME türü (örneğin, "audio/wav" veya "audio/mpeg").

type VoiceType  (isteğe bağlı)

Zorunlu. Sesin türü. `CreateVoice` içinde `"replicated"` veya `"prompted"` olmalıdır. `ListVoices` yanıtlarında `"prebuilt"` de olabilir.

Olası değerler

  • replicated

    Referans ses örneği ve konuşmacı izni kaydından kopyalanan özel ses.

  • prompted

    Doğal dil metni isteminden oluşturulan özel ses.

  • prebuilt

    Google'ın ses kataloğundaki yerleşik bir sistem sesi (ör. "Puck", "Charon"). Yanıtlarda döndürülür. "CreateVoice" içinde tür olarak belirtilemez.

usage Kullanım  (isteğe bağlı)

Yalnızca çıkış. Ses oluşturma isteğiyle ilgili jeton kullanım istatistikleri. Yalnızca `type` değeri `"prompted"` olduğunda `CreateVoice` yanıtında doldurulur; `"replicated"` için ve `GetVoice` ile `ListVoices` yanıtlarında ayarlanmamıştır.

Etkileşim isteğinin jeton kullanımıyla ilgili istatistikler.

Alanlar

cached_tokens_by_modality array (ModalityTokens)  (isteğe bağlı)

Önbelleğe alınmış jeton kullanımının modaliteye göre dökümü.

Tek bir yanıt biçiminin jeton sayısı.

Alanlar

modality<0xx0A> ResponseModality  (isteğe bağlı)

Jeton sayısıyla ilişkili yöntem.

Olası değerler

  • text

    Modelin metin döndürmesi gerektiğini belirtir.

  • image

    Modelin resim döndürmesi gerektiğini belirtir.

  • audio

    Modelin ses döndürmesi gerektiğini belirtir.

  • video

    Modelin video döndürmesi gerektiğini belirtir.

  • document

    Modelin doküman döndürmesi gerektiğini belirtir.

tokens integer  (isteğe bağlı)

Modalite için jeton sayısı.

grounding_tool_count array (GroundingToolCount)  (isteğe bağlı)

Topraklama aracı sayısı.

Topraklama aracı sayısı.

Alanlar

count integer  (isteğe bağlı)

Topraklama aracı sayısı.

type enum (string)  (isteğe bağlı)

Sayımla ilişkili temellendirme aracı türü.

Olası değerler:

  • google_search

    Google Web Arama ve Görsel Arama ile Temellendirme ve Kurumsal Web Temellendirme.

  • google_maps

    Google Haritalar ile temellendirme

input_tokens_by_modality array (ModalityTokens)  (isteğe bağlı)

Giriş jetonu kullanımının modaliteye göre dökümü.

Tek bir yanıt biçiminin jeton sayısı.

Alanlar

modality<0xx0A> ResponseModality  (isteğe bağlı)

Jeton sayısıyla ilişkili yöntem.

Olası değerler

  • text

    Modelin metin döndürmesi gerektiğini belirtir.

  • image

    Modelin resim döndürmesi gerektiğini belirtir.

  • audio

    Modelin ses döndürmesi gerektiğini belirtir.

  • video

    Modelin video döndürmesi gerektiğini belirtir.

  • document

    Modelin doküman döndürmesi gerektiğini belirtir.

tokens integer  (isteğe bağlı)

Modalite için jeton sayısı.

output_tokens_by_modality array (ModalityTokens)  (isteğe bağlı)

Çıkış jetonu kullanımının modaliteye göre dökümü.

Tek bir yanıt biçiminin jeton sayısı.

Alanlar

modality<0xx0A> ResponseModality  (isteğe bağlı)

Jeton sayısıyla ilişkili yöntem.

Olası değerler

  • text

    Modelin metin döndürmesi gerektiğini belirtir.

  • image

    Modelin resim döndürmesi gerektiğini belirtir.

  • audio

    Modelin ses döndürmesi gerektiğini belirtir.

  • video

    Modelin video döndürmesi gerektiğini belirtir.

  • document

    Modelin doküman döndürmesi gerektiğini belirtir.

tokens integer  (isteğe bağlı)

Modalite için jeton sayısı.

tool_use_tokens_by_modality array (ModalityTokens)  (isteğe bağlı)

Aracı kullanma jetonlarının kullanımının, modaliteye göre dökümü.

Tek bir yanıt biçiminin jeton sayısı.

Alanlar

modality<0xx0A> ResponseModality  (isteğe bağlı)

Jeton sayısıyla ilişkili yöntem.

Olası değerler

  • text

    Modelin metin döndürmesi gerektiğini belirtir.

  • image

    Modelin resim döndürmesi gerektiğini belirtir.

  • audio

    Modelin ses döndürmesi gerektiğini belirtir.

  • video

    Modelin video döndürmesi gerektiğini belirtir.

  • document

    Modelin doküman döndürmesi gerektiğini belirtir.

tokens integer  (isteğe bağlı)

Modalite için jeton sayısı.

total_cached_tokens integer  (isteğe bağlı)

İstemdeki önbelleğe alınmış bölümdeki (önbelleğe alınmış içerik) jeton sayısı.

total_input_tokens integer  (isteğe bağlı)

İstemdeki (bağlam) jeton sayısı.

total_output_tokens integer  (isteğe bağlı)

Oluşturulan tüm yanıtlardaki toplam jeton sayısı.

total_thought_tokens integer  (isteğe bağlı)

Düşünen modeller için düşünce jetonlarının sayısı.

total_tokens integer  (isteğe bağlı)

Etkileşim isteği için toplam jeton sayısı (istem + yanıtlar + diğer dahili jetonlar).

total_tool_use_tokens integer  (isteğe bağlı)

Araç kullanma istemlerinde bulunan jeton sayısı.