Trang chủ → Hướng dẫn → Dùng Cherry Studio với API tùy chỉnh: địa chỉ, model, Claude và ảnh đầu vào

Dùng Cherry Studio với API tùy chỉnh: địa chỉ, model, Claude và ảnh đầu vào

Thêm một nhà cung cấp vào Cherry Studio mất chưa tới một phút. Ô duy nhất hay điền sai là địa chỉ API, vì Cherry tự thêm /v1. Khi bạn bắt đầu đính kèm ảnh chụp màn hình, việc model nào thật sự nhìn thấy ảnh trở nên quan trọng — chúng tôi đã thử bảy model.

Thêm nhà cung cấp

1. Mở Cài đặt → Nhà cung cấp model và bấm Thêm. Đặt tên (ví dụ APICLAN) và chọn loại OpenAI.
2. Dán khóa API lấy từ bảng điều khiển.
3. Nhập https://apiclan.us làm địa chỉ API.
4. Bấm Kiểm tra và chọn một model bất kỳ để xác nhận khóa hoạt động.

Bạn nhập	Cherry Studio gọi tới
https://apiclan.us	https://apiclan.us/v1/chat/completions ✓
https://apiclan.us/v1/	https://apiclan.us/v1/chat/completions ✓
https://apiclan.us/v1	https://apiclan.us/v1/v1/chat/completions ✗ 404

Cherry Studio tự thêm /v1/chat/completions vào địa chỉ, trừ khi địa chỉ kết thúc bằng /. Vì vậy https://apiclan.us và https://apiclan.us/v1/ đều dùng được, còn https://apiclan.us/v1 không có dấu gạch chéo cuối sẽ thành /v1/v1 và trả về 404.

Thêm model

Bấm Quản lý bên dưới nhà cung cấp. Cherry Studio lấy danh sách từ /v1/models, nơi chỉ trả về các model thuộc nhóm của khóa. Ngày 12/10/2026 danh sách gồm:

• Nhóm GPT: gpt-5.6-sol, gpt-5.6-terra, gpt-6-astra, gpt-6-sol, gpt-6.1-sol
• Nhóm DeepSeek: deepseek-v4-flash, deepseek-v4-pro, deepseek-v4.1-flash (cùng các phiên bản có ngày)

Bấm + cạnh model bạn muốn. Nếu thiếu một model, khóa của bạn thuộc nhóm khác — mỗi khóa trên cổng này gắn với đúng một nhóm.

Thêm Claude

Thêm nhà cung cấp thứ hai loại Anthropic, cùng địa chỉ https://apiclan.us và một khóa tạo trong nhóm Claude. Sau đó thêm claude-opus-5-5 hoặc claude-fable-5-1. Mỗi nhóm một nhà cung cấp giúp khóa không bị lẫn: GPT, DeepSeek và Claude mỗi loại một mục.

Model nào đọc được ảnh bạn đính kèm

Chúng tôi gửi cùng một ảnh nhỏ tô một màu tới từng model qua kiểu yêu cầu OpenAI mà Cherry Studio dùng, và hỏi đó là màu gì. Sau đó lặp lại với màu thứ hai để loại trường hợp đoán trúng.

Model	Đọc được ảnh	Thời gian trả lời
claude-opus-5-5	✓	3.1 s
claude-fable-5-1	✓	3.3 s
deepseek-v4.1-flash	✓	2.3–3.1 s
gpt-6-astra	✓	6.6 s
gpt-5.6-sol	✓	7.3 s
gpt-6.1-sol	✓	24–25 s
deepseek-v4-pro	✗	—

deepseek-v4-pro không nhận ảnh: với ảnh màu xanh lá, nó trả lời “white”, lần còn lại không trả về gì, và đều không báo lỗi. Với ảnh chụp màn hình, hãy dùng model có dấu tick. gpt-6.1-sol đọc ảnh đúng nhưng mất khoảng 24 giây, so với 2,6 giây tới token đầu tiên khi chỉ gửi văn bản. Nếu Cherry Studio không hiện nút ảnh cho một model, hãy mở cài đặt của model đó và tick Thị giác. Thử nghiệm ngày 12/10/2026.

Lỗi thường gặp

• 401 → khóa sai, hoặc khóa không khớp với nhà cung cấp (ví dụ khóa nhóm GPT đặt vào nhà cung cấp Anthropic).
• 404 → địa chỉ kết thúc bằng /v1 mà không có dấu gạch chéo. Hãy dùng https://apiclan.us.
• model_not_found (is not supported by any configured account in this group) → model không nằm trong nhóm của khóa. Hãy thêm từ Quản lý thay vì gõ tay.
• Câu trả lời bỏ qua ảnh của bạn → model không đọc được ảnh. Chuyển sang model có dấu tick trong bảng.

Cần cấu hình công cụ lập trình? Dùng Cline với API tùy chỉnh · Dùng Codex với API tùy chỉnh.

Bắt đầu sử dụng

Không thuê bao, không mức tối thiểu hàng tháng, không cần gọi cho nhân viên bán hàng. Nạp bằng USDT và tiêu đúng phần bạn dùng — 1 USDT cho bạn 2 tín dụng số dư API.

Đọc hướng dẫn nhanh 30 giây

Ngôn ngữ: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

Giá trên trang này được điền tự động từ dữ liệu thanh toán thực tế. Điều khoản bên thứ ba được trích từ tài liệu của chính họ.