> ## Documentation Index
> Fetch the complete documentation index at: https://docs.imini.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 平台介绍

> 了解 imini 开放平台 —— 面向开发者的一站式 AIGC 图像与视频生成 API

**imini 开放平台** 是一个面向开发者的 AIGC 服务聚合网关。我们将 Google Gemini、快手可灵、字节跳动豆包等业界顶级图像与视频生成模型，以 **imini 自有的统一 API 协议**对外开放，让你**无需对接多家模型厂商，仅用一个 API Key 即可调用全部能力**。

从快速原型到规模化生产，imini 帮你跳过模型选型、鉴权对接、SDK 封装、异步任务调度这些重复工作，把精力留给业务本身。

## 核心能力

<CardGroup cols={2}>
  <Card title="图像生成" icon="image">
    文生图 + 图生图（编辑/换装/风格迁移），支持最多 **14 张参考图**，输出可达 **4K 分辨率**，14 种宽高比任选。
  </Card>

  <Card title="视频生成" icon="video">
    文生视频、图生视频、首尾帧补齐、多模态参考（图 + 视频 + 音频），支持 **720P / 1080P** 带声或无声输出。
  </Card>

  <Card title="标准 HTTP 接入" icon="plug">
    采用 `Authorization: Bearer` 标准鉴权，**cURL、Postman、任意 HTTP 客户端开箱即用**；请求参数为 imini 自有协议，接口结构保持跨模型一致。
  </Card>

  <Card title="异步任务架构" icon="clock">
    所有生成接口提交即返回 `task_id`，通过轮询查询结果，**适合批量并发与生产级集成**，不会阻塞主业务。
  </Card>
</CardGroup>

## 为什么选择 imini

* **一个 Key 访问全部模型**：省去分别注册、维护多家厂商账号的成本；模型切换只需修改请求体中的 `model` 字段。
* **按调用计费，无订阅门槛**：积分预付费模式，调多少用多少，无月费、无最低消费、无阶梯绑架。详见 [模型价格](/zh/guide/pricing)。
* **标准 HTTP 接入**：采用 Bearer Token 标准鉴权，cURL / Postman / 各语言 HTTP 库皆可直接调用，5 分钟完成接入。
* **统一协议设计**：所有模型共享同一套请求/响应结构、错误码规范与任务查询接口，降低维护负担。
* **持续更新的模型库**：业界主流新模型会在上游发布后第一时间接入，你无需为每次模型换代重构代码。
* **生产级可靠性**：全球 CDN + 多区域路由，错误响应包含 `request_id` 便于问题追溯。

## API 架构概览

imini 的所有接口遵循三条一致的约定：

<CardGroup cols={2}>
  <Card title="统一端点" icon="server">
    所有模型共用基础地址：

    ```
    https://openapi.imini.ai/imini/router
    ```
  </Card>

  <Card title="统一鉴权" icon="key">
    所有请求通过 HTTP Header 传递 API Key：

    ```http theme={null}
    Authorization: Bearer YOUR_API_KEY
    ```
  </Card>

  <Card title="统一任务模型" icon="arrows-rotate">
    提交 → 返回 `task_id` → 轮询 → 得到结果 URL，适合长耗时生成场景。
  </Card>

  <Card title="统一错误结构" icon="triangle-exclamation">
    所有错误响应格式一致：`{ error: { code, message, status, request_id } }`，便于统一处理。
  </Card>
</CardGroup>

## 30 秒看懂调用流程

```bash theme={null}
# 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": "google/nano-banana",
    "prompt": "一只穿着宇航服的柴犬漂浮在空间站里，电影感光线",
    "aspect_ratio": "16:9"
  }'
# → 返回 { "task_id": "tsk_abc123" }

# 2. 查询任务结果
curl https://openapi.imini.ai/imini/router/v1/images/tasks/tsk_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"
# → 返回 { "status": "succeeded", "images": [{ "url": "..." }] }
```

切换模型只需把 `model` 改为 `google/nano-banana-pro` 或 `kling/kling-v3` 等，参数结构保持兼容。

## 典型应用场景

* **创意设计 SaaS**：为 Figma/Canva 类产品集成 AI 生图能力，支持用户上传参考图做风格化改造。
* **电商营销自动化**：根据商品属性批量生成主图、白底图、节日营销海报，配合排版工具直接上架。
* **短视频与 UGC 平台**：文生视频模板、AI 特效、用户头像生成等社交功能。
* **游戏与数字内容**：角色立绘、场景概念图、NPC 头像批量产出，大幅压缩美术前期成本。
* **AI 工作流与 Agent**：接入 Dify、Coze、Make、Zapier、n8n 等工作流平台作为图像/视频生成节点。
* **企业内部工具**：培训材料、PPT 素材、营销文案配图等非公开场景的素材生产。

## 下一步

<CardGroup cols={2}>
  <Card title="快速开始" icon="rocket" href="/zh/guide/getting-started">
    5 分钟获取 API Key 并发起首次调用
  </Card>

  <Card title="模型价格" icon="coins" href="/zh/guide/pricing">
    各模型按场景/分辨率的积分消耗明细
  </Card>

  <Card title="API 手册" icon="book" href="/zh/api-reference/images/nano-banana">
    完整接口文档，含交互式 Playground
  </Card>

  <Card title="更新公告" icon="bell" href="/zh/changelog/index">
    平台新模型上线、功能迭代与变更通知
  </Card>
</CardGroup>