Quickstart: REST

export ASKEDITOR_API_KEY="ake_live_…"

curl https://api.askeditor.com/v1/me \
  -H "Authorization: Bearer $ASKEDITOR_API_KEY"
# → data: { projectName, plan, creditsRemaining, scopes }

curl -X POST https://api.askeditor.com/v1/uploads \
  -H "Authorization: Bearer $ASKEDITOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "purpose": "clip for background removal" }'
# → data: { ticket: "upl_…", uploadUrl: "…" }
# uploadUrl is the BROWSER path for humans (open it, drop the file).
# From a shell, ignore it and post the file directly, as below.

curl -X POST https://api.askeditor.com/v1/uploads/upl_…/file \
  -F "file=@clip.mp4"
# → data: { material: "mat…", status: "uploaded" }

curl "https://api.askeditor.com/v1/estimate?recipeId=remove-background" \
  -H "Authorization: Bearer $ASKEDITOR_API_KEY"
# → data: { credits: 25, etaSeconds: 90, blockers: [] }

curl -X POST https://api.askeditor.com/v1/run/remove-background \
  -H "Authorization: Bearer $ASKEDITOR_API_KEY" \
  -H "Content-Type: application/json" \
  --max-time 600 \
  -d '{ "material": "mat…" }'

{
  "success": true,
  "data": {
    "status": "completed",
    "processedVideoUrl": "https://…/processed.webm",
    "canvasId": "66f…",
    "editorPath": "/workspace/canvas/editor/66f…",
    "credits": 25,
    "creditsCharged": true,
    "cached": false
  }
}