Tài liệu API - KimiCode

Base URL và Xác thực

Kết nối mã của bạn với API của chúng tôi bằng cách cập nhật URL cơ sở và cung cấp khóa của bạn trong tiêu đề. Chúng tôi hỗ trợ xác thực tiêu chuẩn, vì vậy các khách hàng SDK OpenAI hiện có hoạt động ngay lập tức mà không cần thiết lập phức tạp. Khóa API của bạn xuất hiện ngay lập tức sau khi đăng ký bằng Google hoặc email, không cần số điện thoại.

Mỗi tài khoản chỉ giữ một khóa hoạt động tại một thời điểm; việc tạo khóa mới sẽ thay thế khóa cũ. Các yêu cầu được xác thực qua tiêu đề Authorization, đảm bảo quyền truy cập bảo mật vào tín dụng trả trước của bạn.

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

Gửi tin nhắn đầu tiên bằng cách sử dụng điểm cuối hoàn tất cuộc trò chuyện tiêu chuẩn với một yêu cầu POST đơn giản. Điều này xác nhận tích hợp của bạn hoạt động trước khi bạn đi sâu vào các tính năng nâng cao hoặc dữ liệu luồng. Phản hồi trả về văn bản đầu ra từ model không kiểm duyệt.

• Thay thế YOUR_API_KEY bằng khóa của bạn từ bảng điều khiển.
• Đặt mô hình thành 'uncensored' cho mô hình trọng lượng mở cụ thể của chúng tôi.

Copycurl https://api.kimicodepricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List available plan tiers and token costs"}]
  }'

Tích hợp SDK Python

Sử dụng thư viện Python chính thức của OpenAI để tương tác với API của chúng tôi bằng cách trỏ nó vào base URL của chúng tôi. Cách tiếp cận này tận dụng cú pháp quen thuộc, cho phép bạn chuyển đổi nhà cung cấp mà không cần viết lại toàn bộ logic ứng dụng của bạn. Thư viện tự động xử lý tokenization và định dạng yêu cầu.

• Cài đặt gói openai qua pip.
• Cấu hình URL gốc trỏ đến dịch vụ của chúng tôi.

Copyfrom openai import OpenAI

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

Tích hợp SDK Node

Tích hợp API của chúng tôi vào các ứng dụng JavaScript hoặc TypeScript của bạn bằng SDK Node. Điều này đảm bảo hành vi nhất quán giữa các môi trường frontend và backend của bạn. Bạn có thể truyền tin nhắn và nhận phản hồi giống như bạn làm với bất kỳ dịch vụ tương thích OpenAI tiêu chuẩn nào.

Copyimport OpenAI from "openai";

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

Streaming và Việc Sử Dụng Token

Bật chế độ streaming để nhận quá trình tạo token theo thời gian thực qua Server-Sent Events (SSE). Điều này giảm độ trễ cảm nhận cho người dùng và cho phép hiển thị ngay lập tức các kết quả một phần. Dữ liệu sử dụng token, bao gồm số lượng đầu vào và đầu ra, được nhúng trong chunk cuối cùng của luồng.

Phương pháp này lý tưởng cho các giao diện trò chuyện nơi phản hồi tức thì rất quan trọng. Bạn có thể phân tích luồng để cập nhật giao diện người dùng một cách dần dần mà không cần chờ đợi toàn bộ phản hồi.

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)

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

Quản lý mức sử dụng bằng cách hiểu các giới hạn tốc độ và mã lỗi phổ biến. API hỗ trợ cửa sổ ngữ cảnh 100.000 token, cho phép lưu trữ lịch sử hội thoại sâu. Bạn bị giới hạn ở 300 yêu cầu mỗi phút và 8 yêu cầu đồng thời mỗi khóa.

• 401 cho thấy khóa API không hợp lệ hoặc bị thiếu.
• 402 báo hiệu tín dụng trả trước của bạn đã hết.
• 429 có nghĩa là bạn đã vượt quá giới hạn tốc độ.

Lỗi không tiêu tốn tín dụng của bạn, vì vậy bạn có thể thử lại các yêu cầu thất bại mà không bị phạt.