Zed Editor Cài đặt API tùy chỉnh

Zed hỗ trợ cả Giao diện người dùng cài đặt tác nhân và settings.json cho các điểm cuối OpenAI-compatible. Hãy để Zed lưu trữ khóa TokenHub API trong chuỗi khóa hệ thống hoặc cung cấp khóa đó thông qua biến môi trường bắt nguồn từ tên nhà cung cấp. Không đặt chìa khóa vào settings.json.

Thêm nhà cung cấp trong Cài đặt đại lý

1. Mở bảng lệnh và chạy agent: open settings.
2. Đi tới Settings → AI → LLM Providers.
3. Nhấp vào Add Provider và chọn nhà cung cấp OpenAI-compatible.
4. Nhập tokenhub làm tên nhà cung cấp.
5. Nhập https://us-api.tokenhub.com/v1 làm API URL.
6. Nhập ID mẫu chính xác được hiển thị trong danh mục mẫu TokenHub.
7. Nhập cửa sổ ngữ cảnh thực của mô hình đó.
8. Nhập khóa TokenHub API của bạn vào cài đặt nhà cung cấp để Zed lưu khóa đó vào chuỗi khóa hệ thống.

Chỉnh sửa settings.json khi bạn cần nhiều mô hình

Zed hỗ trợ các nhà cung cấp thuộc language_models.openai_compatible. Trong lược đồ này, max_tokens có nghĩa là cửa sổ ngữ cảnh, không phải đầu ra tối đa. Thay thế cả hai giới hạn bằng các giá trị được ghi lại cho mô hình của bạn:

{
  "language_models": {
    "openai_compatible": {
      "tokenhub": {
        "api_url": "__API_BASE_URL__/v1",
        "available_models": [
          {
            "name": "YOUR_TOKENHUB_MODEL_ID",
            "display_name": "TokenHub / YOUR_TOKENHUB_MODEL_ID",
            "max_tokens": 128000,
            "max_output_tokens": 8192,
            "capabilities": {
              "tools": true,
              "images": false,
              "parallel_tool_calls": false,
              "prompt_cache_key": false,
              "chat_completions": true,
              "interleaved_reasoning": false,
              "max_tokens_parameter": false
            }
          }
        ]
      }
    }
  }
}

Nếu capabilities bị bỏ qua, Zed sử dụng các giá trị mặc định OpenAI-compatible được hiển thị ở trên. Chỉ đặt images, parallel_tool_calls hoặc khả năng khác thành true khi cả kiểu máy và điểm cuối TokenHub thực sự hỗ trợ nó.

Thực hiện theo quy tắc tra cứu khóa API của Zed

Zed chuyển đổi ID nhà cung cấp thành chữ hoa và nối thêm _API_KEY. Do đó, ID nhà cung cấp tokenhub ánh xạ tới:

export TOKENHUB_API_KEY="sk-..."

Biến môi trường không trống được ưu tiên hơn móc khóa. Nếu bạn đã cập nhật khóa trong giao diện người dùng nhưng Zed vẫn gửi thông tin xác thực cũ, hãy bỏ đặt biến này và khởi động lại Zed.

Không suy luận hỗ trợ Lý luận hoặc Phản hồi từ tên mô hình

• Khi mô hình TokenHub hỗ trợ reasoning_effort kiểu OpenAI, chỉ đặt một giá trị mà điểm cuối chấp nhận. Zed hiển thị none, minimal, low, medium, high, xhigh và max, nhưng điểm cuối của bên thứ ba có thể hỗ trợ ít giá trị hơn.
• TokenHub hiện khuyến nghị Hoàn thành trò chuyện cho kết nối này, vì vậy hãy giữ capabilities.chat_completions: true.
• Chỉ thay đổi nó thành false đối với kiểu máy yêu cầu Phản hồi API. Không chuyển đổi API chỉ để kích hoạt lý luận.
• Chỉ đặt max_tokens_parameter: true khi điểm cuối yêu cầu max_tokens thay vì max_completion_tokens.

Xác minh bên trong Zed

Chọn TokenHub / YOUR_TOKENHUB_MODEL_ID trong Tổng đài viên hoặc Trợ lý nội tuyến và yêu cầu Trợ lý giải thích về tệp hiện tại. Nếu không có mô hình, hãy kiểm tra JSON, ID nhà cung cấp và available_models. Đối với 401, hãy kiểm tra TOKENHUB_API_KEY hiển thị với quy trình Zed. Nếu công cụ hoặc hình ảnh không thành công, hãy quay lại capabilities và đảm bảo khai báo không vượt quá mức hỗ trợ thực sự của mô hình.

Tài liệu tham khảo chính thức

• Zed: Sử dụng quyền truy cập API