Menu
Documentation
v2.0 API Reference

Molbik AI developer documentation

Integrate Molbik AI's generation engine directly into your own products. Build internal tools, automate client deployments, and scale your agency using our REST API.

API Availability

Our core REST API is distributed globally across highly available edge networks ensuring 99.99% uptime. It is available 24/7 for all accounts with a positive wallet balance.

Authentication

Authenticate your API requests by including your secret API key in the Authorization header of every request.

cURL - Authentication Example
curl https://api.molbik.com/v2/apps \ -H "Authorization: Bearer sk_live_your_secret_key" \ -H "Content-Type: application/json"

Available Endpoints

/v2/generate

Submit a text prompt to asynchronously generate a new full-stack application.

Preview

/v2/webhooks

Configure endpoints to receive notifications when a deployment finishes.

Generate App: Requests & Responses

POST

Trigger a new application generation. Below are the supported request parameters and the expected JSON response format.

JSON Request Body
{
  "prompt": "A CRM dashboard for leads...",
  "stack": "nextjs-tailwind",
  "auto_deploy": true
}
JSON Response (200 OK)
{
  "job_id": "gen_89x2ab",
  "status": "processing",
  "estimated_time": "45s",
  "credits_deducted": 50
}

Deployment Steps

Taking your generated app from prompt to a live custom domain programmatically involves three simple deployment steps:

1

Generate via API

Send your workflow description to the /v2/generate endpoint to begin the build process.

2

Poll for Completion

Use the returned job_id to check the status. Once complete, you will receive a temporary staging URL.

3

Attach Custom Domain

Call the /v2/domains endpoint to map your verified custom domain. SSL certificates are provisioned automatically.

Rate Limits & Errors

API usage is billed directly to your Molbik Wallet. Our credit system is simple and transparent: 1 Credit = ₹1 INR.

Standard API Costs

  • App Generation RequestBase Generation Cost
  • Recharge Bonus (e.g., Load ₹500)+ 50 Credits Free (10% Bonus)
  • Referral Reward+ 10 Credits Free

If your wallet balance drops to zero, the API will return a 402 Payment Required error. Rate limits are set to 60 requests per minute per IP address. Exceeding this will result in a 429 Too Many Requests response.

Need an Enterprise SLA?

If you are planning to hit the API with high volume (1,000+ generations/month), contact our sales team to discuss dedicated compute clusters.