面向开发者的 Ollama API 文档

认证和基础 URL

使用 https://api.ollamaendpointurl.com/v1 作为您的基础 URL，并在 Authorization 。

• 基础 URL: https://api.ollamaendpointurl.com/v1
• 标头: Authorization: Bearer YOUR_API_KEY

在仪表板上通过 Google 或邮箱即时生成您的密钥。无需手机号。此 URL 可与任何标准 OpenAI SDK 配合使用，只需覆盖基础 URL 即可。

首次请求

向以下地址发送 POST 请求 /v1/chat/completions 使用模型 ID uncensored 和你的消息。

Copycurl https://api.ollamaendpointurl.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the default port for Ollama?"}]
  }'

此请求返回包含生成文本的 JSON 响应。如果收到 401 错误，说明您的 API 密钥无效。402 错误表示预付费余额不足。

Python SDK 集成

使用您的密钥和自定义基础 URL 初始化客户端以以编程方式发送请求。

Copyfrom openai import OpenAI

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

设置 max_tokens 用于控制输出长度。如果没有它，默认值为 2,048 个 token。该模型接受标准参数，例如 temperature 和 top_p 用于调整生成行为。

Node SDK 集成

配置 Node.js 客户端以指向我们的端点，以便无缝集成到您的脚本中。

Copyimport OpenAI from "openai";

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

SDK 自动处理序列化。请确保使用支持自定义基础 URL 的较新版本 OpenAI SDK。错误将作为标准 API 异常抛出。

流式响应

通过将 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)

Token 用量详情出现在流的最后一个 chunk 中。这降低了长输出时的感知延迟。该端点支持与大多数客户端库兼容的标准 SSE 格式。

速率限制与上下文窗口

每个 API 密钥限制为每分钟 300 次请求和 8 个并发请求。上下文窗口总共为 100,000 个 token。每次请求的最大输出为 16,000 个 token。请求体超过 8 MB 将被拒绝。429 错误表示您已达到速率限制。稍作等待后重试。错误和拒绝不会消耗信用额度。信用额度永不过期。使用加密货币充值。以 $0.50 试用信用额度开始。立即获取您的密钥。