# Suzanne API

**Canonical:** https://apis.io/apis/suzanne3d/suzanne-api/  
**Provider:** Suzanne — https://apis.io/providers/suzanne3d/  
**Base URL:** https://api.suzanne3d.com  
**Documentation:** https://console.suzanne3d.com/documentation

Suzanne API is published by [Suzanne](https://apis.io/providers/suzanne3d/) on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include 3D, Mesh Generation, Text-to-3D, Photo-to-3D, and Generative AI. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, rate-limit docs, and 6 JSON Schemas.

REST API for turning a text prompt or 1-4 photos into a textured 3D mesh. Jobs are submitted to POST /v1/generations/text-to-3d or /v1/generations/photo-to-3d against the sculptor, atelier or capture models, images are staged through presigned uploads (POST /v1/uploads), jobs are polled at GET /v1/jobs/{job_id}, can be cancelled, and finished meshes are downloaded as GLB, OBJ, STL or FBX via a 302 to a presigned URL. Bearer API keys (sznn_test_ / sznn_live_), an Idempotency-Key header on generation POSTs, and a JSON error envelope.

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/generations/text-to-3d` | Submit a text-to-3D job |
| POST | `/v1/generations/photo-to-3d` | Submit a photo-to-3D job |
| POST | `/v1/uploads` | Create a presigned upload URL |
| GET | `/v1/jobs/{job_id}` | Poll job status |
| POST | `/v1/jobs/{job_id}/cancel` | Cancel a queued or running job |
| GET | `/v1/models/{job_id}/download` | Download the mesh |

## Machine-readable artifacts (14)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/suzanne3d/refs/heads/main/openapi/_ae-authored/suzanne3d-openapi-generated.yml
- **Documentation** — https://console.suzanne3d.com/documentation
- **APIReference** — https://console.suzanne3d.com/documentation
- **GettingStarted** — https://console.suzanne3d.com/documentation/quickstart
- **Authentication** — https://console.suzanne3d.com/documentation/authentication
- **RateLimits** — https://console.suzanne3d.com/documentation/limits
- **Examples** — https://console.suzanne3d.com/documentation/recipes
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/suzanne3d/refs/heads/main/json-schema/suzanne3d-photo-to3d-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/suzanne3d/refs/heads/main/json-schema/suzanne3d-text-to3d-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/suzanne3d/refs/heads/main/json-schema/suzanne3d-job-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/suzanne3d/refs/heads/main/json-schema/suzanne3d-upload-created-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/suzanne3d/refs/heads/main/json-schema/suzanne3d-job-accepted-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/suzanne3d/refs/heads/main/json-schema/suzanne3d-cancel-result-schema.json
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/suzanne3d/refs/heads/main/apis.yml

## Tags

3D, Mesh Generation, Text-to-3D, Photo-to-3D, Generative AI, Jobs

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/suzanne3d/suzanne-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/suzanne3d/.