应用开发
开始开发平台应用
从本地验证到真实用户会话,选择正确的身份与工具。
选择 Python SDK 或 HTTP
Python 应用可使用 jusp-platform-sdk,导入名为 jusp_sdk。其他语言按应用 HTTP 协议接入;不要将外部模型 API Key 当作托管应用的用户身份。
沿着一条路径完成接入
- 在工作台创建应用,确认自己的
appKey、业务入口和组件。 - 使用 jusp app 为已有项目生成接入清单,不重新创建一套业务工程。
- Python 应用 安装 SDK 并 运行本地模拟;其他语言从 HTTP 接入 开始。
- 连接真实平台调试,检查成功、限流、会话过期和任务失败。
- 接入 用户会话,每次业务请求使用当前用户的身份。
- 上传镜像并提交版本,由工作台查看审核结果。提交不等于上线。
模型调用可能计费;本地模拟不计费,也不能证明线上模型质量。工作台及凭据操作需要已获授权的开发者身份,公开文档不授予操作权限。
按任务查阅
| 任务 | 指南 |
|---|---|
| 调用模型与优化提示词 | 应用模型调用 |
| 上传素材、生成、查询、下载 | 完整媒体链路 |
| 任务中断后恢复 | 创建和恢复媒体任务 |
| 异步 Web、连接池、错误处理 | 异步客户端 · 安全检查 |
| 组织目录、应用间调用 | 组织目录 · 应用间授权 |
| 对其他应用发布自己的业务 SDK | 业务 SDK 发布 |
| 查方法、字段和返回值 | Python 参考 · HTTP 参考 |
安装与本地模拟
开发工具通过平台受控入口发行,安装凭据与模型 API Key 不是同一种凭据。独立 CLI 包为 jusp-cli,命令入口为 jusp app。先在本地模拟模式验证,再进行可能产生费用的联网调用。
为每个用户建立运行会话
应用使用平台启动上下文换取运行会话,每次调用关联真实用户。处理会话过期和续期;不能用一个全局开发者凭据覆盖所有用户请求。
提交应用版本
完成本地与联网验证后,在开发者工作台完成镜像和版本提交。提交审核不是已经上线;按工作台展示的版本状态继续处理。