# API tử vi và giải thích AI

10 điểm cuối AI — một phần của hơn 700 điểm cuối trên toàn bộ nền tảng AstroWay (16 danh mục). 5 điểm dành cho horoscope (hàng ngày, hàng tuần, hàng tháng, hàng năm, tương thích) và 5 điểm dành cho diễn giải (natal, synastry, transit, nguyên tố, vị trí). Tất cả đều dựa trên các tính toán thực tế từ Swiss Ephemeris (cùng hệ thống được sử dụng trong Solar Fire và Astrodienst) — không phải từ các mẫu có sẵn hay ảo giác từ LLM thuần túy.

## Cách hoạt động

1. API tính toán bản đồ chiêm tinh thực tế (transit, natal, synastry) thông qua Swiss Ephemeris
2. Kết quả được truyền đến cổng AI của chúng tôi, tích hợp các mô hình hàng đầu trên thị trường (Google Gemini → Groq Llama 3.3 → OpenRouter với GPT-4 / Claude / DeepSeek → Cerebras → SambaNova → Mistral) kèm theo prompt hệ thống chuyên biệt về chiêm tinh và cơ chế chuyển đổi dự phòng (failover) tự động
3. LLM tạo ra văn bản với các biện pháp bảo vệ an toàn tích hợp (cấm tư vấn y tế/pháp lý/tài chính)
4. Phản hồi bao gồm tuyên bố miễn trách (disclaimer) và nhật ký kiểm toán (audit trail)

<Aside type="tip">
Các điểm cuối AI trả về cả kết quả tính toán lẫn văn bản. Bạn có thể chỉ sử dụng kết quả tính toán (các điểm cuối rẻ hơn) và tự tạo văn bản bằng LLM của riêng mình.
</Aside>

## Các điểm cuối — Horoscope

| Điểm cuối | Tín dụng | Nội dung được tạo |
|---|---|---|
| `/v1/horoscope/daily` | 20 | Horoscope hàng ngày dựa trên transit hiện tại |
| `/v1/horoscope/weekly` | 20 | Tổng quan hàng tuần |
| `/v1/horoscope/monthly` | 20 | Dự báo hàng tháng |
| `/v1/horoscope/yearly` | 50 | Dự báo hàng năm |
| `/v1/horoscope/compatibility` | 50 | Phân tích tương thích dưới dạng văn bản |

## Các điểm cuối — Diễn giải

| Điểm cuối | Tín dụng | Nội dung diễn giải |
|---|---|---|
| `/v1/interpret/natal` | 50 | Diễn giải đầy đủ cho bản đồ natal |
| `/v1/interpret/synastry` | 50 | Diễn giải cho synastry |
| `/v1/interpret/transits` | 50 | Diễn giải cho transit hiện tại |
| `/v1/interpret/element` | 20 | Diễn giải cho một nguyên tố riêng biệt (hành tinh trong cung, khía cạnh) |
| `/v1/interpret/placement` | 20 | Diễn giải vị trí (hành tinh trong nhà) |

## Ví dụ

<Tabs>
  <TabItem label="cURL">
    ```bash frame="terminal"
    curl -X POST https://api.astroway.info/v1/horoscope/daily \
      -H "X-Api-Key: aw_live_your_key_here" \
      -H "Content-Type: application/json" \
      -d '{
        "date": "1990-07-14",
        "time": "14:30:00",
        "timezoneOffset": 3,
        "latitude": 50.4501,
        "longitude": 30.5234
      }'
    ```
  </TabItem>
  <TabItem label="Node.js">
    ```ts
    const r = await fetch('https://api.astroway.info/v1/horoscope/daily', {
      method: 'POST',
      headers: {
        'X-Api-Key': process.env.ASTROWAY_API_KEY!,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        date: '1990-07-14',
        time: '14:30:00',
        timezoneOffset: 3,
        latitude: 50.4501,
        longitude: 30.5234,
      }),
    });
    const { data: horoscope } = await r.json();
    console.log(horoscope.text);
    ```
  </TabItem>
  <TabItem label="Python">
    ```python

    r = requests.post(
        'https://api.astroway.info/v1/horoscope/daily',
        headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'},
        json={
            'date': '1990-07-14',
            'time': '14:30:00',
            'timezoneOffset': 3,
            'latitude': 50.4501,
            'longitude': 30.5234,
        },
    )
    horoscope = r.json()['data']
    print(horoscope['text'])
    ```
  </TabItem>
  <TabItem label="PHP">
    ```php
    <?php
    use GuzzleHttp\Client;

    $aw = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
    $r = $aw->post('horoscope/daily', [
        'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
        'json' => [
            'date' => '1990-07-14',
            'time' => '14:30:00',
            'timezoneOffset' => 3,
            'latitude' => 50.4501,
            'longitude' => 30.5234,
        ],
    ]);
    $horoscope = json_decode($r->getBody(), true)['data'];
    echo $horoscope['text'];
    ```
  </TabItem>
</Tabs>

## Các biện pháp bảo vệ an toàn

Tất cả các điểm cuối AI đều có các biện pháp bảo vệ tích hợp:

- **Prompt hệ thống** cấm rõ ràng tư vấn y tế, pháp lý và tài chính
- **Tuyên bố miễn trách (disclaimer) tự động** trong mỗi phản hồi
- **Bộ lọc nội dung** — lọc hậu kỳ dựa trên từ khóa
- **Nhật ký kiểm toán (audit trail)** — ghi lại prompt và phản hồi (lưu trữ 90 ngày)
- **`disclaimer_inline: true`** — tham số dành cho doanh nghiệp muốn nhận văn bản đã bao gồm disclaimer

<Aside type="caution">
Các diễn giải AI nhằm mục đích giải trí. Chúng không thay thế lời khuyên từ chuyên gia chiêm tinh, bác sĩ, luật sư hoặc cố vấn tài chính chuyên nghiệp.
</Aside>

## Ai đang sử dụng

- **Nền tảng nội dung** — horoscope hàng ngày cho khán giả
- **Ứng dụng chiêm tinh** — diễn giải cá nhân hóa thay vì văn bản chung chung
- **AI agents** — thông qua máy chủ MCP hoặc gọi API trực tiếp
- **Phương tiện truyền thông** — tạo nội dung chiêm tinh dựa trên dữ liệu thực tế

## Chi phí

Horoscope hàng ngày — **20 tín dụng**. Diễn giải đầy đủ cho bản đồ natal — **50 tín dụng**. Ở gói Free, bạn có 250 horoscope hàng ngày hoặc 100 diễn giải mỗi tháng.

<CardGrid>
  <LinkCard title="Bắt đầu nhanh chóng →" href="/getting-started/" description="Yêu cầu đầu tiên trong 5 phút" />
  <LinkCard title="AI agents & MCP" href="/use-cases/ai-agents/" description="Tích hợp với Claude, ChatGPT" />
  <LinkCard title="Bảng giá" href="/pricing/" description="Từ miễn phí đến doanh nghiệp" />
</CardGrid>