Skip to main content
POST
배치 운세 생성
v1 Enterprise API (Coming Soon)이 엔드포인트는 Enterprise 버전에서 제공될 예정입니다. 현재는 v0 API를 사용하세요.
여러 프로필의 운세를 한 번에 생성합니다. 최대 100개의 프로필에 대해 동시에 운세를 생성할 수 있습니다.
배치 요청은 비동기로 처리됩니다. 요청 즉시 batch_id가 반환되며, 완료 시 웹훅으로 알림을 받거나 상태를 폴링할 수 있습니다.

Request Body 파라미터

array
required
운세를 생성할 프로필 ID 배열입니다. 최소 1개, 최대 100개까지 지정할 수 있습니다.
string
required
운세 유형입니다. daily, yearly, monthly 중 하나입니다.
string
운세 날짜입니다. ISO 8601 형식(YYYY-MM-DD)입니다. 기본값은 오늘입니다.
string
default:"haiku"
사용할 AI 모델입니다. 배치 요청에서는 비용 효율성을 위해 haiku가 권장됩니다.
string
배치 완료 시 알림을 받을 웹훅 URL입니다. 설정하면 완료 시 POST 요청이 전송됩니다.

Response

성공

배치 요청이 접수되면 Batch 객체가 반환됩니다.

실패


요청 예시


응답 예시


Batch 객체


배치 상태 조회

배치 상태를 확인하려면 GET /v1/fortunes/batch/{batch_id}를 호출합니다.

완료된 배치 응답


웹훅 페이로드

배치 완료 시 설정된 webhook_url로 다음 페이로드가 전송됩니다.

사용 사례

매일 자정에 모든 사용자 운세 생성