模型 API
发现模型与可用能力
查询 Key 可调用的模型别名、实时规格和可选优化能力，不把服务名称或示例参数写死。
先设置 快速开始 中的环境变量。服务发现是只读操作，不生成内容；它确认的是当前身份能看到的服务，不保证稍后的生成一定通过准入。
查询服务
curl --fail-with-body --max-time 30 "$JUSP_BASE_URL/services" \
-H "Authorization: Bearer $JUSP_API_KEY" --output services.json
jq '.data[] | {modelAlias, serviceDisplayName, serviceKind, available, endpoints, mediaSpecContract, apiUsageContract, promptOptimization}' services.json| 字段 | 怎么使用 |
|---|---|
modelAlias | 后续请求的 model，不是内部服务 ID |
serviceDisplayName | 展示给用户的服务名称，不替代别名 |
serviceKind | 区分文本、图片、视频、音频等能力 |
available | 当前可调用性；字段缺失不等于可用，提交前仍会进行实际准入 |
endpoints | 当前服务公开支持的操作入口 |
mediaSpecContract | 当前生成模式、输入素材、合法规格与大小限制 |
apiUsageContract | 当前服务的参数说明和调用示例 |
promptOptimization | 是否开放优化、支持模式及参考素材约束；缺失时不自行假设支持 |
简化的模型目录见 GET /models；精确字段见 GET /services。保留响应中不认识的扩展字段，不据此拼装内部地址。
如何选择参数
- 在返回集合中找到目标公开别名，核对能力类别与可调用性。
- 从该服务当前合同选择模式，再按模式要求上传素材。
- 仅选该模式接受的输入、清晰度、画幅、数量或时长；不生成所有选项的笛卡尔积。
- 使用
apiUsageContract与对应教程形成请求；公共 OpenAPI 的字段全集不表示每个模型都接受全部字段。
例如 Wan 角色动画不需要提示词，视频超分不接受任意时长，H3 四模式的素材要求不同。见 选择视频能力。
目录变化与失败恢复
服务会下架、更新规格或变为暂不可用；可以短期缓存发现结果，但不能将它当作永久授权。收到规格不匹配时重新发现并让用户确认新选择，不能自动切换模型或提高付费规格。401/403 先处理凭据或范围；空列表先核对 Key 的授权服务，不据此断言平台没有模型。