Developer docs
Quickstart
Deploy your first AI agent and make your first withdrawal in under 10 minutes. Free account, no credit card.
1
Get your free API key
Sign up with GitHub, Google, or email. No credit card required. Your key is ready in under 60 seconds.
curl -X POST https://api.forcedream.ai/api/signup \
-H "Content-Type: application/json" \
-d '{"email": "you@example.com"}'
Response: {"api_key": "sk_fd_...", "user_id": "usr_..."}
Sign up at /earn →
2
Route inference to the best model
One endpoint across Claude Sonnet, GPT-4o, Gemini 1.5 Pro, and LLaMA 70B. The router picks the optimal model per task and budget.
curl -X POST https://api.forcedream.ai/v1/inference/route \
-H "Authorization: Bearer sk_fd_..." \
-H "Content-Type: application/json" \
-d '{"task": "research", "priority": "balanced",
"prompt": "Summarise FCA Consumer Duty requirements"}'
Priority options: balanced · cheapest · fastest · quality
3
Check your balance
Every call earns you 78% automatically. Check your balance any time. Withdraw from £5.00 via Stripe, M-Pesa, or Airwallex.
curl https://api.forcedream.ai/v1/account/balance \
-H "Authorization: Bearer sk_fd_..."
# Response
{"balance_gbp": "£0.08", "total_earned_gbp": "£0.08",
"withdrawal_eligible": false, "calls_today": 1}
4
Publish an agent to the marketplace
Publish once. Earn 78% from every call any user makes to your agent — indefinitely.
curl -X POST https://api.forcedream.ai/v1/marketplace/publish \
-H "Authorization: Bearer sk_fd_..." \
-H "Content-Type: application/json" \
-d '{"name": "My Research Agent",
"description": "Synthesises regulatory documents",
"category": "Research",
"price_pence": 8,
"target_markets": ["GB","US","NG","KE"]}'
Publish an agent →
Essential endpoints
Inference
POST /v1/inference/route
POST /v1/memory/store
GET /v1/memory/retrieve
Earnings
GET /v1/account/balance
GET /v1/account/earn-history
POST /v1/withdraw/request
Marketplace
GET /v1/marketplace/list
POST /v1/marketplace/publish
GET /v1/marketplace/analytics
Account
GET /v1/account/keys
POST /v1/account/keys/create
GET /v1/developer/badges