智普清言api postman

### 如何调用智普清言 API #### 调用概述 智普清言 API 提供了一种通过 HTTP 请求的方式与模型交互的方法。开发者可以通过发送 POST 请求来实现对话功能，请求体中需包含 `api_key` 和其他必要参数[^1]。 #### 参数说明 以下是调用过程中可能涉及的关键参数及其作用： - **api_key**: 用户的身份验证密钥，用于确认访问权限。 - **timestamp**: 时间戳，通常表示当前时间的毫秒数，防止重放攻击。 - **exp**: 过期时间，定义该请求的有效期限（单位为毫秒），超过此时间则请求失效[^4]。 #### Python 实现示例 以下是一个基于 Python 的简单调用示例： ```python import requests import json from datetime import datetime if __name__ == "__main__": url = "https://open.bigmodel.cn/api/v1/chat" api_key = "your_api_key_here" # 替换为实际的API Key headers = { 'Content-Type': 'application/json' } timestamp = int(datetime.now().timestamp() * 1000) # 当前时间的时间戳 exp = timestamp + (5 * 60 * 1000) # 设置过期时间为5分钟后 data = { "api_key": api_key, "timestamp": timestamp, "exp": exp, "query": "你好，介绍一下你自己吧", "persona": "你是Python编程工作者。", } response = requests.post(url, headers=headers, data=json.dumps(data)) result = response.json() print(result["answer"]) ``` 上述代码展示了如何构建并发送一个标准的 POST 请求到智普清言 API 接口，并获取返回的结果[^2]。 #### Java 实现示例 对于使用 Java 开发的应用程序，可以参考如下代码片段完成 API 调用操作： ```java import java.io.OutputStream; import java.net.HttpURLConnection; import java.net.URL; public class ZhiPuAPICaller { public static void main(String[] args) throws Exception { String apiUrl = "https://open.bigmodel.cn/api/v1/chat"; URL url = new URL(apiUrl); HttpURLConnection conn = (HttpURLConnection) url.openConnection(); conn.setRequestMethod("POST"); conn.setDoOutput(true); long timestamp = System.currentTimeMillis(); // 获取当前时间戳 long expirationTime = timestamp + (5L * 60L * 1000L); // 设定有效时长 String apiKey = "your_api_key"; // 替换为您的真实API Key String inputJson = "{ \"api_key\": \"" + apiKey + "\",\"timestamp\":" + timestamp + ",\"exp\":" + expirationTime + ",\"query\":\"你好\",\"persona\":\"你是Java开发工程师.\"}"; try(OutputStream os = conn.getOutputStream()) { byte[] input = inputJson.getBytes("utf-8"); os.write(input, 0, input.length); } int code = conn.getResponseCode(); if(code == 200){ System.out.println("成功接收服务器响应！"); }else{ System.err.println("错误：" + code); } } } ``` 以上代码实现了向智普清言 API 发送数据包的功能，并处理了基本的成功与否判断逻辑[^3]。 #### 注意事项 在正式环境中部署之前，请务必确保已妥善保管好自己的 `api_key` 并遵循官方的安全建议以保护账户安全。

### 在 Unity 中集成和使用智普清言 API #### 集成准备 为了在 Unity 项目中集成并使用智普清言 API，需先获取 API 的访问凭证。这通常涉及注册开发者账号并申请特定应用的 API Key 和 Secret Key[^2]。 #### 设置 HTTP 请求库 Unity 自带 `UnityWebRequest` 类用于发起网络请求。对于更复杂的需求或更好的性能表现，可以考虑引入第三方库如 RestSharp 或者继续优化原生支持的功能[^1]。 #### 编写接口鉴权逻辑 根据官方文档说明，在每次向服务器发送数据之前都需要附加必要的认证参数以验证身份合法性。一般情况下会通过 Header 添加 Token 进行授权校验： ```csharp using UnityEngine; using System.Collections; public class ApiAuthenticator : MonoBehaviour { private string apiKey = "your_api_key_here"; private string secretKey = "your_secret_key_here"; public IEnumerator GetAccessToken() { using (var www = UnityWebRequest.Get("https://api.example.com/token")) { // Add headers or query parameters as required by the API documentation. www.SetRequestHeader("Authorization", $"Bearer {GenerateToken(apiKey, secretKey)}"); yield return www.SendWebRequest(); if (www.result != UnityWebRequest.Result.Success) { Debug.LogError($"Error getting access token: {www.error}"); } else { var accessToken = www.downloadHandler.text; // Handle response appropriately. Debug.Log("Access Token Received."); } } } private string GenerateToken(string key, string secret){ // Implement your own method to generate a valid token based on provided keys and secrets. throw new NotImplementedException(); } } ``` 此段代码展示了如何构建一个简单的协程来异步获取访问令牌，并将其应用于后续的所有请求之中。 #### 实现功能调用 一旦获得了有效的 Access Token 后，则可以根据实际业务场景编写相应的服务端交互方法。比如创建文件夹的操作可以通过 POST 方法传递 JSON 格式的命令给远程服务器处理: ```json { "action": "create_folder", "params": {"path":"/desired/path"} } ``` 再利用上述提到过的 Web Request 技术栈完成整个流程自动化操作。