Hướng dẫn cấu hình

Kết nối API Key trong ba bước

Trang này tập hợp các URL cần thiết cho việc cấu hình ứng dụng và quản lý tài khoản. Hãy bắt đầu với Base URL được đề xuất; chỉ chuyển sang endpoint đầy đủ hoặc tuyến Messages-compatible khi ứng dụng yêu cầu.

Hãy làm theo thứ tự này cho lần kết nối đầu tiên

Trước tiên hãy chọn mô hình và kiểm tra giá, lấy API Key, sao chép URL phù hợp, sau đó cấu hình một ứng dụng và gửi một yêu cầu thử nhỏ.

  1. 01Chọn mô hình và kiểm tra giá

    Xác nhận tên mô hình, độ dài ngữ cảnh, khả năng hỗ trợ hình ảnh và hệ số giá trước khi cấu hình ứng dụng.

  2. 02Chuẩn bị API Key

    Người dùng mới: mua API Key trước

  3. 03Sao chép đúng URL

    Dùng cho hầu hết ứng dụng OpenAI-compatible

  4. 04Điền cấu hình ứng dụng

    Phản hồi thành công xác nhận đồng thời Base URL, API Key, tuyến mô hình và đường truyền mạng đều hoạt động.

01

Chuẩn bị API Key

Sử dụng khóa được cung cấp sau khi mua hoặc khóa hiện có vẫn còn hạn mức. Hãy lưu khóa trong biến môi trường phía máy chủ.

  • Người dùng mới: mua API Key trước
  • Đã có khóa: nạp thêm hạn mức cho chính khóa đó
  • Sau khi cấu hình: kiểm tra hạn mức và nhật ký yêu cầu
02

Sao chép đúng URL

Hầu hết ứng dụng OpenAI-compatible cần Base URL kết thúc bằng /v1. Chỉ dùng endpoint đầy đủ khi ứng dụng yêu cầu rõ ràng.

Base URL được đề xuấtDùng cho hầu hết ứng dụng OpenAI-compatible
https://new.weeanno.shop/v1
Base URL dự phòngDùng khi ứng dụng tự nối thêm /v1
https://new.weeanno.shop
Endpoint Chat CompletionsURL đầy đủ cho yêu cầu tương thích với Chat Completions
https://new.weeanno.shop/v1/chat/completions
Endpoint ResponsesURL đầy đủ cho yêu cầu tương thích với Responses
https://new.weeanno.shop/v1/responses
Endpoint MessagesURL đầy đủ cho ứng dụng Messages-compatible
https://new.weeanno.shop/v1/messages
03

Điền cấu hình ứng dụng

Nhập Base URL và API Key vào đúng trường tương ứng. Các ví dụ dưới đây chỉ sử dụng giá trị giữ chỗ.

Ứng dụng OpenAI-compatible

config
base_url = "https://new.weeanno.shop/v1"
api_key = "sk-your-api-key"

Claude Code · Messages-compatible

config
export ANTHROPIC_BASE_URL="https://new.weeanno.shop"
export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"
export ANTHROPIC_MODEL="claude-sonnet-4-6"

Kiểm tra bằng cURL

Phản hồi thành công xác nhận đồng thời Base URL, API Key, tuyến mô hình và đường truyền mạng đều hoạt động.

bash
curl https://new.weeanno.shop/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Không bao giờ dán API Key thật vào ảnh chụp màn hình, tin nhắn trò chuyện, mã chạy phía trình duyệt hoặc kho mã công khai.

Chọn cách cấu hình theo công cụ

Chọn đúng giao thức mà ứng dụng yêu cầu. Công cụ OpenAI-compatible dùng Base URL /v1; Claude Code dùng URL cổng Messages-compatible.

Cherry Studio · Chatbox · WorkBuddy

Ứng dụng OpenAI-compatible

Điền Base URL này

https://new.weeanno.shop/v1
Mở hướng dẫn cấu hình

Codex CLI · Cursor · VS Code · Trae · OpenCode

Ứng dụng OpenAI-compatible

Điền Base URL này

https://new.weeanno.shop/v1
Mở hướng dẫn cấu hình

OpenClaw · Hermes · Dify · n8n · LangChain · OpenWebUI

Ứng dụng OpenAI-compatible

Điền Base URL này

https://new.weeanno.shop/v1
Mở hướng dẫn cấu hình

Kiểm tra nhanh các lỗi thường gặp

Hãy kiểm tra mã trạng thái HTTP trước khi đổi mô hình hoặc API Key.

401 / 403
Ứng dụng OpenAI-compatible dùng Authorization: Bearer <key>. Claude Code dùng ANTHROPIC_AUTH_TOKEN.
404
Kiểm tra ứng dụng cần Base URL hay endpoint đầy đủ, đồng thời xác minh tên mô hình.
429
Giảm số yêu cầu đồng thời, rút ngắn ngữ cảnh và kiểm tra hạn mức Token còn lại.
TIMEOUT
Gửi một yêu cầu thử nhỏ, sau đó kiểm tra đường truyền mạng và thử lại với thời gian chờ tăng dần.

Trước khi liên hệ bộ phận hỗ trợ WEE ANNO

Cung cấp đủ thông tin để tái hiện lỗi mà không làm lộ toàn bộ API Key.

  • Công cụ và phiên bản
  • Tên mô hình và Base URL (che API Key)
  • Mã trạng thái HTTP, nội dung lỗi và request ID
  • Thời gian ước tính và múi giờ
Liên hệ hỗ trợ WEE ANNO

URL cổng khách hàng

Các URL công khai dưới đây dẫn đến trang mua, nạp thêm hạn mức, tra cứu đơn hàng, kiểm tra hạn mức Token và tài liệu đầy đủ dành cho nhà phát triển.

Trang chủTrang chủ và menu điều hướng WEE ANNO
https://weeanno.shop/vi
Mua API KeyMua và nhận API Key mới
https://weeanno.shop/vi/buy
Nạp thêm hạn mứcNạp thêm hạn mức cho API Key hiện có
https://weeanno.shop/vi/topup
Tra cứu đơn hàngKiểm tra trạng thái thanh toán và cộng hạn mức
https://weeanno.shop/vi/topup/query
Tra cứu hạn mức TokenKiểm tra hạn mức còn lại và nhật ký yêu cầu
https://weeanno.shop/vi/quota
Tài liệu dành cho nhà phát triểnVí dụ SDK, streaming, lỗi và giới hạn
https://weeanno.shop/vi/docs