2025年12月12日
可用的魔搭API完整获取过程!
Z-Image网站上的魔搭API接口配额根本不够用,每天早上,起床测试就发现已经被大家用完了。
我就想着再去搞一个账号,补充一下。
注册的时候顺带给大家分享一个如何获取魔搭API。 本身是很简单的。但是魔搭API不光是复制了就能用,而是需要绑定阿里云,并且完成认证才可以!
首先打开魔搭:
https://www.modelscope.cn/
开始登录或者注册。

这里有好几种方式,可以用github等授权登录,也可以单独注册 。国内账号也可以直接用手机验证码登录。
然后设置一下自己的ID。

注册成功之后 ,点击右上角的头像。打开下拉菜单。

找到菜单“绑定阿里云账号” 然后点击下面的立即绑定。
然后就会跳转到阿里云平台。如果你之前已经注册并登录了,就直接进入授权页面。

勾选,点击授权就可以了。
如果没有注册或,或者没有登录过,可以先注册然后登录。国内平台注册登录都非常方便,没有任何难度。
然后也是找到右上角的头像。
点击账号。

进入到这里个人实名信息。进行个人认证。

认证完成之后 ,就万事俱备了。
这个时候在回到魔搭,点击访问令牌。

然后复制这个令牌就可以了。
也可以新建一个临时用的密钥,这样会安全一些。
其实不论用哪种都问题不大,因为默认不是付费的账号,配额用完了最多没法用。密钥泄露了删掉就可以了。
有了这个密钥之后,就可以接入各种软件了。或者自己基于这个密钥调用魔搭的模型。
我们主要是用来生成Z-Image的图片。
有了密钥之后,就直接可以添加到Web版本或者桌面版了。
Web版地址:https://tools.tonyhub.xyz/zimage
如果有兴趣从源代码开始配置,可以参考:
配置完出现了错误码,可以参考这个文档:
| 错误码 | 含义 | 说明 |
|---|---|---|
| 200 OK | 请求成功 | 返回正常的图像数据 / URL |
| 400 Bad Request | 请求参数错误 | 通常是参数格式、必选字段缺失等问题 |
| 401 Unauthorized | 未授权 | token 不正确 / 过期 / 权限不足 |
| 403 Forbidden | 禁止访问 | 令牌权限问题,阿里云关联认证 |
| 404 Not Found | 资源不存在 | 模型 ID/版本/路由错误,找不到服务端资源 |
| 408 Request Timeout | 请求超时 | 网络抖动或模型推理超时 |
| 429 Too Many Requests | 调用过于频繁 | 被限流,需要控制频率,配额上限 |
| 500 Internal Server Error | 服务器内部错误 | 服务端出错 |
| 503 Service Unavailable | 服务不可用 | 临时性故障或资源调度失败 |
没找到官方地址,汇总了一下网络文章,大概准确。