Tài liệu dành cho nhà phát triển Docs
Sử dụng sức mạnh tính toán toàn cầu giống như bất kỳ API đám mây hiện đại nào. Trang web này là phiên bản beta công khai trước và tài liệu chính thức dành cho nhà phát triển sẽ được phát hành cùng với phiên bản beta công khai toàn cầu và sẽ được cập nhật liên tục.
01bắt đầu nhanh
Hoàn thành nhiệm vụ đầu tiên trong ba bước
- Đăng ký và kích hoạt: Đăng ký tài khoản beta công khai qua email; mở khóa đầy đủ các chức năng và bằng cấp khuyến khích beta công khai sau KYC. Không cần thanh toán trước, thanh toán tùy theo khối lượng.
- Chọn phương thức truy cập: Lựa chọn bảng điều khiển/Định tuyến tự động API/gửi hàng loạt CLI, chọn một trong ba phương pháp.
- Triển khai và giám sát: Xem mức năng lực tính toán, chi tiết chi phí và báo cáo nghiệm thu trong thời gian thực; nhiệm vụ đào tạo hỗ trợ khả năng chịu lỗi điểm kiểm tra.
# 提交一个 LoRA 微调任务(接口形态示意,以正式文档为准)
curl https://api.a12.network/v1/jobs -H "Authorization: Bearer $A12_API_KEY" -d '{
"type": "lora-finetune",
"base_model": "llama-3.1-8b",
"dataset": "s3://my-bucket/finetune.jsonl",
"auto_tier": true # Công cụ lập lịch tự động chọn mức chi phí tối ưu
}'
base_url 改为 A12 端点即可迁移,SDK 兼容。02Loại phiên bản
A12 cung cấp ba loại phiên bản và mức chênh lệch giá dựa trên các tiêu chuẩn hiện hành trong thị trường đám mây GPU phổ thông:
| kiểu | giá | sự ưu tiên | Áp dụng |
|---|---|---|---|
| Theo yêu cầu | Giá tiêu chuẩn (xem thư mục GPU) | Cao nhất | Tải sản xuất, dịch vụ trực tuyến, bất kỳ nhiệm vụ nào không thể bị gián đoạn |
| Có thể ngắt trước | ≈Giá chuẩn × 50% | Thấp | Xử lý hàng loạt, hiển thị, quét tham số, v.v. có thể làm gián đoạn quá trình tải; nó có thể bị đình chỉ bởi các nhiệm vụ chất lượng cao |
| Kín đáo | Cao nhất −50% | cao | Một nhóm có mức sử dụng ổn định hàng tháng; Thời gian sử dụng cam kết được hưởng chiết khấu, không yêu cầu hợp đồng dài hạn 1-3 |
03Chi tiết thanh toán
Tất cả các quy tắc đều được tiết lộ trước, không có chi phí ẩn:
- Tính phí vào thứ hai: Các nhiệm vụ được giải quyết trong vài giây thực tế từ khi bắt đầu đến khi kết thúc, đếm số lượng được sử dụng.
- tính toán GPU: Giá được tính dựa trên số giờ sử dụng thẻ và giá dao động theo cấp (Cấp S/A/B) và loại phiên bản; mức giảm giá sâu hơn trong thời gian nhàn rỗi.
- kho: 0,10 USD/GB/tháng, việc thanh toán sẽ dừng khi phiên bản bị xóa. Nếu phiên bản bị tắt và phiên bản không bị xóa, việc tính phí dung lượng sẽ tiếp tục.
- băng thông: Thông báo tốc độ nút, thanh toán hai chiều, hiển thị trước khi chọn thẻ; đối với các tải sử dụng nhiều dữ liệu, trước tiên hãy ước tính tổng chi phí băng thông.
- Quy tắc cân bằng: Khi số dư trở về 0, phiên bản sẽ bị tắt trước tiên và dữ liệu sẽ được giữ lại. 72 giờ, số dư có thể được phục hồi bằng cách bù đắp số dư trong kỳ; quá trình xóa sẽ được thực hiện sau khi hết thời gian chờ.
- Tải chỉ dành cho CPU: 0,005 USD/vCPU·giờ + 0,001 USD/GB, thích hợp để chuyển mã, xử lý hàng loạt, thu thập thông tin và các tải không phải GPU khác.
- Đồng tiền thanh toán: Định giá và thanh toán tiền tệ Fiat/USDT (tiền tệ ổn định), người thuê không bị buộc phải giữ Token nền tảng.
04Lưu trữ và băng thông
| dự án | Tỷ lệ | minh họa |
|---|---|---|
| Lưu trữ phiên bản (Đĩa chứa) | 0,10 USD/GB/tháng | Việc thanh toán tiếp tục trong khi phiên bản đang chạy và dừng và sẽ dừng khi phiên bản bị xóa. |
| Lưu trữ đối tượng (tập dữ liệu/mô hình) | 0,10 USD/GB/tháng | Giá mục tiêu trong giai đoạn beta công khai sẽ được công bố cùng với phiên bản beta công khai. |
| Băng thông đầu ra | Thông báo giá theo nút | Có sự khác biệt lớn giữa các nút khác nhau, có thể thấy trên bảng điều khiển trước khi chọn thẻ. |
| Băng thông vào | Thông báo giá theo nút | Thanh toán hai chiều |
Cách thực hành tốt nhất: Đặt tập dữ liệu và mô hình vào bộ lưu trữ đối tượng, đồng thời chia sẻ các lần đọc giữa nhiều tác vụ để tránh tính phí lưu trữ lặp lại cho từng phiên bản.
05Bắt đầu với API
API hoàn toàn tương thích với biểu mẫu OpenAI SDK và có ba lối vào:
# 1) 查询可用算力与实时价
curl https://api.a12.network/v1/offers -H "Authorization: Bearer $A12_API_KEY"
# 2) 提交任务(自动路由最优层级)
curl https://api.a12.network/v1/jobs -H "Authorization: Bearer $A12_API_KEY" -d '{...}'
# 3) OpenAI 兼容推理端点
client = OpenAI(base_url="https://api.a12.network/v1", api_key=os.environ["A12_API_KEY"])
máy trạng thái nhiệm vụ
QUEUED → SCHEDULED → RUNNING → [CHECKPOINT…] → DONE / FAILED / INTERRUPTED
↑__________________ 自动重试(可抢占任务) ______________|
Bạn muốn thử trực tiếp? Mở Trung tâm tương tác API →——在浏览器里构造请求、查看模拟响应、复制 curl / Python / Node 示例。
06Khắc phục sự cố
| triệu chứng | Lý do có thể | đối phó với |
|---|---|---|
| Nhiệm vụ đã được xếp hàng | Nguồn cung của tầng đã chọn eo hẹp/giá trần quá thấp | Bật auto_tier hoặc tăng giới hạn giá |
| Nhiệm vụ ưu tiên đã bị gián đoạn | Nhiệm vụ có mức độ ưu tiên cao chiếm các nút | Cơ chế bình thường; thử lại tự động mà không mất thêm chi phí |
| Khởi động nguội chậm | Hình ảnh vùng chứa quá lớn | Sử dụng các mẫu cài sẵn hoặc hình ảnh mỏng |
| Phiên bản dừng đột ngột | Đặt lại số dư về 0 (dữ liệu được giữ lại trong 72h) | Khôi phục bằng cách nạp tiền vào số dư của bạn |
| Phí băng thông bất thường | Kéo tập dữ liệu lặp đi lặp lại | Thay vào đó, hãy sử dụng các lần đọc được chia sẻ trong bộ nhớ đối tượng |
Chưa được giải quyết?Gửi lệnh làm việcTrong giai đoạn beta công khai, các kỹ sư cốt lõi ở lại Discord để trả lời các câu hỏi.
07Danh sách phần cứng công nhân
Phần cứng kết nối với mạng A12 được chia thành bốn cấp độ tùy theo khả năng. Sau đây là ngưỡng đầu vào và đặc điểm thu nhập của từng Cấp:
| Hệ thống phân cấp | Thiết bị điển hình | Yêu cầu tối thiểu | Đặc điểm doanh thu |
|---|---|---|---|
| Tập trung cấp S | Máy chủ GPU trung tâm dữ liệu (Cụm H100/A100) | Phòng máy tính cấp tổ chức / Mạng công cộng ổn định / Cam kết trực tuyến 99,9% | Đơn giá cao nhất; cung cấp độc quyền cho tải có độ nhạy cao |
| Chuyên gia cấp A | Máy trạm chuyên nghiệp (L40S/A6000/5090) | Đồ họa độc lập ≥24GB / CPU 4 nhân / RAM 16GB / băng thông rộng ổn định | Lý luận và điều chỉnh nguồn cung chính |
| Cấp tiêu dùng cấp B | PC chơi game/thiết kế (RTX 4090, v.v.) | Đồ họa độc lập ≥8GB / CPU 4 nhân / RAM 12GB | Nhiệm vụ đo lường; LoRA / xử lý hàng loạt |
| Cạnh cấp C | Máy tính xách tay chơi game/thiết bị nhẹ | Bất kỳ đồ họa lõi/đồ họa rời hiện đại nào (tác vụ CPU) | Xử lý hàng loạt nhẹ + khối lượng công việc chỉ dành cho CPU |
Yêu cầu chung cho mọi cấp độ
- Thời lượng trực tuyến và tỷ lệ chiếm dụng nhiệm vụ ảnh hưởng đến mức độ ưu tiên lập kế hoạch (danh tiếng lịch sử L5)
- Chỉ chấp nhận đơn đặt hàng sau khi vượt qua năm lớp xác minh (xác minh khai báo → đo lường năng lực → đo từ xa thời gian chạy → xác minh nhiệm vụ → danh tiếng lịch sử)
- Hỗ trợ Windows/Linux; thực thi được đóng gói, vô hình với hệ thống tệp máy chủ
08Đảm bảo thu nhập dài hạn cho người lao động
Kinh tế bên cung được tiết lộ đầy đủ - bạn kiếm được bao nhiêu, nền tảng chia bao nhiêu và các quy tắc thay đổi như thế nào, tất cả đều được nêu rõ:
chia thành các cấu trúc
- Giai đoạn beta công khai: Công nhân được chia thành 80%---Tỷ lệ hào phóng nhất trong số các nền tảng chính trên toàn mạng (so sánh: các nền tảng cấp độ người tiêu dùng phổ thông có hoa hồng ngầm khoảng 50%).
- Lộ trình từng bước (báo trước 30 ngày): Sau khi mạng ổn định nguồn cung, nó sẽ được điều chỉnh thành 75%, giai đoạn trưởng thành quy mô lớn 70%---Chia sẻ doanh thu lưu trữ/băng thông và bổ sung tải chỉ dành cho CPU được triển khai cùng lúc. Mục tiêu thiết kế là tổng doanh thu của công nhân sẽ không giảm do điều chỉnh bậc thang.
Cam kết minh bạch về thu nhập (tham chiếu đến các tiêu chuẩn cao nhất về tính minh bạch của ngành)
- Được phát hành 30 ngày sau phiên bản beta công khai"Báo cáo thu nhập thực tế hàng tuần của người lao động": Công bố doanh thu trung bình thực tế, hầu hết các phạm vi máy, lượng tử hàng đầu và tỷ lệ lấp đầy nhiệm vụ theo mô hình GPU, cùng với mô tả về tầm cỡ thống kê.
- Giải quyết và đi Đã kiếm được → Đang chờ xử lý (1–72 giờ quan sát) → Đã phát hành Ký quỹ ba bang, bên vi phạm sẽ bị mất và bồi thường cho những người thuê nhà bị thiệt hại.
- Việc điều chỉnh hệ số phải tuân theo ba ràng buộc:Giới hạn trên ±20% / khoảng thời gian 90 ngày / thông báo trước 30 ngày。
- Tải băng thông và chỉ CPU được bù trong khoảng thời gian thấp của tác vụ GPU để cải thiện việc sử dụng nút.
