04 / API · KEYSProgrammatic access
Keys, scopes, and usage.
Mint scoped tokens for production workloads, CI pipelines, or partner integrations. Rotate at will — old keys remain valid for 12 hours after rotation.
Live keys
3
4 total
Calls · 30d
212,846
Across all keys
Error rate
0.21%
p99 well under target
Quota
1M / mo
Studio plan
AKeys
| Label | Token | Scopes | Calls · 30d | Last used | Status | |
|---|---|---|---|---|---|---|
Production · web production · created — · by Amélie Roux | kdg_live_8a32_••••••••••••••• | posters:writeposters:read+1 | 184,232 | — | live | |
Mobile app · iOS production · created — · by Tomás Aguirre | kdg_live_2f01_••••••••••••••• | posters:writeposters:read | 27,410 | — | live | |
Sandbox · CI test · created — · by Tomás Aguirre | kdg_test_d44b_••••••••••••••• | posters:writethemes:read | 1,204 | — | live | |
Legacy WordPress production · created — · by Hana Park | kdg_live_91aa_••••••••••••••• | posters:read | 0 | — | revoked |
BQuickstart
POST /v1/posters
curl -X POST https://api.kodograph.studio/v1/posters \
-H "Authorization: Bearer kdg_live_8a32_••••••••••••" \
-H "Content-Type: application/json" \
-d '{
"city": "Paris",
"country": "France",
"theme": "noir",
"distance": 2200,
"width": 24,
"height": 36,
"format": "png",
"dpi": 300
}'Rate limits
1 200 requests / minute
Burst 60 RPS, sustained 20 RPS.
Render queue
Median 5.4 s · p95 12.1 s
Webhook callback when ready.
Output
PNG · PDF · SVG
CDN-backed, 30-day retention.
CWebhooks
Endpoint
Receive POST callbacks when a render completes or fails.
https://kodograph.studio/api/webhooks/incoming