前置条件
在开始之前,请确认已完成以下事项:1
注册 imini 账号
访问 imini.ai 注册账号并完成邮箱验证。
3
创建 API Key
前往 API Keys 管理页,创建一个用于服务端调用的 API Key 并妥善保存。
接入地址
imini 开放平台所有接口共用同一基础地址:/v1/images/generate)均需拼接在此基础地址之后使用。
鉴权方式
所有请求均通过 HTTP Header 传递 API Key,采用 Bearer Token 标准:异步任务模型
imini 所有生成类接口(图像、视频)均采用异步任务模型。一次完整的生成流程包含两步:图像任务查询地址为
/v1/images/tasks/{task_id};视频任务查询地址为 /v1/videos/tasks/{task_id}。建议轮询间隔为 2 秒,图像任务通常在 10~30 秒内完成。第一步:提交生成任务
以下示例使用google/nano-banana 模型生成一张 1:1 图像:
第二步:轮询任务结果
使用上一步返回的task_id 轮询任务状态,直至 status 变为 succeeded 或 failed:
成功响应示例(
status: succeeded):
错误处理
所有错误响应共享统一结构:生产接入建议
在将 imini 集成到生产环境前,请参考以下实践:- 合理设置轮询间隔:推荐首次查询间隔 2 秒,随后可按指数退避(2s / 3s / 5s)降低请求频率,避免对查询接口造成不必要压力。
- 配置合理的超时:提交接口建议 30 秒超时;轮询整体超时建议按模型调整(图像 2 分钟、视频 10 分钟)。
- 错误重试策略:对
429、500、502建议重试 2~3 次并加入随机抖动(jitter);对400、401、402不应重试。 - API Key 轮换:建议将 API Key 存入密钥管理系统(KMS / Secrets Manager),定期轮换,并对不同业务场景使用独立的 Key 便于观测与隔离。
- 幂等与请求追踪:在你的侧记录提交返回的
task_id与request_id,便于与平台日志对账。 - 内容安全:业务侧建议对用户输入的提示词与参考图做预审,以降低触发
400内容违规错误的概率。
下一步
API 手册
查阅各模型的完整参数定义与交互式 Playground
模型价格
按模型、分辨率、场景查看积分消耗规则
更新公告
关注新模型上线、参数变更与服务调整
条款与协议
接入前请阅读用户协议与隐私政策

