Một API: Hướng dẫn nhanh

URL cơ sở & Xác thực

Bắt đầu bằng cách trỏ client của bạn đến endpoint chuyên dụng của chúng tôi. Đây là api tương thích với OpenAI sử dụng các tiêu đề xác thực tiêu chuẩn, vì vậy bạn chỉ cần thay đổi hai giá trị trong cấu hình của mình.

URL cơ sở là https://api.onekeyllmapi.com/v1. Tạo khóa API độc quyền của bạn trên trang đăng ký. Không cần thẻ để bắt đầu, và khóa sẽ được hiển thị ngay lập tức sau khi đăng ký. Hãy giữ khóa này an toàn; nó xác thực tất cả các yêu cầu đến dịch vụ.

Hoàn tất cơ bản

Gửi một prompt văn bản đơn giản để nhận phản hồi trực tiếp. Đây là cốt lõi của dịch vụ ai api cho nhà phát triển của chúng tôi. Mô hình trả về văn bản không từ chối nội dung cho mục đích người trưởng thành hợp pháp, rất lý tưởng cho các tác vụ sáng tạo hoặc không giới hạn.

• ID mô hình: uncensored
• Endpoint: POST /v1/chat/completions
• Ngữ cảnh: 100.000 token

Thực hiện yêu cầu đầu tiên của bạn với ví dụ này:

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

Tích hợp SDK Python

Sử dụng thư viện Python OpenAI chính thức để tương tác với dịch vụ của chúng tôi. Những thay đổi duy nhất cần thiết là base_url và api_key. Điều này đảm bảo logic hiện có của bạn hoạt động mà không cần sửa đổi.

• Cài đặt qua pip install openai
• Đặt biến môi trường hoặc truyền trực tiếp trong khởi tạo máy khách
• Gọi chat.completions.create() như bình thường

Cấu hình máy khách như thế này:

Copyfrom openai import OpenAI

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

Sử dụng SDK Node.js

Tích hợp với các dự án JavaScript hoặc TypeScript bằng gói Node.js OpenAI tiêu chuẩn. Trỏ máy khách đến URL của chúng tôi và cung cấp khóa của bạn. Cách tiếp cận này duy trì tương thích với bất kỳ cấu trúc máy khách tương thích OpenAI nào.

• Cài đặt qua npm install openai
• Khởi tạo với URL cơ sở tùy chỉnh
• Sử dụng các mẫu async/await tiêu chuẩn

Ví dụ khởi tạo:

Copyimport OpenAI from "openai";

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

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

Nhận phản hồi từng token để giảm độ trễ cảm nhận. api truyền phát của chúng tôi hỗ trợ Server-Sent Events (SSE), cho phép bạn hiển thị đầu ra khi nó được tạo. Điều này hữu ích cho giao diện trò chuyện hoặc các ứng dụng thời gian thực.

• Đặt stream: true trong yêu cầu của bạn
• Phân tích luồng SSE trên máy khách
• Xử lý các token từng phần một cách hiệu quả

Bật truyền phát trong mã của bạn:

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 & Ngữ cảnh

Hiểu các ràng buộc để xây dựng các tích hợp mạnh mẽ. API hỗ trợ cửa sổ ngữ cảnh 100k context api, cho phép xử lý các tài liệu dài hoặc cuộc hội thoại dài. Các yêu cầu bị giới hạn ở kích thước thân 8 MB.

Các lỗi phổ biến bao gồm 401 cho khóa không hợp lệ, 402 khi tín dụng trả trước đã hết, và 429 khi vượt quá 300 yêu cầu mỗi phút. Tín dụng trả theo mức sử dụng không bao giờ hết hạn, và bạn có thể nạp tiền từ $10. Gọi hàm được hỗ trợ để thực thi hàm.