Chuyển đổi client của bạn chỉ trong ba dòng

URL cơ bản & Xác thực

Để dùng API, hãy trỏ client của bạn đến https://api.mistralapi.top/v1. Xác thực dựa trên token bearer trong tiêu đề Authorization. Bạn tạo khóa này qua trang Lấy khóa API bằng tài khoản Google hoặc email/mật khẩu. Khóa hiển thị ngay khi tạo. Giữ token này an toàn vì nó cấp quyền truy cập đầy đủ vào tín dụng trả trước của bạn. Khác với nhà cung cấp tiêu chuẩn, chúng tôi không yêu cầu số điện thoại hay thẻ tín dụng để kích hoạt tín dụng dùng thử ban đầu.

Dịch vụ của chúng tôi được thiết kế để tích hợp trực tiếp vào các cấu hình client Mistral hoặc OpenAI hiện có. Chỉ cần cập nhật thuộc tính base_url trong phiên bản SDK của bạn. Cấu trúc endpoint khớp với định dạng /v1/chat/completions tiêu chuẩn, đảm bảo mã hiện có của bạn hoạt động mà không cần sửa đổi. Chúng tôi hỗ trợ một ID mô hình duy nhất, uncensored, xử lý tất cả các tác vụ tạo văn bản.

Endpoint Chat Completions

Tương tác cốt lõi diễn ra qua endpoint POST /v1/chat/completions. Bạn gửi một body JSON chứa ID model, mảng messages và các tham số tùy chọn. API trả về phản hồi văn bản hoặc dữ liệu có cấu trúc nếu bạn chỉ định chế độ JSON. Endpoint này là cách chính để tương tác với LLM. Nó hỗ trợ cả yêu cầu đồng bộ tiêu chuẩn và phản hồi truyền phát. Mọi yêu cầu đều tiêu thụ token từ số dư trả trước của bạn dựa trên khối lượng đầu vào và đầu ra.

Lỗi được xử lý qua các mã trạng thái HTTP tiêu chuẩn. Nếu khóa của bạn không hợp lệ, bạn nhận được 401. Nếu bạn hết tín dụng, bạn nhận được 402. Giới hạn tốc độ được áp dụng ở mức 300 yêu cầu mỗi phút và 8 kết nối đồng thời mỗi khóa. Hãy sử dụng ví dụ sau để xác minh kết nối và tính hợp lệ của khóa.

Copycurl https://api.mistralapi.top/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."}]
  }'

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

Để giảm độ trễ và cải thiện trải nghiệm người dùng, bạn hãy bật chế độ truyền phát (streaming) bằng cách đặt stream: true trong thân yêu cầu. API trả về luồng Sự kiện gửi bởi máy chủ (SSE). Mỗi phần chứa một phản hồi từng phần. Phần cuối cùng bao gồm thống kê sử dụng token đầy đủ cho yêu cầu. Điều này cho phép ứng dụng của bạn hiển thị token khi chúng được tạo ra, thay vì phải chờ đợi quá trình hoàn tất. Truyền phát (streaming) rất lý tưởng cho các giao diện trò chuyện nơi phản hồi ngay lập tức là yếu tố then chốt.

Khi sử dụng truyền phát (streaming), bạn hãy đảm bảo máy khách của mình phân tích cú pháp định dạng SSE đúng cách. Mảng choices trong mỗi phần sẽ chứa nội dung delta. Bạn phải tích lũy các delta này để xây dựng phản hồi đầy đủ. Thống kê sử dụng token chỉ khả dụng trong sự kiện cuối cùng của luồng. Hãy sử dụng phương pháp này để giữ chân người dùng trong khi mô hình xử lý các prompt phức tạp.

Copystream = 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)

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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