Public Developer SDK Documentation
Runnerflo B2B AI & FaaS SDK Reference
Integrate 17 AI models and general-purpose serverless functions into your SaaS applications with zero monthly deposits and automatic end-user payment validation.
1. The Zero-Friction B2B2C Architecture
Runnerflo provides a zero-friction model designed specifically for SaaS builders:
- ✓ $20 Lifetime Pass: Pay once via Geo-Routing Xendit, access forever. Includes 100 free test credits upon 1x24h account verification.
- ✓ No Monthly Deposits: You do NOT need to surrender credit cards or maintain prepaid monthly balances to serve production traffic.
- ✓ Polar.sh Merchant of Record (MoR): Handle global European VAT and US Sales Tax compliance out-of-the-box without requiring $1,000 US LLC setup fees.
- ✓ Custom Profit Margin: Configure your desired markup percentage (e.g. +200%). End-users are billed automatically, Runnerflo retains base GPU cost, and your profit is credited directly to your Payout Wallet.
2. Quickstart Code Examples
Invoke Runnerflo APIs using cURL, Node.js, or Python:
cURL Example (OmniVoice Speech Clone):
curl -X POST https://runnerflo-gateway.pages.dev/v1/runnerflo-voiceclone/generate \
-H "Authorization: Bearer rfl_live_YOUR_API_KEY" \
-F "text=Halo, selamat datang di platform SaaS kami!" \
-F "language=id"
Node.js / JavaScript SDK Example:
const response = await fetch('https://runnerflo-gateway.pages.dev/v1/runnerflo-avatar/generate', {
method: 'POST',
headers: {
'Authorization': 'Bearer rfl_live_YOUR_API_KEY'
},
body: formData // contains portrait image + speech audio
});
const data = await response.json();
console.log('Generated Avatar Video URL:', data.url);
3. API Endpoint Catalog (17 Services)
| Model / Service ID | Capability | Base Cost | Response Artifact |
|---|---|---|---|
| runnerflo-voiceclone | Voice cloning & TTS (600+ languages) | $0.005 / call | Presigned WAV URL |
| runnerflo-avatar | Talking head avatar video (13.6B params) | $0.025 / call | Presigned MP4 URL |
| remotion-cloudrun | Programmatic MP4 video rendering | $0.050 / call | Presigned MP4 URL |
| flux.2-klein-4b | Sub-second image generation & edit | $0.003 / call | Presigned PNG URL |
| runnerflo-serverless-engine | V8 Isolate FaaS code execution | $0.000001 / call | JSON Response Body |