Echo 开发者计划指南

运作方式

1. 1. 您使用 AINative API 构建应用
2. 您的客户使用您的应用 → 消耗 API 积分
3. 您在 AINative 成本基础上设置加价率（0–40%）
4. AINative 收取 5% 平台费
5. 您通过每周 Stripe Connect 结算获得剩余收入

示例： 客户使用 1,000 积分，基础成本为 0.10 美元。您设置 30% 加价率 → 您获得 0.03 美元，AINative 收取 0.0015 美元。

注册为开发者

python
import requests

requests.post(
https://api.ainative.studio/api/v1/echo/register,
headers={Authorization: fBearer {jwt_token}},
json={developer_name: 我的应用, website: https://myapp.com}
)

设置加价率

python

设置 25% 加价率（范围：0.0 至 0.40）

requests.put(
https://api.ainative.studio/api/v1/echo/markup,
headers={Authorization: fBearer {jwt_token}},
json={markup_rate: 0.25}
)

查看收益

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

print(f总收益：${earnings[total_earnings]})
print(f本月收益：${earnings[currentperiodearnings]})
print(f待结算金额：${earnings[pending_amount]})

连接 Stripe 进行结算

python

开始 Stripe Connect 入驻流程

onboard = requests.post(
https://api.ainative.studio/api/v1/echo/connect/onboard,
headers={Authorization: fBearer {jwt_token}}
).json()

将用户重定向至：

print(onboard[onboarding_url]) # Stripe Connect Express 页面

检查状态

status = requests.get( https://api.ainative.studio/api/v1/echo/connect/status, headers={Authorization: fBearer {jwt_token}} ).json() print(f结算已启用：{status[payouts_enabled]})

请求手动结算

python

最低结算金额：10 美元

payout = requests.post(
https://api.ainative.studio/api/v1/echo/payout,
headers={Authorization: fBearer {jwt_token}},
json={amount: 50.00}
).json()
print(f已请求结算：${payout[amount]}，预计到账时间：{payout[estimated_arrival]})

自动结算设置

python

启用每周自动结算

requests.post(
https://api.ainative.studio/api/v1/echo/settings/auto,
headers={Authorization: fBearer {jwt_token}},
json={enabled: True, minimum_amount: 10.00, schedule: weekly}
)

收益历史

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

Echo API 端点

端点	方法	描述
/api/v1/echo/register	POST	注册为开发者
/api/v1/echo/markup

PUT | 设置加价率（0-40%） | | /api/v1/echo/earnings | GET | 当前收益汇总 | | /api/v1/echo/earnings/history | GET | 历史收益 | | /api/v1/echo/earnings/breakdown | GET | 按应用/客户细分 | | /api/v1/echo/payouts | GET | 列出历史结算记录 | | /api/v1/echo/payout | POST | 请求手动结算 | | /api/v1/echo/balance | GET | 可用结算余额 | | /api/v1/echo/connect/onboard | POST | 开始 Stripe Connect 入驻 | | /api/v1/echo/connect/status | GET | 检查 Stripe Connect 状态 | | /api/v1/echo/settings/auto | GET/POST | 自动结算设置 |

关键概念

• - 开发者构建自己的应用 — 而非向 AINative 上传模型
• 客户向开发者付费 — 开发者使用 AINative 定价 + 加价率向客户收费
• 每周结算 通过 Stripe Connect Express，最低 10 美元
• 平台费 为开发者收益的 5%（自动扣除）
• 加价率范围 0% 至 40% — 按开发者账户设置

参考资料

• - src/backend/app/api/v1/endpoints/developerearnings.py — 21 个路由处理器
• src/backend/app/services/stripeservice.py — Stripe Connect 集成
• src/backend/app/tasks/developerpayouts.py — 每周 Celery 结算任务
• docs/guides/DEVELOPERPAYOUTSGUIDE.md — 完整结算指南
• docs/projects/ainative-developer-studio/guides/ECHODEVELOPER_GUIDE.md — 外部开发者指南（1,283 行）