# Cuddler Platform API

**Canonical:** https://apis.io/apis/cuddler-ai/cuddler-ai-platform-api-api/  
**Provider:** Cuddler — https://apis.io/providers/cuddler-ai/  
**Base URL:** https://api.cuddler.ai  
**Documentation:** https://platform.cuddler.ai/docs/api-reference

Cuddler Platform API is one of 3 APIs that [Cuddler](https://apis.io/providers/cuddler-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Platform API. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

The platform-api API from Cuddler — 36 operation(s) for platform-api.

## Operations (41)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/webhook-endpoints/{id}` | Read one explicitly granted existing webhook endpoint; independent control gate… |
| PATCH | `/v1/webhook-endpoints/{id}` | Conditionally enable or disable one explicitly granted endpoint; disabling… |
| GET | `/v1/catalog` | Public retail model catalog and curated voices; no organisation or account cost… |
| GET | `/v1/models` | The video and image models, their limits, billing unit and prices, and which… |
| GET | `/v1/models/{id}` | One model: kind, durations or canvases, reference limits and per-resolution… |
| POST | `/v1/videos/estimate` | Price a video before creating it: model tokens (or seconds), USD and the… |
| POST | `/v1/videos` | Create a video job (Idempotency-Key required): holds its estimate from the… |
| GET | `/v1/videos` | This organization's videos, newest first, optionally by status; paged with… |
| GET | `/v1/videos/{id}` | One video: status, final bill, a fresh one-hour download link once it… |
| POST | `/v1/videos/{id}/cancel` | Cancel a queued video and release its hold; a video already rendering cannot be… |
| GET | `/v1/videos/{id}/download` | A succeeded video with the Cuddler.ai watermark (watermark=true): a one-hour… |
| POST | `/v1/images/estimate` | Price an image before creating it: USD per image and the balance hold; writes… |
| POST | `/v1/images` | Create an image job (Idempotency-Key required): text or reference images to one… |
| GET | `/v1/images` | This organization's images, newest first, optionally by status; paged with… |
| GET | `/v1/images/{id}` | One image: status, final bill, a fresh one-hour download link once it… |
| POST | `/v1/speech` | Generate speech with a frozen price and one provider submission… |
| GET | `/v1/speech` | This organization's speech jobs, newest first |
| POST | `/v1/music` | Generate music with a frozen price and one provider submission; Idempotency-Key… |
| GET | `/v1/music` | This organization's music jobs, newest first |
| POST | `/v1/speech/estimate` | Exact text meter, voice surcharge and price before creating speech |
| POST | `/v1/music/estimate` | Quote one music generation before creating it |
| GET | `/v1/speech/{id}` | One speech job and a fresh private download link |
| GET | `/v1/music/{id}` | One music job and a fresh private download link |
| POST | `/v1/speech/{id}/cancel` | Cancel queued speech and release its hold |
| POST | `/v1/music/{id}/cancel` | Cancel queued music and release its hold |
| GET | `/v1/voices` | Curated voices supported by the requested speech model |
| POST | `/v1/operations` | Atomically freeze an immutable operation plan for one logical slot; no… |
| GET | `/v1/operations/{id}` | Read the authenticated signed operation plan, upload finalization and known… |
| POST | `/v1/operations/{id}/execute` | Execute or recover the original operation using its signed final request and… |
| POST | `/v1/operations/{id}/uploads/{sourceId}` | Reserve or mark ready the original content-bound upload; finalize the operation… |
| POST | `/v1/uploads` | Start a reference upload (Idempotency-Key required): returns a signed PUT URL… |
| GET | `/v1/uploads/{id}` | One upload and its state: pending, ready, rejected (with the reason) or expired |
| POST | `/v1/uploads/{id}/complete` | Finish an upload after the PUT: checks, strips image metadata and moderates it… |
| POST | `/v1/portraits` | Start the official portrait authorization for an owned reference; the person… |
| GET | `/v1/portraits/{id}` | Verify portrait authorization with the official service |
| POST | `/v1/portraits/{id}/revoke` | Revoke portrait authorization and schedule removal of its remote copies |
| GET | `/v1/videos/{id}/references` | Reference preparation and authorization actions for this video |
| GET | `/v1/balance` | The prepaid USD balance: total, held for running jobs, available (the spending… |
| GET | `/v1/usage` | Spend, tokens, seconds and video counts between two UTC dates, by day, by model… |
| GET | `/v1/openapi.json` | This API as OpenAPI 3.1 |
| GET | `/v1/llms.txt` | Agent-readable index of the endpoints, models, prices and limits |

## Machine-readable artifacts (4)

- **OpenAPI** — https://artifacts.apis.io/cuddler-ai/openapi/cuddler-ai-platform-api-api-openapi.yml
- **Documentation** — https://platform.cuddler.ai/docs
- **LLMsTxt** — https://api.cuddler.ai/v1/llms.txt
- **Webhooks** — https://platform.cuddler.ai/docs/webhooks

## Other Cuddler APIs (2)

- [Cuddler MCP](https://apis.io/apis/cuddler-ai/cuddler-mcp/)
- [Cuddler Platform Ark API](https://apis.io/apis/cuddler-ai/cuddler-ai-platform-ark-api/)

## Tags

Platform API

---

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