API ซาจู › API ไพ่ทาโรต์

API ไพ่ทาโรต์

เมื่อกำหนดจำนวนไพ่ที่จะสุ่ม (1~10 ใบ) หรือรูปแบบการวางไพ่ ระบบจะสุ่มไพ่จากสำรับ 78 ใบ (เมเจอร์ 22 · ไมเนอร์ 56) โดยไม่ซ้ำกัน แล้วส่งคืนไพ่ตั้ง·ไพ่กลับหัว คีย์เวิร์ด ความหมาย และที่อยู่รูปภาพของไพ่แต่ละใบในรูปแบบ JSON ชื่อสินค้าคือ “ไพ่ทาโรต์” ไม่มีการตีความด้วย AI ความหมายเป็นประโยคที่กำหนดไว้สำหรับไพ่แต่ละใบตามเดิม

คู่มือเริ่มต้นใช้งาน Playground ตารางราคา

จำนวนไพ่·การวางไพ่·seed

ส่งเพียงค่าเดียวระหว่าง count กับ spread หากส่ง seed เมื่อใช้ seed เดียวกัน·จำนวนไพ่ (หรือการวางไพ่) เดียวกัน·การตั้งค่าไพ่กลับหัวเดียวกัน จะได้ไพ่เดิมเสมอ หากไม่ส่งจะสุ่มใหม่ทุกครั้ง เลือกภาษาของชื่อไพ่·คีย์เวิร์ด·ความหมายได้ด้วย lang

รูปภาพไพ่

imageUrl·cardBackUrl เป็นไฟล์ WebP กว้าง 600px สแกนจากต้นฉบับ Rider-Waite ปี 1909 (Pamela Colman Smith, สาธารณสมบัติ) ที่อยู่มีเวอร์ชันกำกับไว้จึงไม่เปลี่ยน สำหรับไพ่กลับหัว ให้หมุนรูปภาพ 180 องศาในการแสดงผล

การตีความทำที่ไหน

ส่งไพ่ที่สุ่มได้เป็นข้อมูลนำเข้าให้ LLM API เพื่อเขียนคำทำนายเอง หรือใส่ tarot ในคำขอ API อ่านดวงซาจู เพื่ออ่านไปพร้อมกับคำทำนายซาจูก็ได้

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

{
  "spread": "past-present-future",
  "question": "올해 하반기에 이직해도 될까요?",
  "seed": "user-1042:2026-10-10"
}

การยืนยันตัวตนใช้เฮดเดอร์ X-Partner-Api-Key ที่อยู่พื้นฐานคือ https://api.hrum.ai/api/v1/partners/v1 ตัวอย่าง Python·JavaScript และการจัดการข้อผิดพลาดอยู่ในคู่มือเริ่มต้นใช้งาน

ตัวอย่างการตอบกลับ (ตัดมาไพ่ 1 ใบ)

{
  "success": true,
  "data": {
    "lang": "ko",
    "count": 3,
    "spread": { "type": "past-present-future", "name": "과거·현재·미래", "description": "시간 흐름을 따라가는 질문", "positions": ["과거", "현재", "미래"] },
    "reversedAllowed": true,
    "seed": "hrum-example-1",
    "cards": [
      {
        "position": 1,
        "positionLabel": "과거",
        "id": "wands_10",
        "name": "완드의 10",
        "nameEn": "Ten of Wands",
        "arcana": "wands",
        "reversed": true,
        "keywords": ["내려놓기", "위임", "해방"],
        "meaning": "무거운 짐을 마침내 내려놓거나 도움을 받기 시작하는 시기.",
        "imageUrl": "https://console.hrum.ai/tarot/cards/v2/wands_10.webp"
      }
    ],
    "cardBackUrl": "https://console.hrum.ai/tarot/cards/v2/back.webp",
    "question": "올해 하반기에 이직해도 될까요?",
    "costPoints": 20
  }
}

ราคา

ไพ่ทาโรต์มีราคา ₩20 ต่อการเรียก 1 ครั้ง (ไม่รวม VAT · รวม VAT ₩22) ไม่ว่าจะสุ่ม 1 ใบหรือ 10 ใบก็นับเป็นครั้งเดียวต่อการเรียก หักจากเครดิตแบบเติมเงินล่วงหน้าเฉพาะการเรียกที่สำเร็จ และไม่หักสำหรับการตอบกลับที่เป็นข้อผิดพลาด 4xx·5xx

ผลลัพธ์ที่ได้รับแล้วให้บันทึกเก็บไว้และนำกลับมาใช้ซ้ำ หากส่งคำขอเดิมอีกครั้งจะถูกคิดค่าบริการอีกครั้ง หากวันเดือนปีและเวลาเกิดเหมือนกันและตัวเลือกเหมือนกัน ผลการคำนวณจะเหมือนกัน จึงควรบันทึกการตอบกลับครั้งแรกไว้ใน DB (เช่น ใช้แฮชของเนื้อหาคำขอเป็นคีย์) แล้วใช้ค่าที่บันทึกไว้ในครั้งต่อไปโดยไม่มีค่าใช้จ่าย สำหรับผลลัพธ์ที่เปลี่ยนตามวันที่อย่างดวงวันนี้ ให้ใส่วันที่ลงในคีย์ด้วยและใช้ซ้ำเฉพาะภายในวันนั้น

ตารางราคาทั้งหมด

เอกสารอ้างอิงฉบับเต็ม

ตารางพารามิเตอร์ทั้งหมด คำอธิบายฟิลด์การตอบกลับ และรหัสข้อผิดพลาดอยู่ในเอกสารอ้างอิง: เอกสารอ้างอิง API ไพ่ทาโรต์ สินค้าซาจูอื่นๆ ดูได้ที่ดู API ซาจูทั้งหมด

ติดต่อ: contact@float.do · ดำเนินการโดย: FLOAT Co., Ltd.