在鸿蒙（HarmonyOS）应用中接入盘古大模型云端 API，通常可以通过华为云 ModelArts Studio (MaaS) 平台来实现。以下是完整的接入流程与核心代码示例：

1. 获取 API 鉴权凭证

在调用云端大模型前，首先需要获取用于身份验证的凭证。根据业务场景，通常有两种鉴权方式：

• Token 认证：适用于应用内部直接调用。需参考华为云《API参考》文档获取 Token 值。
• API Key 认证：适用于将推理服务开放给其他用户调用。需在 ModelArts Studio 平台的“应用接入”中创建应用并获取 API Key（即 X-Apig-AppCode）。

2. 获取 API 请求地址

API 请求地址由“API接口域名”与“API访问路径（URI）”拼接而成。

• 获取域名：登录 ModelArts Studio 平台，在“模型开发 > 模型部署”页面，点击已部署且处于“运行中”状态的模型名称，在详情页获取 API 接口域名。
• 拼接 URI：例如文本补全接口的路径通常为 /generate，完整的请求地址示例为 https://{api-url}/generate。

3. 鸿蒙端 ArkTS 调用示例

在鸿蒙应用层，可以使用 @ohos.net.http 模块发起 POST 请求。以下是一个基础的云端 API 调用代码示例：

typescript

编辑

import { http } from '@ohos.net.http';

// 1. 创建 HTTP 请求对象
const httpReq = http.createHttp();

// 2. 发起 POST 请求
const resp = await httpReq.request('https://{您的API接口域名}/v1/infers/{您的服务ID}/generate', {
  method: http.RequestMethod.POST,
  header: { 
    'Content-Type': 'application/json',
    // 根据鉴权方式二选一填入：
    // 'X-Auth-Token': '您的Token值', 
    // 'X-Apig-Appcode': '您的API_Key值'
  },
  extraData: JSON.stringify({
    messages: [{ role: 'user', content: '你好，请介绍一下鸿蒙系统' }],
    temperature: 0.9,
    max_tokens: 600
  })
});

// 3. 处理返回结果
if (resp.responseCode === 200) {
  console.log('大模型返回结果:', resp.result);
}

4. 进阶：端云协同架构

对于鸿蒙原生应用，推荐采用端云协同（混合路由）方案以兼顾性能与数据安全：

• 端侧处理：对于敏感数据（如手机号脱敏）、短上下文或低延迟要求（< 300ms）的场景，可通过 @ohos.ai.pangu SDK 调用端侧盘古 Lite 模型，数据不出端。
• 云端处理：对于长上下文（> 8K）、高质量推理或复杂代码生成，自动路由至云端 API 处理。