AI 创作

概述

AIBUAIBU API 是为 AI 视觉创作平台提供的 RESTful 接口，支持用户认证、AI 图像生成、AI 视频生成、内容管理等功能。 所有接口均返回 JSON 格式数据，采用统一的响应结构。

ℹ️
基础 URL
所有 API 请求的基础地址：
BASE URL http://aibu.tianzao.net/api
💡
建议使用 HTTPS 进行生产环境调用，确保数据传输安全。

认证方式

API 使用 JWT Token 进行认证，支持两种方式传递认证信息：

方式一：Cookie（自动）

登录成功后，服务器会自动设置 aibu_token Cookie，后续请求自动携带。

方式二：Authorization Header

HTTP Header 
Authorization: Bearer <your-jwt-token>

响应格式

所有 API 返回统一格式的 JSON 响应，包含以下字段：

JSON 
{
  "status": "success|error",
  "code": 200,
  "message": "操作成功",
  "data": {}
}
字段 类型 说明
status string 请求状态：success 或 error
code int 状态码，详见状态码说明
message string 操作结果描述
data object 响应数据，失败时可能为空

状态码说明

200
请求成功处理
201
创建成功
400
请求参数错误
401
未登录/Token无效
402
积分不足
403
无权限访问
404
资源不存在
409
资源冲突
429
请求过于频繁
500
服务器内部错误
502
上游服务错误

认证相关

GET /auth/captcha.php

获取图形验证码，返回 PNG 图片

POST /auth/send_code.php

发送短信验证码到指定手机号

请求参数

参数 类型 必填 说明
phone string 是 手机号
captcha string 是 图形验证码

响应示例

200 OK 
{
  "status": "success",
  "code": 200,
  "message": "验证码已发送",
  "data": {
    "countdown": 60
  }
}
POST /auth/register.php

用户注册，使用手机号和短信验证码

参数 类型 必填 说明
phone string 是 手机号
sms_code string 是 短信验证码
password string 是 登录密码
201 Created 
{
  "status": "success",
  "code": 201,
  "message": "注册成功",
  "data": {
    "user_id": 123,
    "free_points": 10
  }
}
POST /auth/login.php

用户登录，支持用户名/手机号 + 密码

参数 类型 必填 说明
username string 是 用户名或手机号
password string 是 登录密码
captcha string 是 图形验证码
200 OK 
{
  "status": "success",
  "code": 200,
  "message": "登录成功",
  "data": {
    "token": "eyJhbGciOiJIUzI1NiIs...",
    "user": {
      "id": 123,
      "username": "user123",
      "email": "user@example.com",
      "avatar_url": "https://...",
      "role": "user"
    }
  }
}
POST /auth/logout.php

退出登录，清除会话

⚠️
需要认证

用户相关

GET /user/profile.php

获取当前用户信息、积分、会员状态和积分记录

参数 类型 必填 说明
page int 否 页码，默认 1
limit int 否 每页数量，默认 20，最大 50
filter string 否 筛选：all/income/expense
🔒
需要认证
POST /user/update-profile.php

更新用户资料、头像或修改密码

更新资料 
{
  "action": "update_info",
  "username": "newname",
  "email": "new@example.com"
}
修改密码 
{
  "action": "change_password",
  "old_password": "oldpass",
  "new_password": "newpass123"
}
🔒
需要认证
GET /user/assets.php

获取用户生成的作品列表

参数 类型 必填 说明
page int 否 页码，默认 1
limit int 否 每页数量，默认 40
🔒
需要认证
GET /user/plans.php

获取会员套餐和积分包列表

GET /user/settings.php

获取站点配置信息

AI 生成相关

GET /ai/models.php

获取可用的 AI 模型列表

POST /ai/create.php

创建图像生成任务（文生图/图生图）

参数 类型 必填 说明
prompt string 是 提示词
model string 否 模型名称，默认 nano-banana-pro
aspectRatio string 否 宽高比：auto/1:1/16:9/9:16/...
imageSize string 否 尺寸：1K/2K/4K
urls array 否 参考图片URL（图生图）
201 Created 
{
  "status": "success",
  "code": 201,
  "message": "生成任务已提交",
  "data": {
    "task_id": 123,
    "external_task_id": "task_abc123",
    "status": "pending",
    "progress": 0
  }
}
🔒
需要认证，消耗积分
POST /ai/status.php

查询图像生成任务状态

参数 类型 必填 说明
task_id int 是 任务ID

状态说明：
pending - 等待中 | running - 生成中 | succeeded - 成功 | failed - 失败

🔒
需要认证

视频生成相关

POST /video/create.php

创建视频生成任务（文生视频/图生视频）

参数 类型 必填 说明
prompt string 是 提示词
model string 否 视频模型
ratio string 否 宽高比：16:9/9:16/1:1
duration int 否 时长(秒)：5/8/10
image_url string 否 首帧图片URL（图生视频）
📋
可用模型：
seedance-2-t2v, seedance-2-i2v, seedance-2-fast,
seedance-15-pro, seedance-pro, seedance-pro-fast,
seedance-lite-t2v, seedance-lite-i2v
🔒
需要认证，消耗积分
POST /video/status.php

查询视频生成任务状态

参数 类型 必填 说明
task_id int 是 任务ID
🔒
需要认证

内容相关

GET /content/banners.php

获取首页轮播图列表

GET /content/categories.php

获取作品分类列表

GET /content/posts.php

获取作品列表

参数 类型 必填 说明
page int 否 页码，默认 1
limit int 否 每页数量，默认 20，最大 50
category_id int 否 分类ID筛选
GET /content/post_detail.php

获取作品详情

参数 类型 必填 说明
id int 是 作品ID
GET /content/styles.php

获取风格模板列表

参数 类型 必填 说明
page int 否 页码，默认 1
limit int 否 每页数量，默认 20
category_id int 否 分类ID筛选
model_type string 否 模型类型：image/video
POST /content/create_post.php

发布作品（提交审核）

🔒
需要认证

存储相关

POST /storage/upload.php

上传文件到七牛云存储

📋
Content-Type: multipart/form-data
文件限制： jpg、png、webp，最大 5MB
🔒
需要认证

数据模型

User（用户）

字段 类型 说明
idint用户ID
usernamestring用户名
emailstring邮箱
avatar_urlstring头像URL
rolestring角色：user/admin
created_atstring注册时间

Post（作品）

字段 类型 说明
idint作品ID
titlestring标题
image_urlstring图片URL
video_urlstring视频URL
content_typestring类型：image/video
promptstring生成提示词
model_namestring使用的模型

Task（生成任务）

字段 类型 说明
task_idint任务ID
external_task_idstring外部任务ID
statusstring状态：pending/running/succeeded/failed
progressint进度 0-100
result_image_urlstring结果图片URL
result_video_urlstring结果视频URL

文档版本 v1.0.0 | 更新日期 2026-04-18

© 2026 AIBUAIBU. All rights reserved.

交流群

扫码加入 AIBUAIBU 交流群

交流群二维码