Ra mắt AstroWay API: toàn bộ ngăn xếp tính toán chiêm tinh với độ chính xác của Swiss Ephemeris

Hôm nay chúng tôi công bố AstroWay API — backend tính toán dành cho các nhà phát triển xây dựng ứng dụng chiêm tinh, sản phẩm tử vi, tính năng tương thích cho hẹn hò và các tác nhân AI cần suy luận về biểu đồ sinh.

Trong bài viết này, bạn sẽ tìm hiểu những gì thực sự có trong API, những giải pháp bất thường mà chúng tôi đã lựa chọn, những gì chúng tôi cố tình bỏ qua và cách chúng tôi đến được đây. Không lan man.

🕓 Bản ghi ngày 2026-04-22, cập nhật 2026-05-09. Một số con số đã lỗi thời. Tình trạng hiện tại: 723 endpoints (chứ không phải 87 vào thời điểm ra mắt), 818 bài kiểm tra CI snapshot (chứ không phải 183), MCP server @astroway/mcp + TypeScript SDK @astroway/sdk + Python SDK astroway + PHP SDK astroway/sdk hiện đã có trên các kho công khai. Tình trạng mới nhất tại /faq và changelog.

API REST dựa trên Swiss Ephemeris (LGPL), được biên dịch sang WASM và triển khai dưới dạng dịch vụ Node.js — giờ đây còn có thêm các giải thích bằng AI (chuỗi dự phòng GPT-4 / Claude / Llama 3.3 / Gemini / DeepSeek / Mistral) phía trên các phép tính thực tế. Động cơ tương tự mà các nhà chiêm tinh chuyên nghiệp đã sử dụng trong hơn 30 năm qua trên Solar Fire, Kepler, Astro Gold và Janus — độ chính xác đến từng giây cung, được đối chiếu với dữ liệu lịch thiên văn NASA JPL và tham chiếu swetest chính thức từ Astrodienst (Astro.com).

Số liệu:

• 723 endpoints — chiêm tinh phương Tây (natal), synastry, transit, tiến triển, hướng dẫn, hồi quy, hài hòa, ngôi sao cố định, điểm Ả Rập, bản đồ thiên văn cộng với toàn bộ Human Design
• 183 bài kiểm tra snapshot trong CI so với đầu ra thực tế từ swetest CGI và danh mục nhật thực của NASA — chạy trên mọi PR
• p50 < 100 ms, p95 < 500 ms cho các endpoints tính toán điển hình
• MCP server @astroway/mcp + ba SDK trên các kho công khai: @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) — cùng một API bằng ba ngôn ngữ
• MCP server: @astroway/mcp — cung cấp API dưới dạng các công cụ (tools) cho Claude, GPT, Cursor và các tác nhân LLM khác
• Bảng giá dựa trên tín dụng: gói miễn phí (10.000 tín dụng / tháng, không cần thẻ), gói trả phí — từ $5 / tháng

Tài liệu đầy đủ: api.astroway.info/docs/api/. Tình trạng trực tuyến: api.astroway.info/status.

Ba năm trước, chúng tôi bắt đầu xây dựng các ứng dụng chiêm tinh dành cho người tiêu dùng. Lớp tính toán hóa ra là phần phức tạp nhất — thậm chí còn phức tạp hơn UI hay nội dung. Các dịch vụ hiện có thường:

1. Có phạm vi bao phủ nông (10–30 endpoints, chủ yếu chỉ natal)
2. Đắt đỏ khi mở rộng ($0,02–$0,10 mỗi yêu cầu mà không có chiết khấu theo khối)
3. Sử dụng động cơ đóng, độ chính xác không thể kiểm chứng
4. Tập trung vào chiêm tinh Vệ Đà, coi phương Tây là thứ yếu

Vì vậy, chúng tôi đã tự tích hợp Swiss Ephemeris và xây dựng lớp tính toán của riêng mình — ban đầu cho sản phẩm người tiêu dùng app.astroway.info, sau đó cho trang marketing astroway.info cung cấp tử vi hàng ngày cho hàng trăm nghìn lượt truy cập mỗi tháng.

Sau ba năm vận hành mã này trong sản xuất, chúng tôi rút ra hai kết luận:

1. Chính động cơ tính toán này phải được cung cấp cho các nhà phát triển khác — không phải vì họ không thể tự viết, mà vì ngăn xếp thư viện + WASM + caching + CI cho độ chính xác mất nửa năm làm việc, không ai nên phải lặp lại.
2. Phủ sóng Human Design của chúng tôi (12 endpoints — bản đồ, loại hình, thẩm quyền, hồ sơ, cổng, kênh, mạch, kích hoạt hành tinh, thập tự nhập thế, định nghĩa) thực sự là độc nhất. Không đối thủ nào cung cấp toàn bộ Human Design qua API.

