Hướng dẫn nhanh cho người dùng Mistral

URL cơ sở & Xác thực

API của chúng tôi tương thích hoàn toàn với các SDK của OpenAI. Bạn chỉ cần cập nhật URL cơ sở và cung cấp khóa API của bạn. URL cơ sở cho dịch vụ này là https://api.mistralapi.com/v1. Xác thực được xử lý qua tiêu đề Authorization bằng mã thông báo Bearer. Không giống như một số nhà cung cấp khác, chúng tôi không yêu cầu định tuyến phức tạp hoặc các tiêu đề cụ thể cho nhà cung cấp; chỉ cần truyền khóa của bạn như bình thường.

• URL cơ sở: https://api.mistralapi.com/v1
• Tiêu đề: Authorization: Bearer YOUR_API_KEY

Khóa API của bạn được tạo ngay lập tức khi đăng ký. Hãy giữ nó an toàn vì nó cấp quyền truy cập vào tín dụng trả trước của bạn. Không có phí đăng ký hàng tháng, chỉ có giá theo mức sử dụng token.

Endpoint Chat Completions

Trọng tâm của API chúng tôi là endpoint POST /v1/chat/completions. Nó chấp nhận một danh sách các tin nhắn và trả về phản hồi được tạo. Endpoint này hỗ trợ định dạng tin nhắn tiêu chuẩn được sử dụng bởi hầu hết các khách hàng LLM. Bạn phải chỉ định ID mô hình là "uncensored". Mô hình này là một mô hình ngôn ngữ lớn trọng số mở được lưu trữ trên máy chủ của chúng tôi, được tinh chỉnh để trả lời mà không từ chối nội dung cho mục đích người trưởng thành hợp pháp.

• Endpoint: POST /v1/chat/completions
• ID mô hình: uncensored

API chỉ trả về phản hồi văn bản. Nó không hỗ trợ hình ảnh, âm thanh, video hoặc embedding. Đối với hầu hết các nhà phát triển, endpoint này thay thế endpoint chat tiêu chuẩn của OpenAI mà không cần thay đổi mã nào ngoài URL cơ sở và ID mô hình.

Tích hợp SDK Python

Sử dụng thư viện Python chính thức của OpenAI là cách nhanh nhất để tích hợp. Đặt URL cơ sở thành endpoint của chúng tôi và cung cấp khóa API của bạn. Mã dưới đây minh họa một yêu cầu hoàn thiện văn bản đơn giản.

• Cài đặt thư viện: pip install openai
• Đặt base_url thành https://api.mistralapi.com/v1
• Sử dụng model="uncensored"

Phương pháp này hoạt động vì API của chúng tôi sao chép cấu trúc phản hồi của OpenAI. Bạn có thể sử dụng các thư viện hiện có cho truyền phát (streaming), gọi hàm và chế độ JSON mà không cần sửa đổi.

Tích hợp SDK Node.js

Đối với nhà phát triển JavaScript/TypeScript, gói npm openai hoạt động mượt mà. Cấu hình client với URL cơ sở và khóa API của bạn. Bạn có thể dùng cùng mã nguồn cho cả OpenAI và mô hình không kiểm duyệt của chúng tôi.

• Cài đặt thư viện: npm install openai
• Định cấu hình baseUrl thành https://api.mistralapi.com/v1
• Chỉ định model: "uncensored"

Tương thích này áp dụng cho tất cả tham số chuẩn như temperature, top_p và trình tự stop. Bạn có thể chuyển nhà cung cấp dễ dàng bằng cách thay đổi cấu hình client.

Phản hồi truyền phát (Streaming)

Chúng tôi hỗ trợ phản hồi truyền phát qua Server-Sent Events (SSE). Bạn nhận được token khi chúng được tạo, giảm độ trễ cảm nhận. Sự kiện gửi bởi máy chủ cuối cùng bao gồm thống kê sử dụng token để tính phí.

• Đặt stream: true trong yêu cầu của bạn
• Đọc các chunk từ phản hồi
• Phân tích chunk cuối cùng để lấy dữ liệu sử dụng

Truyền phát (streaming) lý tưởng cho giao diện trò chuyện và các ứng dụng thời gian thực. Định dạng phản hồi khớp với tiêu chuẩn truyền phát (streaming) của OpenAI, vì vậy logic truyền phát (streaming) hiện có của bạn sẽ hoạt động mà không cần thay đổi.

Giới hạn, Lỗi & Cửa sổ ngữ cảnh

API của chúng tôi có các giới hạn cụ thể để đảm bảo ổn định. Mỗi khóa API hỗ trợ 300 yêu cầu mỗi phút và 8 yêu cầu đồng thời. Kích thước yêu cầu tối đa là 8 MB. Cửa sổ ngữ cảnh là 100.000 token tổng cộng (prompt + completion). Nếu bạn không đặt max_tokens, đầu ra mặc định là 2.048 token; nếu không, đầu ra tối đa là 32.000 token.

• 401: Khóa API không hợp lệ
• 402: Tín dụng không đủ
• 429: Vượt quá giới hạn tốc độ

Tín dụng cao cấp không bao giờ hết hạn. Lỗi và từ chối đều miễn phí. Nếu bạn gặp sự cố, hãy sử dụng trang Hỗ trợ để hoàn tiền hoặc trợ giúp tài khoản.

cURL

Sao chépcurl https://api.mistralapi.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."}]
  }'

Python

Sao chépfrom openai import OpenAI

client = OpenAI(base_url="https://api.mistralapi.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)

Node.js

Sao chépimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.mistralapi.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);

Streaming

Sao chépstream = 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)