合作伙伴计划

使用 Partner 工作区创建由 OpenModels 驱动的自有市场、选择模型路由、设置加价、发布公开店面，并跟踪归属于您的 Partner ID 的用量。

请通过 Discord 联系我们以开始使用：https://discord.com/invite/tRQghcXhaH

设置清单

Partner 概览页会显示设置步骤和当前工作区摘要。

发布前请完成以下步骤：

1. 配置店面。
2. 添加模型并选择供应商路由。
3. 选择合作伙伴套餐。
4. 配置 SEO。
5. 预览公开市场。
6. 市场准备就绪后发布。

配置店面

打开 Storefront，设置显示在公开市场页面上的字段。

关键字段：

添加模型

打开 Models，点击 Add model，选择模型路由，并设置市场价格的加价。

该表会显示上游路由、基础输入和输出价格、加价、最终市场价格和状态。仅当所选供应商路由已可供用户使用时，才保持模型启用。

选择套餐

打开 Plan，选择符合所需模型数量和控制项的套餐。

Launch 套餐是最小的发布套餐。Growth 和 Scale 套餐提供更高的模型上限和更多市场控制项。

配置 SEO

打开 SEO，设置公开页面标题、slug 和元描述。

slug 会成为公开市场的 URL 路径。保存更改前请查看预览，确保搜索结果标题和描述与您要发布的市场一致。

预览和发布

打开 Preview，使用实时 Partner 资料和已发布模型路由查看店面。

使用 Open preview 在单独的标签页中检查公开店面。只有在店面、模型、套餐和 SEO 设置都准备好后才使用 Publish。

跟踪用量

打开 用量，查看请求、佣金、Partner ID 归因和按请求划分的用量行。

使用此页面确认流量归属于预期的 Partner ID，并且模型用量的佣金值已被记录。

公开 Partner API

当您希望使用与托管店面相同的 Partner 资料和模型数据来构建自己的市场页面、定价页面或套餐页面时，请使用公开 Partner API。

公开 cURL

curl "https://openmodels.market/api/v1/partners/public/$PARTNER_ID"

将 $PARTNER_ID 替换为 Storefront 设置中的 Partner ID。

所有者 cURL

仅当已登录的 Partner 所有者需要完整资料和模型负载时，才使用 full=true：

curl "https://openmodels.market/api/v1/partners/public/$PARTNER_ID?full=true" \
  -H "Authorization: Bearer $OPENMODELS_ACCESS_TOKEN"

OPENMODELS_ACCESS_TOKEN 是已登录账户的 OpenModels 应用访问令牌。请勿在此使用 Key Market API 密钥。

查询参数

授权行为

该端点默认公开。没有请求头、使用无效令牌或使用其他账户令牌的请求，都会返回相同的基础公开负载。

只有 Partner 所有者可以通过 Authorization: Bearer $OPENMODELS_ACCESS_TOKEN 和 full=true 读取仅限所有者的字段，例如账户 ID、批发加价、上游模型、供应价格、加价和所有者定价层字段。

响应结构

公开端点会返回标准的 OpenModels 应用封装：

{
  "code": 0,
  "message": "",
  "data": {
    "profile": {
      "partnerId": "partner-example",
      "slug": "partner-example",
      "displayName": "Example Partner Marketplace",
      "description": "A public marketplace description.",
      "supportEmail": "[email protected]",
      "telegram": "@example",
      "discord": "example",
      "whatsapp": "",
      "wechat": "",
      "seoTitle": "Example Partner Marketplace",
      "seoDescription": "Search result description.",
      "status": "published"
    },
    "models": [
      {
        "partnerId": "partner-example",
        "publicModel": "deepseek-v4-flash",
        "provider": "Neolink",
        "providerKind": "third_party",
        "currency": "USD",
        "billingType": "usage_flat",
        "billingUnit": "token",
        "actualPromptMicroUsd": 129917,
        "actualCompletionMicroUsd": 259832,
        "contextWindowTokens": 1000000,
        "enabled": true
      }
    ]
  }
}

字段说明

构建自己的页面

使用 profile 构建页面标题、SEO 元数据、联系链接和市场状态。使用 models 构建模型卡片、价格表和路由元数据。过滤掉 enabled 不为 true 的模型；当存在 pricingTiers 时显示它，以确保图像、视频和分层 token 模型保留其公开定价详情。

Partner 常见问题

什么是 Partner Program？

Partner Program 让您可以创建由 OpenModels 驱动的公开市场。您可以选择要列出的模型、通过加价设置市场价格、发布店面，并跟踪归属于您的 Partner ID 的用量。

这与成为 Provider 相同吗？

不同。Partner Program 用于在现有 OpenModels 路由之上运营市场店面。Provider 入驻则用于将您自己的上游模型列入 OpenModels。

如果您想在自己的市场中打包现有 OpenModels 路由，请使用 Partner Program。如果您运营模型基础设施或上游网关，并希望 OpenModels 将流量路由到它，请使用 Provider Integration。

Partner ID 有什么用途？

Partner ID 是市场的归因标识符。它用于公开 URL 和关联合作伙伴的用量跟踪，因此在需要分享或验证市场归因时请准确复制。

发布前需要添加模型吗？

需要。用户通过店面浏览模型并请求 API 访问前，市场应当已有启用的模型。请从 Models 添加模型、选择供应商路由、设置加价，并在发布前确认最终价格。

如何设置市场定价？

在 Partner 工作区中为每个已列出的模型配置价格。对于公开页面，请展示 Partner API 返回的最终市场价格字段。

我需要合作伙伴套餐吗？

需要。设置清单中在发布前包含 Plan。请选择符合所需模型上限和市场控制项的套餐。

可以在发布前预览吗？

可以。使用 Preview 通过实时 Partner 资料和模型路由查看店面。使用 Open preview 打开单独的公开预览标签页，然后只在页面、模型列表、定价和 SEO 设置准备好后发布。

在哪里跟踪合作伙伴用量？

使用 用量 查看归因请求、模型、供应商、token 用量、佣金率和佣金金额。这是确认流量是否绑定到预期 Partner ID 的最佳位置。

在哪里管理结算？

使用 Partner 工作区中的 Payouts 执行结算相关操作。概览和用量页面会显示预估结算和佣金信号，但结算管理应在专用的 Payouts 页面进行。

发布后可以更改 SEO 吗？

可以。您可以通过 SEO 更新页面标题、slug 和元描述。更改 SEO 后请重新检查预览，因为 slug 控制公开市场的 URL 路径。