API文档

Aluo AI API提供强大的图像处理能力，包括智能背景移除、AI图像生成和编辑等功能。非常适合电商产品摄影、营销素材设计、内容创作等场景。所有API均基于REST架构，支持JSON数据交换。

所有API请求的基础URL：https://aluo.ai/api

API支持两种认证方式： 1. **API密钥认证**（推荐）：在请求头中包含 Authorization: Bearer YOUR_API_KEY - API密钥以 "sk-" 开头 - 可在Aluo AI控制台的"API密钥"页面获取 2. **会话认证**：适用于已登录的Web应用 - 通过Cookie传递会话信息 - 需要用户已登录Aluo AI平台

所有业务API均消耗积分，不同用户类型享有不同的积分价格： - 免费用户：标准积分定价 - 订阅用户（创作者+专业版）：享受积分优惠

在Aluo AI控制台中创建和管理您的API密钥。

保护您的API密钥安全的最佳实践。

使用先进的AI技术智能移除图像背景，支持多种图像格式，返回透明背景的PNG图像。完美适用于产品图处理、人像抠图等场景。

使用 multipart/form-data 格式上传图像文件。

• 电商产品图：快速移除产品照片背景，制作白底图 • 人像处理：移除人像背景，便于后期合成 • 素材制作：为设计素材去除背景，提高重用性 • 证件照处理：快速制作标准证件照背景

返回处理后的图像文件（二进制数据），Content-Type为 image/png。

基于输入图像和文本提示，使用AI技术对图像进行智能编辑和优化。支持风格转换、内容调整、质量增强等多种编辑效果。这是异步任务，积分将在任务完成后扣减。

prompt (必填): 编辑指令的文本描述 inputImage (必填): 原始图像的URL或base64数据 aspectRatio: 输出宽高比（16:9、1:1、9:16等） outputFormat: 输出格式（jpeg、png、webp） enableTranslation: 是否启用提示词翻译 model: 使用的AI模型（flux-kontext-pro、flux-kontext-max）

• 产品图优化：改善产品照片的光照、背景、风格 • 风格转换：将普通照片转换为艺术风格 • 内容增强：提升图像质量、添加视觉效果 • 创意设计：基于原图进行创意性的视觉改造

返回任务信息，需要通过状态查询API获取最终结果。

查询AI图像编辑任务状态和结果。任务完成后返回编辑后的图像URL。

使用AI根据文本描述生成高质量的产品图像。特别适用于电商产品展示、营销素材制作等场景。支持多种尺寸和风格设置。这是异步任务，积分将在任务完成后扣减。

prompt (必填): 产品描述文本 size: 图像尺寸（1:1、3:2、2:3等） filesUrl: 参考图像URL数组（可选）

• 电商产品图：为新产品快速生成专业产品图 • 营销素材：制作产品宣传和广告素材 • 概念设计：可视化产品创意和设计方案 • 样品展示：在实物制作前预览产品效果

返回任务信息，需要通过状态查询API获取最终结果。

查询AI产品图生成任务状态和结果。任务完成后返回生成的产品图像URL。

基于文本描述即时生成专业背景图像，适用于产品摄影、场景设计等用途。支持多种风格和环境设置，可快速为产品或内容创建合适的背景环境。这是同步接口，直接返回生成结果。

prompt (必填): 背景描述文本，支持中英文 可描述风格、颜色、材质、光照等要素 支持场景描述：如"摄影棚"、"自然环境"、"室内场景"等

• 产品摄影：为产品生成专业拍摄背景 • 电商设计：创建产品展示的环境氛围 • 内容创作：为文章、海报制作合适背景 • 品牌视觉：统一品牌的视觉背景风格

同步返回生成结果，包含背景图像URL。