单一 API：快速入门指南

基础 URL 与认证

首先将客户端指向我们的专用接口。此 openai compatible api 使用标准认证头，因此你只需更改配置中的两个值。

基础 URL 为 https://api.onekeyllmapi.com/v1。在注册页面生成你的唯一 API 密钥。开始时无需绑定信用卡，注册后立即显示密钥。请妥善保管该密钥；它用于对所有请求进行认证。

基本补全

发送简单的文本提示词以获取直接响应。这是我们 ai api for developers 服务的核心。模型返回不带内容拒绝的文本，适用于合法成人用途，非常适合创意或无限制任务。

• 模型 ID：uncensored
• 接口：POST /v1/chat/completions
• 上下文：100,000 token

使用以下示例发起你的第一个请求：

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."}]
  }'

Python SDK 集成

使用官方 OpenAI Python 库与我们的服务交互。唯一需要更改的是 base_url 和 api_key。这确保你现有的逻辑无需修改即可工作。

• 通过 pip install openai 安装
• 设置环境变量或在客户端初始化时直接传递
• 照常调用 chat.completions.create()

按如下方式配置客户端：

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)

Node.js SDK 用法

使用标准 OpenAI Node 包与 JavaScript 或 TypeScript 项目集成。将客户端指向我们的 URL 并提供密钥。此方法保持与任何 OpenAI 兼容客户端结构的兼容性。

• 通过 npm install openai 安装
• 使用自定义基础 URL 初始化
• 使用标准的 async/await 模式

初始化示例：

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);

流式响应

逐 token 接收响应以降低感知延迟。我们的 streaming api 支持服务器发送事件 (SSE)，允许你在生成时显示输出。这适用于聊天界面或实时应用。

• 在请求中设置 stream: true
• 在客户端解析 SSE 流
• 高效处理部分 token

在代码中启用流式输出：

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)

限制、错误与上下文

了解约束以构建稳健的集成。API 支持 100k context api 窗口，允许长文档或对话。请求限制为 8 MB 负载大小。

常见错误包括 401（密钥无效）、402（预付额度耗尽）以及超过每分钟 300 次请求时的 429。按量付费额度永不过期，你可以从 $10 起充值。支持用于函数执行的函数调用。