接口文档 - 极客AI开放平台

基本信息

极客AI开放平台提供标准 OpenAI API 格式的接口，你可以使用任何兼容 OpenAI 的客户端或 SDK 直接接入。

项目	内容
API Base URL	`https://ai.muwl.xyz/v1`
协议	HTTPS
数据格式	JSON
字符编码	UTF-8

认证方式

所有 API 请求需在 HTTP Header 中携带 API Key 进行认证。

// 在请求头中添加 Authorization
Authorization: Bearer YOUR_API_KEY

你可以在 API密钥管理页面创建和管理你的 API Key。

对话接口

创建对话补全请求，支持流式返回。

请求地址

POST /v1/chat/completions

请求参数

参数	类型	必填	说明
model	string	是	模型ID，如 gpt-4o
messages	array	是	消息数组，包含 role 和 content
temperature	float	否	采样温度，默认 0.7，范围 0-2
max_tokens	integer	否	最大生成 tokens 数
stream	boolean	否	是否流式返回，默认 false
top_p	float	否	核采样参数

请求示例

POST https://ai.muwl.xyz/v1/chat/completions
Content-Type: application/json
Authorization: Bearer sk-xxxxxx

{
  "model": "gpt-4o",
  "messages": [
    {"role": "system", "content": "你是一个助手"},
    {"role": "user", "content": "你好"}
  ],
  "stream": false
}

响应示例

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

模型列表

获取平台支持的所有模型列表。

请求地址

GET /v1/models

响应示例

{
  "object": "list",
  "data": [
    {
      "id": "gpt-4o",
      "object": "model",
      "created": 1234567890,
      "owned_by": "openai"
    }
  ]
}

查询余额

查询当前账户余额和用量统计。

请求地址

GET /v1/user/balance

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "balance": "123.45",
    "total_used": "67.89",
    "total_requests": 1280
  }
}

错误码

HTTP状态码	含义	说明
200	成功	请求正常处理
400	参数错误	请求参数不合法
401	认证失败	API Key 无效或已过期
402	余额不足	账户余额不足以支付本次请求
403	禁止访问	无权限访问该资源
429	请求过频	超出速率限制
500	服务器错误	服务端内部错误