SeeAny API 开发文档

1.1 接口根地址与调用协议

SeeAny API 基于标准 HTTPS RESTful 协议构建。所有请求均采用 JSON 格式进行数据交换，请求头必须包含有效的认证 Token。

1.2 鉴权认证 (Authentication)

所有受保护接口必须在 HTTP Request Header 中附带 Authorization 字段，并使用 Bearer 模式传递您的 API Key：

Authorization: Bearer sk-sa-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

1.3 异步任务生命周期与 Webhook 回调

由于高画质图像与视频生成需要计算时间，所有生成类接口均采用异步任务模式：

1.4 公共响应格式与错误码

接口返回的标准 JSON 数据结构：

{
  "code": 0,                    // 0 表示成功，非 0 表示错误
  "msg": "任务创建成功",          // 响应描述信息
  "data": {                     // 业务数据负载
    "task_uuid": "wtask_9b3fd2ac8114b771",
    "status": "PROCESSING",
    "wait_time": 15
  }
}

1.5 图片素材直传接口

支持将本地商品图片上传至高速 CDN 节点，返回可在各生成接口中直接作为 inputImgs 引用的公开 URL。

2.1 图像生成与编辑大模型直调

直接调度 seedance4.5、nano-banana-pro、gpt-image-2、seeany4 等最新 SOTA 图片大模型，支持文生图、图生图与自定义画幅比例。

请求参数说明 (Request Body)

调用代码示例 (Python Requests)

import requests
import time

API_KEY = "sk-sa-your-api-key"
headers = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}

# 1. 提交图像生成任务
payload = {
    "mode": "nano-banana-pro",      # 自由指定模型
    "prompt": "电商摄影，白色极简护肤品瓶身，大理石台面，柔和漫射光，4k超清",
    "size": "2K",
    "imgRatio": "3:4",
    "webhook_url": "https://your-domain.com/api/callback"
}

res = requests.post("https://api.seeany.com/api/ai/smarttask", json=payload, headers=headers).json()
task_uuid = res["data"]["task_uuid"]
print(f"Task submitted: {task_uuid}")

# 2. 若未配置 webhook，轮询任务结果
while True:
    task_res = requests.get(f"https://api.seeany.com/api/ai/querytask?task_uuid={task_uuid}", headers=headers).json()
    status = task_res["data"]["status"]
    if status == "SUCCESS":
        print("Image URL:", task_res["data"]["result_url"])
        break
    elif status == "FAILED":
        print("Task failed:", task_res["data"]["error_msg"])
        break
    time.sleep(2)

2.2 视频生成大模型直调

支持 Seedance 2.0、可灵 Kling v3、Wan 2.6 等主流视频大模型，支持图生视频、文生视频与多模态参考。

请求参数说明 (Request Body)

cURL 调用示例

curl -X POST "https://api.seeany.com/api/ai/videotask" \
  -H "Authorization: Bearer sk-sa-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "version": "seedance2.0",
    "mode": "img2video",
    "image_url": "https://your-bucket.com/product.jpg",
    "prompt": "镜头缓缓推进特写，光影流转，质感高级",
    "duration": 5,
    "resolution": "720p",
    "has_audio": true,
    "webhook_url": "https://your-domain.com/api/video_callback"
  }'

2.3 3D 模型生成与语音合成 (TTS)

• 3D 模型生成：传入单张多角度商品图，自动生成 .glb / .obj 格式的 3D 资产模型（¥ 1.60/次）。
• 文字转语音 (TTS)：支持电商带货多语种音色输出，每 50 字 ¥ 0.04 计费。

3.1 电商主图、卖点图与场景套图生成

输入 1 张商品底图，系统按电商上架规范批量策划并生成 5~9 张包含主图、场景图、细节特写与卖点展示的成套商品视觉图。

3.2 A+ 详情页多模块成套策划

自动拆解商品核心痛点与功能参数，按亚马逊 A+ / 天猫详情页标准格式输出成套切片素材。

3.3 标准商品白底图生成

自动抠除原背景并居中放置商品，补充真实物理接触柔和阴影，输出完全符合平台审核规范的 1:1 白底主图。

4.1 智能发丝级抠图与背景替换

精准识别主体边缘，支持透明 PNG 导出及 prompt 换背景，单次费用 ¥0.10。

4.2 智能扩图、区域消除与局部重绘

支持无缝扩展边缘画面、涂抹消除多余杂物以及根据蒙版（Mask）局部重绘修改细节。

4.3 超分辨率高清放大与 AI 变清晰

通过生成式超分辨率算法重构微观细节，支持将模糊图片最高无损放大至 4K/8K 分辨率。