更新时间：2026-08-19 22:03（Asia/Shanghai）
Submit a Hidream-O Series Image Generation Task
1. Endpoint
/api/maas/gw/v1/images/generations
2. Method
POST
3. Request Parameters
Header
| Parameter | Type | Required | Description |
|---|---|---|---|
| Authorization | string | Yes | Bearer API key, for example sk-xxxxxxxx |
| Content-Type | string | Yes | application/json |
Body (by model)
model_idis required and selects an image generation or editing model. This page coversHiDream-O1-Image-Dev-2604,HiDream-O1-Image-1.5,HiDream-O1-Image-2, andHiDream-O1-Edit-1.5.
HiDream-O1-Image-Dev-2604 HiDream-O1-Image-1.5
| Parameter | Type | Required | Description |
|---|---|---|---|
| model_id | string | Yes | Image generation model ID. Supported values: HiDream-O1-Image-Dev-2604, HiDream-O1-Image-1.5 |
| prompt | string | Yes | Positive prompt. Recommended maximum length: 5000 characters |
| negative_prompt | string | No | Negative prompt. Default: "" |
| wh_ratio | string | No | Image aspect ratio, for example "3:2", "2:3", "3:4", "4:3", "9:16", "16:9", "1:1". Default: 1:1 |
| n | integer | No | Number of generated images. Range: 1-4. Default: 1 |
| request_id | string | No | Client-defined request ID. Default: "" |
HiDream-O1-Image-2
| Parameter | Type | Required | Description |
|---|---|---|---|
| model_id | string | Yes | Fixed value: HiDream-O1-Image-2 |
| prompt | string | Yes | Positive prompt. Maximum length: 10,000 characters |
| negative_prompt | string | No | Negative prompt. Maximum length: 10,000 characters. Default: "" |
| wh_ratio | string | No | Output aspect ratio in width:height format. Default: auto |
| seed | integer | No | Random seed. Default: -1 |
| request_id | string | No | Client-defined request ID. Default: "" |
Request example
{
"model_id": "HiDream-O1-Image-2",
"prompt": "A futuristic city above a sea of clouds",
"negative_prompt": "",
"wh_ratio": "16:9",
"seed": -1,
"request_id": "image2-example-001"
}
HiDream-O1-Edit-1.5
| Parameter | Type | Required | Description |
|---|---|---|---|
| model_id | string | Yes | Fixed value: HiDream-O1-Edit-1.5 |
| prompt | string | Yes | Image editing instruction. Maximum length: 10,000 characters |
| images | string[] | Yes | Supports up to six images, at least one image must be passed in. Each image may be a publicly accessible URL or Base64 string. Maximum image size: 20 MB; minimum dimensions: 200×200 |
| wh_ratio | string | No | Output aspect ratio in width:height format. Default: auto |
| seed | integer | No | Random seed. Default: -1 |
| request_id | string | No | Client-defined request ID. Default: "" |
Request example
{
"model_id": "HiDream-O1-Edit-1.5",
"prompt": "Replace the background with a beach at sunset",
"images": [
"https://example.com/input.png"
],
"wh_ratio": "auto",
"seed": -1,
"request_id": "edit-1-5-example-001"
}
Response
| Parameter | Type | Required | Description |
|---|---|---|---|
| code | int | Yes | Response code. 0 means success; any non-zero value indicates an error. See message for details |
| message | string | Yes | Response message |
| result | dict | Yes | Returned result |
result
| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | str | Yes | Task ID |