爱创AI平台技能
概述
爱创AI平台（https://www.51aic.com）是面向电商商家的AI内容创作平台，提供AI图片生成、AI视频生成、商品精修、虚拟试穿等全场景AI作图功能。
本技能允许用户在 Claude 对话中直接调用爱创AI平台的服务，无需手动访问网页。
认证流程
所有 API 调用都需要用户的 token。
如果用户没有提供过 token，按以下步骤引导用户获取：
- 请用户打开浏览器访问 https://www.51aic.com
- 点击右上角登录（支持手机号验证码或微信扫码）
- 登录成功后，按
F12 打开浏览器开发者工具
- 切换到 Application（Chrome）或 Storage（Firefox）标签页
- 在左侧导航找到 Cookies →
https://www.51aic.com
- 在 Cookie 列表中找到名为
token 的字段
- 复制该字段的值（通常是一串较长的字符串）
- 将复制的 token 粘贴到对话中
安全提示：token 是用户的登录凭证，请勿在公共对话中分享。对话中的 token 仅在当前会话有效。
获取到 token 后，保存到上下文中，后续所有 API 调用自动使用。
API 基础配置
主 API 地址: https://aicraft.51aic.com
文件上传地址: https://api.fzputi.com/ossmanager/api/Oss/UploadFileV2
图片 CDN: https://oss.fzputi.com/
所有请求需要在 HTTP Header 中携带：Token: <用户token>
核心能力
1. 图片上传
如果用户提供了本地图片文件，需要先上传到平台 OSS。
上传逻辑：
- 读取图片文件，转为 base64 编码
- 拼接成
data:image/jpeg;base64,... 格式
- 生成 OSS 路径：
tools/aiCraft/1m/YYYYMMDD/<uuid>.<ext>
- POST 到上传接口
macOS/Linux：
FILE_PATH="<图片路径>"
B64=$(openssl base64 -in "$FILE_PATH" | tr -d '\n')
EXT="${FILE_PATH##*.}"
[ "$EXT" = "jpeg" ] && EXT="jpg"
UUID=$(uuidgen | tr '[:upper:]' '[:lower:]' | tr -d '-')
DATE=$(date +%Y%m%d)
MIME="image/$EXT"
[ "$EXT" = "jpg" ] && MIME="image/jpeg"
curl -s -X POST "https://api.fzputi.com/ossmanager/api/Oss/UploadFileV2" \
-H "Content-Type: application/json; charset=utf-8" \
-H "Token: <token>" \
-d "{\"ossFilePath\":\"tools/aiCraft/1m/$DATE/$UUID.$EXT\",\"fileBase64\":\"data:$MIME;base64,$B64\"}"
Windows：
$FilePath = "<图片路径>"
$B64 = [Convert]::ToBase64String([IO.File]::ReadAllBytes($FilePath))
$Ext = [System.IO.Path]::GetExtension($FilePath).TrimStart('.')
if ($Ext -eq "jpeg") { $Ext = "jpg" }
$UUID = [Guid]::NewGuid().ToString().Replace("-", "").ToLower()
$Date = Get-Date -Format "yyyyMMdd"
$MIME = "image/$Ext"
if ($Ext -eq "jpg") { $MIME = "image/jpeg" }
$Body = @{
ossFilePath = "tools/aiCraft/1m/$Date/$UUID.$Ext"
fileBase64 = "data:$MIME;base64,$B64"
} | ConvertTo-Json
$BodyBytes = [System.Text.Encoding]::UTF8.GetBytes($Body)
Invoke-RestMethod -Uri "https://api.fzputi.com/ossmanager/api/Oss/UploadFileV2" -Method POST -Headers @{"Content-Type"="application/json; charset=utf-8"; "Token"="<token>"} -Body $BodyBytes
上传成功后会返回 https://oss.fzputi.com/... 的 URL，用于后续生成请求。
2. 图片生成（17种模式）
支持17种图片生成模式，详见 references/image-modes.md。
最常用的是 自由创作 模式：
- 上传参考图（可选，最多10张）
- 输入提示词描述想要的图片
- 选择图片比例和生成数量
- 调用 API 生成
API 端点：POST https://aicraft.51aic.com/api/v1/Task/Publish
业务规则（重要）：提交生成任务时，必须先查询并复用现有的 conversationId，一律不创建新的 conversation（批次）。这样能保证所有记录在同一个会话下，查询历史时不会断档。
查询方式：POST /api/v1/Conversation/Search（projectType: IMAGE/VIDEO，按 lastMessageAt 倒序取第一条）
prompt 字段规则（重要）：
- 自由创作模式：prompt 由用户自定义，是核心必填参数，描述想要什么图片
- 其他16种模式（如AI试衣、去水印等）：有固定的默认 prompt（详见 references/image-modes.md），不可为空，否则任务发布会失败（code: 999）
- 部分模式（如换色、翻译、换表情）的 prompt 包含动态参数（颜色、语言、表情等），需要根据用户选择填充
请求体示例（自由创作）：
{
"conversationId": "",
"projectType": "IMAGE",
"mode": 1,
"type": 2,
"payload": {
"aspectRatio": "auto",
"count": 1,
"prompt": "一件红色连衣裙，白色背景，电商商品图",
"sceneMode": "free_creation",
"referenceImages": [
{ "key": "images", "index": 0, "url": "https://oss.fzputi.com/...", "description": "" }
]
}
}
3. 视频生成（开发中）
注意：视频生成功能当前处于开发调试阶段，网页端视频页面暂时被重定向到首页。API 可能不稳定或不可用，建议优先使用图片生成功能。
支持商品讲解视频、带货视频、促销视频等多种类型。
API 端点：POST https://aicraft.51aic.com/api/v1/Task/Publish
配置参数详见 references/video-config.md。
请求体示例（新手模式）：
{
"conversationId": "",
"projectType": "VIDEO",
"mode": 1,
"type": 1,
"payload": {
"prompt": "介绍这款红色连衣裙的优点",
"duration": 8,
"orientation": "9:16",
"size": "large",
"language": "0",
"videoType": "2",
"videoChannel": "fast",
"images": ["https://oss.fzputi.com/..."]
}
}
4. 查询任务状态
生成任务提交后，返回 taskJobId 和 conversationId。可通过以下接口查询任务进度：
- 任务进度:
POST /api/v1/Task/GetProgress（支持批量查询，见下方 API 调用参考）
5. 查询积分
积分查询需要两步认证：
- 获取支付认证 token：用用户 token 调用
/api/v1/PayPackage/GetToken（body: {"appType": 6}），返回 authorization
- 查询积分：用
authorization 作为 Authorization header，访问支付 API https://api.fzputi.com/payment/api/v1/Vas/GetQuantityByPackageType
返回用户的剩余积分（会员积分 + 套餐积分）。
authorization 缓存：有效期约 2 小时。在同一次对话中获取后可复用，不需要每次查积分都重新调用 GetToken。如后续调用返回 401，再重新获取。
注意：支付 API 与主 API 使用不同的认证机制。如果用户未主动要求查积分，可跳过此步骤，直接引用下方的积分消耗参考表告知用户大致消耗。
使用流程
图片生成流程
- 确认用户已提供 token（如未提供，引导获取）
- 询问用户需要什么类型的图片（自由创作/商品图/AI试衣等）
- 确认 prompt：
- 自由创作：询问用户想要什么图片，由用户描述生成 prompt
- 其他模式：使用对应模式的默认 prompt（见 references/image-modes.md），如用户有特殊需求可在此基础上调整
- 部分模式（换色/翻译/换表情等）需要额外确认动态参数（颜色/语言/表情等）
- 询问参考图片
- 如有本地图片，先调用上传接口
- 构建并发送 Publish 请求
- 返回任务提交结果，告知用户可在 https://www.51aic.com/image/history 查看
视频生成流程（开发中）
- 确认用户已提供 token
- 询问视频类型（商品讲解/带货/促销等）
- 询问参考图片和提示词
- 确认视频配置（通道/比例/清晰度/时长/语言）
- 如有本地图片，先调用上传接口
- 构建并发送 Publish 请求
- 返回任务提交结果
积分消耗参考
| 功能 | 积分消耗 |
|---|
| 图片生成（自由创作） | 5积分/张 |
| 主图套图 | 25积分/套 |
| 视频生成（极速通道8秒） | 30积分 |
| 视频生成（高稳通道8秒） | 100积分 |
| 视频生成（高稳通道12秒） | 150积分 |
在提交生成任务前，可引用上表告知用户所需积分。如用户明确要求查当前余额，再执行积分查询（需要两步认证，见"查询积分"部分）。如积分不足，告知用户需要充值。
错误处理
常见错误及处理方式：
| 错误码 | 含义 | 处理方式 |
|---|
| 401 | Token 无效或过期 | 引导用户重新获取 token |
| 999 | 任务发布失败 | 常见原因：① prompt 为空或不符合模式要求（非自由创作模式必须使用默认 prompt）；② 参数格式错误。检查 prompt 和各字段值 |
| 积分不足 | 积分不够生成 | 告知用户当前积分和所需积分 |
| 上传失败 | 图片格式/大小不符 | 检查图片格式(jpg/png/webp)和大小(≤10MB) |
API 调用参考
以下是用 exec 工具直接调用 API 的示例。macOS/Linux 用 curl，Windows 用 PowerShell Invoke-RestMethod。
调用前需确保已在 Header 中携带 Token: <用户token>。
查询积分（两步认证，authorization 可复用约 2 小时）
Step 1 — 获取支付认证 token：
macOS/Linux：
AUTH=$(curl -s -X POST "https://aicraft.51aic.com/api/v1/PayPackage/GetToken" \
-H "Content-Type: application/json; charset=utf-8" \
-H "Token: <token>" \
-d '{"appType": 6}' | grep -o '"result":"[^"]*"' | sed 's/"result":"//;s/"$//')
Windows：
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$Json = '{"appType": 6}'
$AuthRes = Invoke-RestMethod -Uri "https://aicraft.51aic.com/api/v1/PayPackage/GetToken" -Method POST -Headers @{"Content-Type"="application/json; charset=utf-8"; "Token"="<token>"} -Body ([System.Text.Encoding]::UTF8.GetBytes($Json))
$AUTH = $AuthRes.result
Step 2 — 查询积分余额：
macOS/Linux：
curl -s -X POST "https://api.fzputi.com/payment/api/v1/Vas/GetQuantityByPackageType" \
-H "Content-Type: application/json; charset=utf-8" \
-H "Authorization: $AUTH" \
-d '{"ValueAddedServicesType": 4}'
Windows：
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$Json = '{"ValueAddedServicesType": 4}'
Invoke-RestMethod -Uri "https://api.fzputi.com/payment/api/v1/Vas/GetQuantityByPackageType" -Method POST -Headers @{"Content-Type"="application/json; charset=utf-8"; "Authorization"=$AUTH} -Body ([System.Text.Encoding]::UTF8.GetBytes($Json))
查询会话ID（复用现有批次）
macOS/Linux：
curl -s -X POST "https://aicraft.51aic.com/api/v1/Conversation/Search" \
-H "Content-Type: application/json; charset=utf-8" \
-H "Token: <token>" \
-d '{"projectType": "IMAGE", "pageIndex": 1, "pageSize": 1, "sortField": "lastMessageAt", "sortType": "desc"}'
Windows：
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$Json = '{"projectType": "IMAGE", "pageIndex": 1, "pageSize": 1, "sortField": "lastMessageAt", "sortType": "desc"}'
Invoke-RestMethod -Uri "https://aicraft.51aic.com/api/v1/Conversation/Search" -Method POST -Headers @{"Content-Type"="application/json; charset=utf-8"; "Token"="<token>"} -Body ([System.Text.Encoding]::UTF8.GetBytes($Json))
发布图片生成任务
macOS/Linux：
curl -s -X POST "https://aicraft.51aic.com/api/v1/Task/Publish" \
-H "Content-Type: application/json; charset=utf-8" \
-H "Token: <token>" \
-d '{
"conversationId": "<会话ID>",
"projectType": "IMAGE",
"mode": 1,
"type": 2,
"payload": {
"aspectRatio": "auto",
"count": 1,
"prompt": "一件红色连衣裙，白色背景，电商商品图",
"sceneMode": "free_creation",
"referenceImages": []
}
}'
Windows：
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$Body = @{
conversationId = "<会话ID>"
projectType = "IMAGE"
mode = 1
type = 2
payload = @{
aspectRatio = "auto"
count = 1
prompt = "一件红色连衣裙，白色背景，电商商品图"
sceneMode = "free_creation"
referenceImages = @()
}
} | ConvertTo-Json -Depth 5
$BodyBytes = [System.Text.Encoding]::UTF8.GetBytes($Body)
Invoke-RestMethod -Uri "https://aicraft.51aic.com/api/v1/Task/Publish" -Method POST -Headers @{"Content-Type"="application/json; charset=utf-8"; "Token"="<token>"} -Body $BodyBytes
发布视频生成任务
macOS/Linux：
curl -s -X POST "https://aicraft.51aic.com/api/v1/Task/Publish" \
-H "Content-Type: application/json; charset=utf-8" \
-H "Token: <token>" \
-d '{
"conversationId": "<会话ID>",
"projectType": "VIDEO",
"mode": 1,
"type": 1,
"payload": {
"prompt": "介绍这款红色连衣裙的优点",
"duration": 8,
"orientation": "9:16",
"size": "large",
"language": "0",
"videoType": "2",
"videoChannel": "fast",
"images": ["https://oss.fzputi.com/..."]
}
}'
Windows：
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$Body = @{
conversationId = "<会话ID>"
projectType = "VIDEO"
mode = 1
type = 1
payload = @{
prompt = "介绍这款红色连衣裙的优点"
duration = 8
orientation = "9:16"
size = "large"
language = "0"
videoType = "2"
videoChannel = "fast"
images = @("https://oss.fzputi.com/...")
}
} | ConvertTo-Json -Depth 5
$BodyBytes = [System.Text.Encoding]::UTF8.GetBytes($Body)
Invoke-RestMethod -Uri "https://aicraft.51aic.com/api/v1/Task/Publish" -Method POST -Headers @{"Content-Type"="application/json; charset=utf-8"; "Token"="<token>"} -Body $BodyBytes
查询任务进度
提交任务后返回 taskJobId。可通过 Task/GetProgress 查询任务状态，支持一次查多个。
- 图片任务
taskType: 2
- 视频任务
taskType: 1
macOS/Linux：
curl -s -X POST "https://aicraft.51aic.com/api/v1/Task/GetProgress" \
-H "Content-Type: application/json; charset=utf-8" \
-H "Token: <token>" \
-d '{"conditions":[{"taskJobId":"<任务ID>","taskType":2}]}'
Windows：
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$Json = '{"conditions":[{"taskJobId":"<任务ID>","taskType":2}]}'
Invoke-RestMethod -Uri "https://aicraft.51aic.com/api/v1/Task/GetProgress" -Method POST -Headers @{"Content-Type"="application/json; charset=utf-8"; "Token"="<token>"} -Body ([System.Text.Encoding]::UTF8.GetBytes($Json))
