Hướng dẫn bắt đầu nhanh với API

Xác thực & Base URL

API sử dụng xác thực tương thích OpenAI tiêu chuẩn. Bạn nhận được khóa API ngay sau khi đăng ký bằng Google hoặc email. Sử dụng khóa này trong Authorization header cho tất cả các yêu cầu. URL cơ sở được cố định tại https://api.mistralabliterated.com/v1. Không cần cấu hình bổ sung cho đường dẫn điểm cuối.

Copycurl https://api.mistralabliterated.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the first five prime numbers"}]
  }'

Khóa của bạn xác định tài khoản của bạn và theo dõi mức sử dụng. Nếu bạn mất khóa, hãy tạo khóa mới; khóa cũ sẽ không còn hợp lệ.

POST /v1/chat/completions

Gửi tin nhắn đến mô hình bằng cách sử dụng endpoint hoàn thành chat tiêu chuẩn. Model ID luôn là uncensored. Điểm cuối này xử lý các tương tác văn bản vào/văn bản ra mà không yêu cầu các cấu trúc tải trọng phức tạp. Bạn có thể gửi các tin nhắn system, user và assistant trong một yêu cầu duy nhất.

Copyfrom openai import OpenAI

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

Yêu cầu trả về phản hồi JSON có cấu trúc chứa đầu ra của mô hình. Bạn có thể điều chỉnh các tham số như temperature và top_p để kiểm soát sự sáng tạo. Mô hình không từ chối các chủ đề người trưởng thành hợp pháp hoặc gây tranh cãi, cung cấp phong cách phản hồi thô. Lỗi trả về các mã trạng thái HTTP tiêu chuẩn để dễ dàng gỡ lỗi trong cơ sở mã của bạn.

GET /v1/models

Truy vấn các mô hình khả dụng để xác minh kết nối và cấu hình. Endpoint này trả về danh sách các mô hình khả dụng, xác nhận rằng xác thực và URL cơ sở của bạn đều chính xác. Điều này hữu ích để kiểm tra tích hợp của bạn trước khi gửi các payload nặng.

Copyimport OpenAI from "openai";

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

Phản hồi bao gồm ID mô hình và loại đối tượng. Bạn có thể sử dụng điểm cuối này trong chuỗi khởi động ứng dụng của mình để đảm bảo API có thể truy cập được. Nó trả về ngay lập tức với độ trễ thấp, khiến nó rất lý tưởng cho các kiểm tra sức khỏe. Không có tín dụng nào được tiêu thụ bởi yêu cầu này.

Phát trực tiếp & Công cụ

Bật phát trực tiếp bằng cách đặt stream: true trong yêu cầu của bạn. API gửi các chunk văn bản qua Server-Sent Events (SSE) khi chúng được tạo ra. Điều này giảm độ trễ cảm nhận cho người dùng đang chờ các phản hồi dài. Bạn cũng có thể sử dụng gọi hàm bằng cách cung cấp danh sách các công cụ trong yêu cầu.

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)

Thống kê sử dụng token được bao gồm trong chunk cuối cùng của luồng. Điều này cho phép bạn theo dõi chi phí theo thời gian thực. Mô hình hỗ trợ chế độ JSON cho các đầu ra có cấu trúc khi bạn đặt response_format để {"type": "json_object"}. Lựa chọn công cụ rất linh hoạt, cho phép chọn cụ thể hoặc tự động.

Tham số & Giới hạn

Cửa sổ ngữ cảnh hỗ trợ 100.000 token cho tổng prompt và completion. Lượng output tối đa mỗi yêu cầu là 16.000 token, hoặc 2.048 nếu bạn không chỉ định max_tokens. Bạn có thể kiểm soát việc tạo với temperature, top_p, stop, và seed tham số. Các hình phạt về tần suất và hiện diện cũng có sẵn để tinh chỉnh.

Giới hạn tốc độ cho phép 300 yêu cầu mỗi phút cho mỗi khóa và 8 yêu cầu đồng thời. Kích thước thân yêu cầu tối đa là 8 MB. Những giới hạn này đảm bảo hiệu suất ổn định cho các ứng dụng thông lượng cao. Điều chỉnh chiến lược batching của bạn để nằm trong những giới hạn này.

Lỗi & Giá cả

HTTP 401 cho biết khóa API không hợp lệ hoặc bị thiếu. HTTP 402 nghĩa là số dư trả trước của bạn đã hết; hãy nạp thêm tiền bằng tiền điện tử để tiếp tục. HTTP 429 báo hiệu việc vượt quá giới hạn tốc độ; hãy chờ đợi hoặc giảm độ đồng thời. Lỗi không tiêu tốn số dư, nên bạn không phải trả phí cho các yêu cầu thất bại.

Giá là $0.15 cho mỗi triệu token đầu vào và $0.50 cho mỗi triệu token đầu ra. Số dư không bao giờ hết hạn, và không có phí hàng tháng. Nạp tiền bắt đầu từ $20 kèm theo ưu đãi cho các khoản lớn. Hoàn tiền không khả dụng, nhưng hỗ trợ có thể sửa các khoản tính phí trùng lặp.