智谱AI 提供标准的 HTTP API 接口，支持多种编程语言和开发环境，让您可以轻松集成智谱AI的强大能力。

​
什么是 HTTP API

HTTP API 是智谱AI提供的基于 RESTful 架构的应用程序接口，通过标准的 HTTP 协议与智谱AI的模型服务进行交互。无论您使用什么编程语言或开发框架，都可以通过 HTTP 请求来调用智谱AI的各种AI模型。

​
核心优势

跨平台兼容

支持所有支持HTTP协议的编程语言和平台

标准协议

基于RESTful设计，遵循HTTP标准，易于理解和使用

灵活集成

可以集成到任何现有的应用程序和系统中

实时调用

支持同步和异步调用，满足不同场景需求

​
获取 API Key

  1. 访问 智谱AI开放平台
  2. 注册并登录您的账户
  3. 在控制台中创建 API Key
  4. 复制您的 API Key 以供使用

​
API 基础信息

​
请求地址

https://open.bigmodel.cn/api/paas/v4/

​
请求头要求

Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

​
支持的鉴权方式

最简单的鉴权方式，直接使用您的 API Key：
curl --location 'https://open.bigmodel.cn/api/paas/v4/chat/completions' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "glm-4.5",
"messages": [
{
"role": "user",
"content": "你好"
}
]
}'

​
基础调用示例

​
简单对话

curl --location 'https://open.bigmodel.cn/api/paas/v4/chat/completions' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "model": "glm-4.5",
    "messages": [
        {
            "role": "user",
            "content": "请介绍一下人工智能的发展历程"
        }
    ],
    "temperature": 0.7,
    "max_tokens": 1000
}'

​
流式响应

curl --location 'https://open.bigmodel.cn/api/paas/v4/chat/completions' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "model": "glm-4.5",
    "messages": [
        {
            "role": "user",
            "content": "写一首关于春天的诗"
        }
    ],
    "stream": true
}'

​
多轮对话

curl --location 'https://open.bigmodel.cn/api/paas/v4/chat/completions' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "model": "glm-4.5",
    "messages": [
        {
            "role": "system",
            "content": "你是一个专业的编程助手"
        },
        {
            "role": "user",
            "content": "什么是递归？"
        },
        {
            "role": "assistant",
            "content": "递归是一种编程技术，函数调用自身来解决问题..."
        },
        {
            "role": "user",
            "content": "能给我一个Python递归的例子吗？"
        }
    ]
}'

​
常用编程语言示例

import requests
import json

def call_zhipu_api(messages, model="glm-4.5"):
url = "https://open.bigmodel.cn/api/paas/v4/chat/completions"

headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
}

data = {
"model": model,
"messages": messages,
"temperature": 0.7
}

response = requests.post(url, headers=headers, json=data)

if response.status_code == 200:
return response.json()
else:
raise Exception(f"API调用失败: {response.status_code}, {response.text}")

# 使用示例
messages = [
{"role": "user", "content": "你好，请介绍一下自己"}
]

result = call_zhipu_api(messages)
print(result['choices'][0]['message']['content'])

​
错误处理

​
常见错误码

错误码说明解决方案
401未授权检查API Key是否正确
429请求过于频繁降低请求频率，实施重试机制
500服务器内部错误稍后重试，如持续出现请联系支持
更多错误码和解决方案请参考 API 错误码文档

​
实践建议

安全性

  • 妥善保管API Key，不要在代码中硬编码
  • 使用环境变量或配置文件存储敏感信息
  • 定期轮换API Key

性能优化

  • 实施连接池和会话复用
  • 合理设置超时时间
  • 使用异步请求处理高并发场景

错误处理

  • 实施指数退避重试机制
  • 记录详细的错误日志
  • 设置合理的超时和重试次数

监控

  • 监控API调用频率和成功率
  • 跟踪响应时间和错误率
  • 设置告警机制

​
获取帮助

API 文档

查看完整的API接口文档和参数说明

技术支持

获取技术支持和帮助
建议在生产环境中使用HTTPS协议，并实施适当的安全措施来保护您的API密钥和数据传输。