การดึงรายการการใช้เครดิตการสนทนาของ 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 | ข้อผิดพลาดภายในระบบ |
