URL cơ sở và Xác thực
Bắt đầu bằng cách trỏ máy khách tương thích OpenAI của bạn vào URL cơ sở của API Mimo. Bạn sẽ nhận được khóa API ngay sau khi đăng ký bằng Google hoặc email. Truyền khóa này trong tiêu đề Authorization tiêu chuẩn. Định danh mô hình là uncensored, chạy trên mô hình trọng số mở được tinh chỉnh để giảm thiểu từ chối đối với nội dung người trưởng thành hợp pháp.
Khác với các dịch vụ đăng ký, việc thanh toán là trả trước bằng tiền mã hóa. Lỗi không tiêu tốn tín dụng. Bạn có thể xác minh kết nối bằng cách liệt kê các mô hình hoặc gửi một prompt văn bản đơn giản. Hãy giữ khóa của bạn an toàn; một khóa cho mỗi tài khoản sẽ thay thế khóa trước đó nếu bạn tạo khóa mới.
Endpoint Chat Completions Tiêu chuẩn
Gửi yêu cầu POST tiêu chuẩn đến endpoint chat completions. Đặt mô hình thành uncensored và cung cấp các thông điệp của bạn theo định dạng mảng yêu cầu. API trả về đầu ra văn bản dựa trên prompt của bạn. Bạn có thể điều chỉnh các tham số như temperature hoặc top_p để kiểm soát tính sáng tạo.
curl https://api.mimoapi.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."}]
}'Endpoint này xử lý các tương tác văn bản vào, văn bản ra. Endpoint này không hỗ trợ embedding, hình ảnh hoặc tinh chỉnh. Nếu bạn cần những tính năng đó, bạn phải sử dụng một dịch vụ khác. Cửa sổ ngữ cảnh cho phép tối đa 100.000 token tổng cộng cho prompt và kết quả kết hợp.
Tích hợp SDK Python
Sử dụng thư viện Python OpenAI chính thức để tương tác với API. Ghi đè URL cơ sở để trỏ đến endpoint của API Mimo. Điều này cho phép bạn sử dụng các phương thức SDK giống nhau mà bạn dùng cho GPT-4 hoặc các mô hình khác. Đặt khóa API và mô hình mục tiêu trong cấu hình máy khách của bạn.
from openai import OpenAI
client = OpenAI(base_url="https://api.mimoapi.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)Cách tiếp cận này đảm bảo mã của bạn có thể di chuyển. Nếu bạn chuyển nhà cung cấp, bạn chỉ cần thay đổi URL cơ sở và khóa. SDK Python xử lý tuần tự hóa và thử lại tự động. Bạn cũng có thể đặt tham số seed để có đầu ra xác định.
Tích hợp SDK Node.js
Cài đặt gói Node.js OpenAI và định cấu hình URL cơ sở. Truyền khóa API của bạn trong đối tượng cấu hình. Máy khách sẽ định tuyến các yêu cầu đến endpoint mô hình không kiểm duyệt. Điều này hoạt động với cả các import CommonJS và mô-đun ES.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.mimoapi.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);Nhà phát triển Node.js có thể sử dụng các mẫu bất đồng bộ giống nhau mà họ dùng với các dịch vụ tương thích OpenAI khác. SDK xử lý phân tích cú pháp luồng và mã hóa JSON. Bạn có thể đặt max_tokens để kiểm soát độ dài đầu ra, mặc định là 2,048 nếu không được chỉ định.
Phản hồi truyền phát (SSE)
Bật truyền phát bằng cách đặt stream: true trong yêu cầu của bạn. API trả về các Sự kiện do Máy chủ Gửi (SSE) chứa các token từng phần. Điều này cho phép bạn hiển thị đầu ra dần dần cho người dùng. Thống kê sử dụng token xuất hiện trong chunk cuối cùng của luồng.
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)Truyền phát giảm độ trễ cảm nhận được đối với các phản hồi dài. Bạn phải xử lý các sự kiện luồng trong mã máy khách của mình. API không đảm bảo số lượng token chính xác trong khi truyền phát, nhưng chunk cuối cùng bao gồm dữ liệu sử dụng chính xác. Điều này hữu ích cho minh bạch hóa tính phí.
Giới hạn tốc độ, Lỗi và Chế độ JSON
API áp dụng giới hạn 300 yêu cầu mỗi phút trên mỗi khóa và cho phép 8 yêu cầu đồng thời. Nếu bạn vượt quá giới hạn này, bạn sẽ nhận được lỗi 429. Lỗi 401 cho biết khóa không hợp lệ hoặc đã hết hạn. Tín dụng trả trước chỉ được tính cho việc sử dụng token thực tế; lỗi và từ chối đều miễn phí.
Đối với đầu ra có cấu trúc, hãy sử dụng chế độ JSON bằng cách đặt response_format thành json_object. Điều này buộc mô hình trả về JSON hợp lệ. Điều này hữu ích cho gọi hàm hoặc trích xuất dữ liệu. Cửa sổ ngữ cảnh hỗ trợ tối đa 32,000 token đầu ra cho mỗi yêu cầu.
