前置条件
接入地址
https://openapi.imini.ai/imini/router
鉴权方式
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
仅在服务端使用 API Key。若泄露,请在 API Keys 轮换。
模型 ID 与素材
model 使用工作台的模型 ID。旧别名见对应模型页;新任务回显提交的 ID。
素材须可被 API 读取。图片和音频也可传 Base64 Data URI,解码后分别限 20 MiB/张和 15 MiB/段;完整请求限 32 MiB。视频仅支持 HTTP(S) URL。
视频模式根据素材及其 reference_type 推断,无需传 video_mode。
异步任务模型
提交后凭task_id 轮询图像任务或视频任务。建议分别每 2 秒、5 秒查询一次。
第一步:提交生成任务
以下示例使用nano-banana 模型生成一张 1:1 图像:
curl -X POST https://openapi.imini.ai/imini/router/v1/images/generate \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "nano-banana",
"prompt": "一只在樱花树下打盹的橙色猫咪,水彩风格",
"aspect_ratio": "1:1"
}'
import requests
BASE_URL = "https://openapi.imini.ai/imini/router"
API_KEY = "YOUR_API_KEY"
response = requests.post(
f"{BASE_URL}/v1/images/generate",
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json={
"model": "nano-banana",
"prompt": "一只在樱花树下打盹的橙色猫咪,水彩风格",
"aspect_ratio": "1:1",
},
timeout=30,
)
response.raise_for_status()
task_id = response.json()["task_id"]
print(f"Submitted task: {task_id}")
const BASE_URL = 'https://openapi.imini.ai/imini/router';
const API_KEY = 'YOUR_API_KEY';
const response = await fetch(`${BASE_URL}/v1/images/generate`, {
method: 'POST',
headers: {
Authorization: `Bearer ${API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
model: 'nano-banana',
prompt: '一只在樱花树下打盹的橙色猫咪,水彩风格',
aspect_ratio: '1:1',
}),
});
if (!response.ok) {
throw new Error(`Submit failed: ${response.status}`);
}
const { task_id } = await response.json();
console.log(`Submitted task: ${task_id}`);
{
"task_id": "task_2041350318103396352",
"model": "nano-banana",
"created_at": "2026-04-07T03:00:17.062Z",
"request_id": "285f20ce-8158-401b-945c-7bc6a7ef6ead"
}
第二步:轮询任务结果
使用上一步返回的task_id 轮询任务状态,直至 status 变为 succeeded 或 failed:
curl https://openapi.imini.ai/imini/router/v1/images/tasks/TASK_ID \
-H "Authorization: Bearer YOUR_API_KEY"
import time
def wait_for_result(task_id: str, interval: int = 2, timeout: int = 120):
"""轮询任务结果,最长等待 timeout 秒。"""
deadline = time.time() + timeout
while time.time() < deadline:
result = requests.get(
f"{BASE_URL}/v1/images/tasks/{task_id}",
headers={"Authorization": f"Bearer {API_KEY}"},
timeout=10,
).json()
status = result["status"]
if status == "succeeded":
return result["images"]
if status == "failed":
raise RuntimeError(f"Task failed: {result['error']}")
time.sleep(interval)
raise TimeoutError(f"Task {task_id} timed out after {timeout}s")
images = wait_for_result(task_id)
print(images[0]["url"])
async function waitForResult(taskId, { intervalMs = 2000, timeoutMs = 120_000 } = {}) {
const deadline = Date.now() + timeoutMs;
while (Date.now() < deadline) {
const res = await fetch(`${BASE_URL}/v1/images/tasks/${taskId}`, {
headers: { Authorization: `Bearer ${API_KEY}` },
});
const data = await res.json();
if (data.status === 'succeeded') return data.images;
if (data.status === 'failed') throw new Error(`Task failed: ${JSON.stringify(data.error)}`);
await new Promise(r => setTimeout(r, intervalMs));
}
throw new Error(`Task ${taskId} timed out`);
}
const images = await waitForResult(task_id);
console.log(images[0].url);
| 状态 | 含义 |
|---|---|
queued | 任务已提交,等待进入处理队列 |
processing | 模型正在生成中 |
succeeded | 生成成功,结果见 images[] 字段 |
failed | 生成失败,详情见 error 对象 |
status: succeeded):
{
"task_id": "task_2041350318103396352",
"status": "succeeded",
"model": "nano-banana",
"created_at": "2026-04-07T03:00:17.062Z",
"completed_at": "2026-04-07T03:00:29.418Z",
"images": [
{
"url": "https://file.iminicdn.com/file/2026/04/07/xxxx.png",
"width": 1024,
"height": 1024
}
],
"error": null,
"request_id": "285f20ce-8158-401b-945c-7bc6a7ef6ead"
}
错误处理
{
"error": {
"code": "INVALID_PARAMETER",
"message": "aspect_ratio must be one of: 1:1, 2:3, ...",
"status": 400,
"request_id": "req_abc123"
}
}
| HTTP 状态码 | 含义 |
|---|---|
400 | 请求参数无效 |
401 | API Key 缺失、无效或已吊销 |
402 | 积分不足 |
404 | 任务不存在 |
413 | 请求体或素材超限 |
429 | 请求频率超限 |
500 / 502 | 服务异常 |
error。排查时提供 task_id 和 request_id。

