Skip to main content
POST
운세 생성
v1 Enterprise API (Coming Soon)이 엔드포인트는 Enterprise 버전에서 제공될 예정입니다. 현재는 v0 API를 사용하세요.
프로필 정보를 기반으로 운세를 생성합니다. 생성된 운세는 자동으로 저장되며, 동일한 조건으로 재요청 시 캐시된 결과가 반환됩니다.
운세 생성에는 AI 모델이 사용되며, 응답 시간은 선택한 모델에 따라 다릅니다. 실시간 응답이 필요한 경우 스트리밍 API를 사용하세요.

Request Body 파라미터

string
required
운세를 생성할 프로필의 ID입니다. prf_ 접두사로 시작합니다.
string
required
운세 유형입니다. daily, yearly, monthly 중 하나입니다.
string
운세 날짜입니다. ISO 8601 형식(YYYY-MM-DD)입니다. 기본값은 오늘입니다.
string
default:"haiku"
사용할 AI 모델입니다. haiku, sonnet, gpt4o 중 하나입니다.
  • haiku: 빠른 응답, 경제적 (기본값)
  • sonnet: 상세한 분석, 중간 비용
  • gpt4o: 최고 품질, 높은 비용
boolean
default:"true"
행운의 아이템(숫자, 색상, 방향 등)을 포함할지 여부입니다.
string
멱등성 키입니다. 동일한 키로 재요청 시 동일한 결과가 반환됩니다. 최대 64자입니다.

Response

성공

운세 생성에 성공하면 Fortune 객체가 반환됩니다.

실패


요청 예시


응답 예시


Fortune 객체


캐싱

동일한 profile_id, fortune_type, fortune_date, model 조합으로 요청하면 캐시된 결과가 반환됩니다. 캐시된 응답은 cached: true로 표시되며, latency_ms가 크게 줄어듭니다.