> ## 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.

# Seedream 5.0 Pro 生图

> Seedream 5.0 Pro 生图 · model `seedream-5-0-pro`

* 调用 `POST /v1/images/generations`，`model` 为 `seedream-5-0-pro`
* 请求体至少包含 `model` 与 `prompt`
* 同步或异步以线上响应为准；若返回 task id，请用任务查询接口轮询

## 身份

| 字段    | 值                  |
| ----- | ------------------ |
| 系列    | 图像系列               |
| 品牌    | Seedream           |
| model | `seedream-5-0-pro` |

## 接口

| 方法     | 路径                       |
| ------ | ------------------------ |
| `POST` | `/v1/images/generations` |

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

## 鉴权

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

## 请求体

| 字段        | 类型        | 必填 | 说明                                                                                      |
| --------- | --------- | -- | --------------------------------------------------------------------------------------- |
| `model`   | string    | 是  | 固定为 `seedream-5-0-pro`                                                                  |
| `prompt`  | string    | 是  | 图像描述 / 编辑说明                                                                             |
| `n`       | integer   | 否  | 生成张数（受网关上限约束）                                                                           |
| `size`    | string    | 否  | 尺寸或宽高比（模型相关）                                                                            |
| `quality` | string    | 否  | 质量档位（模型相关）                                                                              |
| `images`  | string\[] | 否  | 参考图：图片 URL 或 base64；`image`、`image_urls`、`input_reference` 为可接受的别名，调用上游前统一归一为 `images`。 |

### 参考图限制

| 项目      | 值                       |
| ------- | ----------------------- |
| 单次参考图上限 | 10 张                    |
| 单次参考图下限 | 多图生图 2 张、单图生图 1 张；文生图不传 |
| 接受格式    | 官方未公布                   |
| 单文件大小上限 | 官方未公布                   |

## 响应

### 200

| 字段               | 类型      | 说明                       |
| ---------------- | ------- | ------------------------ |
| `created`        | integer | 创建时间戳（若返回）               |
| `data`           | array   | 图像结果（`url` 或 `b64_json`） |
| `task_id` / `id` | string  | 异步时的任务 id（若返回）           |

错误形态见右栏示例。异步任务以创建响应中的 `task_id` / 控制台日志为准（公开文档不提供独立图像 query 路径）。

<Panel>
  <RequestExample>
    ```bash cURL theme={null}
    curl --request POST \
      --url https://api.omnimux.ai/v1/images/generations \
      --header 'Authorization: Bearer <token>' \
      --header 'Content-Type: application/json' \
      --data '{
      "model": "seedream-5-0-pro",
      "prompt": "a product photo on white background",
      "n": 1
    }'
    ```
  </RequestExample>

  <ResponseExample>
    ```json 200 theme={null}
    {
      "created": 1741428397,
      "data": [
        { "url": "https://example.com/image.png" }
      ]
    }
    ```

    ```json 400 theme={null}
    {
      "error": { "message": "Invalid request", "type": "invalid_request_error", "code": "bad_request" }
    }
    ```

    ```json 401 theme={null}
    {
      "error": { "message": "Invalid token", "type": "authentication_error", "code": "unauthorized" }
    }
    ```

    ```json 402 theme={null}
    {
      "error": {
        "message": "Insufficient quota. Please top up your account.",
        "type": "insufficient_quota",
        "code": "insufficient_quota"
      }
    }
    ```

    ```json 403 theme={null}
    {
      "error": { "message": "Model not allowed", "type": "permission_error", "code": "forbidden" }
    }
    ```

    ```json 429 theme={null}
    {
      "error": { "message": "Rate limit exceeded", "type": "rate_limit_error", "code": "rate_limit_exceeded" }
    }
    ```

    ```json 500 theme={null}
    {
      "error": { "message": "Internal server error", "type": "server_error", "code": "internal_error" }
    }
    ```
  </ResponseExample>
</Panel>