面向开发者的 API 文档

基础 URL 和认证

基础 URL 为 HTTPS://api.ollamaapiurl.com/v1。通过在 Authorization 请求头中传入您的唯一 API 密钥进行身份验证。该密钥将作为所有请求的凭证。注册后立即从仪表板获取该密钥。

• 保持密钥安全。它授予你预付费额度的完全访问权限。
• 随时从设置页面生成新密钥。

我们的 API 系统很简单。每个账户一个活动密钥，确保清晰的追踪。如果丢失访问权限，可立即重新生成。无需电话号码验证即可阻止您的访问。

首次请求

使用标准 HTTP 发送第一个提示。该端点接受文本输入并返回文本输出。此方法适用于您喜欢的任何 HTTP 客户端库。

Copycurl https://api.ollamaapiurl.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List all available models in the local library"}]
  }'

响应包含令牌使用情况。您只需为处理的令牌付费。错误不会消耗您的预付款余额。这种透明度让您能够精确控制支出。

Python SDK 集成

使用官方 OpenAI Python 库。将其指向我们的 base URL。将 model id 设置为 uncensored。这确保你获得无审查的行为，而无需本地设置的麻烦。

Copyfrom openai import OpenAI

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

该库自动处理重试和格式化。您将获得结构化 JSON 或原始文本。也支持流式传输。这种方式使您的代码保持简洁且易于维护。

Node SDK 设置

安装 openai 包。将基础 URL 配置为指向我们的服务。从您的环境中设置 API 密钥。此设置与 Python 配置非常相似。

Copyimport OpenAI from "openai";

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

Node 开发人员获得一致的行为。模型会立即响应提示。您可以将其集成到任何 Web 服务器或后台工作中。无需复杂的路由逻辑。

流式响应

通过在请求中将 stream 设置为 true 来启用流式传输。API 返回生成的数据块。这改善了用户的感知延迟。你可以实时显示生成的令牌。

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)

最后一个 chunk 包含总 token 数。可用于计费验证。流式传输适用于所有参数。它也支持函数调用。你的用户可以实时看到进度。

限制、错误和上下文

您的上下文窗口总计 100,000 个令牌，包括提示和完成。每次请求最多可输出 16,000 个令牌。速率限制允许每分钟 300 次请求。每个密钥的并发请求上限为 8 个。

常见错误包括 401（无效密钥）。402 错误表示您的预付费余额已耗尽。429 响应表示您达到了速率限制。请查看仪表板通过加密货币充值。余额永不过期。双重收费等错误可通过支持部门修复。