// Tài liệu kỹ thuật

Hướng dẫn cấu hình & Tích hợp

Các thông số kết nối tiêu chuẩn và ví dụ mã nguồn giúp bạn kết nối nhanh nhất tới hệ thống API Gateway.

// 01 / Cấu hình kết nối & SDK mẫu

connection_profile.conf
API Base URL (Endpoint):
https://api.aceapikey.com/v1
Authorization Header:
Bearer sk-your-api-key
Tên Model khả dụng:
qwen-turbohoặc model bạn muốn dùng
integration_node.jsNODE.JS SDK
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-your-api-key",
  baseURL: "https://api.aceapikey.com/v1",
});

const res = await client.chat.completions.create({
  model: "qwen-turbo",
  messages: [{ role: "user", content: "Hello ACE" }],
});

console.log(res.choices[0].message.content);
integration_python.pyPYTHON SDK
from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.aceapikey.com/v1"
)

res = client.chat.completions.create(
    model="qwen-turbo",
    messages=[{"role": "user", "content": "Hello ACE"}]
)

print(res.choices[0].message.content)

// Khả năng tương thích

Tương thích với tool bạn đang dùng

ACE API Key hoạt động hoàn hảo với nhiều công cụ hỗ trợ custom Base URL và API Key theo chuẩn OpenAI-compatible API.

01 // AI Coding / IDEide_tools
CursorClaude CodeCodex CLIGemini AntigravityOpenCodeClineRoo CodeContinue
02 // API Client / Chat Clientchat_clients
Cherry StudioChatboxLobeChatLibreChatOpen WebUI
03 // Automation / App Builderbuilders
Difyn8nFlowiseLangChainLlamaIndex
04 // Developer SDKsdks
OpenAI SDKPythonNode.jsREST API
Cấu hình chung cho các tool
Base URL:https://api.aceapikey.com/v1
API Key:sk-your-api-key
Model name:model bạn muốn dùng

// 03 / Các câu hỏi thường gặp (FAQ)

Q:ACE API Key có phải website chính thức của OpenAI, Anthropic hoặc Google không?

A:

ACE API Key không phải website chính thức của OpenAI, Anthropic hoặc Google. ACE là nền tảng phân phối và hỗ trợ kết nối API AI cho người dùng Việt Nam. Tùy từng gói/model, ACE hỗ trợ nhiều loại route: chính chủ/pay-as-you-go, route đối tác, route tối ưu chi phí hoặc alias route cho test/staging. Mỗi route có giá, tốc độ và độ ổn định riêng. Khách hàng nên chọn gói phù hợp với nhu cầu sử dụng.

Q:Quota là hạn mức hoạt động như thế nào?

A:

Quota là hạn mức sử dụng của API key. Khi bạn gọi model, hệ thống sẽ trừ quota dựa trên model đang dùng, số lượng input token, output token và cache nếu có. Token không bằng quota. Mỗi model có biểu giá riêng, nên cùng một lượng token nhưng mức quota bị trừ có thể khác nhau.

Q:ACE API Key tương thích với những tool/phần mềm nào?

A:

ACE API Key dùng được với nhiều công cụ hỗ trợ custom Base URL và API Key theo chuẩn OpenAI-compatible API, bao gồm Cursor, Claude Code, Codex CLI, Gemini Antigravity, OpenCode, Cline, Roo Code, Continue, Cherry Studio, Open WebUI, Dify, LibreChat, LobeChat, Chatbox và các SDK phổ biến. Bạn chỉ cần nhập Base URL: https://api.aceapikey.com/v1, API Key và tên model muốn sử dụng. Lưu ý: Một số tool có thể yêu cầu định dạng model hoặc provider riêng. Nếu chưa cấu hình được, ACE có thể hỗ trợ setup ban đầu.

Q:Tôi nên bắt đầu với model nào?

A:

Nếu muốn tối ưu chi phí để test, staging hoặc chạy tác vụ hàng loạt, bạn có thể bắt đầu với Qwen, GLM hoặc DeepSeek. Nếu cần coding, agent task, phân tích logic phức tạp hoặc chất lượng cao hơn, hãy chọn các route GPT/Claude cao cấp phù hợp ngân sách.

Q:Alias route là gì?

A:

Alias route là cách giữ tên model quen thuộc để tool dễ tương thích, nhưng backend có thể được định tuyến sang một model khác nhằm tối ưu chi phí hoặc tốc độ. Nếu gói nào dùng alias route, ACE sẽ ghi rõ để khách hàng không nhầm với model chính chủ.