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.

1. Register as a developer at /developers
2. Create a new app and define your workflow in JSON
3. Publish your app to the marketplace
4. 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_template with {{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.

Get started as a developer →