OpenAI 兼容端点快速入门指南

前提条件：Python 或 Node.js

安装官方 openai 包到你的运行时环境后再继续。

Python 用户需要 1.0.0 或更高版本。Node 开发者需要 4.0.0 或更高版本。两个版本都支持标准的 chat-completions 结构。

无需额外依赖。SDK 自动处理 JSON 序列化和 HTTP 传输。

配置 base_url 和 API 密钥

将您的 SDK 客户端指向我们的基础 URL 并提供您生成的密钥。

使用 https://api.openaicompatibleendpoint.com/v1 作为 base URL。将 API 密钥设置为仪表板上显示的值。

• Python： base_url="https://api.openaicompatibleendpoint.com/v1"
• Node： baseURL: "https://api.openaicompatibleendpoint.com/v1"

此配置适用于任何兼容 OpenAI SDK 的客户端。无需对逻辑的其他部分进行代码更改。

发送您的第一个聊天补全

向...发起 POST 请求 /v1/chat/completions 附带您的系统和用户消息。

模型 ID 是 uncensored. 该模型针对合法成人或争议性话题无审查地回答。

• 上下文窗口：总共 100,000 个 token。
• 最大输出：16,000 个 token。

发送您的提示并立即接收文本输出。错误和拒绝不收费。只有实际的令牌使用量会消耗您的预存信用。

启用流式传输和函数调用

通过将 stream: true 在请求参数中。

Token 用量包含在流式响应的最后一个数据块中。这使您能够实时跟踪成本。

完全支持函数调用。使用 tools 用于定义您的模式。模型返回结构化的工具调用，您可以在应用程序逻辑中执行它们。JSON 模式也可通过 response_format.

处理错误和 token 限制

API 为常见问题返回标准 HTTP 状态码。

• 401：无效的 API 密钥。检查您的仪表板。
• 402：余额不足。使用 USDT 或 USDC 充值。
• 429：超出速率限制。您每分钟允许 300 次请求。

如果您超过 16,000 令牌输出限制，响应将被截断。上下文窗口包括提示和完成令牌。

定价与限制

按用量付费。输入代币每 1M 计费 $0.15。输出代币每 1M 计费 $0.50。

预存余额永不过期。不发放退款，但重复扣款可通过支持页面修复。

仅使用加密货币充值。可接受的货币为 USDT (TRC20) 和 USDC (Base)。最低充值额为 $20。奖励余额根据金额从 +5% 到 +15% 不等。

cURL

Copycurl https://api.openaicompatibleendpoint.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return list of supported file formats"}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

流式传输

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)