Hướng dẫn nhanh cho người dùng Mistral
Di chuyển sang giải pháp thay thế API Mistral không kiểm duyệt của chúng tôi bằng cách cập nhật URL cơ sở và khóa của bạn. Chạy mã khách hàng giống hệt nhau với mô hình cửa sổ ngữ cảnh 100k của chúng tôi với giá trả theo mức sử dụng minh bạch.
Cài đặt SDK tương thích OpenAI của bạn
Vì API của chúng tôi triển khai tiêu chuẩn chat-completions của OpenAI, bạn có thể sử dụng bất kỳ SDK hiện có nào. Đối với Python, hãy cài đặt gói openai chính thức qua pip. Nhà phát triển Node.js nên cài đặt gói npm openai. Các thư viện này xử lý tuần tự hóa, thử lại và truyền phát tự động.
Bạn không cần SDK Mistral độc quyền. Sử dụng các khách hàng tương thích OpenAI chuẩn đảm bảo bạn có thể chuyển đổi giữa các nhà cung cấp một cách dễ dàng. Đảm bảo bạn đã cài đặt Python 3.8+ hoặc Node.js 16+ trước khi tiếp tục.
Cấu hình URL cơ sở và Khóa API
Xác thực yêu cầu một khóa API hợp lệ và URL cơ sở chính xác. Lấy khóa của bạn từ trang Lấy khóa API sau khi đăng ký bằng email của bạn. Bạn không cần thẻ tín dụng cho bản dùng thử.
Đặt các biến môi trường của bạn hoặc truyền chúng trực tiếp trong khởi tạo máy khách của bạn. URL cơ sở cho dịch vụ này là https://api.mistralapikey.com/v1. Điều này cho phép bạn hoán đổi cấu hình Mistral hoặc OpenAI hiện có của bạn với các thay đổi mã tối thiểu. Khóa của bạn có thể được tạo lại bất cứ lúc nào, thu hồi khóa trước đó.
Gửi yêu cầu đầu tiên của bạn
Gửi một yêu cầu hoàn thành trò chuyện tiêu chuẩn để kiểm tra khả năng kết nối. Sử dụng ID mô hình uncensored để truy cập mô hình ngôn ngữ lớn của chúng tôi. Endpoint chấp nhận các yêu cầu POST với các tải trọng JSON chứa messages và model.
Mô hình của chúng tôi trả lời mà không từ chối nội dung cho việc sử dụng người lớn hợp pháp. Nó hỗ trợ cửa sổ ngữ cảnh 100.000 token cho cả đầu vào và đầu ra. Đảm bảo thân yêu cầu của bạn dưới 8 MB.
curl https://api.mistralapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'
Bật phản hồi truyền phát
Để tạo token theo thời gian thực, hãy đặt tham số stream thành true. API trả về các sự kiện do máy chủ gửi (SSE) thay vì một đối tượng JSON đơn lẻ. Điều này rất lý tưởng cho giao diện trò chuyện hoặc đầu ra terminal trực tiếp.
Xử lý luồng bằng cách lặp qua các phần. Mỗi phần chứa các phần delta một phần của phản hồi. Điều này làm giảm độ trễ nhận thức cho người dùng so với việc chờ đợi sự hoàn thành đầy đủ. Mô hình không kiểm duyệt hỗ trợ truyền phát gốc.
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
Sử dụng Gọi công cụ/hàm
API của chúng tôi hỗ trợ gọi công cụ có cấu trúc thông qua định dạng tương thích OpenAI. Xác định các hàm trong mảng tools và để mô hình quyết định khi nào gọi chúng. Truyền tên hàm và đối số như được trả lại bởi mô hình.
Điều này cho phép các quy trình làm việc phức tạp nơi LLM tương tác với các API hoặc cơ sở dữ liệu bên ngoài. Đảm bảo các định nghĩa hàm của bạn là các lược đồ JSON hợp lệ. Mô hình sẽ phản hồi với các cuộc gọi công cụ khi thích hợp, cho phép bạn thực hiện logic và đưa kết quả trở lại cuộc trò chuyện.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.mistralapikey.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);
Kiểm tra các mô hình có sẵn
Truy vấn endpoint GET /v1/models để liệt kê các mô hình có sẵn. Điều này trả về siêu dữ liệu bao gồm ID mô hình, loại đối tượng và chủ sở hữu. Dịch vụ của chúng tôi hiện chỉ cung cấp mô hình uncensored.
Endpoint này hữu ích cho việc gỡ lỗi hoặc cấu hình máy khách động. Nó xác nhận khóa API của bạn là hợp lệ và dịch vụ có thể truy cập được. Các nhà cung cấp khác có thể liệt kê nhiều mô hình; chúng tôi tập trung vào việc cung cấp một tùy chọn không kiểm duyệt chất lượng cao mà không có độ phức tạp định tuyến.
Python
from openai import OpenAI
client = OpenAI(base_url="https://api.mistralapikey.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)Thông số kỹ thuật
Toàn bộ giới hạn và tính năng thực tế của API ở một nơi — hãy kiểm tra trước khi nạp tiền.
| Mục | Giá trị |
|---|---|
| Định dạng | tương thích OpenAI: mọi SDK OpenAI đều chạy được, chỉ cần đổi base URL và khóa |
| Xác thực | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.mistralapikey.com/v1 |
| ID mô hình | uncensored |
| Endpoint | POST /v1/chat/completions · GET /v1/models |
| Chế độ JSON | response_format: {"type": "json_object"} |
| Streaming | có — server-sent events; phần cuối chứa lượng token đã dùng |
| Cửa sổ ngữ cảnh | 100.000 token (đầu vào + đầu ra) |
| Tham số | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Đầu ra tối đa | tối đa phần còn lại của cửa sổ 100.000 token; max_tokens tùy chọn (không giới hạn riêng) |
| Gọi hàm | có — tools, tool_choice; phản hồi có tool_calls, kể cả khi streaming; kết quả gửi lại bằng role: tool |
| Header phản hồi | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Giới hạn tốc độ | 300 yêu cầu mỗi phút cho mỗi khóa |
| Yêu cầu đồng thời | tối đa 8 cùng lúc cho mỗi khóa |
| Kích thước yêu cầu | tối đa 8 MB |
| Thời hạn | tín dụng đã trả không hết hạn, không đăng ký định kỳ |
| Dùng thử miễn phí | $0,50 trong 7 ngày, không cần thẻ · Khóa dùng thử: 2 yêu cầu song song, 60 yêu cầu/phút; hạn mức đầy đủ (8 và 300) sau lần nạp đầu |
| Nạp tiền | USDT (TRC20) hoặc USDC (Base), số tiền nguyên bất kỳ từ $20 đến $500 |
| Thưởng | +5% từ $50, +10% từ $100, +15% từ $200 |
| Giá | $0,15 cho 1 triệu token đầu vào · $0,50 cho 1 triệu token đầu ra |
| Tính phí | tín dụng trả trước theo mức dùng thực tế; lỗi và từ chối miễn phí |
| Nội dung | cho phép nội dung người lớn; từ chối nội dung tình dục liên quan đến trẻ vị thành niên |
| Đăng nhập | Google hoặc email và mật khẩu |
| Khóa | mỗi tài khoản một khóa đang hoạt động; khóa mới thay thế khóa cũ |
Mã lỗi
Lỗi trả về dạng JSON với type cố định; yêu cầu lỗi hoặc bị từ chối không bị tính phí.
| HTTP | Loại | Ý nghĩa |
|---|---|---|
400 | bad_request | JSON sai, tin nhắn trống, tham số sai hoặc vượt cửa sổ ngữ cảnh |
401 | missing_key · invalid_key · key_revoked | thiếu khóa, sai khóa hoặc khóa đã bị thay |
402 | no_credit | hết tín dụng — nạp tiền là dùng tiếp ngay |
403 | content_blocked | nội dung tình dục liên quan trẻ vị thành niên — từ chối, không tính phí |
404 | not_found | endpoint không tồn tại |
413 | request_too_large | nội dung lớn hơn 8 MB |
429 | rate_limited · concurrency | vượt 300/phút hoặc 8 đồng thời — chờ rồi thử lại |
503 | upstream_busy | mô hình đang bận — thử lại sau vài giây |
Hỏi đáp
Chi phí cho giải pháp thay thế API Mistral không kiểm duyệt là bao nhiêu?
Giá là $0,15 cho mỗi 1 triệu token đầu vào và $0,50 cho mỗi 1 triệu token đầu ra. Không có phí hàng tháng hoặc đăng ký. Bạn có thể nạp tiền từ $20 bằng tiền điện tử (USDT trên TRC20, USDC trên Base), kèm theo tín dụng bonus cho các khoản nạp lớn.
Điều gì xảy ra nếu tôi vượt quá giới hạn tốc độ?
Bạn sẽ nhận được lỗi 429 Too Many Requests. Giới hạn là 300 yêu cầu mỗi phút cho mỗi khóa API. Nếu bạn đạt đến giới hạn này, hãy đợi một lúc hoặc tạo lại khóa của bạn. Thân yêu cầu cũng phải dưới 8 MB.
Tín dụng dùng thử có hiệu lực mãi mãi không?
Không. Tài khoản mới nhận $0.50 tín dụng dùng thử có hiệu lực trong 7 ngày. Nhận tín dụng này bằng một cú nhấp chuột trên trang khóa API của bạn. Không cần thẻ để bắt đầu. Tuy nhiên, tín dụng trả trước đã trả tiền không bao giờ hết hạn.
Khóa của bạn chỉ cách một biểu mẫu
Tạo tài khoản, sao chép khóa, thay đổi URL cơ sở. Đó là toàn bộ thiết lập.