Whisper 管道快速入门

前置条件

开始前，请确保你拥有活跃账户和 API 密钥。在 获取 API 密钥 页面仅使用邮箱和密码注册。密钥会立即显示。你获得 $0.50 免费试用额度，有效期 7 天，无需信用卡。用于生产环境，通过加密货币（USDT 或 USDC）从 $10 起充值。我们的定价简单明了：输入 token 每 1M token $0.25，输出 token 每 1M token $1.00。额度永不过期。

Base URL： https://api.whisperapis.com/v1。此接口兼容任何 OpenAI 兼容客户端。你只需配置 Base URL 并在授权头中提供 API 密钥即可。基本 HTTP 请求无需特殊 SDK。

初始化客户端

大多数开发者将使用官方 OpenAI SDK 或兼容库。通过将客户端指向我们的 Base URL 来初始化。这确保所有请求路由到我们的无审查模型，而非 OpenAI 服务器。模型 ID 始终为 uncensored。

确保环境变量 OPENAI_API_KEY 设置为你的密钥。如果你使用其他语言或库，请验证其是否支持自定义 Base URL。SDK 会自动处理 JSON 序列化和头注入，减少管道脚本中的样板代码。

发送聊天补全请求

发送标准的聊天补全请求以优化管道输出。例如，从语音转文本转录中提取结构化 JSON，或生成不带内容过滤的图片说明。

接口为 POST /v1/chat/completions。包含模型 ID、消息数组，以及可选的系统提示词以定义无审查行为。

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

我们的模型能很好地处理高上下文数据，支持总共 100,000 个 token。这非常适合单次处理长转录文本或详细图片描述。

流式响应

对于实时后处理或交互式管道，请启用流式输出。在请求中将 stream 参数设置为 true。API 返回 Server-Sent Events (SSE) 而非单个 JSON 对象。

按到达顺序解析 delta 字段。这降低了大型输出的感知延迟，例如生成详细脚本或从嘈杂的 OCR 结果中提取长文本块。流式格式兼容标准 OpenAI SDK 流式处理程序。

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)

确保客户端正确处理部分分块。当流以 finish_reason 为 stop 或 length 结束时，聚合这些 delta 以重建完整的文本响应。

工具调用支持

我们的无审查模型支持函数调用，允许你为管道定义结构化输出。在 tools 数组中使用 JSON schema 定义定义你的工具。

模型在响应中返回工具调用，你可以执行这些调用以更新对话上下文。这对于从不结构化文本中提取特定数据点非常有用，例如从语音转录中提取日期、名称或坐标。

Copyfrom openai import OpenAI

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

在后续消息中将工具调用传回 API。模型将根据结果优化其输出。这允许在不离开聊天界面的情况下实现复杂的多步推理。确保你的 schema 严格，以避免生成格式错误的 JSON 响应。

限制、错误与上下文

监控你的使用情况以避免中断。API 对每个密钥实施 每分钟 300 个请求 的限制。如果超出此限制，你将收到 429 速率限制错误。在客户端中实现指数退避。

常见错误：

• 401：API 密钥无效或已过期。从仪表板重新生成密钥。
• 402：额度不足。充值账户以继续处理。
• 429：超出速率限制。降低请求频率或分批处理较小任务。

上下文窗口： 模型支持 100,000 个 token 用于提示词 + 补全。如果输入超过此限制，请截断较早的消息或拆分数据。请求体限制为 8 MB。确保你的负载符合这些约束以获得可靠性能。

Node.js

Copyimport OpenAI from "openai";

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