跳到主要内容

生成图像

本文档介绍 /v1/platform 系列接口，支持腾讯云混元、即梦、可灵等 AIGC 模型的图像和视频生成。所有接口均以统一格式封装，屏蔽底层差异。

POST /v1/platform/image

提交一个 AI 图像生成任务。任务异步执行，接口返回 task_id，需通过 查询任务接口 轮询结果。

⚠️ 该接口生成的文件 URL 仅保留 7 天，请及时下载保存。

请求参数​

application/json
参数名类型必选说明
modelstring必选模型标识，必须以 image- 开头。格式：image-{model_name}-{version}，例如 image-kling-2.1。
promptstring必选图像生成的正向文本描述。支持中英文，建议尽量详细描述画面内容、风格、构图等。
negative_promptstring可选负向提示词，描述不希望在图像中出现的内容，如 模糊，低质量，水印。
enhance_promptstring可选是否开启提示词自动优化增强。
可选值：enabled / disabled
generation_modestring可选生成模式，具体可选值请参考所用模型文档。例如图生图、局部重绘等。
inputsarray可选输入文件列表，用于参考图、风格图等场景（图生图）。
↳ inputs[i] 子字段
outputobject可选输出配置，控制图像分辨率、存储方式等。
↳ output 子字段
input_regionstring可选输入素材来源地区。
可选值：mainland / oversea
session_idstring可选用于去重的识别码。如果三天内曾有过相同 session_id 的请求，则本次请求会返回错误。最长 50 个字符，不填或填空字符串表示不做去重。
session_contextstring可选来源上下文，用于透传用户请求信息，任务回调时将返回该字段值，最长 1000 个字符。
ext_infoobject可选保留字段，特殊用途时使用，具体格式由所用模型决定。
inputs[i] 子字段
字段名类型必选说明
urlstring必选输入图像的公网可访问 URL。推荐使用小于 7M 的图片，支持格式：jpeg、jpg、png、webp。
textstring可选输入图片的描述信息，用于帮助模型理解图片内容。目前仅 GEM 2.5、GEM 3.0 有效。
output 子字段
字段名类型必选说明
resolutionstring可选生成图片的分辨率。各模型可选值：
• GEM 2.5 / 3.0：1K、2K、4K，默认 1K
• Vidu q2：1080p、2K、4K，默认 1080p
• Kling 2.1：1k、2k，默认 1k
• Hunyuan 3.0：720P、1080P、2K、4K
aspect_ratiostring可选指定所生成图片的宽高比。与 width/height 二选一，优先级高于后者。各模型可选值：
• GEM：1:1、3:2、2:3、3:4、4:3、4:5、5:4、9:16、16:9、21:9
• Qwen：暂不支持
• Hunyuan：16:9、9:16、1:1、4:3、3:4、3:2、2:3、21:9
• Vidu：16:9、9:16、1:1、3:4、4:3、21:9、2:3、3:2
• Kling：16:9、9:16、1:1、4:3、3:4、3:2、2:3、21:9
widthinteger可选输出图像宽度（像素）。与 height 同时指定时自动推算宽高比；若已设置 aspect_ratio 则忽略。
heightinteger可选输出图像高度（像素）。与 width 配合使用。
media_namestring可选输出媒体文件名，最长 64 个字符。缺省由系统指定生成文件名。
class_idinteger可选分类 ID，用于对媒体进行分类管理。默认值：0（其他分类）。
input_compliance_checkstring可选是否开启输入内容的合规性检查。
可选值：enabled / disabled
output_compliance_checkstring可选是否开启输出内容的合规性检查。
可选值：enabled / disabled
person_generationstring可选是否允许人物或人脸生成。
可选值：allow_adult / disallowed
allow_adult 允许生成成人；disallowed 禁止在图片中包含人物或人脸。

请求示例​

JSON（文生图）
{
  "model":  "image-kling-2.1",
  "prompt": "一只可爱的橘猫坐在樱花树下，水彩画风格，高细节",
  "negative_prompt": "模糊，低质量，水印，变形",
  "enhance_prompt": "enabled",
  "output": {
    "aspect_ratio": "1:1",

  }
}
JSON（图生图）
{
  "model":  "image-jimeng-3.0",
  "prompt": "将图片改为赛博朋克霓虹灯风格",
  "generation_mode": "image_to_image",
  "inputs": [
    {
      "url": "https://example.com/source.jpg"
    }
  ],
  "output": {
    "aspect_ratio": "16:9"
  }
}

响应参数​

字段名类型说明
task_idstring任务唯一 ID，用于后续查询任务状态。
statusstring任务初始状态，通常为 queued。

响应示例​

JSON · 200 OK
{
  "task_id": "img_abc123xyz456",
  "status":  "queued"
}