Skip to main content

​
基础信息

  • Base URL: https://api.kira.art (生产环境)
  • 认证方式: Bearer Token (Supabase JWT)
  • 响应格式: JSON

​
认证

大部分 API 需要在请求头中携带 JWT Token： 
Authorization: Bearer <your-jwt-token>

​
API 路由

路由前缀说明认证
/agentAI 对话和消息管理需要
/thread对话线程 CRUD需要
/user用户和 Profile 管理部分需要
/feed社交 Feed部分需要
/like点赞功能需要
/publish发布到 Feed需要
/billing订阅和支付需要
/image图片处理需要
/images批量图片操作需要
/version版本管理需要
/filter滤镜管理需要
/rewind时间回溯需要
/download图片下载公开
/setting系统设置需要
/support客服支持需要
/mail邮件服务内部
/sitemap站点地图公开

​
通用响应格式

​
成功响应

{
  "message": "ok"
}

​
错误响应

{
  "message": "Error description"
}
HTTP 状态码:
  • 200 - 成功
  • 400 - 请求参数错误
  • 401 - 未授权
  • 403 - 禁止访问
  • 404 - 资源不存在
  • 500 - 服务器错误

​
CORS 配置

允许的域名:
  • https://*.kira.art
  • https://kira.art
  • 开发环境允许所有来源

​
限流

当前没有全局限流，但部分操作有业务限制：
  • 免费用户每日 Credits 上限
  • 图片生成消耗 Credits