Đó chính là sự ra mắt.

Chúng tôi có /nakshatras, /ashtakavarga và các endpoints cho bản đồ phân chia, nhưng không có Dasha, Panchang, Ashtakoota, KP. Lý do: trong chiêm tinh Vệ Đà tồn tại những bất đồng chưa được giải quyết giữa các trường phái (chiến tranh giữa ayanamsa, tranh cãi về cusp KP, lựa chọn trường phái dash). Một phần Vệ Đà được xây dựng vội vàng so với Prokerala hay VedicAstroAPI chắc chắn sẽ bị chỉ trích.

Quyết định đã được đưa ra: gói Vệ Đà sẽ là giai đoạn 3, sau khi nhu cầu phương Tây ổn định và có thời gian để xác thực so với Jagannatha Hora và Parashara’s Light. Tốt hơn là không tung ra chứ không phải tung ra kém.

Một cuộc gọi /chart tốn khoảng 1/50 lượng tính toán so với /forecast-calendar 365 ngày. Giá cố định mỗi yêu cầu sẽ loại bỏ người dùng nhẹ hoặc trợ cấp cho người dùng nặng. Tín dụng ánh xạ chi phí với khối lượng công việc thực tế — xem bảng giá endpoints tại trang giá.

Phản hồi trên gói miễn phí chứa trường _footer:

{
  "data": { ... },
  "_footer": "Powered by astroway.api — get your own key at api.astroway.info"
}

Việc này không tốn kém gì chúng tôi, nhưng cung cấp cho người dùng miễn phí một lý do nhỏ để nâng cấp. Trên gói Hobby+, trường này bị loại bỏ trong cài đặt khóa. Mẫu này được lấy cảm hứng từ Zapier và RevenueCat.

/rectification (tìm thời gian sinh dựa trên các sự kiện cuộc đời thông qua lưới khả năng) rất tốn tài nguyên: một cuộc gọi mất 10–60 giây và thực hiện hàng chục nghìn phép tính trung gian Swiss Ephemeris. Chúng tôi giới hạn nó ở gói Pro ($59 / tháng) và đặt giá tín dụng cao vì lạm dụng sẽ ảnh hưởng đến cơ sở hạ tầng chung cho tất cả mọi người.

Các endpoints /interpret/* được định tuyến qua cổng AI riêng tư của chúng tôi, hoạt động trên các mô hình tốt nhất thị trường (Google Gemini → Groq → OpenRouter → Cerebras → SambaNova → Mistral) với cơ chế chuyển đổi dự phòng tự động. Chúng tôi không khóa bạn vào các prompt của mình — mỗi phản hồi giải thích đều chứa các phép tính đầu vào, vì vậy bạn có thể thay đổi LLM của mình nếu giọng điệu của chúng tôi không phù hợp. Toàn bộ prompt và đầu ra được ghi vào bảng audit cho mục đích tuân thủ B2B (lưu trữ 90 ngày).

• Gói Vệ Đà — giai đoạn 3, sau khi xác nhận nhu cầu ban đầu (xem trên)
• Webhook cho ngưỡng — đã triển khai nhưng giao diện thô; đang hoàn thiện
• Tiện ích công khai (<script src="api.astroway.info/widget/natal.js">) — giai đoạn 7
• Plugin cho trang marketing chính — dự án riêng, dự kiến trong hệ sinh thái astroway.info

1. Đọc tài liệu nếu bạn muốn hiểu “tại sao”: api.astroway.info/overview
2. Bắt đầu nhanh trong 5 phút với mã: Astrology API Quick Start
3. Bảng giá, bao gồm bảng tín dụng cho từng endpoint: api.astroway.info/pricing
4. Đăng ký — miễn phí, không cần thẻ: api.astroway.info/dashboard/sign-up

Nếu bạn xây dựng thứ gì đó trên API — hoặc gặp lỗi, hoặc muốn một endpoint mà chúng tôi chưa có — hãy nói với chúng tôi. Chúng tôi thích nghe từ 100 nhà phát triển đang yêu cầu tính năng hơn là tung ra những thứ mà chẳng ai dùng đến.

Câu hỏi, yêu cầu, trường hợp edge kỳ lạ: hello@astroway.info.

Roadmap công khai — PRODUCT-PLAN.md — những gì đã hoàn thành, sắp tới, bị trì hoãn và lý do.

Chào mừng bạn.