URL cơ sở của API Mimo là gì?

Với dịch vụ này, đó là https://api.mimoapi.top/v1. Hãy dùng làm URL cơ sở trong bất kỳ máy khách tương thích OpenAI nào, với ID mô hình là uncensored và khóa của bạn dưới dạng token Bearer.

Tôi có nên bao gồm /chat/completions trong URL cơ sở không?

Không. Máy khách tự thêm đường dẫn đó. Chỉ bao gồm khi trường yêu cầu endpoint trò chuyện đầy đủ, lúc đó giá trị là https://api.mimoapi.top/v1/chat/completions.

Tại sao tôi nhận được lỗi không tìm thấy?

URL cuối cùng thường sai: thiếu /v1, đường dẫn bị lặp lại, hoặc dùng tên miền trang web thay vì tên miền phụ api. In URL mà máy khách gửi và so sánh với các endpoint ở trên.

Tôi có thể dùng biến môi trường thay vì chỉnh sửa mã nguồn không?

Có. Các SDK OpenAI cho Python và Node.js đọc OPENAI_BASE_URL và OPENAI_API_KEY, nên bạn có thể trỏ lại tập lệnh bằng cách xuất các biến này và đổi tên mô hình thành uncensored.

URL cơ sở của API Mimo và cách cấu hình máy khách

Các giá trị để sao chép

Bất kỳ ai tìm kiếm url cơ sở của mimo api đều cần ba giá trị, mọi thứ khác chỉ là chi tiết của công cụ bạn đang cấu hình.

Cài đặt	Giá trị
URL gốc	`https://api.mimoapi.top/v1`
ID mô hình	`uncensored`
Tiêu đề xác thực	`Authorization: Bearer YOUR_KEY`
Endpoint chat	`POST /v1/chat/completions`
Danh sách mô hình	`GET /v1/models`

Dịch vụ tương thích OpenAI, nên bất kỳ máy khách nào cho phép bạn thay đổi URL cơ sở và khóa OpenAI đều hoạt động. Đây là API văn bản được lưu trữ, chạy một mô hình trọng số mở từ nhà cung cấp độc lập; đây không phải API chính thức của bất kỳ nhà cung cấp mô hình nào. Chỉ văn bản: không có tạo ảnh, âm thanh hoặc video, không có embedding và không có tinh chỉnh, nên các máy khách mong đợi các endpoint đó sẽ không tìm thấy chúng. Nếu bạn chưa có khóa, trang khóa chỉ mất một phút.

URL cơ sở so với endpoint đầy đủ

Sự nhầm lẫn phổ biến nhất là giữa URL cơ sở và URL endpoint. URL cơ sở dừng ở /v1. Endpoint là URL cơ sở cộng với đường dẫn. Các SDK OpenAI chính thức và hầu hết các công cụ xây dựng trên đó tự ghép hai phần này cho bạn.

URL cơ sở: https://api.mimoapi.top/v1
Endpoint trò chuyện: https://api.mimoapi.top/v1/chat/completions
Endpoint mô hình: https://api.mimoapi.top/v1/models

Khi màn hình cài đặt yêu cầu "URL cơ sở", "API base", "endpoint" hoặc "host", hãy đọc placeholder của nó. Nếu placeholder kết thúc bằng /v1, hãy dán URL cơ sở. Nếu nó kết thúc bằng /chat/completions, hãy dán endpoint trò chuyện đầy đủ. Dán endpoint đầy đủ vào trường yêu cầu URL cơ sở sẽ tạo ra /chat/completions/chat/completions, đường dẫn này không tồn tại. Dán chỉ tên miền cơ bản vào trường yêu cầu URL cơ sở sẽ tạo ra /chat/completions mà không có /v1, dẫn đến lỗi tương tự.

Lưu ý cả tên máy chủ. API nằm trên tên miền phụ api. Tên miền trang web chính phục vụ các trang web, nên yêu cầu đến đó với đường dẫn API sẽ không đến được mô hình.

Python và Node

Với các SDK chính thức, bạn đặt URL cơ sở một lần khi tạo máy khách. Cài đặt với pip install openai hoặc npm install openai.

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": "Name three uses for a base URL."}],
    max_tokens=150,
)
print(resp.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.mimoapi.top/v1",
  apiKey: process.env.LLM_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Name three uses for a base URL." }],
  max_tokens: 150,
});
console.log(resp.choices[0].message.content);

Các SDK OpenAI cho Python và Node.js cũng đọc các biến môi trường OPENAI_BASE_URL và OPENAI_API_KEY khi bạn không truyền giá trị trong mã. Điều này cho phép bạn trỏ lại một tập lệnh hiện có mà không cần chỉnh sửa: xuất hai biến này, và tập lệnh sẽ giao tiếp với API này. Kiểm tra xem tập lệnh có mã cứng tên mô hình như tên GPT không; hãy thay thế nó bằng uncensored.

curl để kiểm tra nhanh

Một lệnh gọi HTTP thuần túy loại bỏ mọi biến số khác, nên đây là bước kiểm tra đầu tiên tốt nhất. Lệnh đầu tiên liệt kê các mô hình và xác nhận khóa. Lệnh thứ hai gửi yêu cầu trò chuyện.

export LLM_API_KEY="YOUR_KEY"

curl -s https://api.mimoapi.top/v1/models \
  -H "Authorization: Bearer $LLM_API_KEY"

curl -s https://api.mimoapi.top/v1/chat/completions \
  -H "Authorization: Bearer $LLM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}],"max_tokens":20}' -i

