API ซาจู › API อ่านดวงซาจู
API อ่านดวงซาจู
เมื่อส่งวันเดือนปีเวลาเกิดและคำถามเข้ามา เซิร์ฟเวอร์จะคำนวณซาจูแล้วส่งให้ AI และ AI จะส่งคืนคำทำนายที่ตรงกับคำถาม ชื่อสินค้าคือ “AI อ่านดวงซาจู” โดยมี “AI อ่านดวงซาจู · หน่วยความจำ” ที่จดจำบทสนทนา และ “รายงานซาจู” ที่รับผลครั้งเดียวโดยไม่ต้องถาม อยู่ในกลุ่มเดียวกัน พรอมต์ภายในและทฤษฎีจะไม่รวมอยู่ในการตอบกลับ ส่งคืนเฉพาะผลการตีความ
คู่มือเริ่มต้นใช้งาน Playground ตารางราคา
วิธีเรียก 3 แบบ
- ปรึกษาครั้งเดียว
POST /reading— ส่งคืนคำทำนายหนึ่งรายการต่อคำถามหนึ่งข้อ การตอบกลับยาวได้ถึง 2,000 ตัวอักษร - ปรึกษาต่อเนื่อง
POST /reading/memory— HRUM เก็บหน่วยความจำบทสนทนาของผู้ใช้ปลายทางแต่ละคน และอ่านดวงต่อจากบริบทเดิมเมื่อกลับมาอีกครั้ง - รายงานในครั้งเดียว
POST /reading/report— รับรายงานแยกตามหัวข้อ เช่น ภาพรวม·การเงิน·ความรัก·วัยจร 10 ปี ได้ในครั้งเดียวโดยไม่ต้องถาม (สูงสุด 12 หัวข้อ)
รายการที่ใส่ร่วมได้
ใส่หลักฐานจากจื่อเวยโต่วซู่·โหราศาสตร์ตะวันตก·ทำนายฝัน·ไพ่ทาโรต์ร่วมในการอ่านดวงได้ หรือเรียกเพียงอย่างเดียวด้วย only ก็ได้ เสาประจำวันของวันนี้สะท้อนในทุกคำทำนายโดยไม่ต้องเรียกแยก หากละเวลาเกิด (hour) จะตัดเสายามออกและตีความจาก 3 เสา ปี·เดือน·วัน
ตัวอย่างคำขอ
ปรึกษาครั้งเดียว (/reading)
curl -X POST https://api.hrum.ai/api/v1/partners/v1/reading \
-H "X-Partner-Api-Key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"question": "올해 이직해도 괜찮을까요?",
"birth": { "year": 1990, "month": 5, "day": 15, "hour": 14, "minute": 30, "gender": "female" },
"maxLength": 600,
"tone": "warm"
}'
ปรึกษาต่อเนื่อง (/reading/memory)
curl -X POST https://api.hrum.ai/api/v1/partners/v1/reading/memory \
-H "X-Partner-Api-Key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"endUserId": "member-1024",
"question": "지난번에 얘기한 이직 건, 다음 달에 움직여도 될까요?",
"birth": { "year": 1990, "month": 5, "day": 15, "hour": 14, "minute": 30, "gender": "female" }
}'
รายงานในครั้งเดียว (/reading/report)
curl -X POST https://api.hrum.ai/api/v1/partners/v1/reading/report \
-H "X-Partner-Api-Key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"birth": { "year": 1990, "month": 5, "day": 15, "hour": 14, "minute": 30, "gender": "female" },
"sections": ["총평", "재물운", "연애·인연"]
}'
การยืนยันตัวตนใช้เฮดเดอร์ X-Partner-Api-Key ที่อยู่พื้นฐานคือ https://api.hrum.ai/api/v1/partners/v1 ตัวอย่าง Python·JavaScript และการจัดการข้อผิดพลาดอยู่ในคู่มือเริ่มต้นใช้งาน
ตัวอย่างการตอบกลับ (/reading)
{
"success": true,
"data": {
"interpretation": "당신의 사주에서 보이는 특징은...",
"sajuSource": "computed",
"usage": {
"inputTokens": 450,
"outputTokens": 280
},
"costPoints": 18
}
}
costPoints คือจำนวนที่หักในการเรียกครั้งนี้ ฟิลด์การตอบกลับของแบบหน่วยความจำและแบบรายงานอยู่ในเอกสารอ้างอิง
ราคา
AI อ่านดวงซาจูมีราคาต่อ 1 ล้านโทเค็น ขาเข้า ₩2,888 (ไม่รวม VAT · รวม VAT ₩3,177) ขาออก ₩23,100 (ไม่รวม VAT · รวม VAT ₩25,410) AI อ่านดวงซาจู · หน่วยความจำ มีราคาต่อ 1 ล้านโทเค็น ขาเข้า ₩3,754 (ไม่รวม VAT · รวม VAT ₩4,129) ขาออก ₩30,030 (ไม่รวม VAT · รวม VAT ₩33,033) รายงานซาจูคิดค่าบริการตามโทเค็น จึงไม่มีราคาตายตัวต่อครั้ง โปรดตรวจสอบช่วงราคาโดยประมาณในตารางราคา ปริมาณผลคำนวณซาจูที่ส่งให้ AI และพรอมต์ระบบไม่คิดค่าบริการ คิดเฉพาะโทเค็นของคำถาม·persona และคำตอบ หากมีรายการที่ใส่ร่วม บล็อกหลักฐานของรายการนั้นจะบวกเพิ่มในโทเค็นขาเข้า และบวกค่าบริการคงที่ของแต่ละรายการด้วย หักจากเครดิตแบบเติมเงินล่วงหน้าเฉพาะการเรียกที่สำเร็จ และไม่หักสำหรับการตอบกลับที่เป็นข้อผิดพลาด 4xx·5xx
ผลลัพธ์ที่ได้รับแล้วให้บันทึกเก็บไว้และนำกลับมาใช้ซ้ำ หากส่งคำขอเดิมอีกครั้งจะถูกคิดค่าบริการอีกครั้ง หากวันเดือนปีและเวลาเกิดเหมือนกันและตัวเลือกเหมือนกัน ผลการคำนวณจะเหมือนกัน จึงควรบันทึกการตอบกลับครั้งแรกไว้ใน DB (เช่น ใช้แฮชของเนื้อหาคำขอเป็นคีย์) แล้วใช้ค่าที่บันทึกไว้ในครั้งต่อไปโดยไม่มีค่าใช้จ่าย สำหรับผลลัพธ์ที่เปลี่ยนตามวันที่อย่างดวงวันนี้ ให้ใส่วันที่ลงในคีย์ด้วยและใช้ซ้ำเฉพาะภายในวันนั้น
เอกสารอ้างอิงฉบับเต็ม
ตารางพารามิเตอร์ทั้งหมด คำอธิบายฟิลด์การตอบกลับ และรหัสข้อผิดพลาดอยู่ในเอกสารอ้างอิง: เอกสารอ้างอิง AI อ่านดวงซาจู · เอกสารอ้างอิงแบบหน่วยความจำ · เอกสารอ้างอิงรายงานซาจู สินค้าซาจูอื่นๆ ดูได้ที่ดู API ซาจูทั้งหมด
ติดต่อ: contact@float.do · ดำเนินการโดย: FLOAT Co., Ltd.