Method: models.batchEmbedText

สร้างการฝังหลายรายการจากโมเดลที่ได้รับข้อความอินพุตในการเรียกใช้พร้อมกัน

คำขอ HTTP

POST https://generativelanguage.googleapis.com/v1beta/{model=models/*}:batchEmbedText

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
model

string

ต้องระบุ ชื่อของ Model ที่จะใช้สร้างการฝัง ตัวอย่าง: โมเดล/embedding-gecko-001

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON
{
  "texts": [
    string
  ],
  "requests": [
    {
      object (EmbedTextRequest)
    }
  ]
}
ช่อง
texts[]

string

ไม่บังคับ ข้อความอินพุตรูปแบบอิสระที่โมเดลจะเปลี่ยนเป็นการฝัง ขีดจำกัดปัจจุบันคือ 100 ข้อความซึ่งจะเกิดข้อผิดพลาด

requests[]

object (EmbedTextRequest)

ไม่บังคับ คำขอฝังสำหรับแบตช์ ตั้งค่าได้เพียง texts หรือ requests เท่านั้น

เนื้อหาการตอบกลับ

การตอบสนองต่อ EmbedTextRequest

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON
{
  "embeddings": [
    {
      object (Embedding)
    }
  ]
}
ช่อง
embeddings[]

object (Embedding)

เอาต์พุตเท่านั้น การฝังที่สร้างจากข้อความอินพุต

ขอบเขตการให้สิทธิ์

ต้องมีขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • 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

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมการตรวจสอบสิทธิ์

EmbedTextRequest

คำขอรับการฝังข้อความจากโมเดล

การแสดง JSON
{
  "model": string,
  "text": string
}
ช่อง
model

string

ต้องระบุ ชื่อโมเดลที่จะใช้กับรูปแบบ model=models/{model}

text

string

ไม่บังคับ ข้อความอินพุตรูปแบบอิสระที่โมเดลจะเปลี่ยนเป็นการฝัง