必须准确配置HTTP节点、鉴权方式与数据格式：一、用灵珠HTTP节点调用第三方API；二、用SDK调用智能体API；三、SSE接入私有大模型；四、调用内置工具节点免代码编排。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在开发基于Rokid灵珠AI平台的应用时，需通过API接口调用智能体能力或集成外部服务，则必须准确配置HTTP节点、鉴权方式与数据格式。以下是实现API接口调用与开发集成的具体方法：
一、通过灵珠平台HTTP节点调用12306等第三方API
灵珠平台内置HTTP节点支持标准RESTful请求，可用于安全调用受控的外部API（如12306模拟环境），避免客户端直连带来的风控与跨域问题。该方式将API调用逻辑托管至云端，由灵珠统一管理请求头、参数拼接与错误重试策略。
1、在灵珠平台工作流编辑器中，拖入“HTTP”节点；
2、在节点配置中选择请求方法（GET/POST），填写目标URL（例如https://12306-api.mock.dev/query）；
3、于“Headers”区域添加Authorization: Bearer {your_api_key}，其中密钥需提前在灵珠平台“凭证管理”中绑定；
4、在“Body”中选择JSON格式，输入动态参数，例如：{"date":"2026-02-18","from":"BJP","to":"HGH"}；
5、勾选“启用响应解析”，并将返回字段（如data.trains）映射为后续节点可用变量。
二、使用灵珠生成的智能体API供Android端SDK调用
发布后的智能体将生成专属HTTPS API端点及Token，Android应用可通过Rokid CXR-S SDK中的RokidAgentClient类发起调用，实现眼镜端与云端智能体的低延迟交互。该路径适用于语音指令触发、图片上传、结构化结果回传等典型多模态场景。
1、在灵珠平台完成智能体调试并点击“发布”，获取API地址（形如https://api.rizon.rokid.com/v1/agents/{agent_id}/chat）；
2、进入“凭证管理”，创建新Token，记录Access Key ID与Secret Access Key；
3、在Android Studio项目中，初始化客户端：RokidAgentClient client = new RokidAgentClient("your_agent_id", "your_access_key_id", "your_secret_access_key");；
4、构建消息对象，调用client.sendMessage()，传入文本或base64编码的图片字节数组；
5、监听onSuccess()回调，解析返回JSON中的output.text或output.image_url字段用于UI渲染。
三、自定义SSE流式API接入私有大模型
灵珠平台支持通过SSE（Server-Sent Events）协议接入开发者私有部署的大模型服务，适用于需要完全控制推理过程、模型权重或数据不出域的高合规要求场景。接入后，灵珠将把用户输入经标准化封装后推送至指定SSE端点，并按约定格式接收分块响应。
1、确保私有服务已部署SSE接口，响应Content-Type为text/event-stream，每条数据以data:开头并以\n\n结尾；
2、在灵珠平台“智能体设置→模型能力→自定义模型”中，填入SSE服务地址（如https://my-model.internal/sse）；
3、配置请求头，至少包含Authorization: Bearer {internal_token}与X-Rokid-Request-ID；
4、在“入参映射”中声明如何将用户消息、图片base64、上下文历史组装为SSE POST body；
5、在“响应解析”中指定data:字段内JSON结构的提取路径，例如choices.0.message.content。
四、在工作流中调用灵珠内置工具节点实现免代码API编排
灵珠提供预置工具节点（如“日期解析”“地理位置编码”“文本摘要”），无需编写代码即可在可视化工作流中串联调用。这些节点本质是封装好的内部API，可直接作为原子能力嵌入复杂逻辑，显著降低多步骤数据处理的开发成本。
1、在工作流画布中点击“+添加节点”，选择“工具”分类下的对应功能（如“高德地图地理编码”）；
2、在节点配置面板中输入参数字段名，例如将用户说的“杭州西溪湿地”映射至address输入项；
3、启用“自动重试”，设置失败时最多调用3次，间隔1秒；
4、连接该节点输出至下一个“条件判断”节点，依据返回的status字段值（如1表示成功）分流执行；
5、将地理编码返回的location.lng与location.lat作为变量，传入后续HTTP节点请求天气API。
