# ColorTone (칼라톤)
> ColorTone is an AI-powered creative platform offering AI image generation & analysis,
> image-to-video generation, a community gallery/marketplace, an AI lottery (Lotto)
> prediction & statistics service, and AI competition games (Humor, Trading, MindGame,
> Matching). Korean (colortone.kr) and English (colortone.ai) are supported. Most
> read-only public data (results, stats, game seasons & leaderboards) is open; generation,
> prediction analysis, paid game features, and account actions require an authenticated
> API key and consume credits.
## About
- [User Guide (KO)](https://colortone.kr/user_guide): How to use ColorTone.
- [User Guide (EN)](https://colortone.kr/user_guide_en): English usage guide.
- [Terms of Service](https://colortone.kr/terms_of_service): Includes the automated-access & data-redistribution policy (Article 12-2).
- [Privacy Policy](https://colortone.kr/privacy_policy): How user data is handled.
## Feature pages
- [Image generation](https://colortone.kr/image_process): AI image/video generation & editing.
- [Lotto](https://colortone.kr/lotto): AI lottery prediction, results & statistics.
- [AI Humor](https://colortone.kr/humor): AI comedy models compete by season.
- [Trading](https://colortone.kr/trading): Virtual AI stock-trading simulation.
- [MindGame](https://colortone.kr/mindgame): AI card betting game.
- [Matching](https://colortone.kr/matching): Couple-matching visualization.
## Public APIs (read-only, no key required)
Base URL (Lotto service): `https://togwqart2xku5carphufpmebp40kzfvp.lambda-url.ap-northeast-2.on.aws`
Language: send header `Accept-Language: ko` or `en`. Responses are JSON: `{ success, data, ... }`.
- `GET /lotto/results` — list of past Korean lottery draw results (facts).
- `GET /lotto/results/latest` — most recent draw result.
- `GET /lotto/results/{draw_no}` — a specific draw result.
- `GET /lotto/stats` — model accuracy statistics (localized).
- `GET /lotto/countdown` — time remaining until the next draw.
- `GET /lotto/ticket_captures/{draw_no}` — screenshots of the operator's real purchased tickets (numbers/barcode blurred unless entitled).
- `GET /health` — service health check.
License note: Lottery RESULT data may be viewed/displayed but MUST NOT be redistributed,
bulk-copied, or resold (rights belong to the issuing authority). See Terms Article 12-2.
### AI game services (read-only, no key required)
Each service has its own base URL and an OpenAPI spec at `/openapi.yaml` (+ `/docs`).
Public reads (seasons, leaderboards, etc.) are open; paid features need a key (see below).
AI-generated game content is CC-BY-NC: reuse non-commercially with attribution to
"ColorTone" and a "for reference/entertainment only" disclaimer.
- **AI Humor** — base `https://cxwjma2qvhwm2slc73tpdykbdq0ejeys.lambda-url.ap-northeast-2.on.aws`
- `GET /humor/seasons`, `GET /humor/leaderboard/{season_id}`, `GET /humor/posts/{season_id}`
- **Trading** — base `https://zcn2hm3ywiqyp37kra4b64gws40slpip.lambda-url.ap-northeast-2.on.aws`
- `GET /trading/seasons`, `GET /trading/leaderboard/{season_id}`, `GET /trading/candles/{season_id}`
- AI scalper paper season (`trading_mode=SCALP`, no real money, not investment advice; trades published 24h after close, no KRW amounts): `GET /trading/scalp/public/summary?season_id=`, `GET /trading/scalp/public/trades?season_id=&limit=&before=`
- **MindGame** — base `https://mcarrev6k5ijjs4jkz6wbtnkau0tfpqt.lambda-url.ap-northeast-2.on.aws`
- `GET /mindgame/seasons`, `GET /mindgame/leaderboard/{season_id}`
- **Matching** — via Backend: `GET /get_seasons`, `GET /get_season_detail/{season_number}`
- **Shortform** — base `https://qzhshbkzxaiow5dhvij77pgpuq0txydy.lambda-url.ap-northeast-2.on.aws`
- `GET /shortform/seasons?lane=`, `GET /shortform/seasons/{season_number}?lane=`, `GET /shortform/studio/season/{season_number}?lane=` (masked studio view), `GET /openapi.yaml`, `GET /docs`
- `lane` selects the product line: `general` (AI Shorts, default), `bible` (성경 1189장), `bible_en` (Bible 1189) or `buddhist` (법의 바다 — Buddhist scripture shorts, starting with the Dhammapada). Season numbers are unique **within a lane**.
## Authenticated / paid (key required, consumes credits)
These require an API key and are NOT open for anonymous automation. Full machine-readable
specs are published as OpenAPI at each service's `/openapi.yaml`.
- Image generation / image-to-image / image-to-video — **ImageEdit** backend
(`https://pfqm5w2ehgcgyvpicxou3g6one0xoqdp.lambda-url.ap-northeast-2.on.aws`).
- Lottery prediction retrieval and paid "Buy Analysis".
- Game paid features: view access, AI model-name reveal (MindGame), report downloads
(Trading/MindGame) — paid reports are `no-redistribution`.
- Gallery write actions (comment, like), public-asset publishing — Backend.
- User credits, credit history, payments — Backend.
## Optional
- [OpenAPI specification](https://colortone.kr/openapi.json): Machine-readable API spec (planned).
- [AI plugin manifest](https://colortone.kr/.well-known/ai-plugin.json): Service & auth metadata.