Render API
Base URL: https://api.dajiaoai.com
The API accepts a project payload conforming to the Dino-GSP project file protocol, renders a specified slide, and returns the exported file URL and metadata.
Size units
viewBound uses logical canvas coordinates, scale is the number of pixels per logical unit, and the returned width and height are image pixel dimensions. Visual dimensions such as font sizes and line widths in project content use px. If your source specification uses pt, see Size Units and Conversion.
Overview
| Description | Path | Method | Supports |
|---|---|---|---|
| Export PNG | /api/render/v2 | POST | 2D, 3D |
| Export SVG | /api/render-svg | POST | 2D |
| Export TikZ/TeX | /api/render-tikz | POST | 2D |
Use the new PNG endpoint
Use POST /api/render/v2 for PNG exports. Existing integrations using /api/render can refer to the legacy endpoint and migration guide.
See Authentication for authentication details.
PNG endpoint
See Export PNG for POST /api/render/v2 parameters and examples.
Error responses
| Status | Cause |
|---|---|
400 | Invalid parameters or content does not conform to the Dino-GSP project file protocol |
401 | Invalid API key |
422 | Legacy endpoints reject projects containing 3D geometry (UNSUPPORTED_3D_GEOMETRY); v2 errors are listed below |
| Error code | HTTP status | Retryable | Description |
|---|---|---|---|
RENDER_QUEUE_FULL | 503 | Yes | Render queue is full; response includes Retry-After: 1. |
RENDER_TIMEOUT | 504 | Yes | Total queue and execution time exceeded the limit. |
RENDER_CANCELLED | 499 | Yes | Client cancelled the request or the service shut down while the task was queued. |
RENDER_INVALID_REQUEST | 422 | No | Invalid target slide, non-3D target, or output dimensions exceed the limit. |
RENDER_WORKER_FAILED | 500 | Yes | Render worker exited unexpectedly or the task failed. |
UNSUPPORTED_3D_PRIMITIVE | 422 | No | Target slide contains 3D primitives not yet implemented by the native backend. |