Public Endpoints No auth required
GET
/api/health
System health & bindings status
{ "status": "healthy",
"version": "4.0.0",
"ai_binding": true,
"d1_binding": true,
"kv_binding": true }
"version": "4.0.0",
"ai_binding": true,
"d1_binding": true,
"kv_binding": true }
GET
/api
API info, pricing, public endpoints
GET
/api/models
Available AI models & agents
GET
/api/pricing
Tier details: Free, Pro, Enterprise
POST
/api/signup
Create free API key instantly
| Body | Type | Description |
|---|---|---|
| string | Required. Valid email address. | |
| name | string | Optional. Display name. |
curl -X POST "https://api.colorfulmoves.com/api/signup" \
-H "Content-Type: application/json" \
-d '{"email":"you@company.com","name":"Dev"}'
-H "Content-Type: application/json" \
-d '{"email":"you@company.com","name":"Dev"}'
Authentication
All authenticated endpoints require an API key. Pass it via X-API-Key header or ?key= query parameter.
GET
/api/key
Get your key info & tier
curl "https://api.colorfulmoves.com/api/key" \
-H "X-API-Key: cm_xxxxxxxxxxxxxxxx"
-H "X-API-Key: cm_xxxxxxxxxxxxxxxx"
Chat Endpoints
POST
/api/agent/chat
Single agent chat with any of 11 agents
| Body | Type | Description |
|---|---|---|
| agent | string | Required. Agent ID: nomatica, lupus, sage, etc. |
| message | string | Required. User prompt. |
| systemPrompt | string | Optional. Override default system prompt. |
POST
/api/agent/chat-multi
Parallel multi-agent query
curl -X POST "https://api.colorfulmoves.com/api/agent/chat-multi" \
-H "X-API-Key: cm_xxx" \
-H "Content-Type: application/json" \
-d '{"agents":["lupus","sage","trader"],"message":"Analyze risks"}'
-H "X-API-Key: cm_xxx" \
-H "Content-Type: application/json" \
-d '{"agents":["lupus","sage","trader"],"message":"Analyze risks"}'
POST
/api/agent/chat/stream
SSE streaming response (~20 words/sec)
POST
/api/chat
Direct model access (custom messages)
Billing
GET
/api/billing
Current tier, limits, subscription status
GET
/api/usage
Usage stats: daily/monthly, per-agent breakdown
POST
/api/portal
Stripe Customer Portal (manage/cancel/update card)
Payment Endpoints
POST
/api/checkout
Stripe Checkout session for subscriptions
POST
/api/checkout/square
Square backup checkout (alternative provider)
POST
/api/topup
Emergency request packs: 100/500/1000
POST
/api/webhooks/stripe
Stripe webhook receiver (HMAC verified)
Admin Dashboards Admin key required
GET
/api/admin/revenue?admin_key=xxx
Revenue: MRR, subscribers, churn, usage
GET
/api/admin/pnl?admin_key=xxx
PnL: margins, costs, conversion funnel
Analytics
POST
/api/analytics
Track landing page events (public)
Available Models
| Model | Name | Tier | Specialty |
|---|---|---|---|
| @cf/meta/llama-3-70b-instruct | Llama 3 70B | Premium | Complex reasoning, finance, trading |
| @cf/meta/llama-3-8b-instruct | Llama 3 8B | Standard | Fast responses, general queries |
| @cf/meta/llama-3.1-8b-instruct | Llama 3.1 8B | Standard | General purpose |
| @cf/google/gemma-2-7b-it | Gemma 2 7B | Standard | Technical, security (Lupus) |
| @cf/qwen/qwen2-7b-instruct | Qwen 2 7B | Standard | Multilingual, DevOps (Orion) |
| @cf/deepseek-ai/deepseek-coder-33b-instruct | DeepSeek Coder | Premium | Code generation, blockchain (Dai, Coder) |
| @cf/tii/falcon-3-7b-instruct | Falcon 3 7B | Standard | Creative, general (Cosmos) |
| @cf/mistral/mistral-7b-instruct-v0.2 | Mistral 7B | Standard | General purpose |
Tier Pricing
| Feature | Free | Pro ($29/mo) | Enterprise ($299/mo) |
|---|---|---|---|
| Daily requests | 100 | 10,000 | Unlimited |
| Monthly requests | 3,000 | 300,000 | Unlimited |
| Models | Standard (8B) | All (70B + 33B) | All + Custom |
| Agents | 10 | 10 | 10 + Custom |
| Multi-agent | Max 3 | Unlimited | Unlimited |
| Support | Community | Dedicated + SLA |