控制台

图像生成

POST/v1/images/generations

文生图接口：根据文本描述生成一张图片。

请求参数

字段类型必填说明
model: string必填

模型 ID。推荐使用稳定 model ID；需要复现固定版本时，可填写 snapshot model ID。

prompt: string必填

待生成图像的文本描述，非空字符串，最多 4000 字符。

negative_prompt: string可选

不希望出现在图片中的内容，最多 4000 字符。示例使用 Model Card 推荐的负向词。

size: string可选

图片尺寸，格式为宽x高，默认 1024x1024。每边 256–2048，且为 16 的倍数；总像素不超过 2097152。

n: integer可选

生成图片数量，仅支持 1。

seed: integer可选

随机种子，用于控制生成过程的随机性和结果复现，范围为 0–2^53−1。未提供时由系统随机生成。

num_inference_steps: integer可选

推理步数，范围为 1–100。

guidance_scale: number可选

引导系数，范围为 0–10，显式传入 0 有效。

response_format: string可选

仅支持 url，不支持 b64_json。

output_watermark: object可选

输出水印设置。enabled 为布尔值，省略时默认开启可见水印；传 {"enabled": false} 关闭可见水印，图片仍保留 AIGC 元数据。

返回值

成功时返回包含图片 URL 的 JSON。当前一次生成一张 PNG，不支持流式输出。

字段类型说明
created: integer

响应中的创建时间戳。

data: array

生成图片结果列表。

data[].url: string

生成图片的 URL。

usage: object

实际图像生成用量。

usage.generated_images: integer

实际生成图片数量。

usage.output_width: integer

实际图片宽度，单位像素。

usage.output_height: integer

实际图片高度，单位像素。

错误码

HTTPerror.code触发条件与处理建议
400: invalid_field_value

请求体不是合法 JSON、字段类型或取值不合法、含不支持的参数，或模型 / 版本找不到。检查字段名及参数范围；快照模型不要另传 version。

403: 2 个 error.code

鉴权失败或平台安全审核拦截。

404: resource_not_found

图片结果资产不存在。重新提交生成请求；重复出现时保留请求标识，联系服务方排查。

429: 2 个 error.code

并发或请求频率超限。

502: upstream_invalid_result

上游结果结构、模型版本或用量校验失败。保留任务和追踪标识，联系服务方排查。

下一步

场景指南

图像生成：从输入到图片结果

根据文本描述生成图像，支持长文本和文字渲染，适合海报设计、插画创作和视觉内容生成。

模型

MOSS-Image-Base-1.0

模型 ID、能力与快照。