youcut.ai API
同样的工具,通过 REST 调用。上传 → 创建任务 → 轮询,从积分钱包计费。
- 基础地址
- https://api.youcut.ai/api/v1
- 身份认证
- 以 Bearer Token 形式发送密钥,密钥以 yk_live_ 开头。可在控制台创建与撤销。
- 速率限制
- 默认每分钟 60 次请求,如需更高限额请联系我们。
快速开始
上传文件 → 创建任务 → 轮询直到完成
# 1. Upload
curl -X POST https://api.youcut.ai/api/v1/uploads \
-H "Authorization: Bearer yk_live_..." \
-F "file=@photo.jpg"
# → { "id": "asset_uuid", "url": "...", "mime": "image/jpeg", ... }
# 2. Create a job
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":["asset_uuid"],"params":{"bg":"transparent"}}'
# → { "id": "job_uuid", "status": "queued", "credits": 1, ... }
# 3. Poll
curl https://api.youcut.ai/api/v1/jobs/job_uuid -H "Authorization: Bearer yk_live_..."
# → { "status": "succeeded", "outputs": [{ "asset_id": "...", "url": "https://..." }] }错误
所有错误返回 { error: { code, message, details } }。402 insufficient_credits 包含 required 与 balance。
{ "error": { "code": "insufficient_credits", "message": "Not enough credits", "details": { "required": 3, "balance": 1 } } }Webhook
在 params 中传入 callback_url,任务完成后会收到 POST 通知(Business 及以上)。
SDK
官方 JavaScript 与 Python SDK 即将发布。REST API 现在即可用任何 HTTP 客户端调用。
API 定价
按调用以积分或等值美元计费。Business 与企业版提供阶梯价格。
| 工具 | 接口 | 价格 |
|---|---|---|
| AI 抠图 | POST /jobs { tool: "background-remover" } | $0.02 / image |
| 批量抠图 | POST /jobs { tool: "batch-background-remover" } | $0.02 / image |
| AI 物体擦除 | POST /jobs { tool: "object-remover" } | $0.03 / image |
| AI 去路人 | POST /jobs { tool: "people-remover" } | $0.03 / image |
| AI 去文字 | POST /jobs { tool: "text-remover" } | $0.03 / image |
| AI 去水印 | POST /jobs { tool: "watermark-remover" } | $0.03 / image |
| GIF 抠图 | POST /jobs { tool: "gif-background-remover" } | $0.02 / image |
| 视频抠图 | POST /jobs { tool: "video-background-remover" } | $0.02 / image |
| AI 图片放大 | POST /jobs { tool: "image-upscaler" } | $0.02 / image |
| AI 照片增强 | POST /jobs { tool: "photo-enhancer" } | $0.02 / image |
| 老照片修复 | POST /jobs { tool: "photo-restoration" } | 2 credits |
| AI 扩图 | POST /jobs { tool: "image-expander" } | 2 credits |
| AI 证件照 | POST /jobs { tool: "passport-photo-maker" } | 2 credits |
| AI 背景生成 | POST /jobs { tool: "ai-background-generator" } | 2 credits |
| AI 图片生成 | POST /jobs { tool: "ai-image-generator" } | 1 credits |
| AI 修图 | POST /jobs { tool: "ai-photo-editor" } | 3 credits |
| AI 视频生成 | POST /jobs { tool: "ai-video-generator" } | 6 credits |
| 图生视频 | POST /jobs { tool: "image-to-video" } | 6 credits |
| AI 说话照片 | POST /jobs { tool: "talking-photo" } | 20 credits |
| AI 职业头像 | POST /jobs { tool: "ai-headshot" } | 4 credits |
| AI 商品图生成 | POST /jobs { tool: "product-photo-generator" } | 3 credits |
| AI 商品场景化 | POST /jobs { tool: "ai-product-staging" } | 3 credits |
| AI 虚拟模特 | POST /jobs { tool: "virtual-model" } | 5 credits |
| AI 海报生成器 | POST /jobs { tool: "ai-poster-generator" } | 3 credits |
| AI Logo 生成器 | POST /jobs { tool: "ai-logo-generator" } | 3 credits |
| AI 壁纸生成器 | POST /jobs { tool: "ai-wallpaper-generator" } | 1 credits |
| AI 着色页生成器 | POST /jobs { tool: "ai-coloring-page-generator" } | 1 credits |
| AI 纹身生成器 | POST /jobs { tool: "ai-tattoo-generator" } | 2 credits |
| 卡通头像 | POST /jobs { tool: "cartoon-selfie" } | 2 credits |
| AI 换发型 | POST /jobs { tool: "ai-hairstyle-changer" } | 2 credits |
| 电商产品海报 | POST /jobs { tool: "product-poster-generator" } | 4 credits |
| 老照片动起来 | POST /jobs { tool: "animate-old-photo" } | 8 credits |
| 产品视频生成器 | POST /jobs { tool: "product-video-generator" } | 8 credits |
| 背景虚化 | POST /jobs { tool: "blur-background" } | 1 credits |
| 头像抠图 | POST /jobs { tool: "face-cutout" } | 1 credits |
| 动漫图片增强 | POST /jobs { tool: "anime-enhancer" } | $0.02 / image |
| AI 贺卡生成器 | POST /jobs { tool: "ai-greeting-card-generator" } | 3 credits |
| AI 表情包生成器 | POST /jobs { tool: "ai-meme-generator" } | 1 credits |
| AI 墙面装饰画生成器 | POST /jobs { tool: "ai-wall-art-generator" } | 3 credits |
| AI 刺绣生成器 | POST /jobs { tool: "ai-embroidery-generator" } | 2 credits |
| AI 美甲生成器 | POST /jobs { tool: "ai-nail-art-generator" } | 2 credits |
| 草图渲染 | POST /jobs { tool: "sketch-to-image" } | 3 credits |
| AI POD 图案生成 | POST /jobs { tool: "pod-design-generator" } | 3 credits |
| AI 肖像艺术 | POST /jobs { tool: "ai-portrait-art" } | 2 credits |
| 虚拟试衣 | POST /jobs { tool: "virtual-try-on" } | 5 credits |
| 视频变清晰 | POST /jobs { tool: "ai-video-enhancer" } | $0.02 / image |
| 颜值诊断 | POST /jobs { tool: "pretty-scale" } | 1 credits |
| AI 占卜师 | POST /jobs { tool: "ai-fortune-teller" } | 1 credits |
免费:绑卡后每月 100 次。Business 方案包含 $30 API 额度。