การดึงรายการการใช้เครดิตการสนทนาของ Agent

การดึงรายการการใช้เครดิตการสนทนาของ Agent

สามารถใช้ API นี้เพื่อดึงรายละเอียดการใช้เครดิตการสนทนาของ Agent ที่ระบุภายในช่วงเวลาที่กำหนด โดยจัดกลุ่มตาม conversationId และสามารถคืนข้อมูลในช่วงไม่เกิน 30 วัน

วิธีการเรียก

GET

URL การเรียก

https://api.gptbots.ai/v1/account/agent/conversation/credits

การยืนยันตัวตน

รายละเอียดสามารถดูได้ที่ ภาพรวม API ในส่วนวิธีการยืนยันตัวตน

ความถี่ในการเรียก

API นี้จะถูกนับรวมในโควต้าต่อชั่วโมงของ "API ประเภทสถิติ" ขององค์กร โดยใช้ร่วมกันกับ API ประเภทสถิติอื่น ๆ (รวมถึง API สถิติระดับองค์กร) หากเกินโควต้า ระบบจะส่ง 40008

คำขอ

ตัวอย่างคำขอ

curl -X GET 'https://api.gptbots.ai/v1/account/agent/conversation/credits?start_time=1774837924000&end_time=1775183447000&page=1&page_size=20' \ -H 'Authorization: Bearer your_apikey'
                      
                      curl -X GET 'https://api.gptbots.ai/v1/account/agent/conversation/credits?start_time=1774837924000&end_time=1775183447000&page=1&page_size=20' \
  -H 'Authorization: Bearer your_apikey'

                    
บล็อกโค้ดนี้ในหน้าต่างลอย

ส่วนหัวของคำขอ

ฟิลด์ ประเภท คำอธิบาย
Authorization Bearer ${token} ใช้ Authorization: Bearer ${token} สำหรับการยืนยันตัวตน โปรดรับ token จากหน้าคีย์ API

พารามิเตอร์ของคำขอ

ฟิลด์ ประเภท จำเป็น คำอธิบาย
start_time long ใช่ เวลาเริ่มต้นของการค้นหา เป็นเวลามิลลิวินาที
end_time long ใช่ เวลาสิ้นสุดของการค้นหา เป็นเวลามิลลิวินาที ช่วงเวลาระหว่าง start_time และ end_time ต้องไม่เกิน 30 วัน
page int ไม่ หมายเลขหน้า เริ่มต้นที่ 1
page_size int ไม่ จำนวนรายการต่อหน้า เริ่มต้นที่ 20 และสูงสุดไม่เกิน 100
conversation_id string ไม่ รหัสการสนทนา

การตอบกลับ

ตัวอย่างการตอบกลับ

{ "list": [ { "conversation_id": "6830a1f2e4b0f1a2b3c4d5e6", "conversation_create_time": 1774838000000, "chat": 1.50, "anonymization": 0, "asr": 0, "tts": 0, "rerank": 0.30, "database_processing": 0, "tool_call": 0.20, "knowledge_doc_indexing": 0, "question_tag": 0, "moderation": 0.01, "total": 2.0 } ], "total": 1, "page": 1, "page_size": 20, "start_time": 1774837924000, "end_time": 1775183447000 }
                      
                      {
    "list": [
        {
            "conversation_id": "6830a1f2e4b0f1a2b3c4d5e6",
            "conversation_create_time": 1774838000000,
            "chat": 1.50,
            "anonymization": 0,
            "asr": 0,
            "tts": 0,
            "rerank": 0.30,
            "database_processing": 0,
            "tool_call": 0.20,
            "knowledge_doc_indexing": 0,
            "question_tag": 0,
            "moderation": 0.01,
            "total": 2.0
        }
    ],
    "total": 1,
    "page": 1,
    "page_size": 20,
    "start_time": 1774837924000,
    "end_time": 1775183447000
}

                    
บล็อกโค้ดนี้ในหน้าต่างลอย

การตอบสนองที่ประสบความสำเร็จ

ฟิลด์ ประเภท คำอธิบาย
list list รายละเอียดการใช้เครดิต
conversation_id string รหัสการสนทนา
conversation_create_time long เวลาสร้างการสนทนา (เวลามิลลิวินาที) จะเป็น null หากบันทึกการสนทนาถูกลบ
chat decimal การใช้เครดิตในการสนทนา (LLM chat)
anonymization decimal การใช้เครดิตในการทำให้ไม่ระบุตัวตน
asr decimal การใช้เครดิตในการรู้จำเสียง (ASR)
tts decimal การใช้เครดิตในการแปลงข้อความเป็นเสียง (TTS)
rerank decimal การใช้เครดิตในการจัดลำดับเวกเตอร์ใหม่
database_processing decimal การใช้เครดิตในการประมวลผลฐานข้อมูล
tool_call decimal การใช้เครดิตในการเรียกใช้งานเครื่องมือ
knowledge_doc_indexing decimal การใช้เครดิตในการจัดทำดัชนีความรู้
question_tag decimal การใช้เครดิตในการติดป้ายคำถาม
moderation decimal การใช้เครดิตในการตรวจสอบเนื้อหา
total decimal สรุปการใช้เครดิตทั้งหมดของการสนทนานี้
total long จำนวนการสนทนาที่ตรงตามเงื่อนไข (ใช้สำหรับแบ่งหน้า)
page int หมายเลขหน้าปัจจุบัน
page_size int จำนวนรายการต่อหน้า
start_time long เวลาเริ่มต้นในการค้นหา
end_time long เวลาสิ้นสุดในการค้นหา

การตอบสนองที่ล้มเหลว

ฟิลด์ ประเภท คำอธิบาย
code int รหัสข้อผิดพลาด
message string ข้อมูลคำอธิบายข้อผิดพลาด

รหัสข้อผิดพลาด

Code Message
40000 พารามิเตอร์ไม่ถูกต้อง
40001 ช่วงเวลาที่ไม่ถูกต้อง (เกิน 30 วัน)
50000 ข้อผิดพลาดภายในระบบ