รายการการใช้เครดิตการทำงานของ Workflow
รายการการใช้เครดิตการทำงานของ Workflow
สามารถใช้ API นี้เพื่อดึงรายละเอียดการใช้เครดิตของ Workflow ที่ระบุในช่วงเวลาหนึ่ง โดยจัดกลุ่มตาม runId และสามารถคืนข้อมูลได้สูงสุด 30 วัน
วิธีการร้องขอ
GET
ที่อยู่การเรียก
https://api.gptbots.ai/v1/account/workflow/run/credits
การตรวจสอบการเรียกใช้งาน
รายละเอียดดูได้จาก ภาพรวม API ในส่วนของวิธีการตรวจสอบสิทธิ์
ความถี่ในการเรียกใช้งาน
API นี้คำนวณเข้ากับโควต้าต่อหนึ่งนาทีของแพ็กเกจองค์กรในหมวด "API สถิติ" ใช้ร่วมกับ API สถิติอื่น (รวมถึง API สถิติระดับองค์กร) เมื่อเกินจำนวนที่กำหนดจะคืนค่า 40008
การร้องขอ
ตัวอย่างการร้องขอ
curl -X GET 'https://api.gptbots.ai/v1/account/workflow/run/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/workflow/run/credits?start_time=1774837924000&end_time=1775183447000&page=1&page_size=20' \
-H 'Authorization: Bearer your_apikey'
บล็อกโค้ดนี้ในหน้าต่างลอย
หัวข้อการร้องขอ
| ฟิลด์ | ประเภท | คำอธิบาย |
|---|---|---|
| Authorization | Bearer ${token} | ใช้ Authorization: Bearer ${token} สำหรับการตรวจสอบสิทธิ์ในการเรียก ใช้คีย์จากหน้า API Key เป็น token |
พารามิเตอร์การร้องขอ
| ฟิลด์ | ประเภท | จำเป็น | คำอธิบาย |
|---|---|---|---|
| start_time | long | ใช่ | เวลาที่เริ่มค้นหา เป็น timestamp มิลลิวินาที |
| end_time | long | ใช่ | เวลาสิ้นสุดการค้นหา เป็น timestamp มิลลิวินาที. ระยะห่างระหว่าง start_time และ end_time ต้องไม่เกิน 30 วัน |
| page | int | ไม่ใช่ | หมายเลขหน้า ค่าเริ่มต้นคือ 1 |
| page_size | int | ไม่ใช่ | จำนวนรายการต่อหน้า ค่าเริ่มต้นคือ 20 สูงสุดคือ 100 |
| run_id | string | ไม่ใช่ | ID การทำงานของ Workflow |
การตอบกลับ
ตัวอย่างการตอบกลับ
{
"list": [
{
"run_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"run_start_time": 1774838000000,
"chat": 2.10,
"anonymization": 0,
"asr": 0.50,
"tts": 0,
"rerank": 0.30,
"database_processing": 0,
"tool_call": 0.80,
"knowledge_doc_indexing": 0,
"question_tag": 0,
"total": 3.70
}
],
"total": 1,
"page": 1,
"page_size": 20,
"start_time": 1774837924000,
"end_time": 1775183447000
}
{
"list": [
{
"run_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"run_start_time": 1774838000000,
"chat": 2.10,
"anonymization": 0,
"asr": 0.50,
"tts": 0,
"rerank": 0.30,
"database_processing": 0,
"tool_call": 0.80,
"knowledge_doc_indexing": 0,
"question_tag": 0,
"total": 3.70
}
],
"total": 1,
"page": 1,
"page_size": 20,
"start_time": 1774837924000,
"end_time": 1775183447000
}
บล็อกโค้ดนี้ในหน้าต่างลอย
การตอบสนองที่สำเร็จ
| ฟิลด์ | ประเภท | คำอธิบาย |
|---|---|---|
| list | list | รายการรายละเอียดการใช้เครดิต |
| run_id | string | รหัสการทำงานของ Workflow |
| run_start_time | long | เวลาเริ่มต้นการทำงานของ Workflow (ค่าเวลามิลลิวินาที) หากบันทึกการทำงานถูกลบ จะเป็น 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 | การใช้เครดิตสำหรับการติดแท็กคำถาม |
| 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 | ข้อผิดพลาดภายในระบบ |
