API 文档
算力平方提供统一的 REST API,一个密钥即可调用 100+ 主流 AI 大模型。 接口兼容主流对话补全协议,现有代码仅需替换 Base URL 与密钥。
快速开始
# 1. 注册账号并创建 API Key
# 2. 替换下方密钥即可发起第一次调用
curl https://ai.sl2.cn/v1/chat/completions \
-H "Authorization: Bearer sk-sl2xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"model": "deepseek-v4-flash", "messages": [{"role": "user", "content": "你好"}]}'
认证方式
所有 API 请求通过 HTTP Header 携带密钥进行认证。API Key 请妥善保管,切勿在前端代码或公开仓库中暴露。
Authorization: Bearer sk-sl2xxxxxxxxxxxxxxxx
密钥泄露请立即在控制台删除并重新生成;支持创建多个 Key 按业务隔离。
Base URL
将原厂商接口地址替换为算力平方统一入口,模型名改为模型列表中的取值即可完成迁移:
| 用途 | 地址 |
|---|---|
| 对话 / 补全 / Embedding | https://ai.sl2.cn/v1 |
| 图像生成 | https://ai.sl2.cn/v1/images/generations |
| 视频生成(异步) | https://ai.sl2.cn/v1/videos |
对话补全
POST /v1/chat/completions
| 参数 | 类型 | 说明 |
|---|---|---|
| model | string | 模型 ID,如 deepseek-v4-flash、qwen3.8-max、kimi-k3 |
| messages | array | 对话消息列表,role 取值 system / user / assistant |
| stream | boolean | 是否流式返回,默认 false |
| temperature | number | 采样温度 0-2,默认 1.0 |
| max_tokens | integer | 最大输出 Token 数 |
200 响应示例
{
"id": "chatcmpl-sl2001",
"object": "chat.completion",
"model": "deepseek-v4-flash",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "你好!我是 DeepSeek,很高兴为你服务。"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 12,
"completion_tokens": 18,
"total_tokens": 30
}
}
图像生成
POST /v1/images/generations
支持通义万相(qwen-image)、字节跳动 Seedream等主流文生图模型,按张计费。
curl https://ai.sl2.cn/v1/images/generations \
-H "Authorization: Bearer sk-sl2xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen-image",
"prompt": "国风插画,青山绿水间的算力数据中心",
"size": "1024x1024",
"n": 1
}'
视频生成
POST /v1/videos(异步任务)
提交任务后返回 task_id,通过轮询接口查询进度;支持豆包 Seedance、混元视频、海螺视频等主流视频模型。
# 提交任务
curl https://ai.sl2.cn/v1/videos \
-H "Authorization: Bearer sk-sl2xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"model": "doubao-seedance", "prompt": "无人机航拍城市夜景延时摄影", "duration": 5}'
# => {"task_id": "video-sl2001", "status": "queued"}
# 轮询任务
curl https://ai.sl2.cn/v1/videos/video-sl2001 \
-H "Authorization: Bearer sk-sl2xxxxxxxx"
# => {"task_id": "video-sl2001", "status": "succeeded",
# "video_url": "https://cdn.sl2.cn/video/xxx.mp4"}
代码示例
以 deepseek-v4-flash 为例,三大主流语言的一步接入示例:
curl https://ai.sl2.cn/v1/chat/completions \
-H "Authorization: Bearer sk-sl2xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-v4-flash",
"messages": [
{"role": "system", "content": "你是一个专业的技术助手"},
{"role": "user", "content": "用一句话介绍算力平方"}
]
}'
from openai import OpenAI
client = OpenAI(
api_key="sk-sl2xxxxxxxx",
base_url="https://ai.sl2.cn/v1"
)
resp = client.chat.completions.create(
model="deepseek-v4-flash",
messages=[
{"role": "system", "content": "你是一个专业的技术助手"},
{"role": "user", "content": "用一句话介绍算力平方"}
]
)
print(resp.choices[0].message.content)
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "sk-sl2xxxxxxxx",
baseURL: "https://ai.sl2.cn/v1"
});
const resp = await client.chat.completions.create({
model: "deepseek-v4-flash",
messages: [
{ role: "system", content: "你是一个专业的技术助手" },
{ role: "user", content: "用一句话介绍算力平方" }
]
});
console.log(resp.choices[0].message.content);
错误码
| 状态码 | 错误标识 | 说明与处理建议 |
|---|---|---|
| 400 | invalid_request_error | 请求参数错误,检查 model 与 messages 格式 |
| 401 | authentication_error | 密钥无效或已删除,请重新生成 |
| 402 | insufficient_points | 余额不足,请前往控制台充值后重试 |
| 404 | model_not_found | 模型名不存在,请核对模型列表取值 |
| 429 | rate_limit_exceeded | 触发速率限制,请按指数退避重试或申请提额 |
| 500 | internal_error | 服务内部错误,失败调用自动返还余额 |