Menghasilkan beberapa embedding dari model yang diberikan teks input dalam panggilan sinkron.
Permintaan HTTP
POST https://generativelanguage.googleapis.com/v1/{model=models/*}:batchEmbedContents
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
model |
Wajib. Nama resource model. Ini berfungsi sebagai ID untuk digunakan oleh Model. Nama ini harus cocok dengan nama model yang ditampilkan oleh metode Format: |
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"requests": [
{
object ( |
Kolom | |
---|---|
requests[] |
Wajib. Menyematkan permintaan untuk batch. Model di setiap permintaan ini harus sesuai dengan |
Isi respons
Respons terhadap BatchEmbedContentsRequest
.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"embeddings": [
{
object ( |
Kolom | |
---|---|
embeddings[] |
Hanya output. Embedding untuk setiap permintaan, dalam urutan yang sama seperti yang diberikan dalam permintaan batch. |
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/generative-language
https://www.googleapis.com/auth/generative-language.tuning
https://www.googleapis.com/auth/generative-language.tuning.readonly
https://www.googleapis.com/auth/generative-language.retriever
https://www.googleapis.com/auth/generative-language.retriever.readonly
Untuk informasi selengkapnya, lihat Ringkasan Autentikasi.
EmbedContentRequest
Permintaan yang berisi Content
untuk model yang akan disematkan.
Representasi JSON |
---|
{ "model": string, "content": { object ( |
Kolom | |
---|---|
model |
Wajib. Nama resource model. Ini berfungsi sebagai ID untuk digunakan oleh Model. Nama ini harus cocok dengan nama model yang ditampilkan oleh metode Format: |
content |
Wajib. Konten yang akan disematkan. Hanya kolom |
taskType |
Opsional. Jenis tugas opsional yang menggunakan embeddings. Hanya dapat disetel untuk |
title |
Opsional. Judul opsional untuk teks. Hanya berlaku jika TaskType adalah Catatan: Menentukan |
outputDimensionality |
Opsional. Dimensi opsional yang dikurangi untuk embedding output. Jika ditetapkan, nilai yang berlebihan dalam embedding output akan dipotong dari bagian akhir. Didukung oleh model yang lebih baru sejak tahun 2024, dan model sebelumnya ( |