Echo Developer Program Guide#

How It Works#

1. You build an app using AINative APIs
2. Your customers use your app → they consume API credits
3. You set a markup (0–40%) on top of AINative's cost
4. AINative takes 5% platform fee
5. You receive the rest via weekly Stripe Connect payouts

Example: Customer uses 1,000 credits at base cost $0.10. You set 30% markup → you earn $0.03, AINative takes $0.0015.

Register as a Developer#

python

import requests

requests.post(
    "https://api.ainative.studio/api/v1/echo/register",
    headers={"Authorization": f"Bearer {jwt_token}"},
    json={"developer_name": "My App", "website": "https://myapp.com"}
)

Set Your Markup Rate#

python

# Set 25% markup (range: 0.0 to 0.40)
requests.put(
    "https://api.ainative.studio/api/v1/echo/markup",
    headers={"Authorization": f"Bearer {jwt_token}"},
    json={"markup_rate": 0.25}
)

Check Earnings#

python

earnings = requests.get(
    "https://api.ainative.studio/api/v1/echo/earnings",
    headers={"Authorization": f"Bearer {jwt_token}"}
).json()

print(f"Total earned: ${earnings['total_earnings']}")
print(f"This month: ${earnings['current_period_earnings']}")
print(f"Pending payout: ${earnings['pending_amount']}")

Connect Stripe for Payouts#

python

# Start Stripe Connect onboarding
onboard = requests.post(
    "https://api.ainative.studio/api/v1/echo/connect/onboard",
    headers={"Authorization": f"Bearer {jwt_token}"}
).json()

# Redirect your user to:
print(onboard["onboarding_url"])  # Stripe Connect Express page

# Check status
status = requests.get(
    "https://api.ainative.studio/api/v1/echo/connect/status",
    headers={"Authorization": f"Bearer {jwt_token}"}
).json()
print(f"Payouts enabled: {status['payouts_enabled']}")

Request Manual Payout#

python

# Minimum payout: $10
payout = requests.post(
    "https://api.ainative.studio/api/v1/echo/payout",
    headers={"Authorization": f"Bearer {jwt_token}"},
    json={"amount": 50.00}
).json()
print(f"Payout requested: ${payout['amount']}, ETA: {payout['estimated_arrival']}")

Auto-Payout Settings#

python

# Enable weekly automatic payouts
requests.post(
    "https://api.ainative.studio/api/v1/echo/settings/auto",
    headers={"Authorization": f"Bearer {jwt_token}"},
    json={"enabled": True, "minimum_amount": 10.00, "schedule": "weekly"}
)

Earnings History#

python

history = requests.get(
    "https://api.ainative.studio/api/v1/echo/earnings/history",
    headers={"Authorization": f"Bearer {jwt_token}"},
    params={"days": 30}
).json()

Echo API Endpoints#

EndpointMethodDescription/api/v1/echo/registerPOSTRegister as developer/api/v1/echo/markupPUTSet markup rate (0-40%)/api/v1/echo/earningsGETCurrent earnings summary/api/v1/echo/earnings/historyGETEarnings over time/api/v1/echo/earnings/breakdownGETBreakdown by app/customer/api/v1/echo/payoutsGETList past payouts/api/v1/echo/payoutPOSTRequest manual payout/api/v1/echo/balanceGETAvailable payout balance/api/v1/echo/connect/onboardPOSTStart Stripe Connect/api/v1/echo/connect/statusGETCheck Stripe Connect status/api/v1/echo/settings/autoGET/POSTAuto-payout settings

Key Concepts#

• Developers build their OWN apps — not upload models to AINative
• Customers pay developers — developers bill customers using AINative pricing + markup
• Weekly payouts via Stripe Connect Express, minimum $10
• Platform fee 5% of developer earnings (deducted automatically)
• Markup range 0% to 40% — set per developer account

References#

• src/backend/app/api/v1/endpoints/developer_earnings.py — 21 route handlers
• src/backend/app/services/stripe_service.py — Stripe Connect integration
• src/backend/app/tasks/developer_payouts.py — Weekly Celery payout tasks
• docs/guides/DEVELOPER_PAYOUTS_GUIDE.md — Full payouts guide
• docs/projects/ainative-developer-studio/guides/ECHO_DEVELOPER_GUIDE.md — External dev guide (1,283 lines)