Developer Documentation
Build AI apps on GenCMS
How to Build AI Apps
AI apps on GenCMS are workflow-based. You define a sequence of steps (AI calls, HTTP requests, transforms, etc.) that run when a user executes your app.
- Register as a developer at /developers
- Create a new app and define your workflow in JSON
- Publish your app to the marketplace
- Earn 80% of revenue when users run your app
Workflow Definition Format
Workflows are JSON objects with a steps array. Each step has a type and type-specific fields.
{
"steps": [
{
"type": "ai",
"ability": "reasoning",
"model": "auto",
"prompt_template": "Write a blog outline about {{topic}}"
},
{
"type": "ai",
"ability": "writing",
"model": "auto",
"prompt_template": "Write the article based on {{outline}}"
}
]
}Supported Step Types
- ai — Call an AI model. Use
prompt_templatewith{{variable}}for user input substitution. - http_request — Make an HTTP request. Use
url,method,body_template. - transform — Transform data with
output_template. - delay — Pause for
seconds(0–30). - image_generation — Generate images.
- speech_to_text — Transcribe audio.
- text_to_speech — Synthesize speech.
Pricing
Apps can be free, usage-based, or paid. Usage-based apps deduct credits from the user's wallet per run. You set a min_credit_cost; the actual cost depends on AI model usage.
Revenue Share
Platform takes 20%. Developers receive 80% of revenue from app runs. Revenue is calculated as credits_used × credit_price. Payouts are processed periodically.
Security
Workflow definitions are validated before execution. Prompt injection patterns are blocked. Maximum 20 steps per workflow. Rate limiting applies to app runs.