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 · 2026-11-20 · 8 phút đọc

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ị

  1. 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;
  2. Nạp tiền trong bảng điều khiển hoặc đổi mã thẻ lấy tín dụng;
  3. 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.
Cảnh báo an ninh: khóa API tương đương tín dụng tài khoản. Đừng commit nó vào repo Git hay code front-end. Nên quản lý bằng biến môi trường.

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ìnhGiá trị
Base URLhttps://www.4-4.vip/v1
API KeyKhóa sk-... tạo trong trang Token của bảng điều khiển
Tham số modelNhậ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

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

one-api / new-api tự lưu trữ so với AI Gateway quản lý: chi phí, vận hành và bảo mật Khung quyết định trung thực cho các team phân vân giữa «tự xây hay mua»: chi phí vận hành ẩn, kịch bản sự cố v Kết nối Cursor / Claude Code / Cherry Studio với AI Gateway tùy chỉnh Cách cấu hình Base URL tùy chỉnh cho các công cụ code và chat AI phổ biến, kèm cẩm nang xử lý nhanh lỗi 401 /
Sẵn sàng kết nối chưa?

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í