# SorryAssets

SorryAssets is a local-first AIGC and digital-asset platform for desktop creators, apps, and agents. It exposes a self-owned multi-provider generation engine through the desktop app, HTTP API, MCP, and structured Skills templates.

## Public docs

- Home: https://sorryassets.com/
- Docs index: https://sorryassets.com/docs
- Legacy API Markdown: https://sorryassets.com/docs/api.md
- Pricing: https://sorryassets.com/pricing
- Downloads: https://sorryassets.com/downloads
- Account API keys: https://sorryassets.com/account/keys

## Machine-readable contracts

- LLM index: https://sorryassets.com/llms.txt
- OpenAPI preview contract: https://sorryassets.com/openapi.yaml
- MCP tools schema: https://sorryassets.com/mcp-tools.json
- Skills catalog JSON: https://sorryassets.com/skills/catalog.json
- Runtime catalog: https://sorryassets.com/v1/catalog
- Retail pricing: https://sorryassets.com/v1/pricing

## Indexed docs

- Start with SorryAssets: https://sorryassets.com/docs/start/overview (/docs/start/overview.md)
- Direct HTTP API: https://sorryassets.com/docs/api/direct-http (/docs/api/direct-http.md)
- MCP for agents: https://sorryassets.com/docs/api/mcp (/docs/api/mcp.md)
- Skills as AIGC workflows: https://sorryassets.com/docs/skills/workflows (/docs/skills/workflows.md)

Markdown routes include English and Chinese in the same file.

## Direct API

- Recommended base URL: https://sorryassets.com
- Compatibility API host: https://api.sorryassets.com
- Auth header: Authorization: Bearer sa_...
- Live capabilities today: image.generate, video.generate
- Current Developer Preview endpoints:
  - GET /v1/catalog
  - GET /v1/pricing
  - POST /v1/estimate
  - POST /v1/generate
  - GET /v1/task/:taskRef
  - GET /v1/asset/:taskRef

## Skills

- Skills catalog: https://sorryassets.com/skills
- Machine-readable catalog: https://sorryassets.com/skills/catalog.json
- Source repository: https://github.com/leozejia/sorryassets-skills
- Install all Skills: npx skills add leozejia/sorryassets-skills --skill '*' -a codex -a claude-code -g -y
- Install one Skill: npx skills add leozejia/sorryassets-skills --skill {skill} -a codex -a claude-code -g -y
- Character Creation: https://sorryassets.com/skills/character-creation (/skills/character-creation.md)
- AI Short Drama: https://sorryassets.com/skills/short-drama (/skills/short-drama.md)

## Invariants

- Agents hold account-scoped SorryAssets API keys only, never provider secrets.
- Public pages do not expose upstream channels, credentials, or wholesale costs.
- Assets are delivered, not hosted. Download successful task output promptly.
- Skills are standard Agent Skills packages installed into the caller's agent; optional SorryAssets workflow attachments only scaffold the local canvas.
- OpenAI-compatible images/videos endpoints are the GA target, not the current Developer Preview contract.