Limits
What the API enforces, read from the running code each time this page loads.
Rate limits
Counted over a sliding window of 60 seconds, per API key (per account for a signed-in browser).
| Limit | Counted per | Applies to |
|---|---|---|
| 30 a minute | API key | Calls that create or upload:POST /api/v1/characters POST /api/v1/characters/ready DELETE /api/v1/characters/{character_id} PATCH /api/v1/characters/{character_id} POST /api/v1/characters/{character_id}/sheet POST /api/v1/formats/{format_id}/series DELETE /api/v1/formats/{format_id}/series/{series_id} PATCH /api/v1/formats/{format_id}/series/{series_id} POST /api/v1/formats/{format_id}/series/{series_id}/comments POST /api/v1/generate/image POST /api/v1/generate/video POST /api/v1/jobs POST /api/v1/media/{media_id}/touchup POST /api/v1/products POST /api/v1/runs POST /api/v1/runs/from-analysis POST /api/v1/runs/propose POST /api/v1/runs/{run_id}/approve POST /api/v1/runs/{run_id}/redo POST /api/v1/runs/{run_id}/scenes POST /api/v1/runs/{run_id}/scenes/quote POST /api/v1/scripts POST /api/v1/scripts/{job_id}/make POST /api/v1/studio/glowup/captions PUT /api/v1/studio/library POST /api/v1/studio/pack/runs POST /api/v1/studio/{studio_id}/helpers/{name} POST /api/v1/studio/{studio_id}/helpers/{name}/cancel POST /api/v1/studio/{studio_id}/runs POST /api/v1/studio/{studio_id}/series DELETE /api/v1/studio/{studio_id}/series/{series_id} PATCH /api/v1/studio/{studio_id}/series/{series_id} POST /api/v1/studio/{studio_id}/series/{series_id}/comments DELETE /api/v1/studio/{studio_id}/user-cards/{card_id} POST /api/v1/uploads POST /api/v1/uploads/from-library POST /api/v1/uploads/from-url |
| 120 a minute | API key | Every other call with a key (58 endpoints) |
| 60 a minute | IP address | Calls without a valid key |
| 30 a minute | API key | MCP tools that spend credits |
| 120 a minute | API key | Free MCP tools |
| 30 a minute | Account | Runs from a model page's playground |
The REST API and the MCP server share one count per key: a key's MCP calls and REST calls add up.
What a 429 looks like
Over a limit you get this answer. Wait the seconds in Retry-After (also retry_after in the body), then try again.
Retry-After: 12
Content-Type: application/json {
"error": {
"code": "rate_limited",
"message": "Too many requests. Try again in 12 s.",
"retry_after": 12
}
} - Nothing is charged by a refused call.
- More than 2 uploads from a link at once from one account, or more than 8 across the whole server: the same 429, with 10 seconds to wait.
Daily credit caps per key
- Optional, set per key when you make it. It counts credits charged minus credits that came back with that key over the last 24 hours, not a calendar day.
- Any whole number from 1 up to 10,000,000 cr. No cap: the balance is the only limit.
- A job, run or studio click that would go over is refused with 402 daily_limit_reached, and nothing is charged.
- Chat apps connected through sign-in have no daily cap unless you set one in Settings > Connections.
- Up to 50 active keys per account, by plan.
Uploads and files
| Applies to | Limit |
|---|---|
| One image (JPG, PNG, WEBP, GIF, AVIF, HEIC) | 20 MB |
| One video or audio file | 1024 MB |
| Download time for an upload from a link | 120 s |
| Uploads from a link at once, per account | 2 |
| Uploads from a link at once, whole server | 8 |
| Files are kept (longer on Starter and up) | 30 days |
Waiting and repeats
- A long poll (wait on GET) holds the request up to 50 seconds; MCP tools wait up to 45 seconds.
- Up to 8 long polls at once per account, and 40 across the whole server. One more answers after a pause of up to 2 seconds with the current state, without waiting for the end.
- The API sets no per-account limit on how many jobs run at once: your balance and a key's daily cap decide what starts.
- Idempotency-Key: a repeat with the same key and body within 24 hours returns the first answer and is not charged again.
Job lengths and time limits
Your plan runs a set number of takes at once; more wait their turn and start by themselves. A job that has not started 30 minutes after its turn comes fails and its credits come back automatically. Once started, each model has a time limit below: past it, the job fails and its credits come back automatically.
| Model | Model id | Longest clip | Time limit |
|---|---|---|---|
| Ad analyzer | analysis.ad | Not set | 20 min |
| Add a voice | audio.song-vocals | Not set | 15 min |
| Change the singer | audio.song-voice | Not set | 15 min |
| Dialogue | audio.dialogue | Not set | 10 min |
| Make it longer | audio.song-extend | Not set | 15 min |
| Music | audio.music | 360 s | 15 min |
| New backing music | audio.song-backing | Not set | 15 min |
| Replace a part | audio.song-replace | Not set | 15 min |
| Sound effects | audio.sfx | Not set | 10 min |
| Voice and music apart | audio.song-split | Not set | 15 min |
| Voiceover | audio.tts | Not set | 10 min |
| Captions | edit.captions | Not set | 200 min |
| Merge clips | edit.merge | Not set | 20 min |
| Metadata Remover | edit.clean | Not set | 10 min |
| Resize | edit.resize | Not set | 15 min |
| Flux 2 Pro | image.flux-2-pro | Not set | 15 min |
| GPT Image 2 | image.gpt-image-2 | Not set | 20 min |
| GPT Image 2.5 | image.gpt-image-2-5 | Not set | 20 min |
| Image upscale | image.upscale | Not set | 10 min |
| Nano Banana 2 | image.nano-banana-2 | Not set | 20 min |
| Nano Banana Pro | image.nano-banana-pro | Not set | 20 min |
| Remove background | image.remove-bg | Not set | 10 min |
| Seedream 5 Flash | image.seedream-5-flash | Not set | 15 min |
| AI video edit | video.video-edit | Not set | 45 min |
| Hailuo 2.3 | video.hailuo-2-3 | 10 s | 30 min |
| InfiniTalk | video.infinitalk | Not set | 40 min |
| Kling 3.0 | video.kling-3 | 15 s | 40 min |
| Kling 3.0 Motion Control | video.kling-3-motion | Not set | 40 min |
| Kling 4.0 | video.kling-4 | 30 s | 40 min |
| Kling Avatar | video.kling-avatar | Not set | 60 min |
| Lip sync re-dub | video.lipsync | Not set | 40 min |
| Seedance 2.0 | video.seedance-2 | 15 s | 45 min |
| Seedance 2.0 Mini | video.seedance-2-mini | 15 s | 30 min |
| Seedance 2.5 | video.seedance-2-5 | 30 s | 45 min |
| Seedance 2.5 final in 1080p | video.seedance-2-5-final | Not set | 45 min |
| Veo 3.1 | video.veo-3-1 | 8 s | 45 min |
| Video upscale | video.upscale | Not set | 60 min |
| Wan 2.2 Animate | video.wan-animate | Not set | 45 min |
| Wan 3.0 | video.wan-3 | 30 s | 40 min |
| Wan 3.0 Prime | video.wan-3-prime | 30 s | 40 min |
Longest clip is the largest duration the model's fields accept, where it has one.
Webhooks
- Each try has 10 seconds, the name lookup included, to get an answer from your endpoint.
- 6 tries in all. After a failed try we wait 1 min, 5 min, 30 min, 2 h, 6 h before the next one.
- Any 2xx answer counts as delivered. Redirects are not followed. Only https links to public addresses, on port 443 / 8443.
- At most 1 try in flight at a time per account and 1 per receiving host. A try ends after 10 seconds, the name lookup included, so a slow endpoint holds one of the 4 senders that every customer shares for at most that long per try.
- Up to 100 webhooks waiting per account (not finished yet, or between tries). Past that, a call with callback_url is refused with 429 webhook_queue_full before anything is charged.
- A job, run or studio click that is still not finished 14 days after you sent callback_url is given up: the delivery shows failed (not_finished).
- Bodies over 256 KB are sent with object set to null; GET the url in the body for the whole object.
- Your last 50 deliveries are listed in the workspace; finished ones are kept 30 days.
- After a roll, each old secret also signs for 24 hours from its own roll, up to 5 old secrets at once.