Skip to main content
咏唱引擎在公开模型库中托管设备原生模型包。你可以免认证浏览可用模型，但下载模型包需要 API 密钥或会话令牌。本指南将带你完成列出模型、选择量化等级并获取下载链接的全过程。

​
开始之前

  • 拥有一个咏唱引擎账户（任意区域）。
  • 在控制台创建 API 密钥，或登录以获取会话 JWT。
  • 所有示例的基础 URL 为 https://ariacompute.cn/api（中国站）。如果你使用国际站，请将主机替换为 ariacompute.com。
1

列出可用模型

调用公开模型接口，查看全部模型包及其支持的量化等级。
响应包含每个模型 slug、可用 quant 值（int4、int8、int326）以及 SDK 兼容性。挑选你需要的 slug 与量化等级。
2

创建或定位 API 密钥

打开控制台 API 密钥页面，然后点击 创建。复制以 bfvk- 开头的完整密钥，它仅展示一次。
API 密钥按站点隔离：在 ariacompute.com 创建的密钥无法在 ariacompute.cn 使用。
3

请求下载链接

默认情况下，下载接口返回 302 Found 重定向至一个短时效的 S3 预签名 URL。使用 -L 跟随重定向：
预签名 URL 很快过期。不要缓存或分发它们：每次下载都请求一个新的链接。
4

改为请求 JSON 元数据

如果你想要 URL 但不立即跟随它，发送 Accept: application/json 或附加 ?format=json。
使用 url 字段自行发起下载。filename 字段为建议的输出文件名。
5

目录下载（ZIP 流）

当模型包以目录形式存储时，接口会以 Content-Disposition: attachment 流式返回 ZIP 文件。直接保存：

​
你将获得什么

每个模型包至少包含：
  • weight.bin —— 量化后的权重
  • config.json —— 模型配置
  • 可选的 tokenizer 附属文件

​
可能遇到的错误

​
下一步