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 请求/分钟