# imini Open Platform API

> imini open platform — AIGC image and video generation APIs for developers.
> Unified endpoint, unified Bearer API Key, asynchronous task pattern
> (submit returns a task_id, then poll the task-query endpoint until the task completes).
> Operated by Nexus Line Limited, INC. (Delaware, USA).

## Overview

- Base URL: `https://openapi.imini.ai/imini/router`
- Authentication: `Authorization: Bearer <API_KEY>` — manage keys at https://imini.ai/api-keys
- Request pattern: all generation endpoints are **asynchronous**. Submit a task, receive `task_id`, poll the task-query endpoint until `status` is `completed` or `failed`.
- Error shape (all endpoints): `{ error: { code, message, status, request_id } }`
- Docs site: https://docs.imini.ai
- Pricing: https://docs.imini.ai/en/guide/pricing
- Changelog: https://docs.imini.ai/en/changelog

## Task Query

- Task Query > Images [GET /v1/images/tasks/{task_id}](https://docs.imini.ai/en/api-reference/images/task-query): Poll the status and result of an image generation task. Spec: https://docs.imini.ai/en/openapi/images/task-query.yaml
- Task Query > Videos [GET /v1/videos/tasks/{task_id}](https://docs.imini.ai/en/api-reference/videos/task-query): Poll the status and result of a video generation task. Spec: https://docs.imini.ai/en/openapi/videos/task-query.yaml

## Image Models (POST /v1/images/generate)

- Image Generation > google/nano-banana [Nano Banana](https://docs.imini.ai/en/api-reference/images/nano-banana): Gemini 2.5 Flash Image. Fast and low-cost. Text-to-image and image edit. Up to 3 reference images. Resolution: 1K. Pricing: 50 credits per image (text-to-image), 100 credits (image edit). Spec: https://docs.imini.ai/en/openapi/images/nano-banana.yaml
- Image Generation > google/nano-banana-pro [Nano Banana Pro](https://docs.imini.ai/en/api-reference/images/nano-banana-pro): Gemini 3 Pro Image. High-fidelity. Text-to-image and image edit with asset or style references. Up to 14 reference images. Resolutions: 1K / 2K / 4K. Pricing: 120 credits per image (1K / 2K), 200 credits (4K). Spec: https://docs.imini.ai/en/openapi/images/nano-banana-pro.yaml
- Image Generation > google/nano-banana-2 [Nano Banana 2](https://docs.imini.ai/en/api-reference/images/nano-banana-2): Gemini 3.1 Flash Image. Most fully featured Flash-series model. Text-to-image and image edit. Up to 14 reference images. Resolutions: 512 / 1K / 2K / 4K. Pricing: 50 / 75 / 100 / 150 credits per image by tier. Spec: https://docs.imini.ai/en/openapi/images/nano-banana-2.yaml
- Image Generation > openai/gpt-image-2 [GPT Image 2](https://docs.imini.ai/en/api-reference/images/gpt-image-2): OpenAI gpt-image-2. Text-to-image and image edit with asset references. Up to 3 reference images. Resolutions: 1K / 2K / 4K with three quality tiers (low / medium / high); quality is orthogonal to resolution. Pricing per image: 1K → 60 / 120 / 350 credits, 2K → 70 / 180 / 600 credits, 4K → 80 / 300 / 1000 credits (low / medium / high). Spec: https://docs.imini.ai/en/openapi/images/gpt-image-2.yaml

## Video Models (POST /v1/videos/generate)

- Video Generation > kling/kling-v3 [Kling v3](https://docs.imini.ai/en/api-reference/videos/kling-v3): Kling 3.0. Text-to-video, image-to-video, first-last-frame, multi-reference-image. Resolutions: 720P / 1080P. Optional audio generation. Pricing: 120–220 credits per output second depending on resolution and audio. Spec: https://docs.imini.ai/en/openapi/videos/kling-v3.yaml
- Video Generation > kling/kling-v3-omni [Kling v3 Omni](https://docs.imini.ai/en/api-reference/videos/kling-v3-omni): Kling 3.0 Omni. Same as v3 plus **reference-video** input. Resolutions: 720P / 1080P. Optional audio generation. Pricing: 120–220 credits per output second depending on resolution, audio, and reference video. Spec: https://docs.imini.ai/en/openapi/videos/kling-v3-omni.yaml
- Video Generation > kling/kling-v3-motion-control [Kling v3 Motion Control](https://docs.imini.ai/en/api-reference/videos/kling-v3-motion-control): Kling 3.0 Motion Control. Replicates the motion from a reference video onto a character from a reference image. Requires 1 reference image + 1 reference video. Resolutions: 720P / 1080P. Pricing: 180 credits per second (720P) / 220 credits per second (1080P). Spec: https://docs.imini.ai/en/openapi/videos/kling-v3-motion-control.yaml
- Video Generation > doubao/seedance-2.0 [Seedance 2.0](https://docs.imini.ai/en/api-reference/videos/seedance-2-0): Seedance 2.0. Text-to-video, image-to-video (including first-last-frame), multimodal reference (image + video + audio). Resolutions: 480P / 720P. Pricing: 100 credits per second (480P) / 200 credits per second (720P) without reference video; cost scales with total reference length and output duration when reference video is used — see pricing docs for the table. Spec: https://docs.imini.ai/en/openapi/videos/seedance-2-0.yaml
- Video Generation > doubao/seedance-2.0-fast [Seedance 2.0 Fast](https://docs.imini.ai/en/api-reference/videos/seedance-2-0-fast): Seedance 2.0 Fast. Same capabilities as Seedance 2.0 at lower cost. Pricing: 80 credits per second (480P) / 160 credits per second (720P) without reference video; scales with reference length when reference video is used. Spec: https://docs.imini.ai/en/openapi/videos/seedance-2-0-fast.yaml
- Video Generation > dashscope/happyhorse-1.0 [HappyHorse 1.0](https://docs.imini.ai/en/api-reference/videos/happyhorse-1-0): HappyHorse 1.0. A single model ID covers text-to-video, image-to-video (first frame), reference-to-video (1–9 asset images, refer with `character1` / `character2` … in the prompt), and video editing (1 reference video + 0–5 reference images, audio handling via `extra_params.audio_setting`). Resolutions: 720P / 1080P. Duration 3–15s (video edit follows source video, capped at 15s). Pricing: 180 credits per second (720P) / 300 credits per second (1080P). Spec: https://docs.imini.ai/en/openapi/videos/happyhorse-1-0.yaml

## Docs

- Guide > [Introduction](https://docs.imini.ai/en/guide/introduction.md): Overview of imini Open Platform — a one-stop AIGC image and video generation API for developers.
- Guide > [Getting Started](https://docs.imini.ai/en/guide/getting-started.md): How to onboard and make your first API call — authentication, async flow, error handling, production tips.
- Guide > [Pricing](https://docs.imini.ai/en/guide/pricing.md): Credit consumption details for each model's API calls.
- [Changelog](https://docs.imini.ai/en/changelog/index.md): Product updates and release notes.
- Legal > [Privacy Policy](https://docs.imini.ai/en/legal/privacy.md): imini Open Platform Privacy Policy.
- Legal > [Terms of Service](https://docs.imini.ai/en/legal/terms.md): imini Open Platform Terms of Service.

## OpenAPI Specs

- [Nano Banana](https://docs.imini.ai/en/openapi/images/nano-banana.yaml)
- [Nano Banana Pro](https://docs.imini.ai/en/openapi/images/nano-banana-pro.yaml)
- [Nano Banana 2](https://docs.imini.ai/en/openapi/images/nano-banana-2.yaml)
- [GPT Image 2](https://docs.imini.ai/en/openapi/images/gpt-image-2.yaml)
- [Image Task Query](https://docs.imini.ai/en/openapi/images/task-query.yaml)
- [Kling v3](https://docs.imini.ai/en/openapi/videos/kling-v3.yaml)
- [Kling v3 Omni](https://docs.imini.ai/en/openapi/videos/kling-v3-omni.yaml)
- [Kling v3 Motion Control](https://docs.imini.ai/en/openapi/videos/kling-v3-motion-control.yaml)
- [Seedance 2.0](https://docs.imini.ai/en/openapi/videos/seedance-2-0.yaml)
- [Seedance 2.0 Fast](https://docs.imini.ai/en/openapi/videos/seedance-2-0-fast.yaml)
- [HappyHorse 1.0](https://docs.imini.ai/en/openapi/videos/happyhorse-1-0.yaml)
- [Video Task Query](https://docs.imini.ai/en/openapi/videos/task-query.yaml)