Skip to main content
POST
https://sajuapi.dev
/
api
/
daily-fortune
curl -X POST https://api.sajuapi.dev/api/daily-fortune \
  -H "Content-Type: application/json" \
  -H "X-API-Key: bs_live_xxx" \
  -d '{
    "saju": {
      "pillars": {
        "year": { "stem": { "hangul": "갑" }, "branch": { "hangul": "자" } },
        "month": { "stem": { "hangul": "병" }, "branch": { "hangul": "인" } },
        "day": { "stem": { "hangul": "정" }, "branch": { "hangul": "묘" } },
        "hour": { "stem": { "hangul": "무" }, "branch": { "hangul": "진" } }
      }
    },
    "userName": "홍길동",
    "model": "haiku"
  }'
{
  "success": true,
  "data": {
    "character": {
      "dayMaster": "정화",
      "dayMasterHanja": "丁",
      "elementName": "촛불",
      "emoji": "🕯️",
      "identity": "당신은 정화(丁火), 촛불의 기운을 가진 사람이에요. 섬세하고 따뜻한 마음으로 주변을 밝히는 성격이에요.",
      "investmentIdentity": "신중하게 분석하고 확신이 들 때 투자하는 스타일이에요."
    },
    "investmentTendency": {
      "scores": {
        "riskTolerance": 45,
        "longTermAptitude": 72,
        "trendSensitivity": 58
      },
      "summary": "안정적인 장기 투자에 강점을 가진 타입",
      "warning": "FOMO에 휩쓸리지 않도록 주의하세요"
    },
    "todayFortune": {
      "date": "2024-01-15",
      "formattedDate": "2024년 1월 15일 (월)",
      "score": 78,
      "overallAnalysis": "오늘은 안정적인 투자 결정이 가능한 날이에요. 오후에 좋은 기회가 올 수 있어요.",
      "actionItems": [
        { "type": "do", "text": "메이저 코인 분할 매수" },
        { "type": "do", "text": "포트폴리오 리밸런싱" },
        { "type": "avoid", "text": "레버리지 거래" },
        { "type": "avoid", "text": "단타 매매" }
      ],
      "timing": {
        "best": "14:00-16:00",
        "avoid": "09:00-11:00",
        "reason": "오후에 금 기운이 안정되면서 판단력이 맑아져요."
      }
    },
    "whyExplanation": "오늘은 정화 일간에게 수 기운이 조화를 이루는 날이에요. 감정에 휘둘리지 않고 차분한 결정이 가능해요."
  },
  "meta": {
    "requestId": "req_abc123def456",
    "model": "haiku",
    "cached": false,
    "cost": 0.013,
    "latency": 2341
  }
}

요청

saju
object
required
생년월일시로 계산된 사용자의 사주팔자(四柱八字)
userName
string
required
사용자 이름 (개인화된 응답에 사용됨). 최대 20자.
model
string
default:"haiku"
사용할 AI 모델. 옵션: haiku, sonnet, gpt4o
date
string
대상 날짜 (YYYY-MM-DD 형식). 기본값은 오늘 (KST).
type
string
default:"all"
응답 타입:
  • all: 전체 분석 (성격 + 성향 + 운세)
  • fortune_only: 일일 운세만
  • character: 성격 분석만
  • compare: 3개 모델 비교

응답

success
boolean
요청 성공 여부
data
object
meta
object
요청 메타데이터

예제

curl -X POST https://api.sajuapi.dev/api/daily-fortune \
  -H "Content-Type: application/json" \
  -H "X-API-Key: bs_live_xxx" \
  -d '{
    "saju": {
      "pillars": {
        "year": { "stem": { "hangul": "갑" }, "branch": { "hangul": "자" } },
        "month": { "stem": { "hangul": "병" }, "branch": { "hangul": "인" } },
        "day": { "stem": { "hangul": "정" }, "branch": { "hangul": "묘" } },
        "hour": { "stem": { "hangul": "무" }, "branch": { "hangul": "진" } }
      }
    },
    "userName": "홍길동",
    "model": "haiku"
  }'
{
  "success": true,
  "data": {
    "character": {
      "dayMaster": "정화",
      "dayMasterHanja": "丁",
      "elementName": "촛불",
      "emoji": "🕯️",
      "identity": "당신은 정화(丁火), 촛불의 기운을 가진 사람이에요. 섬세하고 따뜻한 마음으로 주변을 밝히는 성격이에요.",
      "investmentIdentity": "신중하게 분석하고 확신이 들 때 투자하는 스타일이에요."
    },
    "investmentTendency": {
      "scores": {
        "riskTolerance": 45,
        "longTermAptitude": 72,
        "trendSensitivity": 58
      },
      "summary": "안정적인 장기 투자에 강점을 가진 타입",
      "warning": "FOMO에 휩쓸리지 않도록 주의하세요"
    },
    "todayFortune": {
      "date": "2024-01-15",
      "formattedDate": "2024년 1월 15일 (월)",
      "score": 78,
      "overallAnalysis": "오늘은 안정적인 투자 결정이 가능한 날이에요. 오후에 좋은 기회가 올 수 있어요.",
      "actionItems": [
        { "type": "do", "text": "메이저 코인 분할 매수" },
        { "type": "do", "text": "포트폴리오 리밸런싱" },
        { "type": "avoid", "text": "레버리지 거래" },
        { "type": "avoid", "text": "단타 매매" }
      ],
      "timing": {
        "best": "14:00-16:00",
        "avoid": "09:00-11:00",
        "reason": "오후에 금 기운이 안정되면서 판단력이 맑아져요."
      }
    },
    "whyExplanation": "오늘은 정화 일간에게 수 기운이 조화를 이루는 날이에요. 감정에 휘둘리지 않고 차분한 결정이 가능해요."
  },
  "meta": {
    "requestId": "req_abc123def456",
    "model": "haiku",
    "cached": false,
    "cost": 0.013,
    "latency": 2341
  }
}

캐싱 동작

응답은 다음 기준으로 캐시됩니다:
  • 일간 오행 (10가지 옵션)
  • 가장 약한 오행 (5가지 옵션)
  • 날짜 (매일 갱신)
즉, 유사한 사주 구성을 가진 사용자는 캐시된 응답을 받을 수 있어 지연 시간과 비용이 줄어듭니다.
캐시된 응답은 meta.cached: true이며 비용이 $0입니다 (AI 호출 없음).

모범 사례

  1. 클라이언트에서 캐시하세요: 같은 날의 응답을 클라이언트 측에 저장
  2. fortune_only 사용: 오늘의 운세만 필요하면 type=fortune_only로 비용 66% 절감
  3. 프로덕션에서 compare 피하기: 비교 모드는 비용이 3배이므로 테스트용으로만 사용