智谱清影的API接口怎么接入自己的系统?

陌静君_9265

陌静君_9265

2026-05-18

1492人浏览

原创

智谱清影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接口集成到自有系统中,但尚未完成基础接入配置,则可能是由于未正确获取凭证、未选择对应模型或未构造合规请求体。以下是完成接入的具体步骤:

一、获取智谱清影专用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标签与控制字符。

Exa AI
Exa AI

Exa AI是一款AI图像与设计工具,专门为AI模型设计的搜索引擎平台。

下载

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 ZhipuAI
client = 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证书缺失导致连接拒绝。

大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

智谱清影

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Linux 新手先学哪些命令
Linux 新手先学哪些命令

Linux新手命令专题汇集终端基础、文件目录操作、文本查看、软件安装和权限管理等入门文章,帮助按实际任务练习常用命令并建立命令行操作习惯。

2026.10.15

0

20

MySQL 忘记密码怎么办
MySQL 忘记密码怎么办

MySQL忘记密码专题汇集不同版本与系统下的root密码重置方法,覆盖MySQL 5.7、8.0、Mac、Linux及本地集成环境,并提示恢复权限与重新登录的检查步骤。

2026.10.15

0

18

Vue.js 中 ref 和 reactive 的区别
Vue.js 中 ref 和 reactive 的区别

Vue.js中ref和reactive的区别专题汇集两种响应式API的定义、访问方式、对象解构、侦听与性能取舍等文章,帮助结合实际状态类型选择合适写法。

2026.10.15

0

20

VS Code 怎么配置开发环境
VS Code 怎么配置开发环境

VS Code开发环境专题汇集编辑器安装、语言扩展、编译器、解释器、终端和调试配置文章,覆盖Java、Python、C++和PHP等常见语言的入门设置。

2026.10.15

0

18

C++ 开发环境怎么搭建
C++ 开发环境怎么搭建

C++开发环境专题汇集Windows、Linux下的编译器与IDE安装配置教程,涵盖GCC、Clang、Visual Studio、CLion和VS Code,以及编译运行首个程序的步骤。

2026.10.15

0

19

Python 虚拟环境是什么
Python 虚拟环境是什么

Python虚拟环境专题介绍项目依赖隔离的作用,汇集venv与uv创建、激活、退出及解释器切换的相关文章,并覆盖Windows、Linux和VS Code中的常见配置问题。

2026.10.15

0

15

Python 怎么安装并配置环境变量
Python 怎么安装并配置环境变量

Python安装与环境变量配置专题汇集Windows、macOS和Linux的安装步骤、PATH设置、pip配置及常见报错排查文章,帮助完成解释器安装并验证命令行可以正常运行。

2026.10.15

0

15

PHP 连接 MySQL 失败怎么办
PHP 连接 MySQL 失败怎么办

PHP连接MySQL失败专题汇集PDO与MySQLi扩展配置、账号权限、主机端口、套接字和认证方式等排查文章,覆盖连接报错、密码变更与容器环境配置,帮助按错误提示定位原因并修复。

2026.10.15

0

18

PHP 表单提交后如何获取数据
PHP 表单提交后如何获取数据

PHP表单提交后如何获取数据专题汇集HTML表单提交、GET与POST接收、$_POST和$_GET读取、跨文件传值、单选与下拉字段获取,以及空值和接收失败排查等文章,帮助新手完成从提交到处理的完整流程。

2026.10.15

0

20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
智谱AI开放平台手册
智谱AI开放平台手册

共0课时 | 0人学习