API 文档

高性能 AI 模型接口 | OpenAI 完全兼容 | 负载均衡 | 企业级稳定

3 节点负载均衡
流式响应支持
SSL 加密传输
健康检查机制

平台概述

平台提供高性能、稳定可靠的 AI 模型接口。基础设施采用多节点负载均衡，可用性目标为 99.9%。

核心特性

特性	说明
智能路由	基于最少连接数算法的智能负载均衡
健康检查	每 10 秒自动检测后端节点状态
长连接优化	支持 1000 秒超时的流式响应
高并发支持	单节点 400 并发连接 + 2 分钟 KeepAlive

Base URL： https://www.swfsc.info

快速开始

认证方式

所有 API 请求需要在 HTTP Header 中携带 Bearer Token：

Authorization: Bearer YOUR_API_KEY

快速示例

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

支持模型

模型 ID	能力	上下文长度
gpt-4o	最强推理能力	128K
gpt-4o-mini	快速响应	128K
claude-3-5-sonnet-20241022	长文本分析	200K
gemini-2.0-flash-exp	多模态处理	1M

Chat Completions

POST/v1/chat/completions

创建对话补全，支持流式和非流式响应。

请求示例

{
  "model": "gpt-4o",
  "messages": [
    {
      "role": "system",
      "content": "你是一个有帮助的助手"
    },
    {
      "role": "user",
      "content": "介绍一下中国"
    }
  ],
  "temperature": 0.7,
  "stream": false
}

响应示例

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "created": 1234567890,
  "model": "gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "中国是世界上..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 20,
    "completion_tokens": 150,
    "total_tokens": 170
  }
}

参数说明

参数	类型	必填	说明
model	string	是	模型 ID
messages	array	是	对话历史
temperature	float	否	0.0-2.0，默认 1.0
stream	boolean	否	是否流式返回，默认 false
max_tokens	integer	否	最大生成 token 数

流式响应：设置 stream 为 true 时，响应为 Server-Sent Events，每行以 data: 开头。

List Models

GET/v1/models

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

请求示例

curl https://www.swfsc.info/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

响应示例

{
  "object": "list",
  "data": [
    {
      "id": "gpt-4o",
      "object": "model",
      "created": 1234567890,
      "owned_by": "openai"
    },
    {
      "id": "claude-3-5-sonnet-20241022",
      "object": "model",
      "created": 1234567890,
      "owned_by": "anthropic"
    }
  ]
}

Embeddings

POST/v1/embeddings

生成文本向量表示，用于相似度计算、聚类等场景。

请求示例

{
  "model": "text-embedding-3-small",
  "input": "今天天气真不错",
  "encoding_format": "float"
}

响应示例

{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [
        0.0234, -0.0156
      ]
    }
  ],
  "model": "text-embedding-3-small",
  "usage": {
    "prompt_tokens": 5,
    "total_tokens": 5
  }
}

错误码

HTTP 状态码	错误类型	说明
400	Bad Request	请求参数错误
401	Unauthorized	API Key 无效或未提供
429	Rate Limit	请求频率超限
500	Internal Error	服务器内部错误
502	Bad Gateway	上游服务不可用
503	Service Unavailable	服务暂时不可用

错误响应格式

{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

常见问题

如何获取 API Key？

请联系管理员申请 API Key。每个 Key 都有独立的配额和权限设置。

支持哪些 SDK？

兼容 OpenAI 官方 SDK，可以直接使用：

Python: openai
Node.js: openai
其他语言的 OpenAI 兼容客户端

from openai import OpenAI

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

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

流式响应会超时吗？

服务器配置了 1000 秒的响应超时，足以处理大部分长文本生成任务。

如何查看 API 使用量？

登录管理后台即可查看 Token 用量、请求次数等详细统计信息。