Quickstart

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": "google/nano-banana",
    "prompt": "An orange cat napping under a cherry blossom tree, watercolor style",
    "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": "google/nano-banana",
        "prompt": "An orange cat napping under a cherry blossom tree, watercolor style",
        "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: 'google/nano-banana',
    prompt: 'An orange cat napping under a cherry blossom tree, watercolor style',
    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}`);

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):
    """Poll the task result, waiting up to `timeout` seconds."""
    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);