
7API làm gì
7API là một cổng API cung cấp quyền truy cập vào nhiều dòng mô hình AI thông qua một khóa API, một số dư và cơ chế thanh toán theo token. Dịch vụ hỗ trợ các giao diện tương thích với OpenAI và Anthropic, cho phép ứng dụng hiện có chuyển đổi nhà cung cấp bằng cách thay đổi khóa API, URL cơ sở và ID mô hình.
Các dòng mô hình hiện có gồm Claude, GPT, Gemini, Grok, DeepSeek, GLM và Kimi. Bên cạnh các mô hình tiêu chuẩn, dịch vụ cung cấp một số biến thể không kiểm duyệt và đã loại bỏ các bộ lọc khi có sẵn. 7API là cổng trung gian, không phải đơn vị sở hữu các mô hình này, vì vậy hành vi, điều khoản, mã định danh, giá và tình trạng cung cấp của mô hình có thể khác nhau tùy nhà cung cấp nền tảng.
Quan trọng: Mô hình không kiểm duyệt được thiết kế để từ chối ít yêu cầu hơn mô hình tiêu chuẩn, nhưng điều này không đảm bảo mô hình sẽ không bao giờ từ chối. Ứng dụng vẫn cần được đánh giá, áp dụng biện pháp bảo vệ phù hợp, có sự xem xét của con người và tuân thủ điều khoản của nhà cung cấp cũng như luật hiện hành.
Tính năng chính
- Một khóa API: Sử dụng một tài khoản để truy cập các mô hình được hỗ trợ thuộc bảy dòng mô hình lớn.
- Tương thích với OpenAI: Kết nối các ứng dụng hỗ trợ
base_urlOpenAI tùy chỉnh. - Tương thích với Anthropic: Sử dụng endpoint kiểu Anthropic cùng SDK Anthropic và các công cụ tương thích như Claude Code.
- Tùy chọn không kiểm duyệt: Chọn các biến thể không kiểm duyệt và đã loại bỏ bộ lọc khi chúng có trong danh mục đang hoạt động.
- Thanh toán theo token: Không có phí đăng ký, mức tối thiểu hằng tháng hoặc phí theo chỗ ngồi.
- Bộ nhớ đệm prompt: Các tiền tố lặp lại có thể được tính theo mức giá đầu vào đã lưu trong bộ nhớ đệm thấp hơn.
- Khóa phụ: Phân tách nguồn tiền và mức sử dụng cho đồng đội, khách hàng hoặc dự án.
- Công cụ tương thích: Sử dụng Cursor, Codex CLI, OpenCode, LangChain, LlamaIndex và các ứng dụng khác chấp nhận nhà cung cấp tương thích với OpenAI hoặc Anthropic.
Trước khi bắt đầu
Tạo tài khoản thông qua trang web 7API. Trang tổng quan cung cấp khóa API bắt đầu bằng sk-, URL cơ sở chính xác, ID mô hình hiện tại, giới hạn ngữ cảnh, tình trạng cung cấp theo thời gian thực và thông tin giá.
Không sao chép URL cơ sở hoặc ID mô hình từ ví dụ cũ vào môi trường production mà chưa kiểm tra trang tổng quan. Nhà cung cấp có thể phát hành phiên bản mới, đồng thời mã định danh mô hình hoặc các biến thể không kiểm duyệt có thể thay đổi.
Cài đặt SDK
Đối với Python, hãy cài đặt SDK tương ứng với giao diện bạn dự định sử dụng. Bạn chỉ cần gói OpenAI cho ví dụ tương thích với OpenAI hoặc gói Anthropic cho ví dụ tương thích với Anthropic.
pip install openai
pip install anthropicCấu hình biến môi trường
Lưu thông tin xác thực bên ngoài mã nguồn. Sao chép URL cơ sở chính xác từ trang tổng quan và xuất URL cùng khóa:
export SEVEN_API_KEY="sk-..."
export SEVEN_API_BASE_URL="https://.../v1"Tránh commit khóa API thật vào kho mã nguồn. Biến môi trường phía máy chủ hoặc trình quản lý bí mật phù hợp hơn thông tin xác thực được ghi cứng trong mã.
Gửi yêu cầu tương thích với OpenAI
Giao diện tương thích với OpenAI hữu ích khi ứng dụng đã sử dụng SDK OpenAI hoặc một ứng dụng khác cho phép tùy chỉnh URL cơ sở.
- Nhập
OpenAIvà đọc thông tin xác thực từ môi trường. - Khởi tạo ứng dụng khách bằng khóa API và URL cơ sở của 7API.
- Thay
MODEL_IDbằng mã định danh hiện tại từ trang tổng quan. - Gửi yêu cầu hoàn tất cuộc trò chuyện và đọc tin nhắn của trợ lý được trả về.
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["SEVEN_API_KEY"],
base_url=os.environ["SEVEN_API_BASE_URL"],
)
response = client.chat.completions.create(
model="MODEL_ID",
messages=[
{
"role": "system",
"content": "Bạn là một trợ lý chính xác và hữu ích."
},
{
"role": "user",
"content": "Giải thích sự đánh đổi khi định tuyến mô hình trong hai đoạn văn."
},
],
)
print(response.choices[0].message.content)Mẫu tích hợp này cũng có thể được nhiều ứng dụng tương thích với OpenAI sử dụng. Trong cấu hình hiện có thông thường, những thay đổi chính là URL cơ sở, khóa API và ID mô hình được chọn.
Gửi yêu cầu tương thích với Anthropic
Sử dụng giao diện tương thích với Anthropic khi ứng dụng của bạn yêu cầu Anthropic Messages API. Trang tổng quan có thể hiển thị URL cơ sở Anthropic riêng, vì vậy hãy sử dụng endpoint chính xác đó thay vì giả định rằng nó giống với URL tương thích với OpenAI.
import os
from anthropic import Anthropic
client = Anthropic(
api_key=os.environ["SEVEN_API_KEY"],
base_url=os.environ["SEVEN_API_BASE_URL"],
)
message = client.messages.create(
model="MODEL_ID",
max_tokens=1024,
messages=[
{
"role": "user",
"content": "Viết ghi chú phát hành ngắn gọn cho một công cụ dành cho nhà phát triển."
}
],
)
print(message.content[0].text)Thay MODEL_ID bằng một mô hình hiện đang có sẵn. Trong ví dụ này, phản hồi được đọc từ message.content[0].text.
Kiểm thử API bằng cURL
Trước khi tích hợp SDK, một yêu cầu HTTP trực tiếp có thể xác minh khóa, URL cơ sở, ID mô hình và cấu hình tài khoản.
curl "$SEVEN_API_BASE_URL/chat/completions" \
-H "Authorization: Bearer $SEVEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MODEL_ID",
"messages": [
{
"role": "user",
"content": "Xin chào từ hướng dẫn nhanh 7API."
}
]
}'Nếu yêu cầu không thành công, trước tiên hãy xác nhận rằng các biến môi trường đã được thiết lập, endpoint khớp với chế độ tương thích đã chọn và ID model xuất hiện trong danh mục hiện tại trên dashboard.
Chọn dòng model
Việc chọn model nên dựa trên khối lượng công việc thay vì chỉ dựa vào nhãn không kiểm duyệt. README nêu một số lĩnh vực phổ biến cho từng dòng:
- Claude: Lập luận dài, viết và các agent lập trình.
- GPT: Trợ lý đa năng, sử dụng công cụ và đầu ra có cấu trúc.
- Gemini: Quy trình đa phương thức, nghiên cứu và tác vụ có ngữ cảnh dài.
- Grok: Câu trả lời theo thời gian thực và phát triển ý tưởng.
- DeepSeek: Lập trình, lập luận và các agent tiết kiệm chi phí.
- GLM: Agent, lập trình và công việc song ngữ.
- Kimi: Đọc tài liệu dài và quy trình agent.
Không phải mọi model trong các dòng này đều không kiểm duyệt. Hãy kiểm tra danh mục trực tiếp để phân biệt model tiêu chuẩn với các biến thể không kiểm duyệt hoặc đã loại bỏ cơ chế từ chối được chọn lọc. Hãy thử nghiệm đúng phiên bản bạn dự định triển khai vì hành vi có thể thay đổi giữa các bản phát hành.
Kết nối các công cụ dành cho nhà phát triển hiện có
7API có thể được sử dụng với các công cụ chấp nhận nhà cung cấp tương thích tùy chỉnh. Cấu hình bắt buộc phụ thuộc vào giao diện mà client yêu cầu:
- Claude Code: Trỏ cấu hình base URL Anthropic của công cụ đến endpoint 7API tương thích với Anthropic.
- Cursor: Thêm 7API làm nhà cung cấp tùy chỉnh tương thích với OpenAI.
- Codex CLI: Cấu hình một hồ sơ nhà cung cấp tương thích với OpenAI.
- OpenCode: Thêm nhà cung cấp tùy chỉnh và ID model hợp lệ.
- LangChain hoặc LlamaIndex: Sử dụng adapter tương thích với OpenAI cùng base URL và key của 7API.
- Các ứng dụng tương thích khác: Thay thế base URL và API key của nhà cung cấp, sau đó chọn ID model được hỗ trợ.
Hãy tham khảo tài liệu dành riêng cho từng client trong repository khi công cụ sử dụng tên biến môi trường hoặc tệp cấu hình khác.
Mẹo sử dụng nâng cao
So sánh model với cùng một prompt
Vì nhiều dòng model có sẵn thông qua một gateway, bạn có thể gửi cùng một prompt đánh giá đến nhiều ID model mà không cần xây dựng lại toàn bộ tích hợp. Hãy so sánh chất lượng đầu ra, hành vi từ chối, chi phí, độ trễ và độ tin cậy trước khi chọn model cho môi trường production.
Lập kế hoạch cho thay đổi model
Đừng cho rằng ID model hoặc hành vi của model sẽ mãi không thay đổi. Tính khả dụng có thể luân phiên khi các nhà cung cấp cập nhật danh mục. Hãy để việc chọn model có thể cấu hình, xác nhận ID hiện tại trên dashboard và đánh giá lại các prompt quan trọng sau khi phiên bản upstream thay đổi.
Sử dụng bộ nhớ đệm prompt khi phù hợp
Các ứng dụng thường xuyên gửi cùng một tiền tố prompt có thể hưởng lợi từ mức giá đầu vào đã lưu trong bộ nhớ đệm thấp hơn. Hãy xem thông tin giá trực tiếp trước khi ước tính khoản tiết kiệm vì mức giá của nhà cung cấp có thể thay đổi.
Tách các dự án bằng subkey
Sử dụng subkey khi một thành viên trong nhóm, khách hàng hoặc dự án cần được cấp ngân sách riêng với số dư chính. Cách này giúp quản lý quyền truy cập tập trung dễ dàng hơn, đồng thời làm rõ hơn các giới hạn sử dụng.
Định tuyến theo khối lượng công việc
Một gateway duy nhất giúp bạn dễ dàng chọn các dòng model khác nhau cho từng tác vụ. Ví dụ, một ứng dụng có thể đánh giá một dòng cho tài liệu dài và dòng khác cho lập trình hoặc đầu ra có cấu trúc. Quyết định định tuyến nên dựa trên kết quả đo được với các phiên bản model hiện tại.
Thêm biện pháp bảo vệ ở cấp ứng dụng
Việc giảm hành vi từ chối không loại bỏ nhu cầu kiểm soát. Hãy xác thực đầu ra của model, hạn chế quyền truy cập vào các công cụ nhạy cảm, ghi nhật ký dữ liệu vận hành phù hợp, áp dụng đánh giá của con người cho các quy trình có hậu quả đáng kể và tuân thủ điều khoản của nhà cung cấp nền tảng.
Lưu ý về giá và tài khoản
7API áp dụng hình thức thanh toán theo token thay vì thuê bao. Người dùng nạp tiền vào số dư dùng chung và chi tiêu số dư đó cho các model được hỗ trợ. BTC, ETH, USDT và LTC được liệt kê là các tùy chọn nạp tiền được hỗ trợ. Giá trực tiếp có thể thay đổi khi nhà cung cấp cập nhật mức phí, vì vậy hãy sử dụng dashboard thay vì các ước tính cố định để lập ngân sách.
Dịch vụ cũng liệt kê chương trình giới thiệu, trả 15% số tiền nạp do người được giới thiệu thực hiện. Chương trình này tách biệt với hoạt động API và không bắt buộc để sử dụng gateway.
Các hạn chế thường gặp
- Không nhà cung cấp nào có thể đảm bảo model không kiểm duyệt hoặc đã loại bỏ cơ chế từ chối sẽ không bao giờ từ chối yêu cầu.
- Hành vi phụ thuộc vào model, phiên bản, prompt và chính sách của nhà cung cấp.
- ID model, giá và tình trạng cung cấp có thể thay đổi.
- Điều khoản của nhà cung cấp vẫn được áp dụng khi sử dụng gateway.
- Nhà phát triển vẫn chịu trách nhiệm về việc sử dụng hợp pháp và có đạo đức, đánh giá, các biện pháp bảo vệ và giám sát của con người.
Kết luận
7API cung cấp một phương thức thống nhất để đánh giá và gọi các model Claude, GPT, Gemini, Grok, DeepSeek, GLM và Kimi thông qua các giao diện tương thích với OpenAI và Anthropic. Hãy bắt đầu bằng việc lấy thông tin xác thực trên dashboard, thử nghiệm một ID model hiện tại bằng cURL, sau đó tích hợp SDK hoặc công cụ dành cho nhà phát triển phù hợp. Trước khi triển khai production, hãy so sánh chính xác các phiên bản model, theo dõi giá và tình trạng cung cấp, đồng thời áp dụng các biện pháp bảo vệ phù hợp với ứng dụng của bạn.
