Skip to main content
本文将指导你完成从账号准备到发起首次 API 调用的完整流程。预计耗时 5 分钟。

前置条件

在开始之前,请确认已完成以下事项:
1

注册 imini 账号

访问 imini.ai 注册账号并完成邮箱验证。
2

充值积分

所有 API 调用以积分(credits)为计费单位,各模型的消耗规则详见 模型价格。请在 积分总览 完成充值后再发起调用。
3

创建 API Key

前往 API Keys 管理页,创建一个用于服务端调用的 API Key 并妥善保存。

接入地址

imini 开放平台所有接口共用同一基础地址:
下文示例中的相对路径(如 /v1/images/generate)均需拼接在此基础地址之后使用。

鉴权方式

所有请求均通过 HTTP Header 传递 API Key,采用 Bearer Token 标准:
API Key 安全:请仅在服务端使用 API Key。切勿将其提交至代码仓库、前端代码、移动端应用或其他可能被泄露的环境。若怀疑 Key 已泄露,请立即前往 API Keys 管理页 轮换。

异步任务模型

imini 所有生成类接口(图像、视频)均采用异步任务模型。一次完整的生成流程包含两步:
图像任务查询地址为 /v1/images/tasks/{task_id};视频任务查询地址为 /v1/videos/tasks/{task_id}。建议轮询间隔为 2 秒,图像任务通常在 10~30 秒内完成。

第一步:提交生成任务

以下示例使用 google/nano-banana 模型生成一张 1:1 图像:
成功响应示例(HTTP 200):

第二步:轮询任务结果

使用上一步返回的 task_id 轮询任务状态,直至 status 变为 succeededfailed
任务状态说明 成功响应示例status: succeeded):

错误处理

所有错误响应共享统一结构:
常见 HTTP 状态码
每个响应都包含 request_id。在提交工单或联系技术支持时请一并提供,以便我们快速定位问题。

生产接入建议

在将 imini 集成到生产环境前,请参考以下实践:
  • 合理设置轮询间隔:推荐首次查询间隔 2 秒,随后可按指数退避(2s / 3s / 5s)降低请求频率,避免对查询接口造成不必要压力。
  • 配置合理的超时:提交接口建议 30 秒超时;轮询整体超时建议按模型调整(图像 2 分钟、视频 10 分钟)。
  • 错误重试策略:对 429500502 建议重试 2~3 次并加入随机抖动(jitter);对 400401402 不应重试。
  • API Key 轮换:建议将 API Key 存入密钥管理系统(KMS / Secrets Manager),定期轮换,并对不同业务场景使用独立的 Key 便于观测与隔离。
  • 幂等与请求追踪:在你的侧记录提交返回的 task_idrequest_id,便于与平台日志对账。
  • 内容安全:业务侧建议对用户输入的提示词与参考图做预审,以降低触发 400 内容违规错误的概率。

下一步

API 手册

查阅各模型的完整参数定义与交互式 Playground

模型价格

按模型、分辨率、场景查看积分消耗规则

更新公告

关注新模型上线、参数变更与服务调整

条款与协议

接入前请阅读用户协议与隐私政策