Kimicode: Yêu cầu đầu tiên trong năm phút

URL cơ sở và Xác thực

Bắt đầu bằng cách trỏ client của bạn đến URL cơ sở của chúng tôi: https://api.kimicode.top/v1. Bạn cần một khóa API cho mọi yêu cầu. Tạo khóa bằng cách nhấp vào Lấy khóa API trên trang web. Sử dụng đăng nhập Google hoặc email và mật khẩu. Không cần số điện thoại. Khóa được hiển thị ngay sau khi tạo. Hãy giữ nó an toàn; mỗi tài khoản chỉ có một khóa hoạt động. Nếu bạn tạo khóa mới, khóa cũ sẽ ngừng hoạt động. Truyền khóa trong tiêu đề Authorization dưới dạng token bearer.

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

Gửi prompt đầu tiên của bạn đến endpoint hoàn tất hội thoại. Sử dụng ID mô hình uncensored. API chấp nhận các định dạng tương thích OpenAI. Đầu vào đi vào, văn bản được trả ra. Lỗi và từ chối miễn phí, vì vậy bạn chỉ trả tiền cho việc sử dụng token thành công. Kiểm tra kết nối bằng một prompt đơn giản.

Sao chépcurl https://api.kimicode.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."}]
  }'

Nếu khóa không hợp lệ, bạn sẽ nhận lỗi 401. Nếu bạn thiếu tín dụng, bạn sẽ nhận lỗi 402. Kiểm tra số dư tài khoản nếu các yêu cầu thất bại một cách bất thường.

Tích hợp Python SDK

Sử dụng Python SDK chính thức của OpenAI. Đặt URL cơ sở thành endpoint của chúng tôi. Truyền khóa API của bạn. Client xử lý định dạng yêu cầu tự động. Điều này hoạt động cho bất kỳ ngôn ngữ nào hỗ trợ client tương thích OpenAI. Cài đặt thư viện qua pip. Cấu hình client với URL cơ sở và khóa của bạn. Gửi tin nhắn bằng endpoint hoàn tất hội thoại. Phản hồi chứa văn bản được tạo. Bạn có thể phân tích cú pháp nội dung trực tiếp từ đối tượng phản hồi.

Sao chépfrom openai import OpenAI

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

Hãy đảm bảo mã của bạn xử lý ngoại lệ một cách tinh tế. Các vấn đề về mạng hoặc giới hạn tốc độ có thể yêu cầu thử lại.

Sử dụng Node SDK

SDK Node.js hoạt động giống hệt. Nhập client. Cấu hình base URL và khóa API. Gọi phương thức chat completions. Truyền model ID và mảng messages. Cấu trúc response khớp với định dạng OpenAI. Trích xuất nội dung message của assistant. Cách này hoạt động cho server-side generation hoặc edge functions. Không cần cấu hình thêm ngoài việc thay đổi base URL.

Sao chépimport OpenAI from "openai";

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

Xử lý lỗi bằng cách kiểm tra mã trạng thái. Giới hạn tốc độ trả về 429. Không đủ tiền trả về 402.

Phản hồi truyền phát

Bật streaming bằng cách đặt stream: true. API trả về Server-Sent Events (SSE). Mỗi chunk chứa nội dung từng phần. Chi tiết sử dụng token xuất hiện ở chunk cuối. Điều này giảm độ trễ cảm nhận cho các output dài. Xử lý việc ngắt stream đúng cách. Đóng kết nối khi stream kết thúc hoặc xảy ra lỗi. Streaming hoạt động với tất cả các client tiêu chuẩn hỗ trợ SSE.

Sao chépstream = 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)

Đảm bảo client của bạn đệm các chunk đúng cách. Nối nội dung để tạo phản hồi cuối cùng.

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

Cửa sổ ngữ cảnh là 100,000 token tổng cộng. Output tối đa là 32,000 token mỗi yêu cầu. Đặt 2,048 nếu max_tokens chưa được đặt. Giới hạn tốc độ là 300 yêu cầu mỗi phút mỗi khóa. Giới hạn concurrency là 8 yêu cầu đồng thời. Body yêu cầu tối đa là 8 MB. Lỗi bao gồm 401 cho khóa không hợp lệ, 402 cho không có tín dụng, và 429 cho giới hạn tốc độ. Tín dụng không bao giờ hết hạn. Lỗi miễn phí. Không có bẫy đăng ký.