开发文档

全面了解 AI 慧聚堂的技术架构、API 接口和使用指南
API 文档 快速开始
快速开始

五分钟上手 AI 慧聚堂

通过简单的步骤，快速集成和使用我们的 AI 服务

获取 API 密钥

注册账号并获取专属的 API 密钥，用于身份验证

curl -X POST https://api.aihuiju.fun/auth \
  -H "Content-Type: application/json" \
  -d '{"appid": "your_appid", "secret": "your_secret"}'
调用 API 接口

使用获取的 token 调用各种 AI 功能接口

curl -X POST https://api.aihuiju.fun/create \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{"prompt": "a beautiful sunset"}'
获取生成结果

通过 WebSocket 或轮询接口获取生成结果

// WebSocket 连接
const ws = new WebSocket(
  'wss://api.aihuiju.fun/ws/task_id'
);
API 文档

核心 API 接口

详细的接口说明和参数文档

身份验证接口
POST /weiyun/v1/auth

获取访问令牌，用于后续 API 调用

请求参数： 
{
  "appid": "string",      // 应用ID
  "secret": "string"      // 应用密钥
}
响应示例： 
{
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "expires_in": 7200,
  "token_type": "Bearer"
}
图像生成接口
POST /create

提交图像生成任务

请求参数： 
{
  "prompt": "string",          // 生成提示词
  "negative_prompt": "string", // 负面提示词（可选）
  "width": 512,                // 图像宽度
  "height": 512,               // 图像高度
  "steps": 20,                 // 生成步数
  "cfg_scale": 7.5,            // 提示词权重
  "sampler": "Euler a",        // 采样器
  "seed": -1                   // 随机种子，-1表示随机
}
响应示例： 
{
  "task_id": "abc123def456",
  "status": "pending",
  "message": "任务已提交"
}
获取图像接口
GET /image

获取已生成的图像

查询参数： 
?task_id=abc123def456
响应：

直接返回图像二进制数据

WebSocket 接口
GET /ws/:taskId

实时获取任务进度和结果

连接地址： 
wss://api.aihuiju.fun/ws/abc123def456
消息格式： 
{
  "type": "progress|complete|error",
  "data": {
    "progress": 50,           // 进度百分比
    "image_url": "string",    // 图像URL（完成时）
    "message": "string"       // 状态消息
  }
}
常见问题

FAQ

使用过程中可能遇到的问题和解决方案

请联系管理员或关注「AI慧聚堂」公众号，发送「API申请」获取测试密钥。正式上线后，可通过网站控制台申请。
根据图像尺寸和复杂度，通常需要 10-60 秒。512x512 的标准图像大约需要 15-30 秒。建议使用 WebSocket 接口实时获取进度。
目前支持 512x512、768x768、1024x1024 等常见尺寸。如需特殊尺寸，请联系管理员定制。
测试阶段：10次/分钟。正式用户根据套餐不同，限制会相应调整。如有特殊需求，请联系管理员。
赞助一杯奶茶
赞助按钮图标