Truy cập API

22 tháng 9 2026 · AIAdapter · https://www.aiadapter.com

AIAdapter là API tương thích OpenAI. Một tài khoản cấp một API key. Cùng key đó xác thực mọi yêu cầu — cả ứng dụng máy tính lẫn mã ứng dụng. Đừng tạo key thứ hai theo mô hình, nhà cung cấp, hay client.

Chỉ thay origin bên dưới khi gọi máy chủ không phải production. Đường dẫn /v1 là bắt buộc.

1. Thông tin xác thực

Đăng nhập, mở Console → API Keys và tạo key một lần. Bí mật chỉ hiện khi tạo; lưu ngay và dùng lại mọi nơi.

Thư viện OpenAI chính thức nối thêm các đường dẫn như /chat/completions vào base URL. Trỏ client tới …/v1, không phải gốc site.

Coi key là bí mật. Đừng commit, đừng dán vào ticket, đừng nhúng vào JavaScript trình duyệt, ứng dụng di động, hay client mà người dùng cuối có thể xem. Đọc từ biến môi trường hoặc dịch vụ quản lý bí mật. Nếu lộ, xóa rồi tạo đúng một key thay thế.

2. Gọi trực tiếp từ client

Dùng mục này khi muốn gọi mô hình từ ứng dụng đã tương thích OpenAI và không muốn viết mã tích hợp. Client điển hình: Cursor, Claude Desktop, Cherry Studio, Continue, LibreChat.

Chỉ cấu hình ba trường. Key chính là credential do console cấp.

Cursor

1. Mở Settings → Models.
2. Dán API key vào OpenAI API Key.
3. Bật Override OpenAI Base URL và đặt https://www.aiadapter.com/v1 (v1 chữ thường).
4. Thêm định danh mô hình từ marketplace vào Custom Models. Ưu tiên ID không trùng tên mô hình có sẵn của Cursor.

Cursor Tab và một số mô hình tích hợp không dùng custom OpenAI base URL. Sau khi ghi đè, chat với ID mô hình trên marketplace. Nếu ô không nhận focus, cập nhật Cursor lên 3.15.20 trở lên.

Các client tương thích OpenAI khác

Trong Claude Desktop, Cherry Studio, Continue, LibreChat, hoặc bất kỳ client nào nhận nhà cung cấp tương thích OpenAI:

• Nhà cung cấp / loại API: OpenAI compatible
• Base URL: https://www.aiadapter.com/v1
• API key: đúng một key AIAdapter
• Mô hình: định danh marketplace

Đừng phát hành key thứ hai cho client thứ hai. Hai client dùng cùng một key là cấu hình dự kiến.

3. Tích hợp ứng dụng

Dùng mục này khi bạn viết phần mềm. Hợp đồng giống nhau: một key, một base URL, xác thực Bearer. Các ví dụ dưới dùng thư viện OpenAI chính thức như client thay thế.

Đặt AIADAPTER_API_KEY trong môi trường tiến trình. Đừng hard-code bí mật. Thay MODEL_ID bằng đúng định danh trên /models, gồm tiền tố người bán.

HTTP

curl https://www.aiadapter.com/v1/chat/completions \
  -H "Authorization: Bearer $AIADAPTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "Reply with one word: ok"}]
  }'

Python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["AIADAPTER_API_KEY"],
    base_url="https://www.aiadapter.com/v1",
)
response = client.chat.completions.create(
    model="MODEL_ID",
    messages=[{"role": "user", "content": "Reply with one word: ok"}],
)
print(response.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.AIADAPTER_API_KEY,
  baseURL: "https://www.aiadapter.com/v1",
});
const response = await client.chat.completions.create({
  model: "MODEL_ID",
  messages: [{ role: "user", content: "Reply with one word: ok" }],
});
console.log(response.choices[0].message.content);

4. Mô hình và endpoint

Liệt kê mô hình bằng GET /v1/models với cùng Bearer key, hoặc xem /models. Dùng định danh đã liệt kê làm model. Định danh có tiền tố người bán. Sao chép nguyên văn. Ví dụ: pixverse/c1, byteplus-intl/dreamina-seedance-2-5-260628. Đừng gửi tên ngắn như c1 hay seedance-2.5.

Các route tương thích OpenAI phổ biến:

• POST /v1/chat/completions — chat và mô hình ngôn ngữ
• POST /v1/images/generations — mô hình ảnh
• POST /v1/video/generations rồi GET /v1/video/generations/{id} — mô hình video

Ảnh

Tạo ảnh là đồng bộ. Điền định danh marketplace vào model.

curl https://www.aiadapter.com/v1/images/generations \
  -H "Authorization: Bearer $AIADAPTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "byteplus-intl/dola-seedream-5-0-flash-260915",
    "prompt": "A red paper lantern in rain"
  }'

Video

Gửi yêu cầu sẽ trả về job. Poll cùng đường dẫn với id đó đến khi thành công hoặc thất bại. Đừng chờ file xong trên chính request gửi.

curl https://www.aiadapter.com/v1/video/generations \
  -H "Authorization: Bearer $AIADAPTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pixverse/c1",
    "prompt": "A cat walking across a sunlit kitchen",
    "seconds": "5"
  }'

curl https://www.aiadapter.com/v1/video/generations/JOB_ID \
  -H "Authorization: Bearer $AIADAPTER_API_KEY"

Âm thanh và các phương thức khác theo thẻ mô hình trên marketplace.

401 nghĩa là thiếu hoặc sai key. 429 nghĩa là bị giới hạn tốc độ. Số dư hoặc hạn mức không đủ trả về lỗi API; nạp credit trong console trước khi thử lại.

5. Xử lý key

Một key đủ cho mọi tích hợp trên tài khoản. Tạo thêm key sẽ tách nhật ký kiểm toán và tăng nguy cơ lộ; không mở thêm mô hình.

Câu hỏi: help@aiadapter.com