企业与 API — 快境AI

01 · 批量与团队

一个账户，整个设计部都能用。

主账号统一充值和计费，成员席位分开管理；批量提交、批量下载，量再大也不用一张张点。

批量生产

一次连出 99 张

整包上传图片批量处理；详情图最多 20 个商品一起做；一包打包下载 1000 张。

团队席位

3 到 30 个席位

商用版 3 / 5 / 10 席，企业版 5 / 15 / 30 席。成员共用主账号额度，谁用了多少一目了然。

作品保留

最长保留一年

按套餐保留生成的作品，企业旗舰版保留 365 天，随时回来下载、复用参数。

02 · 开放 API

接进你自己的系统，结果主动送回来。

印花提取、抠图、放大、无缝图、图片编辑、文生图等 12 项能力已开放标准接口，按张扣快币，和网页端共用一个账户。

鉴权: API Token（Bearer），在工作台「模型 API」里创建和管理
调用方式: 提交任务拿到任务 ID，查询结果或等回调
回调: 任务完成后推送到你的 callback_url，用 callback_secret 做 HMAC-SHA256 签名，防伪造
频率上限: 提交300 / 分钟查询600 / 分钟上传60 / 分钟
接入方式: HTTP 直接调用、命令行工具 @fastthree-ai/cli、MCP（让 AI 助手直接调用）

查看 API 文档创建 API Token

提交一个印花提取任务，完成后结果推到 callback_url

curl -X POST https://ai.fastthree.com/api/open/v1/tasks/Extract \
  -H "Authorization: Bearer $FT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "reference_images": ["https://cdn.ai.fastthree.com/HD/photo.jpg"],
    "extract_model": "通用模型",
    "resolution": "2k",
    "callback_url": "https://your.app/hooks/fastthree",
    "callback_secret": "••••••••••••••••"
  }'

# → {"taskId": "8C2E5A91F04B", "status": "processing"}

Python · requests

import os, requests

resp = requests.post(
    "https://ai.fastthree.com/api/open/v1/tasks/Extract",
    headers={"Authorization": f"Bearer {os.environ['FT_API_TOKEN']}"},
    json={
        "reference_images": ["https://cdn.ai.fastthree.com/HD/photo.jpg"],
        "extract_model": "通用模型",
        "resolution": "2k",
        "callback_url": "https://your.app/hooks/fastthree",
        "callback_secret": os.environ["FT_CALLBACK_SECRET"],
    },
)
task_id = resp.json()["data"]["taskId"]  # "8C2E5A91F04B"

Node.js 18+ · 原生 fetch

const res = await fetch("https://ai.fastthree.com/api/open/v1/tasks/Extract", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.FT_API_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    reference_images: ["https://cdn.ai.fastthree.com/HD/photo.jpg"],
    extract_model: "通用模型",
    resolution: "2k",
    callback_url: "https://your.app/hooks/fastthree",
    callback_secret: process.env.FT_CALLBACK_SECRET,
  }),
});
const { data } = await res.json();  // data.taskId → "8C2E5A91F04B"

命令行工具 @fastthree-ai/cli，写脚本、跑 CI 都方便

# 安装（Node.js 18+），保存 Token 并验证
npm i -g @fastthree-ai/cli
ft configure --verify

# 上传本地图片 → 提交提取 → 查结果
ft upload ./photo.jpg
ft draw Extract \
  -p 'reference_images=["https://cdn.ai.fastthree.com/HD/photo.jpg"]' \
  -p extract_model=通用模型 -p resolution=2k
ft task 8C2E5A91F04B

写进 Claude Desktop / Cursor / VS Code 的 mcp.json，AI 助手直接调用上传、提交、查询等 8 个工具

{
  "mcpServers": {
    "fastthree": {
      "url": "https://ai.fastthree.com/api/open/v1/mcp",
      "headers": {
        "Authorization": "Bearer 替换成你的 Token"
      }
    }
  }
}

一个任务，四次往返。

上传、提交、回调、对账，每一步都是一个标准 HTTP 请求。生成在后台跑，不用一直等着。

01 上传60 次 / 分钟

POST/api/open/v1/upload
```
# multipart 表单
file=@photo.jpg

# → data
"https://cdn…/HD/photo.jpg"
```
返回的地址直接填进图片参数

02 提交300 次 / 分钟

POST/api/open/v1/tasks/Extract

{ "reference_images": [ … ],
  "resolution": "2k",
  "callback_url": "…" }

# → data
{ "taskId": "8C2E5A91F04B",
  "status": "processing" }

立即返回受理回执，生成在后台跑

03 回调平台 → 你的服务器

POSThttps://your.app/hooks/fastthree

X-FastThree-Signature:
  v1=4f1c…e09a

{ "event": "task.succeeded",
  "data": {
    "result_url": "https://…",
    "points_consumed": 12 } }

返回任意 2xx 即确认；失败自动重试，最多 8 次

04 对账600 次 / 分钟

GET/api/open/v1/tasks/8C2E5A91F04B

# → data
{ "status": "success",
  "pointsConsumed": 12,
  "duration": 86,
  "resultImage": "https://…" }

结果文件保留 3 天，请及时转存

接口一览

Base URLhttps://ai.fastthree.com/api/open/v1

GET	/health	健康检查，唯一不用凭证的接口
GET	/account	查询账户快币余额
POST	/upload	上传图片，返回可用的地址	60 / 分
POST	/tasks/{apiKey}	按接口标识提交任务	300 / 分
GET	/tasks/{id}	查询任务状态与结果	600 / 分
POST	/mcp	MCP 端点（Streamable HTTP）

接口标识

图片提取
无版权图案提取
智能抠图
高清放大
无缝图 · AI 精修
无缝图 · 极速
图片编辑
图片编辑 2.5
文生图
…多模型生图等，见文档

校验回调签名

签名 = HMAC-SHA256(callback_secret, 时间戳 + "." + 原始请求体)。先验签再处理，同一事件按 X-FT2-Event-Id 去重。

import crypto from "node:crypto";
import express from "express";

const app = express();
// 用原始请求体验签，别先解析成对象再序列化
const raw = express.raw({ type: "application/json" });

app.post("/hooks/fastthree", raw, (req, res) => {
  const ts = req.get("X-FastThree-Timestamp");
  const sig = req.get("X-FastThree-Signature") ?? "";
  const expected = "v1=" + crypto
    .createHmac("sha256", process.env.FT_CALLBACK_SECRET)
    .update(`${ts}.`).update(req.body)
    .digest("hex");
  if (sig.length !== expected.length ||
      !crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(expected))) {
    return res.sendStatus(401);
  }
  const event = JSON.parse(req.body);  // event.data.result_url
  res.sendStatus(204);  // 返回 2xx 即确认收到
});

import hashlib, hmac, os

def verify(headers, raw_body: bytes) -> bool:
    # raw_body 是原始请求体字节，不要先 json.loads
    ts = headers["X-FastThree-Timestamp"]
    expected = "v1=" + hmac.new(
        os.environ["FT_CALLBACK_SECRET"].encode(),
        ts.encode() + b"." + raw_body,
        hashlib.sha256,
    ).hexdigest()
    return hmac.compare_digest(
        expected, headers.get("X-FastThree-Signature", "")
    )

03 · 按你的流程来

自己串流程，或者我们来做。

标准功能不够用的时候，有两条路。

工作流

把步骤串成流水线

在工作台里用「工作流」把提取、修整、套图等步骤连起来，一张图进去，整套结果出来。

企业定制

专属功能和流程

把你的生产流程和需求告诉我们，我们为你定制专属功能、专属参数和对接方式。

给团队和系统用的快境AI。