Skip to content
GigAI Tools

Developer API / docs

Rate limits and quotas

One free plan, real numbers. Rate limiting answers 429 with headers that say exactly when to come back.

The free plan

  • 1,000 tool tasks a month. Imports and exports are free of quota.
  • 60 requests a minute per key.
  • 5 jobs running at the same time.
  • Files up to 100 MB through import/url, tighter for some tools (the catalog says which). Inline import/base64 uploads carry up to 24 MB - use import/url for anything larger.
  • 10 webhook endpoints.
  • Result retention up to 24 hours per job.

Sandbox keys (gk_test_) never consume the monthly quota, with files capped at 10 MB and retention at 15 minutes. Usage shows in the dashboard. The quota resets on the first of each month.

Reading the headers

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 12
X-RateLimit-Reset: 1788542891
Retry-After: 4

Over the limit, the answer is 429 with code rate_limited. Sleep for Retry-After seconds and try again. Over the monthly quota, the answer is 429 with code quota_exceeded and retrying does not help until the month rolls over.

Being a good citizen

Use GET /v1/jobs/{id}/wait instead of polling GET /v1/jobs/{id} in a tight loop - one wait call holds for up to 55 seconds and returns the moment the job settles. Use Idempotency-Key on retries so a network blip never runs a job twice. The SDKs do both by default.

Was this page helpful?