提交请求
调用对应能力的 POST 接口，传入 JSON 请求体。
文档内容由站内功能配置与现有提交逻辑生成，按“电商套图 / AI商品图 / 视频创作”三大分组展示。所有接口根地址统一为 https://api.seeany.com/。
调用对应能力的 POST 接口，传入 JSON 请求体。
可先调用 POST /api/upload/image 上传图片，再把返回的 url 填入 inputImgs。文件存放在 apiupd/，并将在 14 天后过期。
可调用 POST /api/prompt-tools/ai-refine 同步润色提示词，按次计费，每次 ¥0.02（2 分）。
可调用 GET /api/developer/balance 查询 API 账户余额与累计充值/消费。金额单位为分，balance 为元。
图片与视频能力按任务模式进入平台队列，处理完成后生成资源。
配置 callback_url 的 API Key 会在每个作品成功或失败时收到回调；任务级失败会单独回调。
POST /api/ai/smarttask HTTP/1.1
Host: api.seeany.com
Authorization: Bearer sk-sa-xxxxxxxxxxxxxxxx
User-Agent: seeany-api
Content-Type: application/jsoncodeint业务状态码。本文列出的开发者接口以 0 表示成功，其他值表示失败。msgstring结果说明或错误信息。data.task_uuidstring异步任务唯一标识，图片/视频类接口常见。data.uuidstring同步生成结果或资源记录 ID，音频接口常见。data.task_idint站内任务记录 ID，文生音频等同步接口返回。{
"code": 0,
"msg": "任务创建成功",
"data": {
"task_uuid": "wtask_a1b2c3d4e5f6",
"total": 1,
"batch_count": 1,
"wait_time": 40
}
}request_idstring请求追踪 ID。statusstring最终状态：`succeeded` 或 `failed`。task_uuidstring异步任务唯一标识，与提交接口返回的 `data.task_uuid` 一致。work_uuidstring作品唯一标识；任务级失败时为空字符串。typeint创作类型 ID，对应页面配置中的 id / aiTypeId。sourceint任务来源；开发者 API 固定为 3。finished_atint任务或作品完成时间，Unix 时间戳。assetsarray最终资源列表；每项含 url、preview、width、height、media_type、status，失败时固定为空数组。error_messagestring失败原因，仅 `failed` 时返回。 后续任务中的 inputImgs 等图片字段必须填写平台可访问的 URL。没有自有图床时，可先通过本接口上传图片，再将返回的 url 用于任务请求。上传结果存放在独立的 apiupd/ 目录，不会保存到站内素材库，并将在 14 天后过期。
filefile图片文件。也可用字段名 `image`。urlstring可直接用于 `inputImgs` 等字段的完整 CDN URL。filepathstring对象存储路径，前缀为 `apiupd/`。widthint图片宽度（px）。heightint图片高度（px）。sizeint文件大小（字节）。mimestringMIME 类型，例如 `image/png`。extstring文件扩展名。curl -X POST "https://api.seeany.com/api/upload/image" \
-H "Authorization: Bearer sk-sa-xxx" \
-H "User-Agent: seeany-api" \
-F "file=@./product.png" 通用提示词润色接口。传入待优化文案，可选附带参考图与优化方向，同步返回润色结果。按次计费，每次 ¥0.02（2 分）。
promptstring待润色的原始提示词，必填。imagesstring[]可选参考图 URL 列表，最多 6 张；有图时会结合图片可见信息润色。actionstring可选优化方向：`more_premium`（更精致）、`more_ecommerce`（更电商）、`more_creative`（更有创意）、`shorter`（更短）、`regenerate`（换一种表达）。不传则做通用润色。extra_contextstring可选补充上下文，例如目标平台、风格偏好、时长约束等。promptstring润色后的最终提示词。curl -X POST "https://api.seeany.com/api/prompt-tools/ai-refine" \
-H "Authorization: Bearer sk-sa-xxx" \
-H "User-Agent: seeany-api" \
-H "Content-Type: application/json" \
-d '{
"prompt": "生成一杯奶油色保温杯的电商主图，白底，居中摆放",
"images": [
"https://img1.seeany.com/apiupd/20260807/9b3fd2ac8114b771.png"
],
"action": "more_ecommerce"
}'当你没有配置回调地址，或者希望主动查询任务进度与结果时，可使用任务轮询接口。建议优先用 `task_uuid` 做幂等查询。
task_uuidstring任务提交成功后返回的任务号。轮询时优先传这个字段。task_uuidstring任务唯一标识。sourceint任务来源；开发者 API 固定为 `3`。statusstring任务状态：`queued`、`running`、`succeeded`、`partial_failed`、`failed`。progressint进度百分比，范围 `0~100`。终态固定返回 `100`。progress_sourcestring进度来源：`upstream`（第三方实时进度）、`estimated`（按预计时间估算）、`summary`（按已处理数量计算）、`default`（默认初始进度）或 `final`（终态）。detailobject任务汇总信息，包含 `total`、`done`、`failed` 三个字段。assetsarray终态结果列表。每项含 `work_uuid`、`num`、`ratio`、`finished_at`、`group_name`、`error_message`、`images`；`images[]` 含 `url`、`preview`、`width`、`height`、`error_message`。进行中通常为空。error_messagestring失败态返回的错误信息；成功态通常为空。started_atint任务实际开始时间，Unix 时间戳；若尚未开始则可能为空。estimated_finish_atint按当前等待时间估算的预计完成时间，Unix 时间戳；仅在可估算时返回。created_atint任务创建时间，Unix 时间戳。updated_atint任务最近更新时间，Unix 时间戳。curl -G "https://api.seeany.com/developer/task/status" \
-H "Authorization: Bearer sk-sa-xxx" \
-H "User-Agent: seeany-api" \
--data-urlencode "task_uuid=wtask_a1b2c3d4e5f6"查询当前 API 账户余额与累计充值、消费、退款。金额以分为单位，balance 为换算后的元（保留两位小数）。API 账户与主站积分互不互通。
has_accountbool是否已开通 API 账户。balance_centint当前可用余额，单位分。balancestring当前可用余额，单位元，保留两位小数。total_recharge_centint累计充值金额，单位分。total_consume_centint累计消费金额，单位分。total_refund_centint累计退款金额，单位分。statusint账户状态：`1` 正常，`0` 已停用或未开通。status_textstring账户状态文案：`正常`、`已停用` 或 `未开通`。curl -G "https://api.seeany.com/api/developer/balance" \
-H "Authorization: Bearer sk-sa-xxx" \
-H "User-Agent: seeany-api"下面的比例与分辨率说明来自当前站内提交逻辑，用于说明 `imgRatio`、`size`、`resolution` 在不同模式下的可用范围。推荐优先传真实模型名；站内别名仍兼容。
nano-banana-pro`nano2` / `banana2` / `banana-pro`支持 `1K`、`2K`、`4K`nano-banana-2`nano-banana2`支持 `1K`、`2K`、`4K`gpt-image-2`sora`支持 `1K`、`2K`、`4K`nano-banana`banana-1` / `banana` / `nano` / `nano-1`不支持 `size`，传了也会被忽略seeany4`seeany4`支持 `2K`、`4K`；未传时按接口默认5 个接口，按 `sort` 升序排列。
/api/ai/grouptask上传商品图并配置多个出图分组后，批量生成主图、详情图、场景图等电商素材。
aiTypeId必填int固定传 2373，用于指定当前能力。aiType条件必填string建议传 imageSets，用于兼容页面记录；服务端按 aiTypeId 识别当前能力。inputImgs必填string[]产品图片 URL 列表，上限 6 张；建议上传同一商品的多角度/细节图。groups必填object[]组图任务配置数组。每项至少包含 `mode`、`imgNum`、`imgRatio`、`size`、`prompt`、`cateName`；可选 `name`、`options`、`refImgs`。每组的 `refImgs` 会与公共 `inputImgs` 去重合并。 可选模式：Banana Pro（nano-banana-pro，真实模型名，支持 size=1K/2K/4K，¥0.20/¥0.30/¥0.40）、中文（seeany4，真实模型名，支持 size=2K/4K，¥0.30/张）。推荐优先传真实模型名；别名与真实名可互通。单图能力须落在该能力 modelist 同族内；组图（grouptask）的 groups[].mode 不做 modelist 拦截。productTypestring商品类目或商品类型。productNamestring商品名称。sellingPointsstring核心卖点，多行文本可直接传字符串。platformstring目标电商平台；提交时会合并进各组 `groups[].options`。desMarketstring目标市场；提交时会合并进各组 `groups[].options`。desLangstring文案语种；提交时会合并进各组 `groups[].options`。visualStylestring视觉风格偏好。/api/ai/groupplan上传商品图后，调用 AI 分析并以 SSE 流式返回推荐的电商套图类型与描述词，不创建异步出图任务。
inputImgs必填string[]产品图片 URL 列表，上限 6 张；建议上传同一商品的多角度图片。productTypestring商品类型或补充品类信息；不传时平台会结合图片自动判断。productNamestring商品名称。sellingPointsstring核心卖点，多行文本可直接传字符串。customRequirementstring补充分析要求，例如希望强调的场景、风格、重点卖点。platformstring目标电商平台，例如 `Amazon`、`Tiktok`。desMarketstring目标市场，例如 `北美`、`东南亚`。desLangstring文案语种，例如 `中文`、`英语`。visualStylestring视觉风格偏好，例如 `极简商业摄影`、`轻奢生活方式`。imgRatiostring默认偏好比例，可传 `-2`、`1:1`、`4:3`、`3:4`、`16:9`、`9:16`、`3:2`、`2:3`、`5:4`、`4:5`、`21:9`；不传时由 AI 自动匹配更合适的比例。/api/ai/grouptask上传商品图并配置详情页模块后，批量生成 A+ 详情页所需的配图内容。
aiTypeId必填int固定传 6489，用于指定当前能力。aiType条件必填string建议传 aDetailPage，用于兼容页面记录；服务端按 aiTypeId 识别当前能力。inputImgs必填string[]输入图片 URL 列表，上限 6 张。groups必填object[]组图任务配置数组，每项包含出图类型、模式、比例、张数和 options。 可选模式：通用（banana，对应真实模型 nano-banana，¥0.10/张，不支持 size）、Pro（banana2，对应真实模型 nano-banana-pro，¥0.20/张起）、中文（seeany4，真实模型名，支持 size=2K/4K，¥0.30/张）。推荐优先传真实模型名；别名与真实名可互通。单图能力须落在该能力 modelist 同族内；组图（grouptask）的 groups[].mode 不做 modelist 拦截。productTypestring商品类目或商品类型。productNamestring商品名称。sellingPointsstring商品卖点文本。modulesstring[]详情页模块配置。desLangstring目标语言。desMarketstring目标市场。platformstring目标电商平台。visualStylestring视觉风格偏好。/api/ai/grouptask上传服装图、模特图和分组配置后，批量生成上身图、场景图和详情图。
aiTypeId必填int固定传 6490，用于指定当前能力。aiType条件必填string建议传 clothSets，用于兼容页面记录；服务端按 aiTypeId 识别当前能力。inputImgs必填string[]输入图片 URL 列表，上限 6 张。modelImg必填string模特图或基准人物图 URL。 服饰套图需要先选择基准模特。baselineModelConfigobject服饰套图基准模特配置。groups必填object[]组图任务配置数组，每项包含出图类型、模式、比例、张数和 options。 可选模式：通用（banana，对应真实模型 nano-banana，¥0.10/张，不支持 size）、Pro（banana2，对应真实模型 nano-banana-pro，¥0.20/张起）、中文（seeany4，真实模型名，支持 size=2K/4K，¥0.30/张）。推荐优先传真实模型名；别名与真实名可互通。单图能力须落在该能力 modelist 同族内；组图（grouptask）的 groups[].mode 不做 modelist 拦截。productTypestring商品类目或商品类型。productNamestring商品名称。desLangstring目标语言。desMarketstring目标市场。platformstring目标电商平台。visualStylestring视觉风格偏好。imgRatiostring服饰套图的默认成图比例；未在分组里单独覆盖时会作为兜底比例使用。/api/ai/batchsmarttask上传商品图和参考图后，生成接近参考画面风格的商品图片。
aiTypeId必填int固定传 6491，用于指定当前能力。aiType条件必填string建议传 hotReplica，用于兼容页面记录；服务端按 aiTypeId 识别当前能力。inputImgs必填string[]输入图片 URL 列表，上限 6 张。refImgs必填string[]参考图 URL 列表，上限 20 张。promptstring文本描述词或补充说明。modestring模型或模式标识。 可选模式：通用（banana，对应真实模型 nano-banana，¥0.10/张，不支持 size）、Banana Pro（nano-banana-pro，真实模型名，支持 size=1K/2K/4K，¥0.20/¥0.30/¥0.40）、中文（seeany4，真实模型名，支持 size=2K/4K，¥0.30/张）。推荐优先传真实模型名；别名与真实名可互通。单图能力须落在该能力 modelist 同族内；组图（grouptask）的 groups[].mode 不做 modelist 拦截。imgNumint输出数量。imgRatiostring输出比例，例如 `1:1`、`3:4`、`9:16`。sizestring输出分辨率，如 `1K`、`2K`、`4K`。isBatchMode必填int固定传 1，与当前爆款复刻批量提交流程一致。20 个接口，按 `sort` 升序排列。
/api/ai/smarttask输入提示词并按需上传参考图后，生成商品创作图片。
aiTypeId必填int固定传 113，用于指定当前能力。aiType条件必填string建议传 smartImg，用于兼容页面记录；服务端按 aiTypeId 识别当前能力。prompt必填string文本描述词或补充说明。inputImgsstring[]输入图片 URL 列表，上限 10 张。modestring模型或模式标识。 可选模式：通用（banana-1，对应真实模型 nano-banana，¥0.10/张，不支持 size）、Banana Pro（nano2，对应真实模型 nano-banana-pro，¥0.20/张起）、Banana Pro（nano-banana-pro，真实模型名，支持 size=1K/2K/4K，¥0.20/¥0.30/¥0.40）、Sora Image（sora，对应真实模型 gpt-image-2，支持 size=1K/2K/4K）、中文增强（seeany4，真实模型名，支持 size=2K/4K，¥0.30/张）。推荐优先传真实模型名；别名与真实名可互通。单图能力须落在该能力 modelist 同族内；组图（grouptask）的 groups[].mode 不做 modelist 拦截。imgNumint输出数量。imgRatiostring输出比例，例如 `1:1`、`3:4`、`9:16`。sizestring输出分辨率，如 `1K`、`2K`、`4K`。/api/ai/smarttask上传原图并填写修改要求后，对现有商品图进行重绘、替换或风格调整。
aiTypeId必填int固定传 558，用于指定当前能力。aiType条件必填string建议传 anyedit，用于兼容页面记录；服务端按 aiTypeId 识别当前能力。inputImg必填string待编辑原图 URL。页面实际提交流程默认使用这个字段。prompt必填string文本描述词或补充说明。refImgstring额外参考图 URL。modestring模型或模式标识。 可选模式：通用（banana-1，对应真实模型 nano-banana，¥0.10/张，不支持 size）、Banana Pro（nano2，对应真实模型 nano-banana-pro，¥0.20/张起）、Banana Pro（nano-banana-pro，真实模型名，支持 size=1K/2K/4K，¥0.20/¥0.30/¥0.40）、Sora Image（sora，对应真实模型 gpt-image-2，支持 size=1K/2K/4K）、中文增强（seeany4，真实模型名，支持 size=2K/4K，¥0.30/张）。推荐优先传真实模型名；别名与真实名可互通。单图能力须落在该能力 modelist 同族内；组图（grouptask）的 groups[].mode 不做 modelist 拦截。imgNumint输出数量。imgRatiostring输出比例，例如 `1:1`、`3:4`、`9:16`。sizestring输出分辨率，如 `1K`、`2K`、`4K`。/api/ai/edittask上传图片并选择编辑子能力后，执行局部编辑、扩图、去水印或线稿处理。
aiTypeId必填int固定传 168，用于指定当前能力。aiType条件必填string建议传 aiediting，用于兼容页面记录；服务端按 aiTypeId 识别当前能力。subAiType必填string编辑子能力标识。当前对应关系为：`upscale=高清放大`、`repainting=高清重绘`、`rembg=AI抠图`、`outpaint=AI扩图`、`eraser=AI消除`、`beautify=精修美化`、`cleaner=变清晰`、`replace=商品替换`、`inpaint=局部修改`、`img2lineart=提取线稿`、`removewater=水印去除`、`smartedit=智能改图`。inputImg必填string单张输入图片 URL。prompt条件必填string文本描述词或补充说明。 `replace`、`changebg`、`inpaint`、`smartedit`、`outpaint` 等子能力需要。maskImg条件必填string遮罩图 URL。 `eraser`、`inpaint`、`removewater` 等需要选区的子能力需要。upscale条件必填string放大等级或放大模式。 `upscale`、`repainting` 子能力需要。lineartType条件必填string线稿或边缘提取模式。 `img2lineart` 子能力需要。waterMarkMode条件必填string水印处理模式。 `removewater` 子能力需要。mode条件必填string模型或模式标识。 `smartedit`、`outpaint` 子能力需要。 可选模式：通用（banana-1，对应真实模型 nano-banana，¥0.10/张，不支持 size）、Banana Pro（nano2，对应真实模型 nano-banana-pro，¥0.20/张起）、Banana Pro（nano-banana-pro，真实模型名，支持 size=1K/2K/4K，¥0.20/¥0.30/¥0.40）、Sora Image（sora，对应真实模型 gpt-image-2，支持 size=1K/2K/4K）、中文增强（seeany4，真实模型名，支持 size=2K/4K，¥0.30/张）。推荐优先传真实模型名；别名与真实名可互通。单图能力须落在该能力 modelist 同族内；组图（grouptask）的 groups[].mode 不做 modelist 拦截。refImg条件必填string替换主体或换背景时使用的参考图 URL。 `replace`、`changebg` 子能力需要。size条件必填string支持高分辨率模式时可传，如 `1K`、`2K`、`4K`。 当 `mode` 为高分辨率模型时可传。outpaintImg条件必填string扩图模式下由编辑器导出的画布图片。 `outpaint` 子能力需要。/api/ai/3dmodeltask上传多视角图片后生成 3D 模型任务。
aiTypeId必填int固定传 116，用于指定当前能力。aiType条件必填string建议传 imageTo3dModel，用于兼容页面记录；服务端按 aiTypeId 识别当前能力。 模式说明：当前能力无可选 modelist，按平台默认模式处理。frontImg必填string正视图 URL，必填。backImg条件必填string后视图 URL，可选。 可选，用于补充背面视角；未提供时可只用正面图提交。leftImg条件必填string左视图 URL，可选。 可选，用于补充左侧视角。rightImg条件必填string右视图 URL，可选。 可选，用于补充右侧视角。/api/ai/batchsmarttask上传产品图后，对画面做精修和细节优化。
aiTypeId必填int固定传 6495，用于指定当前能力。aiType条件必填string建议传 productRetouch，用于兼容页面记录；服务端按 aiTypeId 识别当前能力。inputImgs必填string[]输入图片 URL 列表，上限 24 张。promptstring文本描述词或补充说明。oneClickOptionsobject一键类功能的结构化附加参数。modestring模型或模式标识。 可选模式：通用模式（banana-1，对应真实模型 nano-banana，¥0.10/张，不支持 size）、Pro模式（banana2，对应真实模型 nano-banana-pro，¥0.20/张起）。推荐优先传真实模型名；别名与真实名可互通。单图能力须落在该能力 modelist 同族内；组图（grouptask）的 groups[].mode 不做 modelist 拦截。imgNumint输出数量。imgRatiostring输出比例，例如 `1:1`、`3:4`、`9:16`。sizestring输出分辨率，如 `1K`、`2K`、`4K`。/api/ai/batchsmarttask上传图片并指定目标语言后，输出翻译后的结果图。
aiTypeId必填int固定传 137，用于指定当前能力。aiType条件必填string建议传 imageTranslation，用于兼容页面记录；服务端按 aiTypeId 识别当前能力。 可选模式：通用模式（banana-1，对应真实模型 nano-banana，¥0.10/张，不支持 size）、Banana Pro（nano-banana-pro，真实模型名，支持 size=1K/2K/4K，¥0.20/¥0.30/¥0.40）、中文增强（seeany4，真实模型名，支持 size=2K/4K，¥0.30/张）。推荐优先传真实模型名；别名与真实名可互通。单图能力须落在该能力 modelist 同族内；组图（grouptask）的 groups[].mode 不做 modelist 拦截。inputImgs必填string[]输入图片 URL 列表，上限 24 张。oneClickOptions必填object结构化参数；至少需包含目标语种，例如 `{ "目标语种": "英语" }`。prompt条件必填string文本描述词或补充说明。 接口会根据 `oneClickOptions` 自动生成目标语言描述，通常无需单独传。sizestring输出分辨率，如 `1K`、`2K`、`4K`。imgNumint输出数量。/api/ai/batchsmarttask上传商品图后，批量生成纯白背景图。
aiTypeId必填int固定传 565，用于指定当前能力。aiType条件必填string建议传 whitebgimg，用于兼容页面记录；服务端按 aiTypeId 识别当前能力。inputImgs必填string[]输入图片 URL 列表，上限 24 张。imgNumint输出数量。imgRatiostring输出比例，例如 `1:1`、`3:4`、`9:16`。modestring模型或模式标识。 可选模式：通用模式（banana-1，对应真实模型 nano-banana，¥0.10/张，不支持 size）、Banana Pro（nano-banana-pro，真实模型名，支持 size=1K/2K/4K，¥0.20/¥0.30/¥0.40）。推荐优先传真实模型名；别名与真实名可互通。单图能力须落在该能力 modelist 同族内；组图（grouptask）的 groups[].mode 不做 modelist 拦截。sizestring输出分辨率，如 `1K`、`2K`、`4K`。/api/ai/batchsmarttask上传商品图后，生成带场景氛围的展示图。
aiTypeId必填int固定传 151，用于指定当前能力。aiType条件必填string建议传 sceneImages，用于兼容页面记录；服务端按 aiTypeId 识别当前能力。promptstring文本描述词或补充说明。inputImgs必填string[]输入图片 URL 列表，上限 24 张。refImgstring额外参考图 URL。refImgsstring[]参考图 URL 列表。modestring模型或模式标识。 可选模式：通用模式（banana-1，对应真实模型 nano-banana，¥0.10/张，不支持 size）、Banana Pro（nano-banana-pro，真实模型名，支持 size=1K/2K/4K，¥0.20/¥0.30/¥0.40）、中文增强（seeany4，真实模型名，支持 size=2K/4K，¥0.30/张）。推荐优先传真实模型名；别名与真实名可互通。单图能力须落在该能力 modelist 同族内；组图（grouptask）的 groups[].mode 不做 modelist 拦截。imgNumint输出数量。imgRatiostring输出比例，例如 `1:1`、`3:4`、`9:16`。sizestring输出分辨率，如 `1K`、`2K`、`4K`。oneClickOptionsobject{
"产品类型": "",
"场景类型": "",
"产品展示": "",
"排版呈现": "",
"氛围营造": "",
"价值导向": "",
"目标市场": "",
"文案语种": ""
}/api/ai/batchsmarttask上传商品图后，生成试穿或试戴效果图。
aiTypeId必填int固定传 153，用于指定当前能力。aiType条件必填string建议传 tryOn，用于兼容页面记录；服务端按 aiTypeId 识别当前能力。promptstring文本描述词或补充说明。inputImgs必填string[]输入图片 URL 列表，上限 24 张。refImgstring额外参考图 URL。refImgsstring[]参考图 URL 列表。modestring模型或模式标识。 可选模式：通用模式（banana-1，对应真实模型 nano-banana，¥0.10/张，不支持 size）、Banana Pro（nano-banana-pro，真实模型名，支持 size=1K/2K/4K，¥0.20/¥0.30/¥0.40）、中文增强（seeany4，真实模型名，支持 size=2K/4K，¥0.30/张）。推荐优先传真实模型名；别名与真实名可互通。单图能力须落在该能力 modelist 同族内；组图（grouptask）的 groups[].mode 不做 modelist 拦截。imgNumint输出数量。imgRatiostring输出比例，例如 `1:1`、`3:4`、`9:16`。sizestring输出分辨率，如 `1K`、`2K`、`4K`。oneClickOptionsobject{
"产品类型": "",
"人种肤色": "",
"性别物种": "",
"年龄维度": "",
"身型身材": "",
"展示排版": "",
"场景类型": "",
"展示重点": "",
"氛围营造": "",
"文案语种": "",
"目标市场": ""
}/api/ai/batchsmarttask上传商品图后，生成突出局部细节的特写图片。
aiTypeId必填int固定传 6493，用于指定当前能力。aiType条件必填string建议传 detailCloseup，用于兼容页面记录；服务端按 aiTypeId 识别当前能力。inputImgs必填string[]输入图片 URL 列表，上限 24 张。promptstring文本描述词或补充说明。imgNumint输出数量。imgRatiostring输出比例，例如 `1:1`、`3:4`、`9:16`。modestring模型或模式标识。 可选模式：通用模式（banana-1，对应真实模型 nano-banana，¥0.10/张，不支持 size）、Banana Pro（nano-banana-pro，真实模型名，支持 size=1K/2K/4K，¥0.20/¥0.30/¥0.40）、中文增强（seeany4，真实模型名，支持 size=2K/4K，¥0.30/张）。推荐优先传真实模型名；别名与真实名可互通。单图能力须落在该能力 modelist 同族内；组图（grouptask）的 groups[].mode 不做 modelist 拦截。sizestring输出分辨率，如 `1K`、`2K`、`4K`。oneClickOptionsobject{
"产品类型": "",
"展示形式": ""
}/api/ai/batchsmarttask上传商品图后，生成用于说明卖点的展示图。
aiTypeId必填int固定传 123，用于指定当前能力。aiType条件必填string建议传 oneClickHighlights，用于兼容页面记录；服务端按 aiTypeId 识别当前能力。inputImgs必填string[]输入图片 URL 列表，上限 24 张。promptstring文本描述词或补充说明。imgNumint输出数量。imgRatiostring输出比例，例如 `1:1`、`3:4`、`9:16`。modestring模型或模式标识。 可选模式：通用模式（banana-1，对应真实模型 nano-banana，¥0.10/张，不支持 size）、Banana Pro（nano-banana-pro，真实模型名，支持 size=1K/2K/4K，¥0.20/¥0.30/¥0.40）、中文增强（seeany4，真实模型名，支持 size=2K/4K，¥0.30/张）。推荐优先传真实模型名；别名与真实名可互通。单图能力须落在该能力 modelist 同族内；组图（grouptask）的 groups[].mode 不做 modelist 拦截。sizestring输出分辨率，如 `1K`、`2K`、`4K`。oneClickOptionsobject{
"产品类型": "",
"文案语种": "",
"核心卖点": "",
"表现形式": "",
"卖点重心": "",
"主副标题": "",
"副标题": "",
"字体风格": "",
"元素辅助": "",
"目标市场": ""
}/api/ai/batchsmarttask上传商品图后，生成适合营销展示的主视觉图片。
aiTypeId必填int固定传 6494，用于指定当前能力。aiType条件必填string建议传 marketingHero，用于兼容页面记录；服务端按 aiTypeId 识别当前能力。inputImgs必填string[]输入图片 URL 列表，上限 24 张。promptstring文本描述词或补充说明。imgNumint输出数量。imgRatiostring输出比例，例如 `1:1`、`3:4`、`9:16`。modestring模型或模式标识。 可选模式：通用模式（banana-1，对应真实模型 nano-banana，¥0.10/张，不支持 size）、Banana Pro（nano-banana-pro，真实模型名，支持 size=1K/2K/4K，¥0.20/¥0.30/¥0.40）、中文增强（seeany4，真实模型名，支持 size=2K/4K，¥0.30/张）。推荐优先传真实模型名；别名与真实名可互通。单图能力须落在该能力 modelist 同族内；组图（grouptask）的 groups[].mode 不做 modelist 拦截。sizestring输出分辨率，如 `1K`、`2K`、`4K`。oneClickOptionsobject{
"产品类型": "",
"场景背景": "",
"平台信息": "",
"商品信息": "",
"视觉风格": "",
"营销元素": "",
"文案语种": ""
}/api/ai/batchsmarttask上传商品图后，生成偏真实体验感的买家秀风格图片。
aiTypeId必填int固定传 124，用于指定当前能力。aiType条件必填string建议传 buyerShowcase，用于兼容页面记录；服务端按 aiTypeId 识别当前能力。inputImgs必填string[]输入图片 URL 列表，上限 24 张。promptstring文本描述词或补充说明。imgNumint输出数量。imgRatiostring输出比例，例如 `1:1`、`3:4`、`9:16`。modestring模型或模式标识。 可选模式：通用模式（banana-1，对应真实模型 nano-banana，¥0.10/张，不支持 size）、Banana Pro（nano-banana-pro，真实模型名，支持 size=1K/2K/4K，¥0.20/¥0.30/¥0.40）、中文增强（seeany4，真实模型名，支持 size=2K/4K，¥0.30/张）。推荐优先传真实模型名；别名与真实名可互通。单图能力须落在该能力 modelist 同族内；组图（grouptask）的 groups[].mode 不做 modelist 拦截。sizestring输出分辨率，如 `1K`、`2K`、`4K`。oneClickOptionsobject{
"产品类型": "",
"产品状态": "",
"呈现方式": "",
"场景氛围": "",
"产品真实感": "",
"环境真实感": "",
"拍摄真实感": "",
"目标市场": ""
}/api/ai/batchsmarttask上传商品图后，生成带人物出镜的商品展示图。
aiTypeId必填int固定传 562，用于指定当前能力。aiType条件必填string建议传 brandAvatar，用于兼容页面记录；服务端按 aiTypeId 识别当前能力。promptstring文本描述词或补充说明。inputImgs必填string[]输入图片 URL 列表，上限 24 张。refImgstring额外参考图 URL。refImgsstring[]参考图 URL 列表。modestring模型或模式标识。 可选模式：通用模式（banana-1，对应真实模型 nano-banana，¥0.10/张，不支持 size）、Banana Pro（nano-banana-pro，真实模型名，支持 size=1K/2K/4K，¥0.20/¥0.30/¥0.40）、中文增强（seeany4，真实模型名，支持 size=2K/4K，¥0.30/张）。推荐优先传真实模型名；别名与真实名可互通。单图能力须落在该能力 modelist 同族内；组图（grouptask）的 groups[].mode 不做 modelist 拦截。imgNumint输出数量。imgRatiostring输出比例，例如 `1:1`、`3:4`、`9:16`。sizestring输出分辨率，如 `1K`、`2K`、`4K`。oneClickOptionsobject{
"产品类型": "",
"互动方式": "",
"人物特点": "",
"场景背景": "",
"排版方式": "",
"人种肤色": "",
"性别风格": "",
"年龄特点": "",
"展示重点": "",
"目标市场": ""
}/api/ai/smarttask上传模特图和商品图后，生成模特试穿结果图。
aiTypeId必填int固定传 164，用于指定当前能力。aiType条件必填string建议传 modelTryOn，用于兼容页面记录；服务端按 aiTypeId 识别当前能力。 可选模式：通用模式（banana-1，对应真实模型 nano-banana，¥0.10/张，不支持 size）、Pro模式（banana2，对应真实模型 nano-banana-pro，¥0.20/张起）、中文增强（seeany4，真实模型名，支持 size=2K/4K，¥0.30/张）。推荐优先传真实模型名；别名与真实名可互通。单图能力须落在该能力 modelist 同族内；组图（grouptask）的 groups[].mode 不做 modelist 拦截。modelImg必填string模特图或基准人物图 URL。tryOnMode必填string试穿模式，如 `single`、`multi`、`batch`。inputImg条件必填string单张输入图片 URL。 `tryOnMode=single` 时必填。inputImgs条件必填string[]产品图片 URL 列表；`single` 传 1 张，`multi` 最多 6 张，`batch` 最多 24 张。 `tryOnMode=multi` 或 `batch` 时必填。imgNumint输出数量。imgRatiostring输出比例，例如 `1:1`、`3:4`、`9:16`。/api/ai/batchsmarttask上传商品图并选择视角后，生成三视图或多角度展示图。
aiTypeId必填int固定传 464，用于指定当前能力。aiType条件必填string建议传 multiview，用于兼容页面记录；服务端按 aiTypeId 识别当前能力。 模式说明：当前能力无可选 modelist，按平台默认模式处理。inputImgs必填string[]输入图片 URL 列表，上限 24 张。views必填string多视角类型或视图方案标识。imgNumint输出数量。imgRatiostring输出比例，例如 `1:1`、`3:4`、`9:16`。/api/ai/smarttask上传原图后，按子能力完成换模特、换发型或人物微调。
aiTypeId必填int固定传 121，用于指定当前能力。aiType条件必填string建议传 replaceModel，用于兼容页面记录；服务端按 aiTypeId 识别当前能力。inputImg必填string单张输入图片 URL。prompt条件必填string文本描述词或补充说明。 `subAiType=replace` 时必填。subAiType必填string子能力标识，如 `smartedit`、`outpaint`、`replace` 等。modelImg条件必填string模特图或基准人物图 URL。 `subAiType=replace` 或 `hairchange` 时必填。imgNumint输出数量。imgRatiostring输出比例，例如 `1:1`、`3:4`、`9:16`。modestring生成模型或处理模式。 可选模式：通用模式（banana-1，对应真实模型 nano-banana，¥0.10/张，不支持 size）、Pro模式（banana2，对应真实模型 nano-banana-pro，¥0.20/张起）、中文增强（seeany4，真实模型名，支持 size=2K/4K，¥0.30/张）。推荐优先传真实模型名；别名与真实名可互通。单图能力须落在该能力 modelist 同族内；组图（grouptask）的 groups[].mode 不做 modelist 拦截。size条件必填string支持高分辨率模式时可传，如 `1K`、`2K`、`4K`。 当 `mode` 为高分辨率模型时可传。/api/ai/batchsmarttask上传商品图后，在保留主体的前提下替换背景。
aiTypeId必填int固定传 122，用于指定当前能力。aiType条件必填string建议传 replaceBackground，用于兼容页面记录；服务端按 aiTypeId 识别当前能力。promptstring文本描述词或补充说明。inputImgs必填string[]输入图片 URL 列表，上限 24 张。refImgstring额外参考图 URL。refImgsstring[]参考图 URL 列表。modestring模型或模式标识。 可选模式：通用模式（banana-1，对应真实模型 nano-banana，¥0.10/张，不支持 size）、Banana Pro（nano-banana-pro，真实模型名，支持 size=1K/2K/4K，¥0.20/¥0.30/¥0.40）、中文增强（seeany4，真实模型名，支持 size=2K/4K，¥0.30/张）。推荐优先传真实模型名；别名与真实名可互通。单图能力须落在该能力 modelist 同族内；组图（grouptask）的 groups[].mode 不做 modelist 拦截。imgNumint输出数量。imgRatiostring输出比例，例如 `1:1`、`3:4`、`9:16`。sizestring输出分辨率，如 `1K`、`2K`、`4K`。oneClickOptionsobject{
"背景类型": "",
"风格与光影": ""
}/api/ai/smarttask上传原图并填写替换要求后，替换画面中的商品主体。
aiTypeId必填int固定传 169，用于指定当前能力。aiType条件必填string建议传 productReplace，用于兼容页面记录；服务端按 aiTypeId 识别当前能力。prompt必填string文本描述词或补充说明。inputImg必填string待替换商品原图 URL。页面实际提交流程默认使用这个字段。refImgstring额外参考图 URL。refImgsstring[]参考图 URL 列表。modestring模型或模式标识。 可选模式：通用模式（banana-1，对应真实模型 nano-banana，¥0.10/张，不支持 size）、Pro模式（banana2，对应真实模型 nano-banana-pro，¥0.20/张起）、中文增强（seeany4，真实模型名，支持 size=2K/4K，¥0.30/张）。推荐优先传真实模型名；别名与真实名可互通。单图能力须落在该能力 modelist 同族内；组图（grouptask）的 groups[].mode 不做 modelist 拦截。imgNumint输出数量。imgRatiostring输出比例，例如 `1:1`、`3:4`、`9:16`。sizestring输出分辨率，如 `1K`、`2K`、`4K`。/api/ai/batchsmarttask上传原图后，在保留原有构图方向的基础上重绘商品图。
aiTypeId必填int固定传 125，用于指定当前能力。aiType条件必填string建议传 modelLineartRendering，用于兼容页面记录；服务端按 aiTypeId 识别当前能力。promptstring文本描述词或补充说明。inputImgs必填string[]输入图片 URL 列表，上限 24 张。refImgstring额外参考图 URL。refImgsstring[]参考图 URL 列表。modestring模型或模式标识。 可选模式：通用模式（banana-1，对应真实模型 nano-banana，¥0.10/张，不支持 size）、Pro模式（banana2，对应真实模型 nano-banana-pro，¥0.20/张起）、中文增强（seeany4，真实模型名，支持 size=2K/4K，¥0.30/张）。推荐优先传真实模型名；别名与真实名可互通。单图能力须落在该能力 modelist 同族内；组图（grouptask）的 groups[].mode 不做 modelist 拦截。imgNumint输出数量。imgRatiostring输出比例，例如 `1:1`、`3:4`、`9:16`。sizestring输出分辨率，如 `1K`、`2K`、`4K`。6 个接口，按 `sort` 升序排列。
/api/ai/videotask对应前端页面 `/video/ai-video`：支持自由创作、首尾帧生成、智能多帧，并可选多种视频模型。
aiTypeId必填int固定传 135，用于指定当前能力。aiType条件必填string建议传 aiVideo，用于兼容页面记录；服务端按 aiTypeId 识别当前能力。prompt条件必填string视频描述词。智能多帧模式可不传（描述写在 `multiFrames[].transitionPrompt`）。 除智能多帧，或 Seedance 2.5 已提供参考素材外，其他模式必填。version必填string模型版本，对应页面模型选择。常用：`seedance2.0`、`seedance2.0-fast`、`seedance2.0-mini`、`seedance2.5`、`pro1.5`、`wan2.6`、`wan2.7`、`klingv3`、`klingv3omini`、`happyhorse`、`gemini-omni`、`minimax-h3`、`pro`。mode必填string生成模式。页面会自动推导：自由创作 Seedance2 为 `multimodalref`；仅文案为 `text2video`；单图为 `img2video`；首尾帧为 `frontbackimg2video`；参考图为 `refimg2video`。 模式说明：mode 由创作模式与上传素材决定，见开发说明；不要按图片接口的 modelist 理解。resolutionstring分辨率，如 `480p`、`720p`、`1080p`（随模型变化，与页面输出参数一致）。durationstring时长（秒），与页面时长选项一致。imgRatiostring画面比例，如 `16:9`、`9:16`、`1:1`（可选范围随模型变化）。soundstring`with_audio` / `no_audio`。部分模型页面仅支持有声（如 Wan、HappyHorse、Gemini Omni、MiniMax H3）。channelstring当前视频模型固定 `normal`。inputImg条件必填string单张输入图。图生视频 / 仅首帧时使用。 图生视频或仅首帧时必填。inputImgs条件必填string[]多图参考。自由创作多模态、参考图模式使用；Seedance 2.0 最多 9 张，Seedance 2.5 最多 30 张。 自由创作多模态 / 参考图模式时按页面素材区上传。frontImg条件必填string首帧图。首尾帧生成时与 `backImg` 成对传入。 首尾帧生成时必填。backImg条件必填string尾帧图。首尾帧生成时与 `frontImg` 成对传入。 首尾帧生成时必填。referenceVideos条件必填string[]参考视频。Seedance2 / Wan2.7 / Gemini Omni 等自由创作可传。 自由创作上传参考视频时传。referenceAudios条件必填string[]参考音频。Seedance2 自由创作可传，需搭配图片或视频。 Seedance2 自由创作上传参考音频时传，需搭配图片或视频。dhAioCreationModestring创作模式：自由创作传 `free`（或省略）、首尾帧传 `frames`、智能多帧传 `multiFrames`。multiFrames条件必填object[]智能多帧专用。每项：`img`、`duration`、`transitionPrompt`。 智能多帧（`dhAioCreationMode=multiFrames`）时必填。/api/ai/videotask对应前端页面 `/video/product`：上传产品图并提供脚本，生成商品展示视频。
aiTypeId必填int固定传 6572，用于指定当前能力。aiType条件必填string建议传 productVideo，用于兼容页面记录；服务端按 aiTypeId 识别当前能力。mode必填string固定传 `multimodalref`。 产品视频固定传 `multimodalref`。 模式说明：固定传 `mode=multimodalref`。version必填string页面可选 `seedance2.0` / `seedance2.0-fast` / `seedance2.0-mini`。inputImgs必填string[]产品图片 URL 列表。activeTabstring`aiscript` 或 `customscript`。prompt条件必填string自定义脚本时必填；AI 脚本时建议同步写入最终文案。 `activeTab=customscript` 时必填。aiScript条件必填string`activeTab=aiscript` 时必填。 `activeTab=aiscript` 时必填。scriptModestring脚本模式，如 `simple`。resolutionstring分辨率，如 `720p`。durationstring时长（秒）。imgRatiostring比例，页面默认 `9:16`。soundstring`with_audio` / `no_audio`。voiceover条件必填string旁白文案（开启旁白时）。 开启旁白时可传。voiceoverLang条件必填string旁白语言。 开启旁白时可传。voiceoverTone条件必填string旁白音色。 开启旁白时可传。voiceoverToneAudio条件必填string自定义音色参考音频 URL。 自定义音色时必填。/api/ai/videotask对应前端页面 `/video/trending-remake`：上传参考视频与产品图，复刻相近风格短视频。
aiTypeId必填int固定传 6609，用于指定当前能力。aiType条件必填string建议传 trendingRemakeVideo，用于兼容页面记录；服务端按 aiTypeId 识别当前能力。mode必填string固定传 `multimodalref`。 爆款复刻固定传 `multimodalref`。 模式说明：固定传 `mode=multimodalref`。version必填string`seedance2.0` / `seedance2.0-fast` / `seedance2.0-mini`。inputVideo必填string参考视频 URL。inputImgs必填string[]产品图 URL 列表。referenceVideosstring[]建议与 `inputVideo` 同传一份。remakeMode条件必填string`style`（默认）或 `precise`。 可选 `style`（默认）或 `precise`。prompt条件必填string补充需求，可空；为空时平台会自动分析参考视频。 可选；为空时平台会自动分析参考视频。resolutionstring分辨率，如 `720p`。durationstring时长（秒）。imgRatiostring比例，页面默认 `9:16`。soundstring`with_audio` / `no_audio`。/api/ai/videotask对应前端页面 `/video/tryon`：首帧图生视频，或产品图+模特图+参考图生成试穿短视频。
aiTypeId必填int固定传 6599，用于指定当前能力。aiType条件必填string建议传 tryOnVideo，用于兼容页面记录；服务端按 aiTypeId 识别当前能力。mode必填string`img2video` 或 `ref2video`。 模式说明：`img2video`（首帧）或 `ref2video`（参考图）。version必填string首帧模式传 `klingv3`；参考图模式传 `klingv3omini`。prompt必填string视频描述词。inputImg条件必填string`img2video` 时必填，首帧图。 `mode=img2video` 时必填。inputImgs条件必填string[]`ref2video` 时必填，产品图。 `mode=ref2video` 时必填。modelImg条件必填string`ref2video` 时必填，模特图。 `mode=ref2video` 时必填。refImg条件必填string`ref2video` 时必填，参考图。 `mode=ref2video` 时必填。shotTypestring建议传 `intelligence`。resolutionstring`720p` / `1080p`。durationstring时长（秒）。imgRatiostring首帧模式页面常固定 `9:16`。soundstring`with_audio` / `no_audio`。/api/ai/videotask对应前端页面 `/video/replace-subject`：上传参考视频与目标主体图，替换视频主体。
aiTypeId必填int固定传 6600，用于指定当前能力。aiType条件必填string建议传 replaceSubjectVideo，用于兼容页面记录；服务端按 aiTypeId 识别当前能力。mode必填string固定传 `multimodalref`。 主体替换固定传 `multimodalref`。 模式说明：固定传 `mode=multimodalref`。version必填string`seedance2.0` / `seedance2.0-fast` / `seedance2.0-mini`。prompt必填string替换描述词。inputVideo必填string参考视频 URL。referenceVideos必填string[]建议与 `inputVideo` 同传。inputImgs必填string[]目标主体/商品图。resolutionstring分辨率，如 `720p`。durationstring时长（秒）。imgRatiostring比例，页面默认 `9:16`。soundstring`with_audio` / `no_audio`。/api/ai/audiotask输入文本并选择音色后，生成语音或配音素材。
aiTypeId必填int固定传 166，用于指定当前能力。aiType条件必填string建议传 txt2Speech，用于兼容页面记录；服务端按 aiTypeId 识别当前能力。 模式说明：无模式配置，按选中音色直接合成。prompt必填string文本描述词或补充说明。voice_type必填string音色配置中的 voice_type。emotion条件必填string音色情绪标签。 当所选音色支持情绪切换时可传。avatarstring音色头像 URL。namestring音色名称。