cách cấu hình API cho Cockpit Tools

Cockpit Tools quản lý profile Codex. Bạn phải thực hiện đúng thứ tự “thêm nhà cung cấp → gán vào instance → bật và khởi động” để Codex thực sự dùng API trung gian qionggeme/穷哥么.

Cấu hình nhanh

Đường dẫn
Trang Codex → tab Nhà cung cấp mô hình → Thêm nhà cung cấp tùy chỉnh
Base URL
https://qionggeme.com/v1
Không điền địa chỉ trang nội dung hoặc /docs vào endpoint API.
API Key
API Key được tạo trong bảng điều khiển 穷哥么
Tài liệu chỉ dùng chỗ giữ chỗ; không ghi Key thật vào nội dung.
wireApi
responses
Không chọn nhầm chat_completions.
Mô hình
gpt-5.3-codex-spark
Thực tế lấy theo danh sách mô hình mà token hiện tại nhìn thấy.
Thao tác có hiệu lực
Gán nhà cung cấp → Bật và khởi động
Lưu ≠ chuyển đổi.

Chuẩn bị trước:

Chuỗi tích hợp này để Cockpit Tools quản lý auth.json và config.toml của profile Codex. Hãy ưu tiên chuyển đổi bằng giao diện Cockpit và không đồng thời sửa thủ công các tệp được quản lý khi Cockpit đang tiếp quản.

Các bước cấu hình

  1. Mở tab nhà cung cấp mô hình của Codex

    Trong Cockpit Tools, vào trang Codex, chuyển sang tab “Nhà cung cấp mô hình” rồi nhấp “Thêm nhà cung cấp tùy chỉnh”. Không điền Base URL trong hướng dẫn này vào trường địa chỉ dịch vụ cục bộ của Cockpit; đây là cấu hình nhà cung cấp mô hình bên ngoài.

  2. Điền tên, Base URL và API Key

    Điền các trường như sau:

    • Tên: ví dụ qionggeme-codex để dễ nhận biết.
    • Base URL: https://qionggeme.com/v1
    • API Key: dán API Key qionggeme/穷哥么 của bạn, không có dấu ngoặc hoặc khoảng trắng thừa.

    Base URL là cổng API, không phải URL của trang nội dung; tuyệt đối không thêm /docs.

  3. Đặt wireApi thành responses và điền mô hình

    Trong trường giao thức wireApi, chọn responses. Bạn có thể điền mô hình gpt-5.3-codex-spark; nếu ID này không nằm trong danh sách của token hiện tại, hãy thay bằng một Model ID tương thích Codex trong danh sách và dùng trang giá làm tham khảo cho mô hình chủ lực. Không chọn chat_completions vì hướng dẫn này dùng giao thức Codex Responses nguyên bản.

  4. Lưu cấu hình nhà cung cấp

    Nhấp lưu và xác nhận thẻ nhà cung cấp đã xuất hiện trong danh sách. “Lưu” ở đây chỉ ghi cấu hình vào dữ liệu nhà cung cấp của Cockpit và không tự động chuyển bất kỳ instance Codex nào sang nhà cung cấp này.

  5. Quay lại instance và gán nhà cung cấp

    Quay lại khu vực quản lý instance Codex của Cockpit, chọn instance cần dùng rồi gán nhà cung cấp tùy chỉnh vừa lưu cho instance đó. Nếu chưa gán, profile Codex sẽ không dùng nhà cung cấp dù cấu hình đã lưu thành công.

  6. Thực hiện rõ ràng “Bật và khởi động”

    Sau khi gán, thực hiện “Bật và khởi động” rồi theo dõi trạng thái của instance. Chỉ bước này mới làm Cockpit trỏ profile Codex đích đến nhà cung cấp; nhắc lại: lưu ≠ chuyển đổi.

  7. Xác minh Codex đang dùng nhà cung cấp mới

    Sau khi xác nhận instance đang chạy, hãy khởi động hoặc khởi động lại Codex từ instance đó và gửi một yêu cầu đơn giản. Nếu terminal hoặc profile Codex cũ vẫn chạy từ trước khi chuyển, hãy thoát tiến trình cũ để tránh tiếp tục đọc cấu hình cũ.

Ví dụ cấu hình

# Cockpit Tools → Codex → Nhà cung cấp mô hình → Thêm nhà cung cấp tùy chỉnh
Tên: qionggeme-codex
Base URL: https://qionggeme.com/v1
API Key:  API Key qionggeme/穷哥么 của bạn
wireApi:  responses
Mô hình:  gpt-5.3-codex-spark (hoặc Model ID Codex mà token hiện tại nhìn thấy)

# Sau khi lưu, bắt buộc làm tiếp
1. Quay lại instance
2. Gán nhà cung cấp này
3. Thực hiện “Bật và khởi động”

