制作精灵 V2
目的
基于上传的图片生成精灵动画。您可以创建像素艺术风格或普通风格的精灵表。
方法与路径
POST /public/v1/sprite/make-sprite/v2
认证
请参阅认证页面。需要 Bearer Token。
必需请求头：
Authorization: Bearer {your_api_key}
请求字段
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| start_frame_image | file | 是 | 作为起始帧基础的图片文件 |
| end_frame_image | file | 否 | 作为结束帧基础的可选图片文件 |
| text | string | 是 | 用于精灵生成的文本提示词 |
| frame | integer | 是 | 要生成的帧数。必须为以下之一：49, 81, 121 |
| is_pixel | boolean | 是 | 图片是否为像素艺术风格。true 或 false |
响应
成功响应（200 OK）：
{
"job_id": "uuid-string"
}
| 字段 | 类型 | 说明 |
|---|---|---|
| job_id | string | 已创建任务的唯一标识符。使用 Get Job Status 查询结果 |
错误 / 校 验规则
| 情况 | HTTP 状态 | 错误消息 |
|---|---|---|
| Invalid image file | 400 | "Invalid image file" |
| frame 值不被允许 | 400 | "frame should be one of 49, 81, 121" |
| 认证失败 | 401 | 无效的 API Key |
允许的帧数值：
- 49, 81, 121
异步任务行为
此端点会创建异步任务。它会立即返回 job_id，实际的精灵生成会在后台进行。
轮询方法：
- 保存响应中收到的
job_id - 轮询
GET /public/v1/job/{job_id}检查状态 - 当状态变为
Succeed时，在image_urls中查看结果（GIF 和单独帧图像）
状态流： Pending → Succeed 或 Failed
请求示例
cURL（像素艺术风格）：
curl -X POST "https://api.aetherforgeai.com/public/v1/sprite/make-sprite/v2" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "start_frame_image=@/path/to/character.png" \
-F "text=walking animation" \
-F "frame=49" \
-F "is_pixel=true"
cURL（普通风格）：
curl -X POST "https://api.aetherforgeai.com/public/v1/sprite/make-sprite/v2" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "start_frame_image=@/path/to/character.png" \
-F "text=running animation cycle" \
-F "frame=81" \
-F "is_pixel=false"
cURL（普通风格 + 结束帧）：
curl -X POST "https://api.aetherforgeai.com/public/v1/sprite/make-sprite/v2" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "start_frame_image=@/path/to/character_start.png" \
-F "end_frame_image=@/path/to/character_end.png" \
-F "text=running animation cycle" \
-F "frame=81" \
-F "is_pixel=false"