# ColorTone (칼라톤) — Full Reference for AI Agents
> ColorTone is an AI-powered creative platform. This document is the detailed,
> machine-oriented description of ColorTone's features and publicly callable APIs.
> It complements /llms.txt. Last reviewed: 2026-06.
## Services & domains
- Web (KO): https://colortone.kr
- Web (EN): https://colortone.ai
- Backend API (gallery, users, payments, matching): https://qmrjrms323vlvqihosmwf22ti40qdsms.lambda-url.ap-northeast-2.on.aws
- ImageEdit API (canonical AI image/video generation & media): https://pfqm5w2ehgcgyvpicxou3g6one0xoqdp.lambda-url.ap-northeast-2.on.aws
- Lotto API (lottery results, stats, predictions): https://togwqart2xku5carphufpmebp40kzfvp.lambda-url.ap-northeast-2.on.aws
- Humor API (AI Humor Battle): https://cxwjma2qvhwm2slc73tpdykbdq0ejeys.lambda-url.ap-northeast-2.on.aws
- Trading API (AI stock-trading simulation): https://zcn2hm3ywiqyp37kra4b64gws40slpip.lambda-url.ap-northeast-2.on.aws
- MindGame API (AI card betting game): https://mcarrev6k5ijjs4jkz6wbtnkau0tfpqt.lambda-url.ap-northeast-2.on.aws
Each backend serves its own OpenAPI spec at `/openapi.yaml` and a Swagger UI at `/docs`.
All responses are JSON. Common envelope: `{ "success": boolean, "data": ..., "message"?: string, "error"?: { "code", "message" } }`.
Localization: send `Accept-Language: ko` or `en`.
## Access & licensing policy
- READ of public, low-value data (lottery results, stats, public gallery) is open to
agents/bots, subject to rate limiting. Please send a descriptive `User-Agent`.
- Lottery RESULT data: viewing/display OK; redistribution, bulk copy, or resale PROHIBITED.
- AI PREDICTION/STATS data and AI GAME CONTENT (Humor comments, Trading sims, game
results — all ColorTone-owned): non-commercial reuse allowed under CC-BY-NC WITH
attribution ("ColorTone") AND a disclaimer that the information is for reference/
entertainment only and does not guarantee any outcome. Commercial/bulk reuse requires
a B2B contract.
- PAID REPORTS (Trading/MindGame season reports, PDF): sold per purchase; redistribution,
copying, or resale PROHIBITED (purchaser-only license).
- GALLERY/user content: redistribution NOT permitted unless the user explicitly made the
item public with redistribution consent.
- GENERATION, prediction "Buy Analysis", game paid features (view access, AI model-name
reveal, report downloads), payments, and account changes require an API key and consume
credits. They are not open for anonymous automation.
- See Terms of Service Article 12-2 (Data Redistribution and Automated Access).
## Public endpoints (no key required)
### Lotto service — base: {LOTTO_API_URL}
- `GET /lotto/results` — list past draw results. Query: pagination params.
License: `no-redistribution`.
- `GET /lotto/results/latest` — latest draw result. License: `no-redistribution`.
- `GET /lotto/results/{draw_no}` — specific draw result. License: `no-redistribution`.
- `GET /lotto/stats` — model accuracy statistics (localized). License: `CC-BY-NC + disclaimer`.
- `GET /lotto/ticket_captures/{draw_no}` — PNG captures of the operator's real purchased tickets (Donghaeng Lottery "ticket view" screen). PURCHASE before the draw, RESULT after; numbers and barcode blurred unless the caller owns the purchased-number analysis. License: `no-redistribution`.
- `GET /lotto/countdown` — seconds/time until the next draw.
- `GET /health` — health check.
> Note: lottery PREDICTION read endpoints (`GET /lotto/predictions*`) carry business value
> and are intentionally omitted from this public catalog until the redistribution Terms are
> in effect. Until then, treat predictions as authenticated/paid.
### AI Humor service — base: {HUMOR_API_URL}
- `GET /humor/seasons` — list seasons. License: `CC-BY-NC + disclaimer`.
- `GET /humor/season/{season_id}` — season detail + competitors.
- `GET /humor/leaderboard/{season_id}` — standings.
- `GET /humor/posts/{season_id}` — posts (humor images + AI comments), paginated.
- `GET /humor/post/{post_id}` — post detail + ranked comments.
- `GET /humor/rank/snapshots/{season_id}` — rank history.
### Trading service — base: {TRADING_API_URL}
- `GET /trading/seasons`, `GET /trading/season/{season_id}`, `GET /trading/leaderboard/{season_id}`.
- `GET /trading/candles/{season_id}` — candle chart data.
- `GET /trading/rank/orders/{season_id}`, `GET /trading/rank/snapshots/{season_id}`.
- `POST /trading/history` — a trader's history (body: season_id, trader_id?).
- AI scalper paper-trading season (`trading_mode=SCALP` — an AI buys KRW-market crypto in simulation only, no real money, not investment advice): `GET /trading/scalp/public/summary?season_id=` (per-ledger scoreboard vs. random baseline and rule ledger, cumulative-return curves) and `GET /trading/scalp/public/trades?season_id=&limit=1..100&before=` (AI-ledger closed trades, newest first, published 24h after close, no KRW amounts/volumes/prices; trade reasons are AI-written and unverified).
License (all): `CC-BY-NC + disclaimer`.
### MindGame service — base: {MINDGAME_API_URL}
- `GET /mindgame/seasons`, `GET /mindgame/season/{season_id}`, `GET /mindgame/leaderboard/{season_id}`.
- `POST /mindgame/turns` — turn history. `GET /mindgame/player/{player_id}`,
`GET /mindgame/credit_history/{season_id}`.
License: `CC-BY-NC + disclaimer`.
### Matching — via Backend: {BACKEND_API_URL}
- `GET /get_seasons`, `GET /get_season_detail/{season_number}` — matching seasons (public read).
### Shortform (AI Shorts) — ShortformBackend: https://qzhshbkzxaiow5dhvij77pgpuq0txydy.lambda-url.ap-northeast-2.on.aws
- `GET /shortform/seasons?lane=` — seasons (newest first; each season is one story, released as 1..N vertical parts)
- `GET /shortform/seasons/{season_number}?lane=` — season detail: public cast (name, character season link, image) + stage status
- `GET /shortform/studio/season/{season_number}?lane=` — studio view: stages, scenes, cast, artifacts. Prompts, costs and operator notes are masked for anonymous callers.
- `lane` is the product line: `general` (AI Shorts, the default), `bible` (성경 1189장), `bible_en` (Bible 1189) or `buddhist` (법의 바다 — Buddhist scripture shorts, starting with the Dhammapada) — each a separate series on its own YouTube channel.
Season numbers are unique **within a lane**, so `(lane, season_number)` is the lookup key — asking for another lane's number returns 404.
- `GET /openapi.yaml`, `GET /docs` — machine-readable spec / Swagger UI
## Authenticated & paid endpoints (API key required)
Authentication: `Authorization: Bearer ` (issued from the user's account page; planned).
Scopes: `read:public`, `read:user`, `generate:image`, `purchase`.
Each call consumes the same credits as the web UI. Confirm before any purchase.
### ImageEdit service (generation) — base: {IMAGEEDIT_API_URL}
- Generation: `POST /image2image`, `POST /recreate_from_s3`, `POST /generate_text_image`,
`POST /upload_image`. Async → poll `GET /job_status/{job_id}`, `GET /last_job`.
- Media: `POST /user_media`, `POST /extract_video_frame`, `POST /video_merge`,
`POST /translate`, `POST /delete_image`, `POST /toggle_image_visibility`.
### Backend service — base: {BACKEND_API_URL}
- Gallery (write): `POST /gallery/comment/add`, `POST /gallery/like/add`,
`POST /gallery/like/remove`, `POST /register_public_asset`.
- Gallery (read): `POST /gallery/images`, `GET /gallery/comments/{pa_id}`,
`POST /gallery/public_images`, `POST /get_all_public_assets`.
- User/credits: `POST /get_user_credits`, `POST /get_user_info`, `POST /read_credit_history`.
- Payments: `POST /payment_request`, `POST /payment_confirm` (TossPayments).
- API keys (id+password gated): `POST /api_keys`, `POST /api_keys/list`, `POST /api_keys/revoke`.
### Lotto service — base: {LOTTO_API_URL}
- Predictions: `GET /lotto/predictions`, `GET /lotto/predictions/latest`,
`GET /lotto/predictions/{target_draw_no}`.
- Paid analysis: `GET /lotto/buy_analysis/{target_draw_no}`,
`POST /lotto/check_buy_analysis`, `POST /lotto/purchase_buy_analysis` (200 credits).
- View access: `POST /lotto/check_view`, `POST /lotto/purchase_view`.
- Subscription: `POST /lotto/subscribe`, `GET /lotto/subscription_status`,
`POST /lotto/unsubscribe`.
### Game paid features (consume credits) — `no-redistribution` for downloaded reports
- Trading — base {TRADING_API_URL}: `check_view`/`purchase_view`, `check_report`/
`purchase_report`, `GET /trading/reports/{season_id}`, `check_report_access`/`purchase_report_item`.
- MindGame — base {MINDGAME_API_URL}: `purchase_view`, `check_model`/`purchase_model`
(AI model-name reveal), `purchase_report`/report-store, `reveal_dealer_hand`, `advance_turn`.
## NOT for automated/public use
Administrative and webhook endpoints are internal-only and must not be called by agents.
Every service has its own `/admin/*` (e.g. Lotto crawl/predict/notify/run_pipeline;
Humor/Trading/MindGame create_season/update_status/execute_*/generate_report) plus the
Backend webhooks `/webhook`, `/payment_webhook`, `/fal_webhook`.
## Contact
For B2B/commercial data licensing or automated-access keys, contact ColorTone
(business registration 873-03-03482).