开始接入

HPRT AI Platform 为产品提供版本化的 AI 图片处理 API。接入方通过已有 Atlas 登录态换取 平台会话，图片使用短期签名地址直接上传对象存储，耗时处理通过异步 Job 执行。

推荐阅读顺序

1. Getting Started：完成换票、上传、创建任务、 查询进度与取消的最短路径；
2. 中文接入指南：了解鉴权分级、幂等、状态机、 错误码和客户端恢复策略；
3. English Integration Guide：英文协议说明；
4. API Reference：查询公开接口的请求、响应和字段约束。

接入原则

• X-Client-App 用于应用路由与能力开关，不等同于用户身份；
• 公共能力目录不要求用户登录，用户私有资源必须携带平台 Bearer；
• 图片字节不经过业务 API，客户端按签名要求直接上传；
• 创建和交互请求必须使用稳定的 Idempotency-Key；
• 客户端根据稳定 error.code 分支，不解析或匹配展示文案；
• Job 查询接口始终是任务状态恢复的事实入口。

平台管理、生产部署、云资源、模型成本、内部监控、告警和运维接口不属于客户端契约，不在本站 发布。需要新增应用、环境或能力时，请联系平台管理员取得应用代码、API Base URL、Atlas realm 与已开放能力清单。