Skip to main content
POST
연간 운세 계산
v1 Enterprise API (Coming Soon)이 엔드포인트는 Enterprise 버전에서 제공될 예정입니다. 현재는 v0 API를 사용하세요.
특정 연도의 운세를 계산합니다. 사주팔자와 해당 연도의 세운(歲運)을 분석하여 월별 상세 운세를 제공합니다.
이 API는 프로필 없이 일회성 계산을 수행합니다. 저장된 프로필을 사용하려면 운세 생성 API에서 fortune_type: "yearly"를 사용하세요.

Request Body 파라미터

integer
required
출생 연도입니다. 1900에서 2100 사이의 값이어야 합니다.
integer
required
출생 월입니다. 1에서 12 사이의 값이어야 합니다.
integer
required
출생 일입니다. 1에서 31 사이의 값이어야 합니다.
integer
출생 시입니다. 0에서 23 사이의 값이어야 합니다.
string
required
성별입니다. male 또는 female 중 하나입니다.
integer
required
운세를 계산할 대상 연도입니다. 1900에서 2100 사이의 값이어야 합니다.
string
default:"haiku"
AI 분석에 사용할 모델입니다. haiku, sonnet, gpt4o 중 하나입니다.

Response

성공

연간 운세 계산에 성공하면 YearlyFortune 객체가 반환됩니다.

실패


요청 예시


응답 예시


YearlyFortune 객체


연도 기운 상호작용