# 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).