API Mistral AI: Hướng dẫn Bắt đầu Nhanh

Base URL và Xác thực

Bước đầu tiên là cấu hình máy khách của bạn để trỏ vào cơ sở hạ tầng của chúng tôi. Thay thế URL cơ sở OpenAI tiêu chuẩn bằng HTTPS://api.apimistralai.com/v1 và đưa khóa API duy nhất của bạn vào tiêu đề ủy quyền. Việc thay đổi đơn giản này chuyển hướng tất cả các yêu cầu đến mô hình không kiểm duyệt của chúng tôi trong khi vẫn giữ nguyên logic tích hợp hiện có của bạn.

• Base URL: HTTPS://api.apimistralai.com/v1
• Xác thực: Mã thông báo Bearer qua Authorization header

Đảm bảo khóa của bạn đang hoạt động trong bảng điều khiển tài khoản của bạn trước khi kiểm tra các kết nối.

Yêu cầu đầu tiên

Gửi yêu cầu hoàn thành trò chuyện tiêu chuẩn để xác minh kết nối và phản hồi của mô hình. Các curl lệnh nhắm mục tiêu vào uncensored model với một lời nhắc cơ bản.

Điều này xác nhận điểm cuối có thể truy cập và trả về văn bản mà không có bộ lọc nội dung tiêu chuẩn.

Copycurl https://api.apimistralai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix syntax error in python list comprehension"}]
  }'

Nếu phản hồi chứa văn bản, thì việc tích hợp của bạn đã được định tuyến thành công qua lớp suy luận không kiểm duyệt của chúng tôi.

Tích hợp SDK Python

Sử dụng thư viện Python chính thức của OpenAI để tương tác với API của chúng tôi mà không cần sửa đổi cấu trúc yêu cầu cốt lõi. Khởi tạo client với base URL mới và API key của bạn, sau đó gọi chat.completions.create.

Phương pháp này cho phép bạn giữ nguyên tất cả logic Python hiện có trong khi truy cập vào các khả năng của mô hình không kiểm duyệt.

Copyfrom openai import OpenAI

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

Đối tượng phản hồi hoạt động giống hệt với các phản hồi OpenAI tiêu chuẩn, giúp quá trình di chuyển trở nên liền mạch cho các nhà phát triển Python.

Tích hợp SDK Node

Đối với môi trường JavaScript hoặc TypeScript, hãy khởi tạo gói OpenAI với URL cơ sở tùy chỉnh. Đặt apiKey và baseURL thuộc tính trước khi gọi chat.completions.create.

Điều này đảm bảo các ứng dụng Node.js của bạn định tuyến yêu cầu đến điểm cuối không kiểm duyệt của chúng tôi trong khi vẫn duy trì tương thích với các mẫu SDK tiêu chuẩn.

Copyimport OpenAI from "openai";

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

Cấu trúc phản hồi vẫn nhất quán với các tiêu chuẩn OpenAI, cho phép tích hợp dễ dàng vào các quy trình làm việc Node.js hiện có.

Phản hồi luồng qua SSE

Bật tạo token theo thời gian thực bằng cách đặt stream: true trong yêu cầu của bạn. API trả về luồng Server-Sent Events (SSE), cho phép bạn xử lý các token khi chúng được tạo.

Điều này giảm độ trễ cảm nhận đối với người dùng và cung cấp phản hồi ngay lập tức trong quá trình hoàn thành dài.

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)

Phân tích luồng dữ liệu SSE để hiển thị token từng phần. Chunk cuối cùng chứa tổng số token được sử dụng cho yêu cầu.

Giới hạn, Lỗi và Ngữ cảnh

Theo dõi mức sử dụng dựa trên các giới hạn tốc độ nghiêm ngặt và xử lý các lỗi HTTP phổ biến một cách khéo léo. Bạn được phép 300 yêu cầu mỗi phút và 8 yêu cầu đồng thời mỗi khóa.

Lỗi 401 cho biết khóa API không hợp lệ hoặc bị thiếu, trong khi lỗi 402 có nghĩa là tín dụng trả trước của bạn đã hết. Mã trạng thái 429 cho biết bạn đã vượt quá giới hạn 300 yêu cầu mỗi phút.

Cửa sổ ngữ cảnh của bạn hỗ trợ 100.000 token tổng cộng, với đầu ra tối đa là 16.000 token cho mỗi yêu cầu. Lỗi và từ chối không tiêu thụ tín dụng, đảm bảo bạn chỉ trả tiền cho nội dung thực tế được tạo ra.