快速开始

API参考

SDK和库

API网关文档

欢迎使用 API网关，这是一个统一的大模型接口网关，支持多种主流大模型供应商，提供统一的API接口。

🚀 快速开始

使用您的API密钥，将API基址指向我们的服务，即可开始使用所有支持的大模型。

快速开始

只需三步，即可开始使用 API网关：

1

获取API密钥

访问控制台获取您的API密钥

2

配置API基址

将API基址设置为: https://www.zszf.site/v1

3

开始使用

使用 OpenAI 兼容的SDK或直接调用API

认证

所有API请求都需要通过 HTTP 请求头进行身份验证：

HTTP
Authorization: Bearer YOUR_API_KEY

# 或者使用
X-API-Key: YOUR_API_KEY

聊天补全

创建一个聊天补全请求，使用指定的模型生成对话响应。

POST /v1/chat/completions
{
    "model": "gpt-4",
    "messages": [
        {"role": "system", "content": "你是一个助手"},
        {"role": "user", "content": "你好！"}
    ],
    "temperature": 0.7
}

响应示例

JSON
{
    "id": "chatcmpl-xxx",
    "object": "chat.completion",
    "created": 1700000000,
    "model": "gpt-4",
    "choices": [{
        "index": 0,
        "message": {
            "role": "assistant",
            "content": "你好！有什么可以帮助你的吗？"
        },
        "finish_reason": "stop"
    }],
    "usage": {
        "prompt_tokens": 10,
        "completion_tokens": 20,
        "total_tokens": 30
    }
}

模型列表

获取当前可用的所有模型列表。

GET /v1/models
{
    "object": "list",
    "data": [
        {"id": "gpt-4", "object": "model", "owned_by": "openai"},
        {"id": "gpt-3.5-turbo", "object": "model", "owned_by": "openai"},
        {"id": "claude-3-opus", "object": "model", "owned_by": "anthropic"},
        {"id": "gemini-pro", "object": "model", "owned_by": "google"}
    ]
}

Python SDK

使用官方的 OpenAI Python SDK，只需修改 base_url：

Python
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://www.zszf.site/v1"
)

response = client.chat.completions.create(
    model="gpt-4",
    messages=[{"role": "user", "content": "你好！"}]
)

print(response.choices[0].message.content)

JavaScript SDK

使用官方的 OpenAI JavaScript SDK：

JavaScript
import OpenAI from 'openai';

const openai = new OpenAI({
    apiKey: 'YOUR_API_KEY',
    baseURL: 'https://www.zszf.site/v1'
});

const response = await openai.chat.completions.create({
    model: 'gpt-4',
    messages: [{ role: 'user', content: '你好！' }]
});

console.log(response.choices[0].message.content);

使用 cURL

直接使用 cURL 发送请求：

Bash
curl https://www.zszf.site/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-4",
    "messages": [{"role": "user", "content": "你好！"}]
  }'