模型 API
开始调用模型
使用 API Key 从服务端接入模型能力。
选择你的接入方式
外部程序使用 API Key 调用模型。托管在应用中心的应用应使用用户运行会话，不收集用户 Key，也不用开发者的 Key 为所有用户代付。
第一次接入，依次阅读 创建 API Key → 完成首个调用 → 处理失败和重试。
图片、视频和音频调用请直接使用 API Key 异步媒体完整调用：它明确了创建、鉴权查询、鉴权下载和 Web 后端转存的完整链路。
| 你想实现什么 | 调用指南 |
|---|---|
| 对话、视觉理解、图像续写 | 文本与视觉 |
| 搜索向量、相关性排序 | 向量与重排 |
| 提取文字、解析文档 | OCR 与文档解析 |
| 生成图片、参考图创作 | 图片生成 |
| 生成视频、首尾帧、全能参考 | MiniMax H3 |
| 角色动画与角色替换 | Wan Animate |
| 普通视频、参考视频、口型同步与超分 | 其他视频能力 |
| 语音、音效、转写 | 音频 |
| 在生成前优化提示词 | 提示词优化 |
接口参考提供请求字段、响应结构和错误定义；当前服务支持的合法规格以模型详情为准。
准备调用凭证
在平台的 API Key 页面创建凭证，并仅保存在服务端环境变量中。完整密钥仅在创建成功时显示一次，刷新或关闭后不能找回。
确认服务入口
从模型详情的 API 接入区域复制当前服务的公开 Base URL 和模型别名。JUSP_BASE_URL 包含末尾的 /v1，不要追加第二个 /v1。
export JUSP_BASE_URL='https://你的服务入口/v1'
export JUSP_API_KEY='<API_KEY>'
curl --fail-with-body "$JUSP_BASE_URL/models" \
-H "Authorization: Bearer $JUSP_API_KEY"模型发现请求用于检查授权范围，不会创建生成任务。不要将 Key 写入网页源码、公开仓库或截图。
生成并取得结果
文本调用可以同步返回。图片、视频等媒体任务需要先提交，再根据返回的任务地址查询终态，最后读取输出资源。请求被接受不代表生成已完成。
常见失败
| 现象 | 下一步 |
|---|---|
| 凭证被拒绝 | 检查密钥是否完整、有效，且覆盖当前服务。 |
| 请求受限 | 按接口返回的重试建议等待，不连续重复提交。 |
| 提交超时 | 先确认任务是否已经受理，不盲目新建生成任务。 |