AI 운세 API

별자리와 선택적인 날짜를 주면, endpoint가 프롬프트를 만들고 우리 LLM gateway를 거쳐 language model에 전달해. 그 모델이 짧은 일일 운세를 써. response에는 생성된 운세 텍스트, 함께 표시할 disclaimer, 텍스트를 만든 model의 identifier, 그리고 output 언어가 들어가 - language parameter로 로컬라이즈되고, 생략하면 적절히 default돼. language model이 경로에 있기 때문에, 이 endpoint는 arithmetic와 ephemeris 라우트와 다르게 동작해: 보통 1~3초 정도 느리고, 텍스트는 재현 가능한 calculation이 아니라 새로 만든 guidance라서 동일 입력 두 번 호출하면 다른 문구의 읽기가 나올 수 있어. 주간, 월간, 연간 운세는 같은 gateway와 shape를 공유하는 sibling endpoint야.

curl -X POST https://api.astroway.info/v1/horoscope/daily \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "sign": "taurus",
  "date": "2026-06-15",
  "language": "en"
}'

{
  "ok": true,
  "data": {
    "horoscope": "Today favours steady progress…",
    "disclaimer": "For entertainment purposes…",
    "model": "gemini-2.5-flash",
    "language": "en"
  }
}

이걸 쓰는 경우는 직접 콘텐츠 파이프라인을 만들거나 유지하지 않고 바로 표시할 운세 복사본이 필요할 때야. 일일 콘텐츠에 딱 맞아 - push notifications, email digests, app home screens, widgets 등 - 별자리당 하루에 새로 만든 읽기가 제품이 돼. 반환된 disclaimer는 텍스트와 함께 항상 렌더링하고, 클라이언트에서 번역하지 말고 language parameter로 필요한 언어를 요청해. output이 non-deterministic이고 호출에 model latency가 들어가니까, 페이지 뷰마다 호출하지 말고 생성된 sign-and-date 읽기를 한 번 cache해. 그리고 one-to-three-second 응답 시간을 예산에 잡아. 더 긴 기간이면 weekly, monthly or yearly sibling endpoints로 바꿔.

이건 생성된 guidance이고 deterministic calculation이 아니야 - 동일 입력이 다른 문구의 텍스트를 만들 수 있고, response에 있는 disclaimer는 최종 사용자에게 보여줘야 해. model 필드에는 gateway가 선택한 모델 이름이 들어가는데, 시간에 따라 바뀔 수 있어. language model이 요청 경로에 있기 때문에 대략 1~3초 정도 latency가 예상돼; math endpoints는 훨씬 빠르게 응답해.