Skip to main content
POST
https://sajuapi.dev
/
v1
/
calculations
/
compatibility
궁합 계산
curl --request POST \
  --url https://sajuapi.dev/v1/calculations/compatibility \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "person1.birth_year": 123,
  "person1.birth_month": 123,
  "person1.birth_day": 123,
  "person1.birth_hour": 123,
  "person1.gender": "<string>",
  "person2.birth_year": 123,
  "person2.birth_month": 123,
  "person2.birth_day": 123,
  "person2.birth_hour": 123,
  "person2.gender": "<string>",
  "relationship_type": "<string>",
  "model": "<string>"
}
'
v1 Enterprise API (Coming Soon)이 엔드포인트는 Enterprise 버전에서 제공될 예정입니다. 현재는 v0 API를 사용하세요.
두 사람의 사주를 분석하여 궁합을 계산합니다. 연애, 결혼, 비즈니스 등 다양한 관계 유형에 대한 호환성을 분석합니다.
이 API는 현재 베타 버전입니다. 기능과 응답 형식이 변경될 수 있습니다.

Request Body 파라미터

person1 (필수)

person1.birth_year
integer
required
첫 번째 사람의 출생 연도입니다.
person1.birth_month
integer
required
첫 번째 사람의 출생 월입니다.
person1.birth_day
integer
required
첫 번째 사람의 출생 일입니다.
person1.birth_hour
integer
첫 번째 사람의 출생 시입니다.
person1.gender
string
required
첫 번째 사람의 성별입니다.

person2 (필수)

person2.birth_year
integer
required
두 번째 사람의 출생 연도입니다.
person2.birth_month
integer
required
두 번째 사람의 출생 월입니다.
person2.birth_day
integer
required
두 번째 사람의 출생 일입니다.
person2.birth_hour
integer
두 번째 사람의 출생 시입니다.
person2.gender
string
required
두 번째 사람의 성별입니다.

기타 파라미터

relationship_type
string
default:"romantic"
관계 유형입니다. romantic(연애/결혼), business(비즈니스), friendship(우정) 중 하나입니다.
model
string
default:"haiku"
AI 분석에 사용할 모델입니다.

Response

성공

궁합 계산에 성공하면 Compatibility 객체가 반환됩니다.

실패

상태 코드에러 타입설명
400validation_error요청 데이터가 유효하지 않음
401authentication_errorAPI 키가 유효하지 않음
429rate_limited요청 한도 초과
503service_unavailableAI 모델 서비스 일시 불가

요청 예시

curl -X POST https://api.sajuapi.dev/v1/calculations/compatibility \
  -H "X-API-Key: bs_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "person1": {
      "birth_year": 1990,
      "birth_month": 3,
      "birth_day": 15,
      "birth_hour": 14,
      "gender": "male"
    },
    "person2": {
      "birth_year": 1992,
      "birth_month": 7,
      "birth_day": 22,
      "birth_hour": 10,
      "gender": "female"
    },
    "relationship_type": "romantic",
    "model": "sonnet"
  }'

응답 예시

{
  "relationship_type": "romantic",
  "overall": {
    "score": 82,
    "rating": "excellent",
    "summary": "두 분의 궁합은 매우 좋습니다. 병화(丙火)와 임수(壬水)의 조합으로 서로를 보완하는 관계입니다."
  },
  "person1": {
    "day_master": "병화",
    "element": "fire",
    "characteristics": ["열정적", "리더십", "적극적"]
  },
  "person2": {
    "day_master": "임수",
    "element": "water",
    "characteristics": ["지혜로움", "유연함", "포용력"]
  },
  "element_interaction": {
    "type": "상극",
    "description": "화(火)와 수(水)는 상극 관계이지만, 적절한 균형을 이루면 서로를 제어하고 보완합니다.",
    "balance": "positive",
    "advice": "서로의 다름을 인정하고 존중하면 더욱 강한 유대를 형성할 수 있습니다."
  },
  "categories": {
    "emotional": {
      "score": 85,
      "description": "감정적으로 서로를 잘 이해합니다. 첫 번째 분의 열정을 두 번째 분이 차분하게 받아줍니다."
    },
    "communication": {
      "score": 78,
      "description": "의사소통 스타일이 다르지만, 노력하면 좋은 대화가 가능합니다."
    },
    "values": {
      "score": 80,
      "description": "핵심 가치관이 비슷합니다. 가정과 안정을 중시합니다."
    },
    "physical": {
      "score": 88,
      "description": "물리적 케미스트리가 좋습니다."
    },
    "growth": {
      "score": 82,
      "description": "함께 성장할 수 있는 관계입니다."
    }
  },
  "strengths": [
    "서로 부족한 부분을 보완합니다",
    "열정과 지혜가 조화를 이룹니다",
    "갈등 해결 능력이 있습니다",
    "장기적인 관계에 적합합니다"
  ],
  "challenges": [
    "의사소통 방식의 차이",
    "에너지 레벨의 차이로 인한 갈등 가능성",
    "서로 다른 표현 방식"
  ],
  "advice": {
    "for_person1": "상대방의 조용한 시간을 존중해주세요. 모든 것을 적극적으로 끌고 가려 하지 마세요.",
    "for_person2": "상대방의 열정에 좀 더 적극적으로 반응해주세요. 감정 표현을 조금 더 해주면 좋겠습니다.",
    "together": "서로의 다름을 인정하고, 정기적으로 깊은 대화 시간을 가지세요."
  },
  "lucky_elements": {
    "shared_colors": ["보라", "파랑"],
    "shared_numbers": [1, 6],
    "best_date_days": ["수요일", "토요일"]
  },
  "generated_at": "2025-01-16T09:00:00Z",
  "model": "sonnet",
  "latency_ms": 4200
}

Compatibility 객체

필드타입설명
relationship_typestring관계 유형입니다.
overallobject전체 궁합 점수와 요약입니다.
person1object첫 번째 사람의 사주 정보입니다.
person2object두 번째 사람의 사주 정보입니다.
element_interactionobject오행 상호작용 분석입니다.
categoriesobject카테고리별 호환성입니다.
strengthsarray관계의 강점입니다.
challengesarray관계의 도전 과제입니다.
adviceobject각자와 함께에 대한 조언입니다.
lucky_elementsobject함께 어울리는 행운 요소입니다.

궁합 등급

점수등급설명
90-100perfect천생연분
80-89excellent매우 좋음
70-79good좋음
60-69moderate보통
50-59challenging노력 필요
0-49difficult어려움
궁합 결과는 참고용입니다. 실제 관계의 성공은 두 사람의 노력과 소통에 달려있습니다.