聚因 AI API 文档

聚因是高性能 AI API 聚合平台，提供 500+ 顶级模型的统一接入接口，完全兼容 OpenAI API 格式，一行代码即可接入。

快速接入

聚因 API 完全兼容 OpenAI SDK，只需将 base_url 替换为聚因地址即可。

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://x.96876.top/v1"
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "你好，聚因！"}]
)
print(response.choices[0].message.content)
复制

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-your-api-key",
  baseURL: "https://x.96876.top/v1"
});

const response = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [{role: "user", content: "你好，聚因！"}]
});
console.log(response.choices[0].message.content);
复制

curl https://x.96876.top/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "你好，聚因！"}]
  }'
复制

鉴权说明

所有请求需在 HTTP Header 中携带 API Key：

Authorization: Bearer sk-xxxxxxxxxxxxxxxx
复制

在控制台获取 API Key

1. 登录 https://x.96876.top
2. 进入「个人中心」→「API 密钥」
3. 点击「新建密钥」，复制保存

Chat 对话接口

请求参数

响应示例

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "gpt-4o",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "你好！我是聚因 AI..."
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 20,
    "total_tokens": 30
  }
}

获取模型列表

curl https://x.96876.top/v1/models \
  -H "Authorization: Bearer sk-your-api-key"
复制

流式输出

设置 stream: true 开启 Server-Sent Events 流式返回，获得更低首字延迟的交互体验。

client = OpenAI(api_key="sk-...", base_url="https://x.96876.top/v1")

with client.chat.completions.stream(
    model="claude-3-5-sonnet-20241022",
    messages=[{"role": "user", "content": "写一首关于AI的诗"}]
) as stream:
    for chunk in stream.text_stream:
        print(chunk, end="", flush=True)
复制

const stream = await client.chat.completions.create({
  model: "claude-3-5-sonnet-20241022",
  messages: [{role: "user", content: "写一首关于AI的诗"}],
  stream: true
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content || "");
}
复制

图像生成

response = client.images.generate(
    model="dall-e-3",
    prompt="一只可爱的机器猫坐在星空下",
    n=1,
    size="1024x1024"
)
print(response.data[0].url)
复制

向量嵌入

response = client.embeddings.create(
    model="text-embedding-3-large",
    input="聚因是最好的 AI API 平台"
)
print(response.data[0].embedding)  # 3072 维向量
复制

OpenAI 系列模型

Claude 系列模型

Gemini 系列模型

DeepSeek 系列模型

其他热门模型

客户端接入指南

聚因兼容所有支持自定义 OpenAI endpoint 的客户端工具：

通用配置参数

错误码说明