Tóm tắt AI

Mỗi lần tính toán đều trả về hàng chục đoạn văn bản luận giải. Bản tóm tắt AI biến những đoạn quan trọng nhất thành vài câu về ý nghĩa thực sự của lá số đối với người đó — hoặc, với synastry và composite, đối với hai người khi ở bên nhau.

Bản tóm tắt không được tạo trong lúc tính toán. Kết quả tính toán trả về một liên kết đã ký, và chỉ khi bạn mở liên kết đó thì mô hình mới chạy.

Mô-đun bắt buộc

Cần mô-đun ai:summary, có trong các gói Premium và Deluxe. Mô-đun này không bán riêng.

Bạn cũng cần văn bản luận giải của loại lá số mà bạn muốn tóm tắt (ví dụ natal:texts) — không có văn bản thì không có gì để tóm tắt.

Cách hoạt động

1. Bạn gọi một endpoint tính toán như bình thường.
2. Phản hồi có một đối tượng summary chứa URL đã ký.
3. Bạn mở URL đó khi — và chỉ khi — bạn muốn bản tóm tắt.

Ở bước 1 và 2 không có gì được tính, lưu hay tính phí. Đây là chủ ý: một lệnh gọi lá số không nên phải trả tiền cho tính năng mà phần lớn người dùng không bao giờ dùng đến.

Liên kết tóm tắt

{
    "data": {
        "points": { "...": "..." },
        "aspects": [],
        "chart": { "url": "https://api.astroapi.cloud/api/chart2/natal.svg?..." },
        "summary": {
            "url": "https://api.astroapi.cloud/api/calc/natal/summary?t=eyJ0Ijoi...&expires=1793000000&sig=Ab3...",
            "method": "GET",
            "cost": 10,
            "expiresAt": "2026-08-30T10:00:00Z"
        }
    }
}

Trường	Mô tả
url	URL đã ký trả về bản tóm tắt. Nó mang theo toàn bộ yêu cầu nên không cần body.
method	Luôn là GET.
cost	Số request API bị tính khi bản tóm tắt được tạo. Bản tóm tắt lấy từ cache tính là 1.
expiresAt	Liên kết dùng được trong 7 ngày. Chạy lại phép tính để có liên kết mới.

Đối tượng summary chỉ xuất hiện nếu gói đăng ký của bạn có mô-đun này. Nếu không thấy, hãy kiểm tra gói của bạn.

Hãy lưu liên kết, không chỉ lá số

Liên kết hết hạn sau 7 ngày và được ký cho đúng một lá số. Không thể chỉnh sửa: thay đổi dữ liệu sinh, loại lá số hay tổ chức trong URL sẽ làm chữ ký mất hiệu lực.

Lấy bản tóm tắt

curl "https://api.astroapi.cloud/api/calc/natal/summary?t=eyJ0Ijoi...&expires=1793000000&sig=Ab3..." \
  -H "X-Api-Key: your-api-key"

Nhờ chữ ký, khóa API là tùy chọn, nên liên kết cũng hoạt động từ trình duyệt hoặc từ một thành phần nhúng không thể đặt header. Nếu bạn có gửi khóa, khóa đó phải thuộc đúng tổ chức mà liên kết được cấp cho.

Việc này mất một chút thời gian

Tạo bản tóm tắt sẽ chạy lại phép tính, lấy các văn bản và gọi một mô hình ngôn ngữ. Hãy chờ vài giây. Bản tóm tắt đã tạo trước đó sẽ trả về ngay lập tức.

Phản hồi

{
    "data": {
        "horoscopeType": "natal",
        "language": "vi",
        "summary": "Bạn khởi đầu từ sự hiện diện chứ không phải từ sự thận trọng: Mặt Trời ở Sư Tử trong nhà 10 đặt công việc và danh tiếng vào trung tâm cách bạn hiểu về chính mình…",
        "cached": false,
        "generatedAt": "2026-08-23T10:15:22Z",
        "model": "@cf/qwen/qwen3-30b-a3b-fp8",
        "highlights": [
            { "kind": "point", "label": "Sun in Leo in house 10" },
            { "kind": "point", "label": "Moon in Taurus in house 7" },
            { "kind": "aspect", "label": "Sun square Saturn (orb 0.4°)" }
        ]
    }
}

Trường	Mô tả
summary	Văn bản được tạo, 4 đến 6 câu.
cached	true khi lấy từ cache. Bản tóm tắt từ cache tính là 1 request thay vì 10.
highlights	Các vị trí mà bản tóm tắt dựa vào, mạnh nhất trước.
model	Mô hình đã viết văn bản.

