# ASOP API

OpenAI-compatible relay for asop.uk. Tokens look like asop- + 32 hex chars.
Base URL: https://asop.uk/api/v1
Auth: Authorization: Bearer asop-...
Create tokens: https://asop.uk/api
Credits are shared with the Create page. Failed generations are refunded.

GET /models is the source of truth for currently listed Create-page IDs.

## Pages

- [Quick Start](https://asop.uk/docs/getting-started/quick-start)
- [Quick Start (Markdown)](https://asop.uk/docs/getting-started/quick-start.md)
- [API Reference](https://asop.uk/docs/api-reference)
- [API Reference (Markdown)](https://asop.uk/docs/api-reference.md)

## Endpoints

- GET /models — listed models (kind, output_type, endpoints, sync, require_pack, aliases)
- POST /chat/completions — model: prompt-assist (stream supported)
- POST /images/generations — heishou-krea2 (async job)
- POST /files — upload reference image/video/audio, returns file_id
- POST /jobs — async image or video job
- POST /videos/generations — reference-to-video job
- GET /jobs/:id — poll queued|processing|completed|failed
- GET /jobs/:id/content — 1-hour signed URL
- GET /api/asop/docs/quotes — live credit estimates (login required, same as Create)

## Models (typical live set)

- prompt-assist — chat / reverse-prompt
- heishou-krea2 — async text-to-image · 2K / 6MP / 12MP · krea2Mode story|live|cute
- heishou-h3 — reference-to-video · h3Mode raw|hd|fast|series · default 9:16 · 5s · Raw 768P
- hongchao-h3 — reference-to-video · 5–15s · 480P–4K · stricter policy