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ấu hình nhanh

Đường dẫn tích hợp
Cài đặt → Dịch vụ mô hình → Thêm nhà cung cấp
Loại nhà cung cấp
OpenAI
Đây là quy trình chính trong tài liệu trực tuyến. Nếu phiên bản mới của bạn có mục New API riêng, bạn cũng có thể chọn mục đó.
Tên
穷哥么
API Key
Key được tạo trong bảng điều khiển token của 穷哥么
Địa chỉ API
https://qionggeme.com
Yêu cầu tương thích OpenAI thực tế dùng https://qionggeme.com/v1; nếu tạo riêng nhà cung cấp Anthropic nguyên bản, Base URL là https://qionggeme.com.

Hướng dẫn này tuân theo quy trình chính trong tài liệu trực tuyến chính thức của Cherry Studio: khi thêm nhà cung cấp, chọn loại OpenAI. Nếu giao diện phiên bản mới của bạn có thêm mục New API riêng, bạn cũng có thể chọn mục đó; cả hai đều dùng cùng quy tắc API Key và địa chỉ bên dưới. Trước tiên, hãy tạo API Key trong bảng điều khiển token qionggeme/穷哥么.

Trường dễ điền sai nhất là “Địa chỉ API”. Với trường New API của Cherry Studio, hãy điền địa chỉ gốc https://qionggeme.com, không nối /v1 và không dùng địa chỉ trang nội dung.

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

  1. Tạo và sao chép API Key

    Mở bảng điều khiển token qionggeme/穷哥么, tạo token rồi sao chép Key. Sau đó dán Key vào trường API Key của Cherry Studio; không đưa khóa vào trường tên hoặc địa chỉ API.

  2. Thêm nhà cung cấp theo đường dẫn chính thức

    Trong Cherry Studio, lần lượt mở Cài đặt → Dịch vụ mô hình → Thêm nhà cung cấp và chọn loại OpenAI theo tài liệu trực tuyến chính thức. Nếu phiên bản mới có mục New API riêng, bạn cũng có thể chọn mục đó; các bước sau vẫn là điền tên, API Key và địa chỉ API.

  3. Điền tên, API Key và địa chỉ API

    • Tên: 穷哥么
    • API Key: dán Key vừa tạo
    • Địa chỉ API: https://qionggeme.com

    Trường này phải là địa chỉ gốc. Không đổi thành https://qionggeme.com/v1 và tuyệt đối không thêm /docs.

  4. Hiểu sự khác nhau giữa địa chỉ API và endpoint thực tế

    Trường “Địa chỉ API” của Cherry Studio luôn điền địa chỉ gốc https://qionggeme.com; ứng dụng sẽ gửi yêu cầu tương thích OpenAI đến https://qionggeme.com/v1. Nếu bạn tạo riêng một nhà cung cấp Anthropic nguyên bản, Base URL dùng https://qionggeme.com. Đây không phải thử ngẫu nhiên giữa hai địa chỉ mà là mỗi giao thức có Base URL riêng, rõ ràng.

  5. Bật nhà cung cấp và kiểm tra yêu cầu

    Sau khi lưu, bật công tắc Enable của nhà cung cấp rồi chọn chính xác một mô hình hiện khả dụng để gửi yêu cầu thử. Model ID có thể thay đổi theo danh sách cung cấp; hãy kiểm tra trang bảng giá mô hình hoặc danh sách mô hình trong bảng điều khiển. Nhận được phản hồi bình thường nghĩa là cấu hình đã thành công.

Ví dụ cấu hình

# Cherry Studio → New API
Tên: 穷哥么
API Key: API Key qionggeme/穷哥么 của bạn
Địa chỉ API: https://qionggeme.com

# Base URL thực tế theo từng giao thức
Tương thích OpenAI: https://qionggeme.com/v1
Anthropic nguyên bản (khi cấu hình riêng): https://qionggeme.com

Khắc phục sự cố

Yêu cầu trả về 401 hoặc báo API Key không hợp lệ

Sao chép lại Key từ bảng điều khiển token, kiểm tra khoảng trắng ở đầu/cuối và xác nhận trạng thái token, số dư cùng quyền dùng mô hình đều bình thường.

Yêu cầu trả về 404 hoặc không nhận diện được địa chỉ

Xác nhận bạn dùng loại OpenAI theo quy trình chính thức; nếu phiên bản có mục New API riêng, mục đó cũng dùng được. Trong cả hai trường hợp, “Địa chỉ API” phải chính xác là https://qionggeme.com, không nối /v1 hoặc /docs.

Thông báo mô hình không tồn tại hoặc không khả dụng

Mở trang bảng giá mô hình để kiểm tra Model ID hiện có và bảo đảm tên mô hình khớp hoàn toàn; không tiếp tục dùng tên đã ngừng cung cấp hoặc sai chính tả.

Địa chỉ OpenAI và Anthropic trông không giống nhau

Đây là hành vi đúng. Với nhà cung cấp tương thích OpenAI trên trang này, trường “Địa chỉ API” là https://qionggeme.com và OpenAI Base URL thực tế là https://qionggeme.com/v1; nếu tạo riêng nhà cung cấp Anthropic nguyên bản, dùng https://qionggeme.com.

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

Khi tích hợp New API vào Cherry Studio, “Địa chỉ API” có cần /v1 không?

Không. Theo tài liệu tích hợp chính thức, trường này điền https://qionggeme.com; Cherry Studio sẽ gửi yêu cầu tương thích OpenAI đến https://qionggeme.com/v1.

Có thể điền địa chỉ trang nội dung vào trường API không?

Không. Địa chỉ API phải là https://qionggeme.com, không được dùng địa chỉ có /docs.

Trường tên nên điền gì?

Nên điền “穷哥么” để dễ nhận biết. Hai trường thực sự quyết định xác thực và đích yêu cầu là API Key và địa chỉ API.

Vì sao Base URL thực tế của OpenAI và Anthropic khác nhau?

Hai loại API có quy ước đường dẫn khác nhau: yêu cầu tương thích OpenAI dùng https://qionggeme.com/v1, còn yêu cầu Anthropic nguyên bản dùng https://qionggeme.com. Nếu tạo hai nhà cung cấp riêng, hãy điền theo đúng giao thức.

Kiểm tra tên mô hình ở đâu?

Hãy xem Model ID đang khả dụng trên trang bảng giá mô hình. Nếu một ID không còn xuất hiện trong nguồn dữ liệu hiện tại, đừng tiếp tục dùng tên 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 API cho Claude Code

Dùng biến môi trường để Claude Code kết nối API trung gian qionggeme/穷哥么 và sử dụng khả năng lập trình của Claude mà không cần gói thuê bao chính thức.

Đọc hướng dẫn →