Cài đặt pi Coding Agent API

Cơ chế Custom Models chính thức của pi tải các cổng và mô hình tùy chỉnh từ ~/.pi/agent/models.json. TokenHub sử dụng loại openai-completions API. Không có biểu mẫu “Thêm nhà cung cấp” chung chung ở đây; tệp cấu hình này là điểm vào được hỗ trợ.

Bước 1: chuẩn bị thông tin xác thực cho models.json

Trong cùng một thiết bị đầu cuối khởi chạy pi, hãy đặt:

export TOKENHUB_API_KEY="sk-..."

Trong models.json, giá trị phải là "$TOKENHUB_API_KEY" để đọc biến môi trường. Tài liệu của pi lưu ý rằng chuỗi chữ hoa không có Trong models.json, giá trị phải là "$TOKENHUB_API_KEY"` để đọc biến môi trường. Tài liệu của pi lưu ý rằng chuỗi chữ hoa không có được coi là khóa bằng chữ, không phải là tên biến môi trường.

Bước 2: chỉnh sửa ~/.pi/agent/models.json

{
  "providers": {
    "tokenhub": {
      "baseUrl": "__API_BASE_URL__/v1",
      "api": "openai-completions",
      "apiKey": "$TOKENHUB_API_KEY",
      "models": [
        {
          "id": "YOUR_TOKENHUB_MODEL_ID",
          "name": "TokenHub / YOUR_TOKENHUB_MODEL_ID",
          "reasoning": false,
          "input": ["text"],
          "contextWindow": 128000,
          "maxTokens": 8192
        }
      ]
    }
  }
}

Sửa từng trường từ trang mô hình TokenHub:

• id là ID mẫu được gửi tới API và là bắt buộc.
• Chỉ đặt reasoning thành true cho mẫu hỗ trợ lý luận mở rộng.
• input mặc định là văn bản. Chỉ sử dụng ["text", "image"] cho kiểu máy có đầu vào hình ảnh.
• Mặc dù contextWindow có mặc định, hãy khai báo cửa sổ ngữ cảnh thực của mô hình.
• maxTokens là đầu ra tối đa, không phải cửa sổ ngữ cảnh.

TokenHub sử dụng mã thông báo Bearer. Nếu phiên bản pi của bạn không tự động thêm tiêu đề Cấp phép, hãy thêm "authHeader": true ở cấp nhà cung cấp.

Bước 3: mở /model để tải lại file

Chạy /model trong phiên pi. pi tải lại models.json mỗi khi /model mở, do đó không cần khởi động lại. Chọn tokenhub/YOUR_TOKENHUB_MODEL_ID, yêu cầu nó giải thích một tệp và chỉ gọi công cụ kiểm tra sau khi việc đó thành công.

Nếu nhà cung cấp và kiểu máy được hiển thị nhưng không thể chọn được thì tệp đã tải nhưng thông tin xác thực không được giải quyết. Kiểm tra biến môi trường hoặc lưu khóa nhà cung cấp bằng /login / auth.json.

Chỉ áp dụng ghi đè khả năng tương thích dành riêng cho pi khi cần

Một số dịch vụ OpenAI-compatible từ chối vai trò developer hoặc reasoning_effort. Chỉ thêm các cờ này sau khi xảy ra lỗi 400 tương ứng:

"compat": {
  "supportsDeveloperRole": false,
  "supportsReasoningEffort": false
}

Không vô hiệu hóa các khả năng trước. Khi các yêu cầu cơ bản thành công, hãy định cấu hình thinkingLevelMap, đầu vào hình ảnh, thông số lấy mẫu hoặc chỉ định giá cho kiểu máy chính xác.

Khắc phục sự cố theo hành vi tải của pi

• Nhà cung cấp hoàn toàn vắng mặt trong /model: kiểm tra đường dẫn tệp, cú pháp JSON, baseUrl và api.
• Nhà cung cấp tồn tại nhưng không thể chọn mô hình: $TOKENHUB_API_KEY không giải quyết được hoặc nhà cung cấp thiếu thông tin xác thực đã lưu.
• 401: xác nhận quy trình pi kế thừa biến và đặt authHeader: true nếu được yêu cầu.
• 400 hoặc cắt ngắn sớm: đúng contextWindow, maxTokens hoặc compat; không chỉ đơn giản là tăng số lượng.
• Thay đổi không xuất hiện: mở lại /model thay vì dựa vào lựa chọn cũ được hiển thị trong phiên hiện tại.

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

• pi: Mẫu tùy chỉnh
• pi: Tiện ích mở rộng nhà cung cấp tùy chỉnh API