Seedream4.5 文生图

接口

POST /images/generations

完整 URL: https://modelfold.ai/v1/images/generations

鉴权：所有请求都需要 Authorization: Bearer <API_KEY> 请求头。

模型参数直接放在 JSON 请求体中，不要套 input。请求等待生成完成后返回 data[].url；支持的媒体模型也可使用 异步创建、轮询及回调。示例素材地址须替换为自己的公开可访问文件。计费及错误说明见 API 网关。

生成任务的输入参数

请求参数

请求体 (application/json)

参数	类型	必填	说明
model	string	是	用于生成的模型名称。必填字段。 - 此端点必须使用 seedream/4.5-text-to-image 默认值："seedream/4.5-text-to-image"。 可选值：seedream/4.5-text-to-image。 示例：seedream/4.5-text-to-image。
prompt	string	是	本站网关要求传入 prompt，最长 2000 字。您想要生成的图像的文本描述（最大长度：3000 字符） maxLength: 2000. 示例：A full-process cafe design tool for entrepreneurs and designers. It covers core needs including store layout, functional zoning, decoration style, equipment selection, and customer group adaptation, supporting integrated planning of "commercial attributes + aesthetic design." Suitable as a promotional image for a cafe design SaaS product, with a 16:9 aspect ratio.。
aspect_ratio	string	是	必填。图像的宽高比，决定其视觉形态。 可选值：1:1 / 4:3 / 3:4 / 16:9 / 9:16 / 2:3 / 3:2 / 21:9。 示例：1:1。
quality	string	是	必填。基础质量输出 2K 图像，高质量输出 4K 图像。 可选值：basic / high。 示例：basic。
nsfw_checker	boolean	否	默认 false。为 false 时不额外进行内容过滤，结果由模型直接返回。

请求示例

curl -X POST "https://modelfold.ai/v1/images/generations" \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream/4.5-text-to-image",
  "prompt": "A full-process cafe design tool for entrepreneurs and designers. It covers core needs including store layout, functional zoning, decoration style, equipment selection, and customer group adaptation, supporting integrated planning of \"commercial attributes + aesthetic design.\" Suitable as a promotional image for a cafe design SaaS product, with a 16:9 aspect ratio.",
  "aspect_ratio": "1:1",
  "quality": "basic"
}'

{
  "model": "seedream/4.5-text-to-image",
  "prompt": "A full-process cafe design tool for entrepreneurs and designers. It covers core needs including store layout, functional zoning, decoration style, equipment selection, and customer group adaptation, supporting integrated planning of \"commercial attributes + aesthetic design.\" Suitable as a promotional image for a cafe design SaaS product, with a 16:9 aspect ratio.",
  "aspect_ratio": "1:1",
  "quality": "basic"
}

响应

200 — 生成完成。usage 返回实际计费明细；结果地址仅作结构示例。

{
  "ok": true,
  "created": 1792134000,
  "data": [
    {
      "url": "https://modelfold.ai/uploads/outputs/result.png"
    }
  ],
  "usage": {}
}