AI图像编辑API文档

身份验证

所有API请求都需要在请求头中包含API密钥。

X-API-Key: your_api_key_here

注意：如果API密钥无效或缺失，API将返回 403 Forbidden 错误。

API接口

POST `/api/v1/edit`

使用AI和指定的功能和样式编辑图像。

请求头

X-API-Key: your_api_key
Content-Type: application/json
                

请求体

{

  "image": "base64_string" | "image_url",

  "feature_id": "clothing-change",

  "style_id": "summer_skirt",

  "model_id": "simple",

  // 可选: "base", "simple", "self"，默认为 "simple"

  "color": "blonde"

  // 可选，仅适用于发型变换功能

}

成功响应 (200)

{
  "status": "success",
  "result_image_url": "https://replicate.delivery/..."
}
                

响应格式说明

云部署模型 (base, simple): 返回HTTP URL

"result_image_url": "https://replicate.delivery/pbxt/abc123.jpg"

自部署模型 (self): 返回base64 data URL

"result_image_url": "data:image/png;base64,iVBORw0KGgoAAAANSUhE..."

错误响应 (400/403/500)

{
  "status": "error",
  "error_code": "INVALID_FEATURE_ID",
  "message": "Feature ID 'invalid-feature' not found"
}
                

认证错误响应 (403)

{
  "status": "error",
  "error_code": "INVALID_API_KEY",
  "message": "Invalid API key"
}
                

GET `/api/v1/health`

检查API健康状态。

响应 (200)

{
  "status": "ok"
}
                

发型颜色功能

对于发型变换功能 (feature_id: "hair-style")，您可以额外指定发色参数：

发型颜色示例

{
  "image": "base64_string",
  "feature_id": "hair-style",
  "style_id": "bob_cut",
  "color": "blonde"
}
                

可用颜色值

支持45种发色选择，每种颜色包含 color_id (API使用) 和 display_name (中文显示名称)：

🌿 自然色系

blonde → 金发

brunette → 棕发

black → 黑色

dark_brown → 深棕色

medium_brown → 中棕色

light_brown → 浅棕色

auburn → 赤褐色

red → 红色

✨ 金发系列

strawberry_blonde → 草莓金

platinum_blonde → 铂金色

honey_blonde → 蜂蜜金

ash_blonde → 灰金色

golden_blonde → 金黄色

dirty_blonde → 亚麻色

🖤 深色系列

copper → 铜色

blue_black → 蓝黑色

burgundy → 酒红色

mahogany → 红褐色

chestnut → 栗色

caramel → 焦糖色

chocolate_brown → 巧克力棕

espresso → 浓咖啡色

jet_black → 乌黑色

raven_black → 渡鸦黑

🎨 创意色彩

silver → 银色

white → 白色

blue → 蓝色

purple → 紫色

pink → 粉色

green → 绿色

rose_gold → 玫瑰金

lavender → 薰衣草色

mint_green → 薄荷绿

teal → 蓝绿色

turquoise → 绿松石色

magenta → 洋红色

orange → 橙色

yellow → 黄色

rainbow → 彩虹色

🎭 染发技法

ombre_blonde → 渐变金

ombre_brown → 渐变棕

balayage → 挑染

highlights → 高光

lowlights → 低光

颜色参数说明

可选参数：color 参数仅在使用发型变换功能时有效
向后兼容：不提供 color 参数时，将使用原始发型的颜色

可用模型

选择不同的AI模型进行图像编辑：

基础模型

base

标准质量，处理速度较快。

简单模型

simple

基础质量，处理速度最快。

自部署

self

自部署模型，使用自建服务。

注意：返回base64格式的data URL而非HTTP URL。

可用功能和样式

当前可用的功能和样式（动态加载）：

注意：下面显示的字符串是 feature_id 和 style_id 的实际值，请在API请求中使用这些值。

加载功能中...

错误代码

API返回的标准错误代码：

INVALID_API_KEY

API密钥无效或缺失 (返回403 Forbidden)

INVALID_FEATURE_ID

功能ID未找到

INVALID_STYLE_ID

样式ID未找到

INVALID_IMAGE_FORMAT

不支持的图像格式

IMAGE_TOO_LARGE

图像超出大小限制

PROCESSING_FAILED

AI处理失败

NETWORK_ERROR

网络连接问题

INTERNAL_ERROR

服务器内部错误

图像输入格式

Base64格式

// Data URI格式
"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg=="

// 原始base64字符串
"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg=="
            

URL格式

// 远程URL
"https://example.com/image.jpg"

// 本地系统图像
"/images/system-images/example.jpg"
            

支持的格式

PNG, JPG, JPEG, WebP

大小限制

Base64图像最大10MB，URL支持更大的图像