API ซาจู › API ทำนายฝัน
API ทำนายฝัน
เมื่อส่งเรื่องเล่าความฝันเข้ามา ระบบจะส่งคืนคำสัญลักษณ์ที่พบในคลังคำสัญลักษณ์ความฝันที่ HRUM สร้างขึ้นเอง เรียงตามความโดดเด่นในรูปแบบ JSON ชื่อสินค้าคือ “ทำนายฝัน” คลังคำมีเพียงคำศัพท์ ไม่มีความหมายของการทำนายหรือการตัดสินดีร้าย ข้อมูลนำเข้าเหมือนกันจะได้ผลลัพธ์เหมือนกัน
คู่มือเริ่มต้นใช้งาน Playground ตารางราคา
สิ่งที่ส่งคืน
- คำสัญลักษณ์ — เฉพาะคำที่คำนั้นหรือคำพ้องความหมาย/รูปผันของคำปรากฏจริงในเนื้อหาความฝัน สูงสุด 40 คำ (
items[].keywords) - คะแนนความโดดเด่น — 0~1 เท่าเดิมหรือลดลงตามลำดับในรายการ (
items[].score) - วิธีที่พบ — พบในคลังคำหรือไม่พบสัญลักษณ์ใดเลย (
mode)
หากไม่พบสัญลักษณ์
หากไม่พบสัญลักษณ์ items จะเป็นอาร์เรย์ว่างและไม่คิดค่าบริการ
หากต้องการข้อความคำทำนาย
การตอบกลับไม่มีข้อความคำทำนาย ให้ส่งเนื้อหาความฝันและคำที่พบเป็นข้อมูลนำเข้าให้ API อ่านดวงซาจู (only: "dream") หรือ LLM API
ตัวอย่างคำขอ
{
"dream": "바다에서 커다란 물고기를 두 손으로 잡는 꿈을 꿨어요"
}
การยืนยันตัวตนใช้เฮดเดอร์ X-Partner-Api-Key ที่อยู่พื้นฐานคือ https://api.hrum.ai/api/v1/partners/v1 ตัวอย่าง Python·JavaScript และการจัดการข้อผิดพลาดอยู่ในคู่มือเริ่มต้นใช้งาน
ตัวอย่างการตอบกลับ
{
"success": true,
"data": {
"lang": "ko",
"mode": "glossary",
"items": [
{ "keywords": ["바다"], "score": 1 },
{ "keywords": ["물고기"], "score": 0.979 },
{ "keywords": ["손"], "score": 0.749 }
]
}
}
ราคา
ทำนายฝันมีราคา ₩30 ต่อการเรียก 1 ครั้ง (ไม่รวม VAT · รวม VAT ₩33) คิดค่าบริการเฉพาะเมื่อพบรายการอย่างน้อยหนึ่งรายการ หากผลลัพธ์ว่างจะไม่หัก หักจากเครดิตแบบเติมเงินล่วงหน้าเฉพาะการเรียกที่สำเร็จ และไม่หักสำหรับการตอบกลับที่เป็นข้อผิดพลาด 4xx·5xx
ผลลัพธ์ที่ได้รับแล้วให้บันทึกเก็บไว้และนำกลับมาใช้ซ้ำ หากส่งคำขอเดิมอีกครั้งจะถูกคิดค่าบริการอีกครั้ง หากวันเดือนปีและเวลาเกิดเหมือนกันและตัวเลือกเหมือนกัน ผลการคำนวณจะเหมือนกัน จึงควรบันทึกการตอบกลับครั้งแรกไว้ใน DB (เช่น ใช้แฮชของเนื้อหาคำขอเป็นคีย์) แล้วใช้ค่าที่บันทึกไว้ในครั้งต่อไปโดยไม่มีค่าใช้จ่าย สำหรับผลลัพธ์ที่เปลี่ยนตามวันที่อย่างดวงวันนี้ ให้ใส่วันที่ลงในคีย์ด้วยและใช้ซ้ำเฉพาะภายในวันนั้น
เอกสารอ้างอิงฉบับเต็ม
ตารางพารามิเตอร์ทั้งหมด คำอธิบายฟิลด์การตอบกลับ และรหัสข้อผิดพลาดอยู่ในเอกสารอ้างอิง: เอกสารอ้างอิง API ทำนายฝัน สินค้าซาจูอื่นๆ ดูได้ที่ดู API ซาจูทั้งหมด
ติดต่อ: contact@float.do · ดำเนินการโดย: FLOAT Co., Ltd.