API 文档

基础地址 http://localhost:8000（生产环境替换为你的网关域名）。所有请求通过 Authorization: Bearer <key> 鉴权。

1. 获取密钥

注册或登录后得到 sk-... 密钥，后续所有接口在 Header 携带：

Authorization: Bearer sk-xxxxxxxxxxxxxxxx

2. 接口总览

方法	路径	说明
POST	/v1/auth/register	注册（自动生成密钥）
POST	/v1/auth/login	登录（返回余额 + 密钥列表）
GET	/v1/keys	我的密钥列表
POST	/v1/keys	创建密钥
POST	/v1/keys/:key/toggle	启用 / 禁用密钥
DELETE	/v1/keys/:key	删除密钥
POST	/v1/recharge?amount=100	充值（演示即时到账）
POST	/v1/tasks	提交生成任务（统一入口）
GET	/v1/tasks/:id	查询任务状态
GET	/v1/tasks/:id/result	获取任务结果
GET	/v1/tasks?provider=&limit=	任务列表
POST	/v1/files/upload	上传参考文件

3. 提交生成任务

// POST /v1/tasks
{
  "provider": "duomi-image",      // duomi-image | wuyin-google-omni | minimax-h3
  "prompt": "一只橘猫坐在窗台，午后阳光",
  "size": "1:1",                  // 可选，图片支持 1:1 / 9:16 / 16:9
  "duration": 5,                 // 可选，视频时长（秒）
  "images": ["https://.../ref.png"], // minimax-h3 必填 1 张；其余可选
  "type": "fast"                 // minimax-h3 固定 fast
}

任务为异步模式：pending → processing → succeeded/failed。提交后轮询 GET /v1/tasks/:id 直到终态，结果在 result.url。

4. 上传参考图

curl -X POST http://localhost:8000/v1/files/upload \
  -H "Authorization: Bearer sk-xxx" \
  -F "file=@ref.png"

# 返回 { "url": "/uploads/xxx.png" }，拼上网关域名即为可访问地址

想更快上手？直接打开控制台，在「模型调用」页可视化提交，无需手写请求。