智谱清影API接入需四步：一、在智谱开放平台实名认证后单独申请带“图像生成”权限的API Key；二、调用专用地址https://open.bigmodel.cn/api/paas/v4/image/generations；三、请求体含model、prompt等必填字段；四、推荐用zhipuai SDK≥2.2.0调用images.generations方法。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜如果您希望将智谱清影的API接口集成到自有系统中，但尚未完成基础接入配置，则可能是由于未正确获取凭证、未选择对应模型或未构造合规请求体。以下是完成接入的具体步骤：
一、获取智谱清影专用API Key
智谱清影（ZhiPu Image）属于智谱AI平台下的文生图服务模块，需在智谱开放平台单独启用并获取具备图像生成权限的API Key。该Key与文本模型Key隔离，不可混用。
1、访问智谱AI开放平台官网：
https://www.bigmodel.cn/，完成实名认证（个人身份证或企业营业执照）。
2、登录后点击右上角用户头像，进入“
用户中心 → 项目管理 → API Keys”页面。
3、点击“
添加新的API Key”，在“应用名称”栏填写“智谱清影-生产环境”等可识别名称，勾选“图像生成（ZhiPu Image）
”权限范围，确认创建。
4、复制生成的API Key，该Key仅显示一次，请立即保存；若丢失需重新创建，旧Key自动失效。
二、确认并调用智谱清影API地址与模型标识
智谱清影使用独立于文本模型的RESTful端点，必须使用指定URL及模型名称，否则返回404或模型不支持错误。
1、API基础地址为：
https://open.bigmodel.cn/api/paas/v4/image/generations（注意路径含image/generations）。
2、支持的模型名称包括：
glm-4v-flash（轻量图文理解）、glm-4v（标准多模态）、zhipu-image-stable（稳定图像生成专用模型），请根据文档实时列表选择：https://www.bigmodel.cn/pricing#image。
3、在HTTP请求头中必须包含：
Authorization: Bearer YOUR_API_KEY，且Content-Type设为application/json。
三、构造符合规范的请求体（JSON格式）
智谱清影要求请求体严格遵循字段命名、类型与嵌套结构，任意字段缺失或格式错误将导致400响应。
1、必需字段
model：填入已确认支持图像生成的模型名，例如"glm-4v-flash"。
2、必需字段
prompt：字符串类型，描述图像内容，长度限制512字符，禁止HTML标签与控制字符。
3、可选字段
size：取值为"1024x1024"、"768x1024"或"1024x768"，不填默认为"1024x1024"。
4、可选字段
n：整数，表示生成图片数量，取值1–4，不填默认为1。
5、示例完整JSON体：
{"model":"glm-4v-flash","prompt":"一只蓝猫坐在窗台看雪，写实风格","size":"1024x1024","n":1}
四、使用Python SDK方式接入（推荐）
官方zhipuai SDK自2.2.0版本起支持图像生成接口，可自动处理鉴权、重试与流式响应解析，降低出错概率。
1、升级SDK至最新版：
pip install zhipuai --upgrade，确保版本≥2.2.0（执行zhipuai.__version__验证）。
2、安装依赖：
pip install requests（部分环境需显式安装）。
3、初始化客户端：
from zhipuai import ZhipuAIclient = ZhipuAI(api_key="your_api_key_here")
4、调用图像生成方法：
response = client.images.generations(model="glm-4v-flash", prompt="赛博朋克风城市夜景")
5、提取结果URL：
image_url = response.data[0].url（返回为JSON对象，含data数组）。
五、通过原生HTTP请求接入（兼容所有语言）
适用于Java、Go、Node.js等非Python环境，需手动构造HTTPS POST请求，对签名与编码无额外要求，但必须校验SSL证书有效性。
1、使用curl测试接入连通性：
curl -X POST "https://open.bigmodel.cn/api/paas/v4/image/generations" \-H "Authorization: Bearer YOUR_API_KEY" \-H "Content-Type: application/json" \-d '{"model":"glm-4v-flash","prompt":"山水画风格的竹林小径"}'
2、在Java中使用OkHttp时，设置
RequestBody.create为JSON MediaType，并启用HttpsURLConnection.setDefaultHostnameVerifier（若内网调试需跳过证书校验，生产环境严禁）。
3、Node.js中使用
axios时，确保httpsAgent配置为默认TLS选项，避免因CA证书缺失导致连接拒绝。