Các loại lá số được hỗ trợ

Loại	Endpoint	Bản tóm tắt nói về
natal	/api/calc/natal/summary	Người này là ai
synastry	/api/calc/synastry/summary	Hai người tác động lên nhau thế nào
composite	/api/calc/composite/summary	Mối quan hệ mà hai người tạo nên
transit	/api/calc/transit/summary	Giai đoạn sắp tới
solar	/api/calc/solar-return/summary	Năm sắp tới
lunar	/api/calc/lunar-return/summary	Tháng sắp tới
progressions	/api/calc/progressions/summary	Giai đoạn cuộc đời mà người này đang ở

Những gì đi vào bản tóm tắt

Một lá số sinh đầy đủ tạo ra hơn 40 đoạn luận giải. Đưa hết cho mô hình sẽ cho ra một danh sách chứ không phải một bài đọc — và tốn kém hơn nhiều. Thay vào đó, các vị trí được chấm điểm và chỉ những vị trí mạnh nhất được giữ lại:

• Vị trí — hai ánh sáng và Ascendant nặng ký nhất, sau đó là chủ tinh của lá số, các hành tinh cá nhân và mọi thứ nằm trong nhà góc.
• Góc chiếu — chấm điểm theo độ chính xác (orb hẹp đến đâu so với mức tối đa của góc chiếu đó), theo mức độ "chính" của góc chiếu, và theo mức độ cá nhân của hai đầu. Một góc vuông Mặt Trời–Thổ Tinh chính xác vượt xa một góc lục hợp Hải Vương–Diêm Vương rộng.
• Synastry chỉ giữ các góc chiếu chéo, theo cả hai chiều, có ghi rõ hành tinh của ai tác động lên lá số của ai.
• Transit còn bao gồm các nhà mà hành tinh transit đang đi qua.

Việc chấm điểm mang tính tất định: cùng một lá số luôn cho cùng một lựa chọn, và đó chính là điều khiến kết quả có thể lưu cache.

Mô hình chỉ được dùng các văn bản được cung cấp. Nó không bịa ra vị trí, ngày tháng hay lời khuyên — nên bản tóm tắt phản ánh chính các văn bản luận giải của bạn, kể cả những đoạn bạn tự chỉnh sửa bằng Content Editor.

Ngôn ngữ

Bản tóm tắt được viết bằng ngôn ngữ của phép tính. Hãy truyền language trong yêu cầu tính toán; liên kết sẽ mang theo giá trị đó:

curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "location": { "longitude": 4.89, "latitude": 52.37, "timezone": "Europe/Amsterdam" },
    "language": "vi",
    "includeText": true
  }'

Các văn bản luận giải đã được bản địa hóa, và mô hình được yêu cầu viết bằng cùng ngôn ngữ đó.

Chi phí

Tình huống	Request API
Phép tính có liên kết tóm tắt trong phản hồi	1 (không đổi)
Mở liên kết, bản tóm tắt được tạo	10
Mở liên kết, bản tóm tắt đã có trong cache	1
Yêu cầu thất bại (403, 422, liên kết hết hạn)	0

Bản tóm tắt đã tạo được cache 30 ngày theo từng lá số, ngôn ngữ và phiên bản prompt, nên mở lại cùng một liên kết rất rẻ.

Các header phản hồi X-Quota-Limit, X-Quota-Remaining và X-Quota-Reset phản ánh chi phí có trọng số, báo cáo sử dụng trong bảng điều khiển cũng vậy.

Lỗi

Trạng thái	Ý nghĩa
400	Liên kết sai định dạng hoặc token không thuộc loại lá số này.
401	Chữ ký không hợp lệ hoặc liên kết đã hết hạn.
403	Gói đăng ký thiếu ai:summary hoặc văn bản luận giải của loại này, hoặc liên kết thuộc về tổ chức khác.
409	Một bản tóm tắt cho lá số này đang được tạo. Hãy thử lại sau vài giây — điều này giúp bạn không trả tiền hai lần cho cùng một văn bản.
422	Không có văn bản luận giải nào cho lá số này, nên không có gì để tóm tắt.

Bước tiếp theo

• Nội dung & luận giải — các văn bản làm nền cho bản tóm tắt
• Mô-đun — gói của bạn gồm những gì
• Giới hạn tần suất — hạn mức và request có trọng số