Method: models.generateMessage

สร้างการตอบสนองจากโมเดลโดยได้รับอินพุต MessagePrompt

คำขอ HTTP

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

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

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

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

string

ต้องระบุ ชื่อโมเดลที่จะใช้

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

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

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

การแสดง JSON 
{
  "prompt": {
    object (MessagePrompt)
  },
  "temperature": number,
  "candidateCount": integer,
  "topP": number,
  "topK": integer
}
ช่อง
prompt

object (MessagePrompt)

ต้องระบุ อินพุตข้อความที่มีโครงสร้างที่กำหนดให้โมเดลเป็นพรอมต์

เมื่อมีการพรอมต์ โมเดลจะส่งกลับสิ่งที่คาดว่าจะเป็นข้อความถัดไปในการสนทนา
temperature

number

ไม่บังคับ ควบคุมความสุ่มของเอาต์พุต

ค่ามีได้ที่ครอบคลุมกว่า [0.0,1.0] ค่าที่ใกล้เคียงกับ 1.0 จะทำให้คำตอบมีความหลากหลายยิ่งขึ้น ขณะที่ค่าที่ใกล้เคียงกับ 0.0 มักจะทำให้ได้คำตอบที่ไม่น่าแปลกใจจากโมเดล
candidateCount

integer

ไม่บังคับ จำนวนข้อความตอบกลับที่สร้างขึ้นที่จะแสดง

ค่านี้จะต้องอยู่ระหว่าง [1, 8] เท่านั้น หากไม่ได้ตั้งค่า การตั้งค่านี้จะมีค่าเริ่มต้นเป็น 1
topP

number

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

โมเดลนี้ใช้การสุ่มตัวอย่าง Top-k และนิวเคลียสรวมกัน

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

integer

ไม่บังคับ จำนวนโทเค็นสูงสุดที่ต้องพิจารณาเมื่อสุ่มตัวอย่าง

โมเดลนี้ใช้การสุ่มตัวอย่าง Top-k และนิวเคลียสรวมกัน

การสุ่มตัวอย่างในตำแหน่งบนสุดจะพิจารณาชุดโทเค็นที่เป็นไปได้มากที่สุด topK รายการ

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

การตอบสนองจากโมเดล

ซึ่งรวมถึงข้อความที่รอการพิจารณาและประวัติการสนทนาในรูปแบบข้อความที่จัดเรียงตามลำดับเวลา

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

การแสดง JSON 
{
  "candidates": [
    {
      object (Message)
    }
  ],
  "messages": [
    {
      object (Message)
    }
  ],
  "filters": [
    {
      object (ContentFilter)
    }
  ]
}
ช่อง
candidates[]

object (Message)

ข้อความตอบกลับของผู้สมัครจากโมเดล
messages[]

object (Message)

ประวัติการสนทนาที่โมเดลใช้
filters[]

object (ContentFilter)

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

ข้อมูลนี้ระบุว่า SafetyCategory รายใดบล็อกผู้สมัครจากคำตอบนี้ คะแนนต่ำสุด HarmProbability ที่ทำให้มีการบล็อก และการตั้งค่า HarmThreshold สำหรับหมวดหมู่นั้น

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

ต้องมีขอบเขต 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

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