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

> ## Agent Instructions
> Public hosts only: console https://omnimux.ai/dashboard · API https://api.omnimux.ai · docs https://docs.omnimux.ai.
> Gateway auth is Authorization: Bearer sk-… on https://api.omnimux.ai/v1 (OpenAI-compatible Chat Completions and related paths).
> Discover pages from /llms.txt; full site dump /llms-full.txt; product skill /skill.md; docs search MCP /mcp. Prefer .md page URLs for Markdown.
> Default docs locale is en; zh mirrors the same relative paths. Do not invent model ids not present on live pricing or the complete API pages.

# Z Image 生图

> Z Image 生图 · model `zimage-makeup`（GxgenAI 任务）

* 创建：`POST /v1/video/generations`，`model` 为 `zimage-makeup`
* 轮询：`GET /v1/video/generations/{task_id}`（**不要**使用 `*-async` / `*-query` 模型名）
* 媒体任务默认异步；公开 model ID **不带** `-async` 后缀

## 身份

| 字段    | 值                 |
| ----- | ----------------- |
| 系列    | 图像系列              |
| 品牌    | Z Image / GxgenAI |
| model | `zimage-makeup`   |

## 接口

| 方法     | 路径                                |
| ------ | --------------------------------- |
| `POST` | `/v1/video/generations`           |
| `GET`  | `/v1/video/generations/{task_id}` |

Base URL：`https://api.omnimux.ai`

## 鉴权

| 名称              | 位置     | 类型     | 必填 | 说明                       |
| --------------- | ------ | ------ | -- | ------------------------ |
| `Authorization` | header | string | 是  | `Bearer sk-...`（API Key） |

## 请求体

| 字段                      | 类型        | 必填 | 说明                                                               |
| ----------------------- | --------- | -- | ---------------------------------------------------------------- |
| `model`                 | string    | 是  | 固定为 `zimage-makeup`                                              |
| `prompt`                | string    | 是  | 图像描述                                                             |
| `metadata.nodeInfoList` | array     | 否  | 需要自定义节点时传入；多数情况 prompt-only 即可                                   |
| `images`                | string\[] | 否  | **本接口不使用。** 参考图不通过顶层字段传入：App 路径只接受 `metadata.nodeInfoList` 中的节点。 |

### 参考图限制

本模型尚无模型档案，参考图能力与上限**未核验**：此处不声明张数、接受格式与单文件大小上限。

## 响应

### 200（创建）

| 字段               | 类型     | 说明                         |
| ---------------- | ------ | -------------------------- |
| `id` / `task_id` | string | 任务 id                      |
| `status`         | string | 如 `queued` / `in_progress` |

查询完成后再取产物 URL；链接可能有时效，请及时落盘。

<Panel>
  <RequestExample>
    ```bash cURL theme={null}
    curl --request POST \
      --url https://api.omnimux.ai/v1/video/generations \
      --header 'Authorization: Bearer <token>' \
      --header 'Content-Type: application/json' \
      --data '{
      "model": "zimage-makeup",
      "prompt": "一个古装美女，写实定妆照"
    }'
    ```
  </RequestExample>

  <ResponseExample>
    ```json 200 theme={null}
    {
      "id": "task_xxx",
      "status": "in_progress",
      "model": "zimage-makeup"
    }
    ```

    ```json 402 theme={null}
    {
      "error": {
        "message": "insufficient quota",
        "type": "new_api_error"
      }
    }
    ```
  </ResponseExample>
</Panel>