概览
开普勒AI算力服务平台模型体系涵盖文本、语音、视频、图像与音乐五大方向。旗舰模型性能领先，助力开发者高效构建智能应用。
快速开始（3 分钟）
- 注册并登录账号
进入平台后先完成登录，未登录状态下无法创建 API Key，也无法提交任务。 - 创建 API Key
前往「API 密钥」点击创建，建议按用途命名（如：前端测试、生产服务），并按需要设置过期时间。 - 充值积分
平台按积分计费，提交任务前请确保余额充足。若余额不足，可在积分中心或弹出的收银台中充值。 - 开始调用接口
按各接口文档通过 API 接入业务系统，发起图片或视频等任务。
使用接口前请在「API 密钥」中创建密钥，并在请求头中携带 Authorization: Bearer <您的API_KEY>。
Base URL
请使用以下地址作为 API 请求的 Base URL，不要带末尾斜杠。
地址：https://amags.keplerjai.com
完整请求 URL = 地址 + 路径。路径以 /v1 开头，例如 /v1/images/generations、/v1/tasks/:id。即：图像生成为 POST https://amags.keplerjai.com/v1/images/generations，任务查询为 GET https://amags.keplerjai.com/v1/tasks/:id。下文与各接口文档中的示例均使用该地址。
通用约定
开放 API 使用 API Key 作为 Bearer Token，所有接口路径以 /v1 为前缀。异步任务类接口（如图片、视频生成）提交后返回 task_id，需通过 任务查询接口 轮询状态并获取结果链接。更多说明见 公共参数 与各接口文档。
请求头
- Authorization 必填，
Bearer <API_KEY>，API Key 在「API 密钥」中创建后获得 - Content-Typeapplication/json（POST/PUT 等带 body 的请求）
- Idempotency-Key选填，创建类请求建议携带唯一字符串（如 UUID），用于防止重复提交
统一响应格式
接口返回 JSON，顶层包含 resultCode、resultMsg。成功时 resultCode 为 OK，业务数据与 resultCode/resultMsg 同级（如 task_id、task）；失败时 resultCode 非 OK，resultMsg 为错误说明。
任务查询
GET /v1/tasks/:id，路径参数 id 为创建任务返回的 task_id。响应中 task.status 为 succeeded 时 task.resultUrl 即为结果文件地址；failed 表示任务失败；queued/running 需继续轮询。
接入建议
- 区分测试与生产 API Key，定期轮换，避免长期暴露。
- 服务端统一处理 401/登录过期，及时引导用户重新登录。
- 提交任务前检查积分余额，余额不足时引导充值，减少失败请求。
- 为关键接口增加超时与重试策略，避免网络抖动导致业务中断。