指南目录(34 篇)
魔搭
魔搭 ModelScope 免费 API 教程:每日领 250 魔粒与接入模型推理
魔搭社区每日登录送 200 魔粒,绑定阿里云账号后再加 50 魔粒(短期魔粒发放后 24 小时有效),可直接抵扣官方 API-Inference 在线推理。做好邮箱验证和阿里云实名绑定就能调用。
- 适用对象
- 想免费调用开源大模型做测试、脚本开发或轻量问答的开发者
- 预计用时
- 约 8 分钟
- 更新时间
准备
- 魔搭社区账号,已完成个人邮箱验证
- 已完成实名认证的阿里云账号(调用 API-Inference 必须绑定)
步骤
完成邮箱验证与阿里云绑定,领取当日魔粒
登录 魔搭社区,先在账号设置里完成个人邮箱验证,并绑定已实名认证的阿里云账号——没验证邮箱无法消费魔粒,没绑实名阿里云账号则调不通 API-Inference。
完成后点顶栏的「魔粒值」查看明细:每日登录发放 200 魔粒,已绑阿里云再额外发 50 魔粒。这两笔都属于短期魔粒,从发放时刻起 24 小时有效,哪天要用哪天打开一次网页即可;做完善资料或社区贡献获得的长期魔粒则有 90 天有效期。
复制访问令牌(Access Token)
打开 访问令牌页,复制用于 SDK 与 API-Inference 的访问令牌。在外部客户端里,这串令牌直接填在
API Key一栏。确认模型由「魔搭社区」提供在线推理并复制 ID
在模型库打开目标模型详情页,查看右侧是否有 API-Inference 面板,并将 API 提供方选为 「魔搭社区」,复制对应的模型 ID(例如
Qwen/...)。注意两点:模型支持下载权重不代表开了在线推理接口;如果在页面上切到了你自己绑定的外部平台密钥,调用扣的是外部平台额度而不是魔粒。
用 curl 测试并接入客户端
魔搭文本模型推理兼容 OpenAI 协议,Base URL 填
https://api-inference.modelscope.cn/v1。先跑下面这条命令测试连通性,通过后再填进 Cherry Studio、Cline 或 Magpie:curl https://api-inference.modelscope.cn/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer 你的魔搭访问令牌" \ -d '{ "model": "模型页复制的_Model_ID", "messages": [{"role": "user", "content": "你好"}] }'
注意事项
- 早年「每天固定 2,000 次免费调用」的规则已改为按魔粒扣减:轻量模型约 0.5 魔粒/次,主流模型约 1 魔粒/次,旗舰模型约 2 魔粒/次。
- 接入 Cline、OpenCode 等编程 Agent 时,需确认所选模型支持工具调用(Function / Tool Calling),否则只能普通问答、无法自动读写文件。
常见问题
账上有魔粒,为什么调接口还是报鉴权或权限错误?
检查两项前置条件是否漏做:一是个人设置里的邮箱是否已点验证链接,二是是否已绑定做完实名认证的阿里云账号。
前一天领的 250 魔粒第二天怎么消失了?
每日登录发放的短期魔粒从到账起算 24 小时过期,当天重新登录一次魔搭社区就会发放新一轮。
相关优惠
参考链接
- 魔搭魔粒体系公告www.modelscope.cn/posts/435591
- 魔粒说明文档modelscope.cn/docs/magicube/intro
- API-Inference 接入指南www.modelscope.cn/docs/model-service/API-Inference/intro