# EzUGC Developer Portal

Mint an EzUGC API key from a paid account, then generate UGC videos and image ads from curl, the CLI, or an MCP client.

## Paid access

API keys are issued only from the EzUGC dashboard, and only for accounts on Startup, Growth, or Pro with an active paid subscription (from $99/month). There is no trial key, guest key, or anonymous generation route.
Every call to /api/public re-checks that the account is still paid. If you cancel or the subscription lapses, leftover keys start returning HTTP 402 PUBLIC_API_SUBSCRIPTION_REQUIRED. MCP tool calls use the same key and the same check.

- Create a key: https://app.ezugc.ai/dashboard/apps/mcp
- Pricing: https://www.ezugc.ai/pricing

## Quickstart

1. Subscribe to Startup, Growth, or Pro.
2. Open the dashboard and create an `ezk_live_` key.
3. Confirm the key with `GET /api/public/me`.
4. Generate from the documented endpoints or from the MCP server.

```bash
curl -sS https://api.ezugc.ai/api/public/me \
  -H "Authorization: Bearer ezk_live_YOUR_KEY"
```

`GET /openapi.json` is public so agents can read the contract. It does not generate anything. `GET /api/public/me` still requires a paid key.

## Resources

- HTML docs: https://www.ezugc.ai/docs
- Auth walkthrough: https://www.ezugc.ai/docs/auth
- OpenAPI spec: https://api.ezugc.ai/openapi.json
- MCP server: https://www.ezugc.ai/mcp
- Markdown twin: https://www.ezugc.ai/developers.md