Create an API key.
API access is included with every account. Create a key and start making requests.
Developer API
Build with the ASCII asset API.
Programmatic access to the same engine behind the web app: upload JPEG, PNG, WebP, GIF, MP4, MOV, WebM, GLB, and OBJ files; generate still image, animation, and 3D jobs from prompts; update saved render settings; publish or unpublish Community assets; inspect billing; and download saved assets as HTML or GIF.
Get started
API keys
Plan Limits
Quick start
Free
Starter access intended for personal scripts and prototypes.
- 15 requests per minute
- 5 request burst allowance
- 5 active API keys max
API access requires a signed-in account. Free and Creator plans can both create API keys.
Creator
Higher throughput for production automations and integrations.
- 120 requests per minute
- 30 request burst allowance
- 20 active API keys max
Creator includes higher API throughput while keeping the same signed-in key workflow.
Upload → Poll → Download
Every request needs your API key as a bearer token. Upload a file, poll the job until it completes, then use the returned asset ID or URLs.
1
Upload a file - returns a
job_id
curl -X POST "https://asciithis.com/api/uploads" \ -H "Authorization: Bearer <YOUR_API_KEY>" \ -F "[email protected]" # → { "job_id": "abc123" }
2
Poll until
status is "complete"
curl "https://asciithis.com/api/jobs/abc123?asset_view=manifest" \
-H "Authorization: Bearer <YOUR_API_KEY>"
# → { "status": "complete", "asset_id": "xyz789", "asset": { ... } }
3
Download HTML or GIF
curl -L "https://asciithis.com/api/my-assets/xyz789/download.html" \ -H "Authorization: Bearer <YOUR_API_KEY>" \ -o ascii-export.html curl -L "https://asciithis.com/api/my-assets/xyz789/download.gif" \ -H "Authorization: Bearer <YOUR_API_KEY>" \ -o ascii-export.gif
Endpoint reference
Common responses
Errors
API requests return JSON error bodies. The exact `detail` value depends on the failed endpoint.