youcut API 正式发布
发布于 2026年9月1日 · 1 分钟阅读
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。