Trang này được dịch từ tài liệu tiếng Anh. Lệnh, định danh và ví dụ giữ nguyên. Runtime 7.24.4 · SDK 2.6.7. Bản tiếng Anh

Bắt đầu nhanh API bậc miễn phí

Trạng thái: Đang hoạt động Phạm vi: trạng thái hiện tại Xem xét lần cuối: 2026-08-28 Chủ sở hữu: ax-code runtime

AX Code không cung cấp hạn mức mô hình. Một lần chạy “miễn phí” dùng hạn mức hoặc tín dụng do một nhà cung cấp mô hình bên ngoài đưa ra, mà khả dụng, giới hạn, điều khoản dữ liệu và danh mục mô hình của họ có thể đổi độc lập với AX Code.

Đường được hỗ trợ ngắn nhất: Groq

Groq là nhà cung cấp mặc định của AX Code, danh mục mô hình AX Code hiện tại của nó chứa các mô hình có công cụ, và Groq công bố giới hạn gói Free cho các mã mô hình đó.

1. Tạo tài khoản Groq và khóa API trong Groq Console.
2. Lưu khóa trong AX Code:

ax-code providers login groq

3. Xác nhận các mô hình có trong bản phát hành AX Code bạn đã cài:

ax-code models groq

4. Mở ax-code, chạy /connect, rồi chọn Groq và một trong các mô hình đã liệt kê. Để kiểm tra khói không giao diện, danh mục đóng gói hiện tại hỗ trợ:

ax-code run --model groq/openai/gpt-oss-120b "Inspect this repository without editing it and summarize its purpose."

Nếu ax-code models groq không in đúng mô hình đó, hãy dùng một mã mô hình mà lệnh có in. Danh mục đã cài là nguồn có thẩm quyền cho bản phát hành đã cài.

Các lựa chọn bậc miễn phí và tín dụng miễn phí tích hợp sẵn

Các nhà cung cấp này nằm trong bộ chọn thiết lập mặc định của AX Code. “Tích hợp sẵn” nghĩa là AX Code cung cấp bộ chuyển giao thức, siêu dữ liệu mô hình, luồng thông tin xác thực và điểm cuối nhà cung cấp; không có nghĩa mọi mô hình hoặc mọi yêu cầu đều miễn phí.

Với UnoRouter, kết nối bằng ax-code providers login unorouter, chạy ax-code models unorouter, rồi chọn một mô hình có mã kết thúc bằng :free. Đừng giả định bản song sinh trả phí không có hậu tố đó là miễn phí. Danh mục của chính UnoRouter ghi rằng không phải mọi mô hình miễn phí đều hỗ trợ gọi công cụ; AX Code chỉ hiện các mục có công cụ trong danh mục đóng gói.

Với Google hoặc Hugging Face, hãy kết nối bằng mã nhà cung cấp khớp rồi dùng ax-code models google hoặc ax-code models huggingface. Hãy xem trang giá trực tiếp của nhà cung cấp trước khi chọn mô hình.

Thêm bộ định tuyến mô hình miễn phí của OpenRouter

OpenRouter ghi openrouter/free là bộ định tuyến không mất phí, chọn một mô hình miễn phí đang khả dụng và tương thích với yêu cầu. Vì bộ định tuyến đó không nằm trong ảnh chụp đã tuyển hiện tại của AX Code, hãy thêm một mục mô hình cục bộ thận trọng vào ax-code.json tại gốc dự án (hoặc hợp nhất vào cấu hình AX Code toàn cục):

{
  "$schema": "https://ax-code.app/docs-assets/schema/config.schema.json",
  "provider": {
    "openrouter": {
      "models": {
        "openrouter/free": {
          "name": "OpenRouter Free Models Router",
          "tool_call": true,
          "limit": {
            "context": 32768,
            "output": 4096,
          },
        },
      },
    },
  },
}

Các giới hạn trên là giá trị ngân sách thận trọng của AX Code, không phải quyền được cấp từ OpenRouter. Sau đó hãy kết nối và xác minh danh mục mô hình đã hợp nhất:

ax-code providers login openrouter
ax-code models openrouter
ax-code run --model openrouter/openrouter/free "Inspect this repository without editing it and identify its test command."

Việc lặp openrouter là có chủ đích: đoạn đầu là mã nhà cung cấp AX Code và openrouter/free là mã mô hình mà OpenRouter kỳ vọng. Khả dụng và lựa chọn của bộ định tuyến miễn phí thay đổi theo yêu cầu; xem tài liệu bộ định tuyến miễn phí của OpenRouter.

Cách dùng danh mục API miễn phí bên ngoài

awesome-free-llm-apis hữu ích để khám phá các ưu đãi hiện tại, nhưng không phải danh sách tương thích hay chứng thực của AX Code:

• Một nhà cung cấp trong Nhà cung cấp và mô hình được hỗ trợ có preset thiết lập mặc định của AX Code.
• Một nhà cung cấp chỉ có mặt trong models-snapshot.json được kho đăng ký chống lưng, chưa chắc đã được tuyển cho luồng thiết lập mặc định.
• Một dịch vụ khác có thể hoạt động qua Nhà cung cấp tùy chỉnh và cổng khi nó lộ điểm cuối OpenAI hoặc Anthropic tương thích.
• “Tương thích OpenAI” là cần nhưng chưa đủ cho một tác nhân lập trình. Mô hình đã chọn còn cần phản hồi văn bản dạng luồng và gọi công cụ/hàm đáng tin.
• Tên nhà cung cấp, mã mô hình, hạn mức miễn phí, vùng và yêu cầu tài khoản trong danh sách bên thứ ba có thể lỗi thời. Hãy đối chiếu với trang giá, mô hình và giới hạn tốc độ chính thức của nhà cung cấp trước khi dựa vào chúng.

Tại ngày xem xét của trang này, các dịch vụ mà danh mục đó nêu ánh xạ sang AX Code như sau:

Đặc biệt, preset github-copilot không phải API github-models mà một số danh mục liệt kê. Đừng thay mã nhà cung cấp hoặc luồng thông tin xác thực của bên này bằng bên kia. Các API tổng quát zai và zhipuai bắt đầu từ GLM-5.3; các SKU GLM 3, GLM 4, GLM-5 và GLM-5.2 cũ hơn vẫn bị lọc ra.

Thực hành đánh giá an toàn

• Hãy thử trước với một kho công khai hoặc dùng một lần. Nhà cung cấp hoặc cổng được lưu trữ nhận các lời nhắc và ngữ cảnh mã được gửi tới API của họ.
• Bật cô lập workspace-write, hoặc dùng read-only cho một lần kiểm tra khói chỉ rà soát.
• Bắt đầu với một nhiệm vụ ngắn và một tác nhân. Council, arena, phiên dài và kho lớn có thể tiêu thụ nhiều yêu cầu và nhanh chóng chạm giới hạn bậc miễn phí.
• Lưu thông tin xác thực bằng ax-code providers login hoặc một biến môi trường; đừng bao giờ commit khóa API vào ax-code.json.
• Hãy coi 429 và việc tạm không khả dụng là ràng buộc bình thường của bậc miễn phí. Hãy đợi cửa sổ thử lại của nhà cung cấp hoặc chọn một mô hình miễn phí khác đang được liệt kê.