Cập nhật
URL API tương thích OpenAI: Base URL và Headers
Base URL là https://api.chinesellmapi.com/v1. Hãy đặt nó vào nơi client OpenAI của bạn mong đợi base URL, thêm khóa của bạn dưới dạng token Bearer và sử dụng model ID là uncensored.

Câu trả lời ngắn gọn
Nếu bạn đang tìm một url API tương thích openai cho dịch vụ này, hãy sao chép giá trị này:
https://api.chinesellmapi.com/v1
Đó là base URL. Mọi SDK OpenAI, client desktop và khung tác nhân có trường gọi là "base URL", "API base", "endpoint" hoặc "host" đều sử dụng chuỗi này. Khóa được đưa vào trường "API key" tương ứng và tên mô hình là uncensored.
Có hai endpoint phía sau: POST /v1/chat/completions cho chat và GET /v1/models để liệt kê các mô hình. Không có gì khác từ bề mặt OpenAI được cung cấp, vì vậy không có route embedding, không có route ảnh và không có route fine-tuning. Nếu bạn cần một khóa trước, trang API key sẽ hướng dẫn bạn quy trình đăng ký.
Base URL so với URL endpoint đầy đủ
Hầu hết các lỗi xảy ra ở đây. Client chia thành hai nhóm: những nhóm muốn base URL và tự thêm đường dẫn, và những nhóm muốn URL đầy đủ của lệnh gọi. Bảng hiển thị cả hai dạng.
| Trường yêu cầu gì | Giá trị cần nhập |
|---|---|
| Base URL, API base, OpenAI host | https://api.chinesellmapi.com/v1 |
| URL chat completions đầy đủ | https://api.chinesellmapi.com/v1/chat/completions |
| URL danh sách mô hình | https://api.chinesellmapi.com/v1/models |
Các SDK chính thức của OpenAI, wrapper OpenAI của LangChain, LiteLLM và hầu hết các giao diện chat đều thuộc nhóm đầu tiên. Các công cụ cho phép bạn dán URL yêu cầu thô thuộc nhóm thứ hai. Khi nhãn trường không nói rõ nó là loại nào, hãy đọc văn bản placeholder: nếu nó hiển thị thứ gì đó kết thúc bằng /v1, nó muốn base URL.
Dấu gạch chéo cuối
Hầu hết các SDK xử lý dấu gạch chéo cuối, nhưng một số xây dựng đường dẫn cuối cùng bằng cách nối chuỗi đơn giản. Nếu bạn nhận được lỗi 404 và URL kết thúc bằng /v1/, hãy xóa dấu gạch chéo cuối cùng và thử lại.
Các header mà API yêu cầu
Yêu cầu cần một header cho xác thực và một header cho loại body:
Authorization: Bearer YOUR_KEYContent-Type: application/json
Các SDK tự đặt cả hai cho bạn. Nếu bạn xây dựng yêu cầu bằng tay, đây là lệnh gọi nhỏ nhất hoạt động:
curl https://api.chinesellmapi.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Say hello in one sentence."}]
}'
Phản hồi bao gồm một số header đáng để ghi lại: X-Request-Id cho các câu hỏi hỗ trợ, X-Balance-USD cho tín dụng còn lại, và X-RateLimit-Limit-Requests cùng X-RateLimit-Limit-Concurrency cho các giới hạn áp dụng cho khóa của bạn.
Cài đặt trong các SDK OpenAI
Chỉ có hai giá trị thay đổi so với cài đặt OpenAI tiêu chuẩn: base URL và khóa. Mọi thứ khác trong mã của bạn vẫn giữ nguyên.
Python
from openai import OpenAI
client = OpenAI(
base_url="https://api.chinesellmapi.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Translate 'good morning' into Chinese."}],
)
print(resp.choices[0].message.content)
Node
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.chinesellmapi.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Translate 'good morning' into Chinese." }],
});
console.log(resp.choices[0].message.content);
Streaming hoạt động theo cách tương tự: thêm stream: true và đọc các chunk. Số liệu sử dụng được gửi vào cuối stream. Hãy lưu ý rằng một yêu cầu streaming chiếm một slot concurrency của bạn cho đến khi stream đóng.
Biến môi trường thay vì mã
Các SDK OpenAI hiện tại cho Python và Node đọc OPENAI_BASE_URL và OPENAI_API_KEY từ môi trường khi bạn không truyền chúng trong mã. Đó là cách nhanh nhất để trỏ một dự án hiện có vào một endpoint mới mà không cần chạm vào một dòng:
export OPENAI_BASE_URL="https://api.chinesellmapi.com/v1"
export OPENAI_API_KEY="YOUR_KEY"
python app.py
Nhiều công cụ bên thứ ba sử dụng cùng hai tên biến này, mặc dù một số sử dụng tên riêng của chúng, chẳng hạn như API_BASE hoặc OPENAI_API_BASE trong các dự án cũ. Hãy kiểm tra tài liệu của công cụ để biết tên chính xác. Nếu một dự án hard-code api.openai.com ở đâu đó, hãy tìm kiếm tên máy chủ đó trong mã nguồn và thay thế nó.
Tên mô hình thường nằm trong một cài đặt riêng biệt, vì vậy hãy nhớ thay đổi nó thành uncensored. Việc giữ nguyên tên mô hình OpenAI mặc định là lý do phổ biến thứ hai gây ra lỗi sau khi URL sai.
Kiểm tra kết nối trước khi gỡ lỗi ứng dụng của bạn
Kiểm tra URL và khóa bằng một lệnh gọi không tốn phí. Liệt kê các mô hình không cần token:
curl https://api.chinesellmapi.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
Nếu lệnh này trả về một danh sách JSON bao gồm uncensored, thì URL và khóa đều chính xác và mọi vấn đề còn lại nằm ở cài đặt client của bạn. Nếu nó thất bại, hãy sử dụng bảng này.
| Triệu chứng | Nguyên nhân có thể | Cách khắc phục |
|---|---|---|
| 404 Not Found | Đường dẫn bị lặp (/v1/v1/...) hoặc /v1 bị thiếu | Nhập base URL chính xác một lần, kết thúc bằng /v1 |
| 401 Không được ủy quyền | Khóa bị thiếu, được sao chép kèm theo khoảng trắng hoặc được gửi trong header sai | Gửi Authorization: Bearer YOUR_KEY và sao chép lại khóa |
429 với mã rate_limited | Quá nhiều yêu cầu mỗi phút | Giảm tốc độ hoặc xếp hàng yêu cầu |
429 với mã concurrency | Quá nhiều yêu cầu cùng một lúc | Giới hạn các lệnh gọi song song, nhớ rằng stream chiếm một slot |
429 với Retry-After: 5 | Quá tải tạm thời | Chờ năm giây và thử lại |
| Không tìm thấy mô hình | Tên mô hình OpenAI còn sót lại | Đặt mô hình thành uncensored |
Các giới hạn bạn nên biết trước khi đưa vào sản xuất
Một khóa đầy đủ cho phép 8 yêu cầu đồng thời và 300 yêu cầu mỗi phút. Khóa dùng thử cho phép 2 yêu cầu đồng thời và 60 yêu cầu mỗi phút. Body yêu cầu có thể lên đến 8 MB và cửa sổ ngữ cảnh là 100.000 token, bao gồm cả prompt và completion, vì vậy max_tokens là tùy chọn.
Dịch vụ chỉ hỗ trợ văn bản và chạy một mô hình trọng số mở duy nhất từ một nhà cung cấp độc lập. Đây không phải là API chính thức của bất kỳ nhà cung cấp mô hình nào và nó không định tuyến giữa các nhà cung cấp. Nếu ứng dụng của bạn là sản phẩm ngôn ngữ Trung Quốc, hướng dẫn nhanh cho ứng dụng ngôn ngữ Trung Quốc sẽ cho bạn thấy cách cấu trúc prompt, và hướng dẫn API dịch thuật bao gồm bảng thuật ngữ và placeholder.
Thanh toán theo mức sử dụng từ tín dụng trả trước: $0.15 cho 1M token đầu vào và $0.50 cho 1M token đầu ra. Các yêu cầu thất bại hoặc bị từ chối không bị tính phí. Trang giá cả liệt kê các mức nạp tiền và ưu đãi, và người dùng mới có thể nhận $0.50 tín dụng dùng thử chỉ với một cú nhấp chuột trên trang khóa, có hiệu lực trong 7 ngày và không cần thẻ. Để hướng dẫn chi tiết hơn về thiết lập máy khách, hãy xem tài liệu quickstart.
Nội dung tình dục hóa trẻ vị thành niên luôn bị cấm; ngoài ra, mô hình được tinh chỉnh để trả lời mà không từ chối nội dung cho mục đích người trưởng thành hợp pháp.
Các vị trí khác mà URL được sử dụng
Các framework đặt tên cho trường này khác nhau, nhưng giá trị thì giống nhau. Ba ví dụ phổ biến:
# LangChain
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
base_url="https://api.chinesellmapi.com/v1",
api_key="YOUR_KEY",
model="uncensored",
)
# LiteLLM
import litellm
r = litellm.completion(
model="openai/uncensored",
api_base="https://api.chinesellmapi.com/v1",
api_key="YOUR_KEY",
messages=[{"role": "user", "content": "ping"}],
)
Trong LiteLLM, tiền tố openai/ cho thư viện biết sử dụng định dạng wire của OpenAI với base URL của bạn, và phần sau dấu gạch chéo là ID mô hình. Các giao diện chat như SillyTavern có nguồn "tương thích OpenAI tùy chỉnh" với ba ô: URL, khóa và mô hình. Cũng là ba giá trị đó.
Giữ khóa khỏi trình duyệt
Không gọi API từ JavaScript phía máy khách được gửi đến người dùng. Bất kỳ ai cũng có thể đọc khóa từ trang và tiêu tốn tín dụng của bạn. Hãy đặt một tuyến máy chủ nhỏ ở giữa, lưu trữ khóa trong biến môi trường tại đó, và để trang web của bạn gọi tuyến đó.
Chuyển đổi giữa các endpoint mà không cần thay đổi mã
Nếu bạn thử nghiệm nhiều nhà cung cấp, hãy đặt ba giá trị trong cấu hình thay vì trong mã nguồn. Một khối cài đặt nhỏ sẽ thực hiện công việc và khiến URL trở thành thứ duy nhất bạn cần chỉnh sửa:
import os
from openai import OpenAI
client = OpenAI(
base_url=os.getenv("LLM_BASE_URL", "https://api.chinesellmapi.com/v1"),
api_key=os.environ["LLM_API_KEY"],
)
MODEL = os.getenv("LLM_MODEL", "uncensored")
Điều này cũng giúp tách biệt môi trường staging và production dễ dàng: sử dụng khóa khác nhau cho từng môi trường, và header phản hồi X-Balance-USD sẽ hiển thị tín dụng còn lại của từng khóa.
Hướng dẫn khác
Hỏi đáp
Tôi có cần bao gồm /chat/completions trong base URL không?
Không. Nhập https://api.chinesellmapi.com/v1 và để SDK tự thêm /chat/completions. Chỉ các công cụ yêu cầu URL yêu cầu đầy đủ mới cần dạng dài hơn.
Tôi có thể sử dụng cùng một URL cho nhiều ứng dụng không?
Có. URL và khóa có thể được sử dụng cho bất kỳ số lượng máy khách nào. Chúng chia sẻ các giới hạn của khóa của bạn: 8 yêu cầu đồng thời và 300 yêu cầu mỗi phút đối với khóa đầy đủ.
Tôi nhập tên mô hình nào?
Sử dụng uncensored. Bạn có thể xác nhận bằng cách gọi GET /v1/models với khóa của bạn.
Đây có phải là API chính thức của một nhà cung cấp kiểu OpenAI không?
Không. Đây là một API được lưu trữ cho một mô hình trọng số mở duy nhất do một nhà cung cấp độc lập vận hành, được xây dựng để tương thích với định dạng yêu cầu của OpenAI.
Tôi kiểm tra khóa mà không tiêu tốn tín dụng như thế nào?
Gọi GET /v1/models với header Authorization. Nó trả về danh sách mô hình và không sử dụng token.
Khóa của bạn chỉ cách một biểu mẫu
Tạo tài khoản, sao chép khóa, thay đổi base URL. Đó là toàn bộ thiết lập.