---
title: Astrology Ziwei Api
emoji: 🔮
colorFrom: purple
colorTo: red
sdk: docker
pinned: false
license: mit
short_description: 紫微斗数API - Complete Purple Star Astrology Service
---

# 🔮 东玄 Ziwei Doushu API

**Professional Purple Star Astrology API** - Advanced Ziwei Doushu (紫微斗数) calculation and AI-powered analysis service.

**Powered by Sisi & TH Studio** - Next-generation fortune-telling system with AI interpretation.

---

## ✨ Features

- **完整紫微排盘** (Complete Ziwei Chart)
- **智能星曜分析** (AI-Powered Star Analysis)
- **宫位详解** (Palace Interpretation)
- **大限流年预测** (Major & Annual Fortune Prediction)
- **四化飞星系统** (Four Transformations System)
- **量化评分系统** (Quantified Scoring System)
- **AI命理解读** (AI Fortune Interpretation)
- **择日服务** (Lucky Day Selection)

---

## 🚀 Quick Start

### API Endpoints

#### 1. Health Check
```bash
GET /
```

#### 2. Calculate Ziwei Chart
```bash
POST /calculate-ziwei
Content-Type: application/json

{
  "birth_date": "2000-01-01",
  "birth_time": "14:30",
  "gender": "男",
  "is_leap_month": false
}
```

**Response:**
```json
{
  "status": "success",
  "data": {
    "solar_date": "2000-01-01 14:30",
    "lunar_date": "己卯年十一月廿五未时",
    "palaces": [...],
    "stars": [...],
    "major_cycles": [...],
    "four_transformations": {...}
  }
}
```

---

## 📚 API Documentation

Visit `/docs` for interactive API documentation (Swagger UI).

---

## 🔗 Related Projects

- **Website**: [astrologybazi.com](https://astrologybazi.com)
- **BaZi API**: [astrologybazi-api](https://huggingface.co/spaces/sisithefox/astrologybazi-api)

---

## 📄 License

MIT License

**Technical Note**: This API uses open-source libraries for astronomical calculations (iztro - MIT License). All analysis algorithms, AI interpretation engines, and business logic are proprietary to Sisi & TH Studio.

---

🦊 **Generated with Sisi & TH Studio** ✨