APIMPAPIMP
User GuideAI APIImage APIVideo APIPublic API

seedream-5.0

Submit an async seedream-5.0 image generation task. Returns a task_id to poll via the status endpoint.

POST
/api/generate/submit

Authorization

BearerAuth

AuthorizationBearer <token>

使用 Bearer Token 认证。 格式: Authorization: Bearer sk-xxxxxx

In: header

Request Body

application/json

model*string

模型名,固定为 seedream-5.0

prompt*string

图片描述(必填,非空)。

size?string

输出宽高比。

Value in"1:1" | "4:3" | "3:4" | "16:9" | "9:16" | "3:2" | "2:3" | "21:9" | "auto"
image?string

单张参考图 URL,可与 images 合并使用。

Formaturi
images?array<string>

多张参考图 URL,最多 14 张。

Itemsitems <= 14
n?integer

生成数量。

Range1 <= value <= 4
quality?string

输出分辨率。

Value in"2K" | "3K"
resolution?string

quality 的兼容别名。

Value in"2K" | "3K"
watermark?boolean

是否添加水印。

prompt_priority?string

任务优先模式。

Value in"standard" | "fast"
model_params?object

模型扩展参数。

[key: string]?any
output_format?string

输出图片格式。

Value in"jpeg" | "png"
sequential_image_generation?string

连续组图模式。

Value in"disabled" | "auto"
sequential_image_generation_options?object

连续组图选项。

max_images?integer

连续组图最多生成数量,范围为 1–4。

Range1 <= value <= 4
[key: string]?never
[key: string]?never

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.apimp.ai/api/generate/submit" \  -H "Content-Type: application/json" \  -d '{    "model": "seedream-5.0",    "prompt": "A fashion editorial portrait with soft studio lighting"  }'
{
  "code": 200,
  "data": {
    "task_id": "task_0VDknz6qRwvH5Y5aDAt6mN8pRShzLb6X",
    "status": "not_started",
    "created_time": "2026-06-18T09:21:26",
    "error_message": null
  }
}

{
  "code": 400,
  "error": {
    "message": "field `prompt` is required",
    "type": "invalid_request_error"
  }
}

{
  "code": 400,
  "error": {
    "message": "string",
    "type": "invalid_request_error"
  }
}
{
  "code": 400,
  "error": {
    "message": "string",
    "type": "invalid_request_error"
  }
}
{
  "code": 400,
  "error": {
    "message": "string",
    "type": "invalid_request_error"
  }
}
{
  "code": 400,
  "error": {
    "message": "string",
    "type": "invalid_request_error"
  }
}

How is this guide?

Last updated on