AINative Developer Studio — Complete Developer Guide (v1.0)

# AINative Developer Studio — Complete Developer Guide (v1.0) **Version:** 1.0 **Last Updated:** 2026-01-13 **Audience:** External Developers Building on AINative Platform --- ## Table of Contents 1. Overview 2. Getting Started 3. Authentication 4. Developer Markup Configuration 5. Earnings Tracking 6. Payout Management 7. Stripe Connect Integration 8. Token Metering 9. AI Model Access 10. SDKs 11. Webhooks 12. Best Practices 13. Troubleshooting 14. Support --- ## 1) Overview ### What is AINative Developer Studio? AINative Developer Studio is a virtual app accelerator that enables you to build AI applications without giving up equity. You keep 100% ownership while earning revenue from day one through our user-pays model. ### How It Works ``` User → Your App → AINative API → AI Models → Response ↓ Set Markup (0-40%) ↓ Earn Revenue on Every Request ↓ Automatic Weekly Payouts ``` ### Key Features - **User-Pays Model**: Your customers pay directly for AI usage - **Developer Markup**: Set 0-40% markup, earn on every transaction - **100+ AI Models**: GPT-4, Claude, Gemini, Llama, and more - **Automatic Payouts**: Weekly transfers via Stripe Connect - **Token Metering**: Pay-per-token billing with transparent pricing - **Developer Dashboard**: Real-time analytics and earnings tracking - **React & Next.js SDKs**: Drop-in components for rapid development ### Revenue Model ``` Customer Spends $100 → Base Cost $85 → Your Markup 15% → You Earn $15 ``` - **You set markup**: 0% to 40% - **You earn**: Markup percentage on every AI API call - **Payouts**: Automatic weekly transfers (minimum $50) - **Platform fee**: 5% on payouts (already included in base pricing) --- ## 2) Getting Started ### Step 1: Create Account Sign up at [https://www.ainative.studio/signup](https://www.ainative.studio/signup) **Free Tier Includes:** - 100 free API credits - Access to all AI models - Developer dashboard - Documentation & support ### Step 2: Get API Keys 1. Navigate to [Developer Settings](https://www.ainative.studio/dashboard/developer-settings) 2. Go to **API Keys** tab 3. Click **Create New API Key** 4. Copy and securely store your API key **API Key Format:** ``` ak_live_1234567890abcdefghijklmnopqrstuvwxyz ``` **Security:** - Never commit API keys to version control - Use environment variables - Rotate keys regularly - Use different keys for development/production ### Step 3: Configure Developer Markup 1. Go to **Developer Markup** tab in Developer Settings 2. Set markup percentage (0–40%) 3. Click **Save Configuration** **Markup Calculator:** ```javascript const customerSpend = 100; const yourMarkup = 15; // 15% const yourEarnings = customerSpend * (yourMarkup / 100); // $15 ``` ### Step 4: Install SDK **React:** ```bash npm install @ainative/react-sdk # or yarn add @ainative/react-sdk ``` **Next.js:** ```bash npm install @ainative/nextjs-sdk # or yarn add @ainative/nextjs-sdk ``` ### Step 5: Connect Stripe for Payouts 1. Go to **Stripe Connect** in Developer Settings 2. Click **Connect with Stripe** 3. Complete Stripe Express onboarding 4. Receive automatic weekly payouts (minimum $50) --- ## 3) Authentication ### API Key Authentication All API requests require auth via API key in the `Authorization` header: ```bash curl https://api.ainative.studio/v1/public/models/list \ -H "Authorization: Bearer ak_live_YOUR_API_KEY" ``` **Required Headers:** ``` Authorization: Bearer {your_api_key} Content-Type: application/json ``` ### User Authentication (SDK) ```typescript import { AINativeProvider } from '@ainative/react-sdk'; function App() { return ( ); } ``` --- ## 4) Developer Markup Configuration ### Overview Developer markup is your revenue percentage on every AI API transaction. Set it once and earn automatically. ### Endpoints #### Get Current Markup ``` GET /v1/public/developer/markup Authorization: Bearer {api_key} ``` **Response:** ```json { "markup_percentage": 15.0, "updated_at": "2026-01-13T12:00:00Z" } ``` #### Update Markup ``` PUT /v1/public/developer/markup Authorization: Bearer {api_key} Content-Type: application/json { "markup_percentage": 20.0 } ``` **Request Body:** | Field | Type | Required | Constraints | |-------|------|----------|-------------| | `markup_percentage` | number | Yes | 0 ≤ value ≤ 40 | **Response:** ```json { "success": true, "markup_percentage": 20.0, "message": "Markup updated successfully" } ``` **Validation Rules:** - Minimum 0% - Maximum 40% - Precision: 2 decimals (e.g., 15.50%) - Applies immediately to future transactions ### Markup Strategy (Recommended) | Use Case | Markup | Rationale | |----------|--------|-----------| | Consumer Apps | 10–15% | High volume, price-sensitive | | SMB Tools | 15–25% | Value-focused businesses | | Enterprise SaaS | 25–35% | High-value contracts | | Niche Vertical | 30–40% | Specialized outcomes | **Example:** ```javascript const baseCost = 1.00; const markup = 0.20; // 20% const customerCharge = baseCost * (1 + markup); // $1.20 const yourEarnings = baseCost * markup; // $0.20 ``` --- ## 5) Earnings Tracking ### Overview Track earnings from markup in real time via dashboard or API. ### Endpoints #### Earnings Summary ``` GET /v1/public/developer/earnings/summary Authorization: Bearer {api_key} ``` **Response:** ```json { "total_earnings_cents": 150000, "total_earnings": "$1,500.00", "pending_earnings_cents": 50000, "pending_earnings": "$500.00", "paid_out_earnings_cents": 100000, "paid_out_earnings": "$1,000.00", "current_month_cents": 30000, "current_month": "$300.00", "average_markup_percentage": 18.5, "total_transactions": 1250 } ``` --- ## 14) Support ### Documentation - **API Reference**: [https://api.ainative.studio/docs](https://api.ainative.studio/docs) - **SDK Docs**: [https://github.com/orgs/AINative-Studio/repositories](https://github.com/orgs/AINative-Studio/repositories) - **Blog**: [https://www.ainative.studio/blog](https://www.ainative.studio/blog) ### Support Channels - **Email**: support@ainative.studio - **Discord**: [https://discord.com/invite/paipalooza](https://discord.com/invite/paipalooza) **Response Times:** - Email: 24–48 hours - Discord: real-time during business hours - Critical: email with **[URGENT]** in subject ### Enterprise Support - Dedicated Slack channel - Priority support (4-hour response time) - Architecture review - Custom integrations **Contact**: developer@ainative.studio ### Feature Requests - **GitHub Issues**: [https://github.com/ainative-studio/core/issues](https://github.com/ainative-studio/core/issues) - **Email**: developer@ainative.studio --- **Last Updated:** 2026-01-13 **Version:** 1.0 **Questions?** support@ainative.studio

AINative Developer Studio — Complete Developer Guide (v1.0)

Check your site's AX Score