Hướng dẫn nhanh cho người dùng Kimicode

Yêu cầu tiên quyết

Trước khi viết mã, hãy tạo tài khoản tại kimicode.cc bằng Google hoặc email. Bạn sẽ nhận được một khóa API duy nhất ngay lập tức. Không cần xác minh số điện thoại và không cần thẻ tín dụng. Tài khoản của bạn bắt đầu với $0.50 tín dụng dùng thử có hiệu lực trong bảy ngày. Nếu bạn cần nhiều dung lượng hơn, hãy nạp tiền qua tiền điện tử (USDT trên TRC20 hoặc USDC trên Base) bắt đầu từ $10. Tín dụng không bao giờ hết hạn, và lỗi hoặc từ chối không tiêu tốn token.

Đảm bảo môi trường phát triển của bạn có Node.js (v18+) hoặc Python 3.8+. API này tuân thủ nghiêm ngặt đặc tả client openai, nghĩa là bạn có thể thay thế endpoint của chúng tôi mà không cần thay đổi logic thư viện. Chúng tôi cung cấp một mô hình không kiểm duyệt với ID uncensored.

Cài đặt SDK

Cài đặt SDK chính thức của OpenAI cho ngôn ngữ bạn chọn. Điều này đảm bảo tương thích với các tính năng truyền phát, gọi hàm và chế độ JSON của chúng tôi.

Đối với Python, hãy sử dụng pip để cài đặt thư viện tiêu chuẩn:

• pip install openai

Đối với Node.js, hãy cài đặt gói npm:

• npm install openai

Các thư viện này tự động xử lý định dạng HTTP. Bạn không cần client đặc thù của nhà cung cấp. API kimicode chấp nhận các tham số tiêu chuẩn như temperature, top_p và max_tokens.

Khởi tạo Client

Cấu hình đối tượng client của bạn với URL cơ sở kimicode và khóa API của bạn. URL cơ sở là https://api.kimicode.cc/v1. Đặt api_key thành giá trị bạn nhận được khi đăng ký. Cấu hình này thay thế endpoint mặc định api.openai.com.

• URL cơ sở: https://api.kimicode.cc/v1
• Mô hình: uncensored
• Xác thực: Bearer token qua api_key

Đừng trộn khóa này với các nhà cung cấp khác. Khóa này chỉ hoạt động với endpoint kimicode. Client sẽ xác minh khóa trong yêu cầu đầu tiên. Nếu khóa không hợp lệ, bạn sẽ nhận lỗi 401 ngay lập tức.

Gửi yêu cầu

Gửi yêu cầu hoàn thành chat tiêu chuẩn. ID mô hình phải là uncensored. Bạn có thể điều chỉnh max_tokens lên đến 32.000. Nếu bỏ qua, mặc định là 2.048. Cửa sổ ngữ cảnh là 100.000 token tổng cộng cho prompt và hoàn thành kết hợp.

• Đầu vào: Tin nhắn văn bản trong mảng messages.
• Đầu ra: Phản hồi văn bản trong choices[0].message.content.

Endpoint này hỗ trợ chế độ JSON qua response_format: {"type": "json_object"}. Nó không hỗ trợ embeddings, hình ảnh hoặc âm thanh. Tập trung vào việc tạo văn bản chất lượng cao mà không bị từ chối nội dung cho các chủ đề người trưởng thành hợp pháp.

Truyền phát phản hồi

Bật truyền phát bằng cách đặt stream: true. API trả về Server-Sent Events (SSE). Mỗi chunk chứa văn bản từng phần. Thống kê sử dụng token được bao gồm trong chunk cuối cùng của luồng. Điều này cho phép hiển thị đầu ra theo thời gian thực mà không cần chờ phản hồi đầy đủ.

• Cờ luồng: Đặt thành true trong thân yêu cầu.
• Loại sự kiện: chat.completion.chunk
• Dữ liệu: Chứa delta.content cho các phần văn bản.

Truyền phát không thay đổi giá. Bạn trả tiền cho tổng số token đã xử lý. Lỗi trong quá trình truyền phát được xử lý mượt mà. Nếu kết nối bị ngắt, bạn có thể khởi động lại yêu cầu. Mô hình không kiểm duyệt duy trì tính nhất quán ngay cả khi truyền phát dài trong giới hạn 100k.

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

Theo dõi giới hạn sử dụng của bạn: 300 yêu cầu mỗi phút trên mỗi khóa, 8 yêu cầu đồng thời và thân yêu cầu 8 MB. Nếu bạn vượt quá giới hạn tốc độ, bạn sẽ nhận được lỗi 429. Nếu tín dụng trả trước của bạn đã hết, bạn sẽ nhận được lỗi 402; hãy nạp tiền qua tiền điện tử để tiếp tục. Lỗi 401 cho biết khóa API không hợp lệ hoặc bị thiếu. Lưu ý rằng các yêu cầu thất bại và từ chối không tiêu tốn token. Giới hạn nội dung cứng chặn nội dung tình dục liên quan đến trẻ vị thành niên. Tất cả các nội dung người trưởng thành hợp pháp khác đều được phép.

Gọi hàm

Xác định các công cụ trong tham số tools. Mô hình trả về các lệnh gọi công cụ trong phản hồi. Sử dụng tool_choice để buộc hành vi cụ thể. Tính năng này hoạt động giống hệt với tiêu chuẩn OpenAI. Phân tích cú pháp các lệnh gọi công cụ trong mã của bạn và thực thi chúng. Gửi kết quả lại trong các thông báo tiếp theo. API kimicode xử lý các định nghĩa công cụ một cách hiệu quả. Đảm bảo lược đồ JSON của bạn hợp lệ. Gọi hàm không yêu cầu tín dụng bổ sung ngoài việc sử dụng token. Nó lý tưởng để xây dựng agent hoặc quy trình trích xuất dữ liệu có cấu trúc.

cURL

Copycurl https://api.kimicode.cc/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."}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Truyền phát

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)