精灵换肤 V2

用途

更改现有精灵图像的外观，生成新风格的精灵。用于改变角色外观或转换为不同风格。

方法和路径

POST /public/v1/sprite/reskin/v2

认证

请参阅 认证 页面。需要 Bearer 令牌。

必需头信息：

Authorization: Bearer {your_api_key}

请求字段

字段名	类型	必需	说明
image	file	是	要重新换肤的原始精灵图像文件
description	string	是	对将应用于精灵的更改内容进行说明
quality	string	是	质量等级。可能的值: standard, pro
style	string	否	风格指定。可能的值: pixel, cartoon, sd, quater_view

响应

成功响应 (200 OK)：

{
  "job_id": "uuid-string"
}

字段	类型	说明
job_id	string	创建的作业的唯一标识符。使用 Get Job Status 查询结果

错误 / 验证规则

情况	HTTP 状态	说明
Invalid image file	400	"Invalid image file"
quality 值无效	422	standard, pro 以外的值会导致验证错误
style 值无效	422	pixel, cartoon, sd, quater_view 以外的值会导致验证错误
认证失败	401	无效的 API 密钥

异步作业行为

此端点创建异步作业。请求立即返回 job_id，实际换肤作业在后台进行。

轮询方法：

1. 保存响应中收到的 job_id
2. 轮询 GET /public/v1/job/{job_id} 检查状态
3. 当状态变为 Succeed 时，从 image_urls 查看结果

状态流程： Pending → Succeed 或 Failed

请求示例

cURL (基本风格)：

curl -X POST "https://api.aetherforgeai.com/public/v1/sprite/reskin/v2" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/sprite.png" \
-F "description=change the warrior character armor to golden" \
-F "quality=standard"

cURL (指定像素风格)：

curl -X POST "https://api.aetherforgeai.com/public/v1/sprite/reskin/v2" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/sprite.png" \
-F "description=convert the character to pixel art style" \
-F "quality=pro" \
-F "style=pixel"