youcutai

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.

ToolEndpointPrice
Background RemoverPOST /jobs { tool: "background-remover" }$0.02 / image
Batch Background RemoverPOST /jobs { tool: "batch-background-remover" }$0.02 / image
Object RemoverPOST /jobs { tool: "object-remover" }$0.03 / image
People RemoverPOST /jobs { tool: "people-remover" }$0.03 / image
Text RemoverPOST /jobs { tool: "text-remover" }$0.03 / image
Watermark RemoverPOST /jobs { tool: "watermark-remover" }$0.03 / image
GIF Background RemoverPOST /jobs { tool: "gif-background-remover" }$0.02 / image
Video Background RemoverPOST /jobs { tool: "video-background-remover" }$0.02 / image
Image UpscalerPOST /jobs { tool: "image-upscaler" }$0.02 / image
Photo EnhancerPOST /jobs { tool: "photo-enhancer" }$0.02 / image
Photo RestorationPOST /jobs { tool: "photo-restoration" }2 credits
AI Image ExpanderPOST /jobs { tool: "image-expander" }2 credits
Passport Photo MakerPOST /jobs { tool: "passport-photo-maker" }2 credits
AI Background GeneratorPOST /jobs { tool: "ai-background-generator" }2 credits
AI Image GeneratorPOST /jobs { tool: "ai-image-generator" }1 credits
AI Photo EditorPOST /jobs { tool: "ai-photo-editor" }3 credits
AI Video GeneratorPOST /jobs { tool: "ai-video-generator" }6 credits
Image to VideoPOST /jobs { tool: "image-to-video" }6 credits
Talking PhotoPOST /jobs { tool: "talking-photo" }20 credits
AI Headshot GeneratorPOST /jobs { tool: "ai-headshot" }4 credits
Product Photo GeneratorPOST /jobs { tool: "product-photo-generator" }3 credits
AI Product StagingPOST /jobs { tool: "ai-product-staging" }3 credits
Virtual Model / Try-OnPOST /jobs { tool: "virtual-model" }5 credits
AI Poster GeneratorPOST /jobs { tool: "ai-poster-generator" }3 credits
AI Logo GeneratorPOST /jobs { tool: "ai-logo-generator" }3 credits
AI Wallpaper GeneratorPOST /jobs { tool: "ai-wallpaper-generator" }1 credits
AI Coloring Page GeneratorPOST /jobs { tool: "ai-coloring-page-generator" }1 credits
AI Tattoo GeneratorPOST /jobs { tool: "ai-tattoo-generator" }2 credits
Cartoon SelfiePOST /jobs { tool: "cartoon-selfie" }2 credits
AI Hairstyle ChangerPOST /jobs { tool: "ai-hairstyle-changer" }2 credits
Product Poster GeneratorPOST /jobs { tool: "product-poster-generator" }4 credits
Animate Old PhotosPOST /jobs { tool: "animate-old-photo" }8 credits
Product Video GeneratorPOST /jobs { tool: "product-video-generator" }8 credits
Blur BackgroundPOST /jobs { tool: "blur-background" }1 credits
Face CutoutPOST /jobs { tool: "face-cutout" }1 credits
Anime EnhancerPOST /jobs { tool: "anime-enhancer" }$0.02 / image
AI Greeting Card GeneratorPOST /jobs { tool: "ai-greeting-card-generator" }3 credits
AI Meme GeneratorPOST /jobs { tool: "ai-meme-generator" }1 credits
AI Wall Art GeneratorPOST /jobs { tool: "ai-wall-art-generator" }3 credits
AI Embroidery GeneratorPOST /jobs { tool: "ai-embroidery-generator" }2 credits
AI Nail Art GeneratorPOST /jobs { tool: "ai-nail-art-generator" }2 credits
Sketch to ImagePOST /jobs { tool: "sketch-to-image" }3 credits
POD Design GeneratorPOST /jobs { tool: "pod-design-generator" }3 credits
AI Portrait ArtPOST /jobs { tool: "ai-portrait-art" }2 credits
Virtual Try-OnPOST /jobs { tool: "virtual-try-on" }5 credits
AI Video EnhancerPOST /jobs { tool: "ai-video-enhancer" }$0.02 / image
Pretty ScalePOST /jobs { tool: "pretty-scale" }1 credits
AI Fortune TellerPOST /jobs { tool: "ai-fortune-teller" }1 credits

Free: 100 calls / month with a card on file. Business plans include $30 of API credit.