Bắt đầu nhanh với 4-4 AI: Kết nối AI API hợp nhất trong 5 phút
Hướng dẫn này đưa bạn từ số 0 đến kết nối hoàn chỉnh với 4-4 AI: nhận khóa → cấu hình Base URL → chạy được dòng đầu tiên có streaming. Toàn bộ dùng giao diện tương thích OpenAI — mọi code, framework, công cụ hiện có hỗ trợ Base URL tùy chỉnh (openai SDK, LangChain, Cursor v.v.) đều không cần đổi logic code, chỉ đổi cấu hình.
Chuẩn bị
- Truy cập www.4-4.vip, đăng ký tài khoản và đăng nhập vào bảng điều khiển;
- Nạp tiền trong bảng điều khiển hoặc đổi mã thẻ lấy tín dụng;
- Trong trang «Token», tạo khóa API mới (dạng
sk-...) và giữ kỹ — nó chỉ hiển thị đầy đủ một lần duy nhất khi tạo.
Khái niệm cốt lõi: Base URL và khóa
4-4 AI cung cấp giao thức giao diện tương thích hoàn toàn với OpenAI. Bạn chỉ cần nhớ hai cấu hình:
| Mục cấu hình | Giá trị |
|---|---|
| Base URL | https://www.4-4.vip/v1 |
| API Key | Khóa sk-... tạo trong trang Token của bảng điều khiển |
| Tham số model | Nhập tên mô hình tùy nhu cầu, ví dụ deepseek-chat, glm-4 v.v. (tham chiếu là danh sách mô hình trong bảng điều khiển) |
Đổi mô hình = chỉ đổi tham số model; đổi nhà cung cấp = chỉ đổi Base URL. Đó là giá trị cốt lõi của gateway hợp nhất: tách rời code nghiệp vụ khỏi nhà cung cấp mô hình.
Cách 1: cURL (nhanh nhất để kiểm tra kết nối)
curl https://www.4-4.vip/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $44AI_API_KEY" \
-d '{
"model": "deepseek-chat",
"messages": [
{"role": "user", "content": "Introduce yourself in one sentence"}
]
}'
Nếu JSON trả về có chứa choices[0].message.content nghĩa là toàn chuỗi đã thông.
Cách 2: Python (SDK openai chính thức)
pip install openai
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["44AI_API_KEY"], # your 4-4 AI key
base_url="https://www.4-4.vip/v1" # key: point to the 4-4 AI gateway
)
# regular call
resp = client.chat.completions.create(
model="deepseek-chat",
messages=[{"role": "user", "content": "Write a quicksort in Python"}]
)
print(resp.choices[0].message.content)
# streaming output
stream = client.chat.completions.create(
model="deepseek-chat",
messages=[{"role": "user", "content": "Tell me a nerdy joke"}],
stream=True,
)
for chunk in stream:
delta = chunk.choices[0].delta
if delta and delta.content:
print(delta.content, end="", flush=True)
Cách 3: Node.js
npm install openai
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.N44_API_KEY,
baseURL: "https://www.4-4.vip/v1",
});
const completion = await client.chat.completions.create({
model: "deepseek-chat",
messages: [{ role: "user", content: "Write a debounce function in TypeScript" }],
});
console.log(completion.choices[0].message.content);
Kết nối các framework và công cụ phổ biến
- LangChain / LlamaIndex: dùng thành phần tương thích OpenAI của chúng và trỏ
base_url/openai_api_basevề địa chỉ trên; - Cursor / Claude Code / Cherry Studio và các công cụ AI khác: nhập Base URL và khóa trong phần cài đặt «API tùy chỉnh / tương thích OpenAI»;
- Chương trình tự phát triển: mọi HTTP client tuân thủ giao thức OpenAI đều gọi trực tiếp được, không cần thêm SDK.
Câu hỏi thường gặp (FAQ)
Lỗi 401 Invalid API Key?
Kiểm tra theo thứ tự: ① khi sao chép khóa có lẫn dấu cách hay xuống dòng không; ② khóa có bị vô hiệu hóa/xóa trong danh sách token của bảng điều khiển không; ③ tín dụng tài khoản có cạn chưa; ④ header Authorization có đúng dạng Bearer sk-... không (lưu ý có dấu cách sau Bearer).
Lỗi 429, quá nhiều yêu cầu?
Gateway đặt giới hạn tốc độ theo từng token. Giảm song song, kéo dài thời gian lùi giữa các lần thử lại (khuyến nghị lùi cấp số nhân + jitter) hoặc nâng hạn mức tốc độ của token trong bảng điều khiển.
Đầu ra streaming bị đứt giữa chừng?
Với câu trả lời dài nên bật retry khi timeout của SDK; nếu đi qua proxy công ty, kiểm tra proxy có đệm luồng SSE (text/event-stream) không.
Hỗ trợ những mô hình nào?
Tham chiếu là danh sách thời gian thực trong trang «Mô hình» của bảng điều khiển. 4-4 AI hợp nhất GLM, DeepSeek, Qwen và các mô hình phổ biến khác: cùng một khóa, cùng một giao diện, đổi mô hình tùy ý.
Bài viết liên quan
Một khóa cho GLM, DeepSeek, Qwen và các mô hình hàng đầu: thanh toán hợp nhất và trực quan hóa mức sử dụng.
Xem mô hình và giá Dùng thử miễn phí