From a09264086fe4a2f7d7b343524fd29fb0f963cceb Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=BA=A2=E8=96=AF?= Date: Fri, 25 Jul 2025 10:50:07 +0800 Subject: [PATCH] =?UTF-8?q?=E5=AE=8C=E5=96=84=E5=BA=94=E7=94=A8=E5=BC=80?= =?UTF-8?q?=E5=8F=91=E6=B5=81=E7=A8=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/appstore/intro.md | 103 ++++++++++++++++++++++++++++++++++++++++- 1 file changed, 101 insertions(+), 2 deletions(-) diff --git a/docs/appstore/intro.md b/docs/appstore/intro.md index 4a37531..02bc8d1 100644 --- a/docs/appstore/intro.md +++ b/docs/appstore/intro.md @@ -20,7 +20,7 @@ AI 应用市场是模力方舟打造的开放平台,旨在帮助开发者和 ![AI应用市场](/img/apps/app1.png) -### 为 AI 应用提供的价值 +## 为 AI 应用提供的价值
@@ -62,6 +62,105 @@ AI 应用市场是模力方舟打造的开放平台,旨在帮助开发者和
-### 支持多种应用形式 +## 支持多种应用形式 包括但不限于:桌面软件、移动 App、小程序、Web 应用等。我们鼓励开发者在多种平台上发布 AI 应用,以便触达更广泛的用户群体。 + +## 将应用集成到 AI 应用市场 + +AI 应用市场提供了简单易用的 API,帮助开发者快速将应用集成到平台。您可以通过以下步骤完成集成: + +### 1. 获取应用标识以及应用主令牌 + +在模力方舟的应用市场中,每个应用都需要应用标识 (appid) 和主令牌来调用应用市场相关 API。其中,应用标识在 [创建应用](./create-app) 后系统会自动分配;而主令牌是应用的唯一标识,您可以在 [令牌管理]({{SITE_URL}}/dashboard/settings/tokens) 中获取应用的令牌。 + +通过 appid 获取应用详情的示例代码: + +```python showLineNumbers title="Python" +import requests + +requests.get("https://ai.gitee.com/v1/app", + headers={ + "Authorization": "Bearer YOUR_APP_TOKEN_HERE" # 如果是公开的 APP 就不需要设置 Authorization + }, + params={ + "appid": "" + } +) +``` + +:::warning 注意 +为了令牌避免泄露导致的损失,该令牌只可调用应用市场相关的 API ,而不允许直接使用模型的 API。 +如果你需要为应用提供试用体验,可以单独创建一个令牌,使用该令牌来调用模型的 API。 +::: + +### 2. 使用身份认证 API + +任何一个应用程序要实现计费功能,都需要对用户进行身份认证,例如手机以及邮箱验证等等,特别是国内一般可以通过手机号码实现准实名身份验证。模力方舟的应用市场已经为您提供了身份认证 API ,支持通过手机验证码和邮箱验证码进行注册和登录。 + +模力方舟将为每个应用的用户分配一个子令牌,该令牌会关联到应用的主令牌,通过子令牌消耗的模型 API 的成本都会计入到应用的主令牌中,以实现用户对模型 API 调用的统一计费。应用开发者可以通过子令牌来管理用户的身份信息和使用情况。 + +可以通过以下方式使用身份认证 API: + +1. 完全依赖我们的身份认证 API 来实现用户的注册和登录功能,并获取子令牌 +2. 应用本身已有用户系统,可在这个基础上,使用身份认证 API 来同步用户的身份信息到模力方舟以获取子令牌 + +#### 获取验证码 + +```python showLineNumbers title="Python" +requests.post("https://ai.gitee.com/v1/app/auth/vcode", + headers={ + "Authorization": "Bearer YOUR_APP_TOKEN_HERE", + "Content-Type": "application/json" + }, + json={ + "appid": "", + "mobile": "", + "email": "", + "channel_type": "sms" + } +) +``` + +#### 获取用户子令牌(相当于用户的身份认证) + +```python showLineNumbers title="Python" +requests.post("https://ai.gitee.com/v1/app/auth/token", + headers={ + "Authorization": "Bearer YOUR_APP_TOKEN_HERE", + "Content-Type": "application/json" + }, + json={ + "appid": "", + "channel_type": "sms", + "mobile": "", + "email": "", + "code": "" # 验证码 + } +) +``` + +### 3. 使用应用计费 API + +应用在为用户获取到子令牌后,可以使用应用计费 API 来实现对用户的计费功能。通过该 API 可以实现对子令牌的付费、续费以及查询用户的使用情况等信息。 + +在使用计费 API 之前需要先 [设置收费策略](./price) 。目前应用市场支持支付宝和微信两种支付形式,使用计费 API 的示例代码如下: + +```python showLineNumbers title="Python" +requests.post("https://ai.gitee.com/v1/app/pay", + headers={ + "Authorization": "Bearer APP_USER_TOKEN_HERE", # 这里的 APP_USER_TOKEN_HERE 是用户的子令牌 + "Content-Type": "application/json" + }, + json={ + "plan_ident": "", # 收费策略的标识 + "quantity": 1, + "amount": 1, + "type": "wepay" + } +) +``` + +### 4. 使用模型 API + +应用集成完成后,您可以使用模型 API 来调用模力方舟提供的 AI 模型服务。通过模型 API,您可以实现文本生成、图像处理等多种 AI 功能。 -- Gitee