youcutai

youcut API 正式发布

发布于 2026年9月1日 · 1 分钟阅读

apideveloperslaunch

youcut.ai 上的每个工具现在都提供 REST API,与网页端共用同一个积分钱包、同样的模型和同样的输出质量。抠图每张 $0.02,对比 remove.bg 的 $0.20 和 cutout.pro 的约 $0.056。

我们为什么这样定价

抠图已经接近标准化商品。底层模型每次调用的成本只有零点几美分,为此收 $0.20 是利润决策而非成本决策。我们宁愿赢下这个集成,再把管线的其余部分卖给你:消除、放大、生成、视频。

公开价格:抠图每张 $0.02(走量后降至 $0.01),物体与文字消除 $0.03,放大 $0.02,图片生成为上游模型成本的 2 倍,视频为 1.6 倍。每个响应都会报告实际扣费,因此你的单位成本是可审计的,而不是靠推算。

三个调用跑通全部 API

全部 23 个工具共用一套流程:上传素材、创建任务、轮询结果。

# 1. 上传
curl -X POST https://api.youcut.ai/api/v1/uploads \
  -H "Authorization: Bearer yk_live_..." \
  -F "file=@product.jpg"
# -> { "id": "5b4bcf90-...", "url": "https://...", "width": 1200, "height": 900 }

# 2. 创建任务
curl -X POST https://api.youcut.ai/api/v1/jobs \
  -H "Authorization: Bearer yk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"tool":"background-remover","mode":"product","input_asset_ids":["5b4bcf90-..."],"params":{"bg":"transparent"}}'
# -> { "id": "a21db657-...", "status": "queued", "credits": 1 }

# 3. 轮询
curl https://api.youcut.ai/api/v1/jobs/a21db657-... \
  -H "Authorization: Bearer yk_live_..."
# -> { "status": "succeeded", "outputs": [ { "url": "https://...png" } ], "credits_charged": 1 }

切换工具只需改一个字符串。同样这三个调用可以驱动物体消除、图片放大、AI 图片生成和AI 视频生成;差别只在 params 对象,每个工具在 GET /api/v1/tools 中公布自己的参数结构。

密钥与计费

在控制台的 API Keys 中创建密钥,前缀为 yk_live_,仅在创建时显示一次。API 用量与网页端共用钱包,在流水中记为 api_usage,因此没有单独的开发者套餐、单独的账单,也没有最低消费。所有付费订阅都包含 API 访问;每月 $59 的 Business 档在 2200 积分之外额外附送月度 API 额度。

免费额度:绑卡后每月 100 次调用,足以完整搭建并测试一个集成。

我们刻意没做的事

  • 不强制 SDK。 三个 HTTP 调用不需要客户端库。我们提供 OpenAPI 和轻量的 JS、Python 辅助包,但不强迫你使用。
  • 不做纯 Webhook 设计。 轮询简单且到处都能用;对轮询浪费的长视频任务才提供 Webhook。
  • 不设需要记忆的模型价格档位。 任务响应会在执行前后告诉你消耗的积分。

可靠性

任务通过场景路由执行:每个工具与模式映射到一个主模型和有序的备选模型。当上游服务报错或超时,任务会自动降级到下一个模型,而不是把失败抛给你;若所有模型都失败则自动退还积分。你可以在任务响应的 model_key 字段看到实际服务的模型。

开始使用

注册后在控制台打开 API Keys,复制上面的 curl 即可。如果你正从 remove.bg 迁移,输入输出结构足够接近,多数集成一个下午即可改完,账单则下降一个数量级。

完整参考见 /developers。

← 全部文章

文中提到的工具