vi ▾
Tạo khóa

Bắt đầu nhanh: Kết nối máy khách của bạn

Kết nối các công cụ hiện có của bạn với LLM không kiểm duyệt của chúng tôi trong vài phút bằng định dạng API tương thích OpenAI tiêu chuẩn. Hướng dẫn bắt đầu nhanh này bao gồm xác thực, cấu trúc yêu cầu và chế độ phát trực tiếp để tích hợp ngay lập tức.

Điều kiện tiên quyết và Cài đặt SDK

Cài đặt SDK chính thức cho ngôn ngữ của bạn để tự động xử lý xác thực và tuần tự hóa yêu cầu. Bạn cần một khóa API hợp lệ và URL cơ sở được cấu hình trong môi trường máy khách của bạn. Dịch vụ của chúng tôi chấp nhận các tham số tiêu chuẩn như temperature và top_p mà không cần yêu cầu các tiêu đề tùy chỉnh.

Đảm bảo biến môi trường của bạn chứa token của bạn một cách bảo mật trước khi chạy bất kỳ tập lệnh nào. Các phiên bản SDK phải được cập nhật để hỗ trợ đúng các tính năng streaming và chế độ JSON. Không cần trình điều khiển bổ sung cho việc tạo văn bản thuần túy.

Cấu hình URL cơ sở và Khóa

Điểm client của bạn đến URL cơ sở cụ thể của chúng tôi để định tuyến yêu cầu qua cơ sở hạ tầng không kiểm duyệt của chúng tôi. Sử dụng tiêu đề Authorization: Bearer YOUR_KEY để xác thực mọi lệnh gọi. Cấu hình này hoạt động giống hệt nhau cho việc kiểm tra cục bộ hoặc triển khai tập lệnh sản xuất.

Thay thế điểm cuối OpenAI mặc định bằng máy chủ của chúng tôi để tránh nhầm lẫn với các nhà cung cấp khác. Giữ khóa của bạn bí mật và không công khai nó trong các kho lưu trữ công cộng. Cấu hình vẫn tĩnh cho đến khi bạn xoay khóa.

Gửi yêu cầu đầu tiên của bạn

Thực hiện một lệnh gọi hoàn thành trò chuyện tiêu chuẩn để xác minh kết nối và định dạng phản hồi. Gửi một prompt đơn giản để xác nhận mô hình trả về văn bản mà không từ chối. Bài kiểm tra này đảm bảo khóa của bạn có đủ tín dụng trả trước để sử dụng.

curl https://api.keyapiminimax.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a JSON object with keys id and name"}]
  }'

Kiểm tra phản hồi để xem chi tiết về nội dung và mức sử dụng token. Nếu bạn nhận được lỗi 401, hãy xác định lại định dạng khóa của bạn. Lỗi 402 cho biết bạn cần nạp thêm tín dụng.

Xử lý phản hồi phát trực tiếp

Bật chế độ streaming để nhận các token theo thời gian thực khi chúng được tạo. Điều này giảm độ trễ cảm nhận cho người dùng đang chờ các đầu ra dài. Chunk cuối cùng chứa số đếm token cuối cùng để đảm bảo tính chính xác khi tính toán hóa đơn.

stream = 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)

Xử lý gracefully các phản hồi từng phần trong mã máy khách của bạn. Đệm nội dung cho đến khi luồng đóng hoặc xảy ra lỗi. Phát trực tiếp hoạt động với tất cả các tham số tiêu chuẩn bao gồm điều chỉnh nhiệt độ.

Tích hợp SDK Python

Sử dụng thư viện Python để quản lý các yêu cầu với ít mã boilerplate nhất. Khởi tạo client với URL cơ sở và khóa của bạn để sử dụng ngay lập tức. Cách tiếp cận này đơn giản hóa việc xử lý lỗi và phân tích phản hồi.

from openai import OpenAI

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

Truy cập nội dung được tạo trực tiếp từ đối tượng phản hồi. Kiểm tra lỗi và xử lý giới hạn tốc độ một cách thích hợp. SDK hỗ trợ cả quy trình đồng bộ và bất đồng bộ.

SDK Node và Giới hạn

Tích hợp với các ứng dụng Node.js bằng SDK JavaScript chính thức. Đặt URL cơ sở để đảm bảo các yêu cầu đến được điểm cuối không kiểm duyệt của chúng tôi. Theo dõi mức sử dụng của bạn để duy trì trong giới hạn tốc độ.

import OpenAI from "openai";

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

Bạn có thể thực hiện 300 yêu cầu mỗi phút với độ đồng thời là 8. Mỗi thân yêu cầu phải nhỏ hơn 8 MB. Cửa sổ ngữ cảnh hỗ trợ tổng cộng 100,000 token. Lỗi và từ chối không tiêu thụ tín dụng, nhưng kết quả đầu ra thành công thì có. Hãy giữ khóa của bạn an toàn và xoay vòng nếu cần.

Hiểu về Sử dụng Token

Thanh toán dựa trên số token thực tế được sử dụng trong prompt và completion. Token đầu vào tốn $0.15 cho mỗi triệu, trong khi token đầu ra tốn $0.50 cho mỗi triệu. Tín dụng trả trước bao gồm tất cả việc sử dụng mà không có phí hàng tháng.

Lỗi và từ chối đều miễn phí, nên bạn chỉ trả tiền cho các phản hồi thành công. Chunk cuối cùng trong luồng dữ liệu chứa số lượng token. Theo dõi bảng điều khiển của bạn để theo dõi chi tiêu và tránh hết tín dụng. Nạp thêm USDT hoặc USDC để truy cập ngay lập tức.

Câu hỏi thường gặp

Kích thước cửa sổ ngữ cảnh cho các yêu cầu là gì?

Tổng cửa sổ ngữ cảnh là 100,000 token, kết hợp cả prompt và phần hoàn thành. Đầu ra tối đa mỗi yêu cầu là 16,000 token, hoặc 2,048 nếu bạn không chỉ định max_tokens.

Làm thế nào để xử lý giới hạn tốc độ và lỗi?

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. Mã trạng thái 401 có nghĩa là khóa của bạn không hợp lệ, trong khi 402 cho biết số dư không đủ. Lỗi 429 báo hiệu rằng bạn đã vượt quá giới hạn tốc độ.

Khóa API không kiểm duyệt có hoạt động với các công cụ tiêu chuẩn không?

Có, key hoạt động với bất kỳ client tương thích OpenAI nào bằng cách thay đổi base URL. Nó hỗ trợ streaming, chế độ JSON và gọi hàm giống như các nhà cung cấp lớn. Bạn có thể sử dụng nó với các tiện ích mở rộng IDE và bot phổ biến ngay lập tức.

Tạo khóa API của bạn ngay lập tức

Đăng ký, sao chép token, cập nhật endpoint. Đó là tất cả những gì bạn cần làm.

Tạo khóa