# 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, redqw21-unlocked / qwenimage2.1 (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
- redqw21-unlocked — async Qwen Image 2.1 · 1.5MP / 4MP / 8MP · aliases qwenimage2.1, qwen-image-2.1, qw21, redqw21 · pack required · imageGenMode txt2img|edit|ref
- heishou-h3 — reference-to-video · h3Mode hd|fast|raw|series
- hongchao-h3 — reference-to-video · 5–15s · 480P–4K · stricter policy