youcut.ai API
The same tools, over REST. Upload → create a job → poll. Billed from your credit wallet.
- Base URL
- https://api.youcut.ai/api/v1
- Authentication
- Send your key as a Bearer token. Keys start with yk_live_. Create and revoke keys in the dashboard.
- Rate limits
- 60 requests / minute by default. Contact us for higher limits.
Quickstart
Upload a file → Create a job → Poll until done
# 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://..." }] }Errors
All errors return { error: { code, message, details } }. 402 insufficient_credits includes required and balance.
{ "error": { "code": "insufficient_credits", "message": "Not enough credits", "details": { "required": 3, "balance": 1 } } }Webhooks
Pass a callback_url in params to receive a POST when the job finishes (Business+).
SDKs
Official JavaScript and Python SDKs are coming soon. The REST API works with any HTTP client today.
API pricing
Pay per call with credits or USD equivalents. Volume tiers available on Business and Enterprise.
| Tool | Endpoint | Price |
|---|---|---|
| Background Remover | POST /jobs { tool: "background-remover" } | $0.02 / image |
| Batch Background Remover | POST /jobs { tool: "batch-background-remover" } | $0.02 / image |
| Object Remover | POST /jobs { tool: "object-remover" } | $0.03 / image |
| People Remover | POST /jobs { tool: "people-remover" } | $0.03 / image |
| Text Remover | POST /jobs { tool: "text-remover" } | $0.03 / image |
| Watermark Remover | POST /jobs { tool: "watermark-remover" } | $0.03 / image |
| GIF Background Remover | POST /jobs { tool: "gif-background-remover" } | $0.02 / image |
| Video Background Remover | POST /jobs { tool: "video-background-remover" } | $0.02 / image |
| Image Upscaler | POST /jobs { tool: "image-upscaler" } | $0.02 / image |
| Photo Enhancer | POST /jobs { tool: "photo-enhancer" } | $0.02 / image |
| Photo Restoration | POST /jobs { tool: "photo-restoration" } | 2 credits |
| AI Image Expander | POST /jobs { tool: "image-expander" } | 2 credits |
| Passport Photo Maker | POST /jobs { tool: "passport-photo-maker" } | 2 credits |
| AI Background Generator | POST /jobs { tool: "ai-background-generator" } | 2 credits |
| AI Image Generator | POST /jobs { tool: "ai-image-generator" } | 1 credits |
| AI Photo Editor | POST /jobs { tool: "ai-photo-editor" } | 3 credits |
| AI Video Generator | POST /jobs { tool: "ai-video-generator" } | 6 credits |
| Image to Video | POST /jobs { tool: "image-to-video" } | 6 credits |
| Talking Photo | POST /jobs { tool: "talking-photo" } | 20 credits |
| AI Headshot Generator | POST /jobs { tool: "ai-headshot" } | 4 credits |
| Product Photo Generator | POST /jobs { tool: "product-photo-generator" } | 3 credits |
| AI Product Staging | POST /jobs { tool: "ai-product-staging" } | 3 credits |
| Virtual Model / Try-On | POST /jobs { tool: "virtual-model" } | 5 credits |
| AI Poster Generator | POST /jobs { tool: "ai-poster-generator" } | 3 credits |
| AI Logo Generator | POST /jobs { tool: "ai-logo-generator" } | 3 credits |
| AI Wallpaper Generator | POST /jobs { tool: "ai-wallpaper-generator" } | 1 credits |
| AI Coloring Page Generator | POST /jobs { tool: "ai-coloring-page-generator" } | 1 credits |
| AI Tattoo Generator | POST /jobs { tool: "ai-tattoo-generator" } | 2 credits |
| Cartoon Selfie | POST /jobs { tool: "cartoon-selfie" } | 2 credits |
| AI Hairstyle Changer | POST /jobs { tool: "ai-hairstyle-changer" } | 2 credits |
| Product Poster Generator | POST /jobs { tool: "product-poster-generator" } | 4 credits |
| Animate Old Photos | POST /jobs { tool: "animate-old-photo" } | 8 credits |
| Product Video Generator | POST /jobs { tool: "product-video-generator" } | 8 credits |
| Blur Background | POST /jobs { tool: "blur-background" } | 1 credits |
| Face Cutout | POST /jobs { tool: "face-cutout" } | 1 credits |
| Anime Enhancer | POST /jobs { tool: "anime-enhancer" } | $0.02 / image |
| AI Greeting Card Generator | POST /jobs { tool: "ai-greeting-card-generator" } | 3 credits |
| AI Meme Generator | POST /jobs { tool: "ai-meme-generator" } | 1 credits |
| AI Wall Art Generator | POST /jobs { tool: "ai-wall-art-generator" } | 3 credits |
| AI Embroidery Generator | POST /jobs { tool: "ai-embroidery-generator" } | 2 credits |
| AI Nail Art Generator | POST /jobs { tool: "ai-nail-art-generator" } | 2 credits |
| Sketch to Image | POST /jobs { tool: "sketch-to-image" } | 3 credits |
| POD Design Generator | POST /jobs { tool: "pod-design-generator" } | 3 credits |
| AI Portrait Art | POST /jobs { tool: "ai-portrait-art" } | 2 credits |
| Virtual Try-On | POST /jobs { tool: "virtual-try-on" } | 5 credits |
| AI Video Enhancer | POST /jobs { tool: "ai-video-enhancer" } | $0.02 / image |
| Pretty Scale | POST /jobs { tool: "pretty-scale" } | 1 credits |
| AI Fortune Teller | POST /jobs { tool: "ai-fortune-teller" } | 1 credits |
Free: 100 calls / month with a card on file. Business plans include $30 of API credit.