1、通过天宫AI开发者平台注册并创建项目获取API Key和Secret Key，配置IP白名单以确保调用安全；2、调用文本接口需发送HTTPS POST请求至指定URL，携带认证头和JSON格式文本数据实现自然语言处理；3、语音功能通过multipart/form-data上传音频至转写接口或传入文本调用合成接口获取音频流；4、图像服务支持Base64或文件上传进行内容分析与生成，返回标签或图像链接；5、实时对话采用WebSocket连接，发送认证令牌和会话信息实现低延迟流式交互。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您希望将天宫AI的能力嵌入到自有系统或应用中，以实现智能化的交互与数据处理，可以通过调用其开放的API接口完成集成。以下是具体的调用方法和开发步骤：
一、获取API访问密钥
在调用天宫AI开放接口前，必须先完成身份认证配置。通过官方开发者平台注册账号并创建项目后，系统将生成唯一的API Key和Secret Key，用于后续请求的身份验证。
1、登录天宫AI开发者控制台，进入“项目管理”页面。
2、点击“新建项目”，填写项目名称与用途说明。
3、项目创建成功后，系统自动分配API Key和Secret Key，请妥善保存。
4、在安全设置中启用IP白名单功能，限制调用来源以增强安全性。
二、接入基础文本处理接口
该接口支持自然语言理解、文本生成、情感分析等功能，适用于聊天机器人、内容审核等场景。调用时需使用HTTPS协议，并携带有效的认证签名。
1、构造请求URL：https://api.tiangong.ai/v1/text/generate。
2、设置请求头（Headers），包含Content-Type为application/json及Authorization字段。
3、在请求体（Body）中传入文本输入内容，例如{"text": "你好，今天天气怎么样？", "model": "large"}。
4、发送POST请求并解析返回的JSON格式响应结果。
三、集成语音识别与合成接口
此接口允许上传音频文件进行语音转文字，或将文本转换为自然语音输出。适用于智能客服、语音助手等应用场景。
1、访问语音识别接口地址：https://api.tiangong.ai/v1/audio/transcribe，采用multipart/form-data方式提交音频文件。
2、在请求参数中指定音频编码格式（如PCM、MP3）和语言类型（如zh-CN）。
3、对于文本转语音功能，调用合成接口并传入待朗读文本及音色选项。
4、接收服务器返回的音频下载链接或直接流式播放结果。
四、对接图像理解与生成服务
通过该接口可实现图像内容识别、标签提取、视觉问答以及基于提示词生成图像的功能。适合用于内容推荐、智能编辑等领域。
1、调用图像理解接口时，需将图片以Base64编码或文件形式上传至https://api.tiangong.ai/v1/image/analyze。
2、在请求中定义分析任务类型，如"captioning"、"classification"或"vqa"。
3、若使用图像生成功能，向https://api.tiangong.ai/v1/image/generate发送包含描述语句的请求体。
4、等待模型处理完成后，获取生成图像的临时访问URL。
五、实现实时对话流式通信
为了支持低延迟的连续对话体验，天宫AI提供基于WebSocket的双向通信通道，可用于构建实时交互式应用。
1、建立连接至wss://api.tiangong.ai/v1/chat/stream，并在握手阶段附带认证令牌。
2、客户端发送包含会话上下文的消息帧，包括用户输入和历史记录标识符。
3、服务端通过同一连接逐步返回部分响应，实现逐字输出效果。
4、维持心跳机制防止连接中断，建议每30秒发送一次ping消息。
