Tài liệu API: Các điểm cuối tương thích OpenAI

Xác thực & Base URL

Truy cập API bằng cách đặt khóa độc nhất của bạn và URL cơ sở trong các biến môi trường của bạn. Endpoint nằm tại https://api.apikeykimi.com/v1. Bạn phải bao gồm header Authorization: Bearer YOUR_API_KEY với mọi yêu cầu. Khóa này được tạo ngay lập tức khi đăng ký qua Google hoặc email. Đây là thông tin xác thực duy nhất cần thiết cho xác thực. Không cần cấu hình phạm vi hoặc quyền.

Copycurl https://api.apikeykimi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "convert this json object to python dictionary syntax"}]
  }'

Endpoint Hoàn thành Trò chuyện

Gửi tin nhắn đến mô hình bằng cách sử dụng tiêu chuẩn /v1/chat/completions endpoint. endpoint. Chỉ định ID mô hình là uncensored trong thân yêu cầu. API trả về văn bản được tạo dựa trên lịch sử câu lệnh của bạn. Bạn có thể điều chỉnh các tham số như nhiệt độ và top_p để kiểm soát sự sáng tạo. Mô hình hỗ trợ gọi hàm và chế độ JSON cho các đầu ra có cấu trúc.

Copyfrom openai import OpenAI

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

Phản hồi luồng (SSE)

Bật phân phối token thời gian thực bằng cách đặt stream: true trong yêu cầu của bạn. Máy chủ trả về một luồng Server-Sent Events. Mỗi chunk chứa văn bản một phần cho đến khi phản hồi hoàn tất. Điều này lý tưởng cho các giao diện trò chuyện và hiển thị mã trực tiếp. Chi tiết sử dụng token xuất hiện trong chunk cuối cùng của luồng.

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)

Gọi hàm & Chế độ JSON

Định nghĩa các công cụ hoặc buộc đầu ra JSON bằng cách sử dụng response_format tham số. Đặt json_object để đảm bảo các phản hồi JSON hợp lệ. Bạn cũng có thể truyền định nghĩa công cụ để gọi hàm. Mô hình tuân thủ nghiêm ngặt các ràng buộc này. Điều này cho phép tích hợp đáng tin cậy với các dịch vụ bên ngoài. Sử dụng tool_choice để kiểm soát cách các công cụ được gọi.

Giới hạn Token & Ràng buộc

Cửa sổ ngữ cảnh hỗ trợ tối đa 100.000 token cho cả đầu vào và đầu ra kết hợp. Đầu ra tối đa cho mỗi yêu cầu là 16.000 token. Nếu bạn không đặt max_tokens, giới hạn mặc định là 2.048 token. Các yêu cầu được giới hạn ở kích thước thân 8 MB. Bạn bị giới hạn ở 300 yêu cầu mỗi phút. Chỉ có 8 yêu cầu có thể chạy đồng thời mỗi khóa.

Xử lý lỗi & Giới hạn sử dụng

Xử lý lỗi bằng cách kiểm tra mã trạng thái HTTP. Mã 401 cho biết khóa API không hợp lệ hoặc đã hết hạn. Lỗi 402 nghĩa là tín dụng trả trước của bạn đã cạn. Phản hồi 429 báo hiệu bạn đã vượt quá giới hạn tốc độ 300 yêu cầu mỗi phút. Lỗi và từ chối không tiêu tốn token. Kiểm tra số dư của bạn trên bảng điều khiển để tránh gián đoạn.

Node.js

Copyimport OpenAI from "openai";

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