เมธอด: collections.countTokens
- ปลายทาง
- พารามิเตอร์เส้นทาง
- เนื้อหาคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- ตัวอย่างคำขอ
- GenerateContentRequest
เรียกใช้เครื่องมือแปลงข้อมูลเป็นโทเค็นของโมเดลในเนื้อหาอินพุตและแสดงผลจำนวนโทเค็น
ปลายทาง
โพสต์
https://generativelanguage.googleapis.com/v1beta/{model=models/*}:countTokens
พารามิเตอร์เส้นทาง
model
string
ต้องระบุ ชื่อทรัพยากรของโมเดล ซึ่งจะเป็นรหัสให้โมเดลใช้งาน
ชื่อนี้ควรตรงกับชื่อโมเดลที่แสดงผลโดยเมธอด models.list
รูปแบบ: models/{model}
จะอยู่ในรูปแบบ models/{model}
เนื้อหาของคำขอ
เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้
contents[]
object (Content
)
ไม่บังคับ อินพุตที่ระบุให้กับโมเดลเป็นพรอมต์ ระบบจะไม่สนใจช่องนี้เมื่อตั้งค่า generateContentRequest
generateContentRequest
object (GenerateContentRequest
)
ไม่บังคับ อินพุตโดยรวมที่ให้กับโมเดล Model.countTokens จะนับข้อความแจ้ง การเรียกใช้ฟังก์ชัน ฯลฯ
ตัวอย่างคำขอ
ข้อความ
Python
Node.js
เปลือกหอย
Kotlin
Swift
Dart
Java
แชท
Python
Node.js
เปลือกหอย
Kotlin
Swift
Dart
Java
สื่อในบรรทัด
Python
Node.js
Kotlin
Swift
Dart
Java
ไฟล์
Python
Node.js
แคช
Python
Node.js
คำแนะนำของระบบ
Python
Node.js
Kotlin
Swift
Dart
Java
เครื่องมือ
Python
Node.js
Kotlin
Swift
Dart
Java
เนื้อหาการตอบกลับ
การตอบกลับจาก models.countTokens
โดยจะแสดงผล tokenCount
ของโมเดลสำหรับ prompt
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
totalTokens
integer
จำนวนโทเค็นที่ model
แปลง prompt
เป็นโทเค็น
ไม่ติดลบเสมอ เมื่อตั้งค่าที่แคชไว้เนื้อหา นี่จะยังเป็นขนาดพรอมต์ที่มีประสิทธิภาพโดยรวม เช่น ซึ่งรวมถึงจำนวนโทเค็นในเนื้อหาที่แคชไว้
การแสดง JSON |
---|
{ "totalTokens": integer } |
GenerateContentRequest
คำขอเพื่อสร้างเสร็จสมบูรณ์จากโมเดล
การแสดง JSON |
---|
{ "model": string, "contents": [ { object ( |
model
string
ต้องระบุ ชื่อของ Model
ที่จะใช้ในการสร้างการดำเนินการให้เสร็จสมบูรณ์
รูปแบบ: name=models/{model}
contents[]
object (Content
)
ต้องระบุ เนื้อหาของการสนทนาปัจจุบันกับโมเดล
สำหรับการค้นหาแบบเลี้ยวเดียว อินสแตนซ์นี้เป็นอินสแตนซ์เดียว สำหรับการค้นหาแบบหลายเลี้ยว ช่องนี้เป็นฟิลด์ที่ซ้ำได้ซึ่งมีประวัติการสนทนาและคำขอล่าสุด
tools[]
object (Tool
)
ไม่บังคับ รายการของ Tools
ที่โมเดลอาจใช้เพื่อสร้างคำตอบถัดไป
Tool
คือโค้ดที่ช่วยให้ระบบโต้ตอบกับระบบภายนอกเพื่อดำเนินการหรือชุดการดำเนินการที่อยู่นอกเหนือความรู้และขอบเขตของโมเดลได้ เครื่องมือที่รองรับมีเพียง Function
ในขณะนี้
toolConfig
object (ToolConfig
)
ไม่บังคับ การกำหนดค่าเครื่องมือสำหรับ Tool
ที่ระบุไว้ในคำขอ
safetySettings[]
object (SafetySetting
)
ไม่บังคับ รายการอินสแตนซ์ SafetySetting
ที่ไม่ซ้ำกันสำหรับการบล็อกเนื้อหาที่ไม่ปลอดภัย
สิ่งนี้จะบังคับใช้ในGenerateContentRequest.contents
และGenerateContentResponse.candidates
ประเภท SafetyCategory
แต่ละประเภทไม่ควรมีการตั้งค่ามากกว่า 1 รายการ API จะบล็อกเนื้อหาและการตอบกลับทั้งหมดที่ไม่ตรงตามเกณฑ์ที่การตั้งค่าเหล่านี้กำหนดไว้ รายการนี้จะลบล้างการตั้งค่าเริ่มต้นสำหรับแต่ละ SafetyCategory
ที่ระบุใน safetySettings หากไม่มี SafetySetting
สำหรับ SafetyCategory
ที่ระบุในรายการ API จะใช้การตั้งค่าความปลอดภัยเริ่มต้นสำหรับหมวดหมู่นั้น สนับสนุนหมวดหมู่อันตราย HARM_CATEGORY_HATE_SPEECH, HARM_CATEGORY_SEXUALLY_EXPLICIT, HARM_CATEGORY_DANGEROUS_CONTENT, HARM_CATEGORY_HARASSMENT
systemInstruction
object (Content
)
ไม่บังคับ คำสั่งของระบบชุดนักพัฒนาแอป ขณะนี้มีเพียงข้อความเท่านั้น
generationConfig
object (GenerationConfig
)
ไม่บังคับ ตัวเลือกการกำหนดค่าสำหรับการสร้างและเอาต์พุตโมเดล
cachedContent
string
ไม่บังคับ ชื่อของเนื้อหาที่แคชซึ่งใช้เป็นบริบทในการแสดงการคาดการณ์ หมายเหตุ: ใช้การแคชอย่างชัดแจ้งเท่านั้น ซึ่งผู้ใช้สามารถควบคุมการแคชได้ (เช่น เนื้อหาที่จะแคช) และประหยัดต้นทุนอย่างแน่นอน รูปแบบ: cachedContents/{cachedContent}