# Hermosso API

**Canonical:** https://apis.io/apis/hermosso-com/hermosso-com-api/  
**Provider:** Hermosso — https://apis.io/providers/hermosso-com/  
**Documentation:** https://hermosso.com/docs/api

Hermosso API is one of 2 APIs that [Hermosso](https://apis.io/providers/hermosso-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Hermosso API as documented publicly: 14 operations. Contract generated from the documentation by API Evangelist (2026-11-11); not the provider's own document.

## Operations (14)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/images/edit` | Prompt-driven edit, with references or a mask. |
| POST | `/api/v1/images/extend` | Outpaint beyond the frame. |
| POST | `/api/v1/images/generate` | POST /api/v1/images/generate |
| POST | `/api/v1/images/relight` | Relight a subject. |
| POST | `/api/v1/images/remove-background` | Cut out to a transparent PNG. |
| POST | `/api/v1/images/restore` | Repair, face-restore and colorize an old photo. |
| POST | `/api/v1/images/upscale` | Enlarge to 4K, 8K or 22K. |
| POST | `/api/v1/images/variations` | Reimagine a shot several ways. |
| GET | `/api/v1/jobs` | GET /api/v1/jobs |
| GET | `/api/v1/me` | GET /api/v1/me |
| POST | `/api/v1/videos/animate` | Photo to video. |
| POST | `/api/v1/videos/generate` | Text to video. |
| POST | `/api/v1/videos/upscale` | Upscale a clip. |
| POST | `/mcp` | MCP server (AI assistants) endpoint for streaming tool calls. |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/hermosso-com/openapi/_ae-authored/hermosso-com-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/hermosso-com/json-schema/hermosso-com-post-mcp-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/hermosso-com/json-schema/hermosso-com-post-api-v1-images-generate-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/hermosso-com/json-schema/hermosso-com-post-api-v1-videos-generate-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/hermosso-com/json-schema/hermosso-com-post-api-v1-videos-upscale-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/hermosso-com/json-schema/hermosso-com-post-api-v1-videos-animate-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/hermosso-com/json-schema/hermosso-com-post-api-v1-images-extend-request-schema.json

## Other Hermosso APIs (1)

- [Hermosso API](https://apis.io/apis/hermosso-com/hermosso-api/)

---

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