# Lưu ý
Lưu cấu hình không đồng nghĩa đã chuyển instance; không đồng thời sửa thủ công auth.json / config.toml do Cockpit quản lý.

Khắc phục sự cố

Đã lưu nhà cung cấp nhưng Codex vẫn đi qua tuyến cũ

Lưu chỉ hoàn tất bước ghi dữ liệu. Quay lại instance, xác nhận đã gán nhà cung cấp, thực hiện rõ ràng “Bật và khởi động” rồi khởi động lại Codex đang chạy. Hãy kiểm tra trạng thái instance, không chỉ nhìn thẻ nhà cung cấp.

Chọn nhầm chat_completions và yêu cầu Responses báo lỗi

Sửa nhà cung cấp, đổi wireApi thành responses và giữ Base URL là https://qionggeme.com/v1. Hướng dẫn này không phụ thuộc chuyển đổi Chat Completions hoặc định tuyến cục bộ.

Nhà cung cấp tồn tại nhưng không có hiệu lực trong danh sách instance

Kiểm tra xem nhà cung cấp đã thực sự được gán cho instance hiện tại chưa. Gán là một thao tác độc lập; khi đổi instance, bạn cũng phải kiểm tra lại quan hệ gán rồi thực hiện “Bật và khởi động”.

Instance không khởi động hoặc cổng/trạng thái chạy bất thường

Xem trạng thái chạy và thông tin cổng của instance Cockpit, xác nhận dịch vụ đã khởi động và cổng không bị tiến trình khác chiếm. Hãy xác định tiến trình đang chiếm trước khi xử lý, không dừng mù quáng; sau khi đổi cổng, khởi động lại instance và kiểm tra lại.

Vẫn đọc profile cũ hoặc trạng thái rối sau khi sửa thủ công

Dừng instance được quản lý, xác nhận quan hệ gán và trạng thái bật, rồi để Cockpit thực hiện lại “Bật và khởi động”. Cockpit quản lý auth.json và config.toml của profile Codex; khi tắt, hãy dùng cơ chế của công cụ để khôi phục profile đã lưu và tránh sửa hai tệp này trong lúc Cockpit đang tiếp quản.

Sẵn sàng bắt đầu?

Đăng ký qionggeme/穷哥么 để lấy API Key và dùng ngay mọi mô hình đang cung cấp.

Đăng ký ngay

Câu hỏi thường gặp

Base URL trong Cockpit Tools phải điền gì?

Điền https://qionggeme.com/v1, đây là endpoint Codex API của qionggeme/穷哥么. Không điền URL trang nội dung và không dùng địa chỉ có /docs.

Vì sao wireApi phải là responses?

Codex sử dụng giao thức Responses nguyên bản. Cấu hình nhà cung cấp trong hướng dẫn này dựa trên giao thức đó; chat_completions là giao thức khác và sẽ làm định dạng hoặc định tuyến yêu cầu không khớp.

Lưu nhà cung cấp có nghĩa là đã chuyển thành công chưa?

Chưa. Lưu chỉ lưu cấu hình nhà cung cấp; bạn còn phải quay lại instance, gán nhà cung cấp, thực hiện rõ ràng “Bật và khởi động”, sau đó kiểm tra trạng thái chạy và yêu cầu thực tế.

Cockpit Tools thay đổi những tệp Codex nào?

Cockpit quản lý auth.json và config.toml của profile Codex, rồi tiếp quản profile đích sang nhà cung cấp đã chọn khi bật. Khi tắt nên khôi phục bằng cơ chế của Cockpit và không đồng thời sửa thủ công các tệp được quản lý.

gpt-5.3-codex-spark có luôn khả dụng không?

Đây chỉ là Model ID ví dụ. Khả năng sử dụng thực tế lấy theo danh sách mô hình mà token hiện tại nhìn thấy trong bảng điều khiển. Nếu không có ID này, hãy đổi sang Model ID tương thích Codex trong danh sách; trang giá chỉ để tham khảo mô hình chủ lực.

Hướng dẫn liên quan

cách cấu hình API tùy chỉnh cho Codex CLI

Kết nối qionggeme/穷哥么 bằng cấu hình model provider chính thức của Codex, lưu khóa trong biến môi trường và dùng Responses API.

Đọc hướng dẫn →

cách cấu hình API cho CC Switch

Ưu tiên tính năng nhập một chạm trong bảng điều khiển qionggeme/穷哥么 để chuyển nhà cung cấp, endpoint, mô hình và API Key sang CC Switch an toàn; nếu nhập thất bại, bạn vẫn có thể cấu hình thủ công theo các trường chính thức.

Đọc hướng dẫn →

cách cấu hình Cherry Studio với New API

Thêm qionggeme/穷哥么 theo tài liệu tích hợp New API chính thức của Cherry Studio, sử dụng loại tương thích OpenAI và địa chỉ gốc của tên miền API.

Đọc hướng dẫn →