快速入门：聊天补全 API

前提条件与基础 URL

我们的 API 完全兼容标准 OpenAI 聊天补全接口。您只需要一个基础 URL 和 API 密钥即可开始发送请求。基础 URL 为 HTTPS://api.howmuchisanapikey.com/v1。此单一端点处理所有文本生成，无需您管理多个服务 URL 或代理配置。

认证很简单。您必须包含一个 Authorization 标头，采用 Bearer 方案，后跟您的唯一密钥。每个发送到聊天补全端点的请求都需要此标头来验证您的账户，并根据预付费余额跟踪令牌使用情况。

认证与请求头

在每个请求中包含 Authorization 头以验证你的身份。头格式为 Authorization: Bearer YOUR_API_KEY。如果密钥无效或已过期，API 将立即返回 401 错误。这确保只有授权的账户才能消耗你的预付费信用。

对于基本的文本生成，您无需传递额外的头。但是，如果您使用 JSON mode 或 function calling 等特定功能，必须将 Content-Type 头设置为 application/json。这告诉服务器如何正确解析请求体。

发送你的第一次聊天补全

向 /v1/chat/completions 发送 POST 请求，附带你的消息历史和模型标识符。模型 ID 为 "uncensored"。该模型经过微调，对合法的成人内容、虚构作品或争议性话题不进行拒绝。它不过滤基于标准政治或社会规范的内容。

以下是开始使用的基本 curl 示例：

Copycurl https://api.howmuchisanapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a simple hello world function in python"}]
  }'

响应将在 choices 数组中包含生成的文本。您可以将其直接解析到您的应用程序逻辑中。每个请求都会消耗您提示的输入令牌和模型响应的输出令牌。

流式响应和令牌使用

使用服务器发送事件（SSE）接收生成中的 token。这降低了长输出的感知延迟。在请求体中将 stream 参数设置为 true。服务器将发送多个块，每个块包含响应的部分增量。

最后一个数据块包含使用数据。该对象包含请求消耗的总输入和输出令牌。您可以使用此数据更新本地信用余额或实时监控您的支出。流式传输非常适合期望即时反馈的聊天界面。

函数调用和 JSON 模式

API 支持通过 JSON 模式和函数调用进行结构化输出。将 response_format 设置为 {"type": "json_object"} 以强制模型返回有效的 JSON。这对于提取数据或生成结构化配置而无需解析错误非常有用。

对于函数调用，在请求中提供 tools 数组。如果模型判断需要调用函数，它将返回 tool_calls。然后你可以执行该函数并将结果发送回模型。这使得无需外部解析逻辑即可实现复杂的多步工作流。

处理限制和错误

每个密钥每分钟限制 300 次请求，最多支持 8 个并发请求。如果超出这些限制，您将收到 429 Too Many Requests 错误。响应体中将包含 retry-after 详细信息。请调整客户端节流机制，以避免不必要的重试。

如果您的预付费额度已耗尽，API 将返回 402 Payment Required 错误。您可以随时通过加密货币充值。错误和拒绝请求均不收费，因此您只需为成功的令牌生成付费。上下文窗口为 100,000 个令牌（包括提示和补全）。

Python

Copyfrom openai import OpenAI

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