Cờ -i in ra các tiêu đề phản hồi. Hãy tìm X-Request-Id (hãy cung cấp nó khi liên hệ hỗ trợ), X-Balance-USD (tín dụng còn lại của bạn) và hai tiêu đề giới hạn tốc độ, X-RateLimit-Limit-Requests và X-RateLimit-Limit-Concurrency. Để truyền phát, thêm "stream": true vào thân và -N vào curl để đầu ra không bị đệm. hướng dẫn nhanh năm phút sẽ hướng dẫn bạn về truyền phát và gọi công cụ sau phần này.

LangChain, giao diện trò chuyện và các công cụ khác

Các công cụ bên thứ ba sử dụng nhãn riêng, nhưng tất cả đều cần ba giá trị giống nhau. Một số mẫu bạn sẽ thấy:

LangChain (Python): ChatOpenAI(model="uncensored", base_url="https://api.mimoapi.top/v1", api_key="YOUR_KEY"). Lớp tương tự hoạt động cho bất kỳ máy chủ tương thích OpenAI nào.
SillyTavern và các giao diện đóng vai tương tự: chọn nguồn trò chuyện tùy chỉnh hoặc chung chung tương thích OpenAI, dán URL cơ sở, thêm khóa, và gõ uncensored làm tên mô hình nếu danh sách không tự điền.
Open WebUI và các giao diện trò chuyện tự lưu trữ khác: thêm kết nối tương thích OpenAI trong cài đặt, sử dụng cùng URL cơ sở và khóa.
Plugin trình soạn thảo và tập lệnh: tìm "endpoint OpenAI tùy chỉnh" hoặc "ghi đè URL cơ sở" trong cài đặt plugin.

Tên menu của mỗi công cụ thay đổi giữa các phiên bản, nên hãy dựa vào mục đích của trường thay vì nhãn chính xác. Nếu công cụ khăng khăng kiểm tra khóa với nhà cung cấp cố định, nó không tương thích với endpoint tùy chỉnh, và một công cụ khác là giải pháp.

Khi công cụ cung cấp danh sách thả xuống mô hình, nó thường điền bằng cách gọi GET /v1/models. Nếu danh sách thả xuống vẫn trống, hãy gõ ID mô hình bằng tay. Nếu công cụ từ chối tên mô hình không xác định, hãy tìm tùy chọn có nhãn "mô hình tùy chỉnh".

Khắc phục các lỗi cấu hình thường gặp

Khi yêu cầu thất bại, mã trạng thái và URL chính xác giúp thu hẹp nguyên nhân nhanh chóng. Hãy xem qua danh sách này.

Lỗi xác thực. Khóa bị thiếu, bị cắt ngắn hoặc có khoảng trắng hoặc ký tự xuống dòng ở cuối. Dán lại khóa và đảm bảo tiêu đề đọc Bearer, một khoảng trắng, sau đó là khóa.
Không tìm thấy. Đường dẫn sai. In URL cuối cùng mà máy khách tạo ra. Nó phải chính xác là https://api.mimoapi.top/v1/chat/completions. Hãy tìm /v1 bị thiếu, đường dẫn bị lặp lại hoặc tên máy chủ sai.
Mô hình không xác định. Tên mô hình còn sót lại từ nhà cung cấp khác. Đặt mô hình thành uncensored.
HTTP 429 với rate_limited hoặc concurrency. Bạn vượt quá 300 yêu cầu mỗi phút hoặc 8 yêu cầu đồng thời (60 và 2 trên khóa dùng thử). Hãy giảm tốc độ hoặc xếp hàng yêu cầu. Mã 429 với tiêu đề Retry-After: 5 có nghĩa là quá tải tạm thời; hãy đợi năm giây và thử lại.
Yêu cầu quá lớn. Giới hạn kích thước body là 8 MB, và cửa sổ ngữ cảnh là 100.000 token cho prompt cộng với kết quả. Hãy cắt ngắn lịch sử.
Hoạt động trong curl, thất bại trong trình duyệt. Gọi API trực tiếp từ JavaScript phía client khiến khóa của bạn bị lộ cho mọi khách truy cập. Hãy chuyển hướng các yêu cầu qua máy chủ của riêng bạn.

Không bao giờ đặt khóa trong kho lưu trữ công khai hoặc gói phía máy khách. Hãy lưu trữ nó trong biến môi trường và giữ nó khỏi ảnh chụp màn hình và ticket hỗ trợ.

Các bước tiếp theo sau lệnh gọi thành công đầu tiên

Khi URL cơ sở hoạt động, một vài cài đặt đáng biết. Truyền phát qua SSE được bật bằng stream: true. Gọi công cụ sử dụng tools và tool_choice, với kết quả gửi lại dưới dạng tin nhắn role: "tool". Chế độ JSON là response_format: {"type": "json_object"}. Các điều khiển lấy mẫu như temperature, top_p, stop, seed và các tham số penalty được chuyển tiếp.

Về mặt tài chính, bạn trả $0,15 cho mỗi 1 triệu token đầu vào và $0,50 cho mỗi 1 triệu token đầu ra từ tín dụng trả trước; trang giá cả liệt kê các mức nạp tiền và ưu đãi. Mô hình được tinh chỉnh để trả lời mà không từ chối nội dung cho việc sử dụng hợp pháp của người trưởng thành, và nội dung tình dục liên quan đến người chưa thành niên luôn bị cấm. Các prompt không được dùng để huấn luyện.