API 概述
通过 REST API 将 Aluo 功能集成到您的应用程序中。
简介
Aluo API 提供 RESTful 接口,让您可以将 AI 图像处理能力集成到自己的应用程序中。所有 API 使用基于积分的计费系统,根据用户类型(免费/PRO)收取不同的积分费用。
Base URL: https://api.aluo.ai/api认证
所有 API 请求都需要在 HTTP Header 中包含 API Key 进行认证。
Authorization: Bearer sk-xxxxxxxxxxxxxx
如何获取 API Key:登录账户 → 用户信息 → API Tab → 创建新密钥
响应格式
所有 API 响应都采用统一的 JSON 格式:
成功响应
{
"code": 0,
"success": true,
"data": {
// API specific data
},
"credits_deducted": 8,
"credits_remaining": 42
}错误响应
{
"code": -1,
"success": false,
"message": "User-friendly error message",
"error": "Detailed error description"
}错误代码
| 代码 | 说明 | HTTP 状态 |
|---|---|---|
0 | 成功 | 200 |
-1 | 业务错误(参数错误、处理失败等) | 400/500 |
-2 | 未认证或 API Key 无效 | 401 |
402 | 积分不足 | 402 |
500 | 服务器内部错误 | 500 |
积分系统
所有 API 调用都会消耗积分。PRO 用户享受更低的积分消耗率。
积分扣除说明: 对于背景移除 API (remove-bg),积分会在 API 调用时自动扣除。对于图片生成和编辑 API,积分由客户端在获取生成结果后扣除。如果处理失败,已扣除的积分会自动退还到您的账户。
可用接口
速率限制
- 免费用户:10 请求/分钟
- PRO 用户:100 请求/分钟
- MAX 用户:1000 请求/分钟