Method: models.countTokens

เรียกใช้เครื่องมือแปลงข้อมูลเป็นโทเค็นของโมเดลในเนื้อหาอินพุตและแสดงผลจำนวนโทเค็น

คำขอ HTTP

POST https://generativelanguage.googleapis.com/v1/{model=models/*}:countTokens

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

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

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

string

ต้องระบุ ชื่อทรัพยากรของโมเดล ซึ่งจะเป็นรหัสให้โมเดลใช้งาน

ชื่อนี้ควรตรงกับชื่อโมเดลที่แสดงผลโดยเมธอด models.list

รูปแบบ: models/{model}

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

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

การแสดง JSON 
{
  "contents": [
    {
      object (Content)
    }
  ],
  "generateContentRequest": {
    object (GenerateContentRequest)
  }
}
ช่อง
contents[]

object (Content)

ไม่บังคับ อินพุตที่ระบุให้กับโมเดลเป็นพรอมต์ ระบบจะไม่สนใจช่องนี้เมื่อตั้งค่า generateContentRequest
generateContentRequest

object (GenerateContentRequest)

ไม่บังคับ อินพุตโดยรวมที่ให้กับโมเดล model.countTokens จะนับข้อความแจ้ง การเรียกใช้ฟังก์ชัน ฯลฯ

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

การตอบกลับจาก models.countTokens

โดยจะแสดงผล tokenCount ของโมเดลสำหรับ prompt

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

การแสดง JSON 
{
  "totalTokens": integer
}
ช่อง
totalTokens

integer

จำนวนโทเค็นที่ model แปลง prompt เป็นโทเค็น

ไม่ติดลบเสมอ เมื่อตั้งค่าแคชเนื้อหา นี่จะยังเป็นขนาดพรอมต์ที่มีประสิทธิภาพโดยรวม เช่น จำนวนโทเค็นในเนื้อหาที่แคชไว้

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

ต้องใช้ขอบเขต 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

สำหรับข้อมูลเพิ่มเติม โปรดดูภาพรวมการตรวจสอบสิทธิ์

GenerateContentRequest

คำขอเพื่อสร้างเสร็จสมบูรณ์จากโมเดล

การแสดง JSON 
{
  "model": string,
  "contents": [
    {
      object (Content)
    }
  ],
  "safetySettings": [
    {
      object (SafetySetting)
    }
  ],
  "generationConfig": {
    object (GenerationConfig)
  }
}
ช่อง
model

string

ต้องระบุ ชื่อของ Model ที่จะใช้ในการสร้างการดำเนินการให้เสร็จสมบูรณ์

รูปแบบ: name=models/{model}
contents[]

object (Content)

ต้องระบุ เนื้อหาของการสนทนาปัจจุบันกับโมเดล

สำหรับการค้นหาแบบเลี้ยวเดียว อินสแตนซ์นี้เป็นอินสแตนซ์เดียว สำหรับการค้นหาแบบหลายเลี้ยว ช่องนี้เป็นฟิลด์ที่ซ้ำได้ซึ่งมีประวัติการสนทนาและคำขอล่าสุด
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
generationConfig

object (GenerationConfig)

ไม่บังคับ ตัวเลือกการกำหนดค่าสำหรับการสร้างและเอาต์พุตโมเดล