提交混元生图(3.0)任务

最近更新时间:2026-01-30 19:27:50

我的收藏

1. 接口描述

接口请求域名: aiart.tencentcloudapi.com 。

混元生图接口,基于混元大模型,根据输入的文本描述快速生成图片。
默认提供1个并发,代表最多能同时处理1个已提交的任务,上一个任务处理完毕后,才能开始处理下一个任务。

默认接口请求频率限制:20次/秒。

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:SubmitTextToImageJob。
Version String 公共参数,本接口取值:2022-12-29。
Region String 公共参数,详见产品支持的 地域列表
Prompt String

文本描述。
算法将根据输入的文本智能生成与之相关的图像。
不能为空,推荐使用中文。最多可传1024个 utf-8 字符。


示例值:雨中, 竹林, 小路
Images.N Array of String

垫图url列表,大小不超过10MB,支持 jpg jpeg png webp格式,最多3张图


示例值:["https://xxx.jpeg"]
Resolution String

生成图分辨率,默认1024:1024:

  • 宽高维度均在 [512, 2048] 像素范围内;
  • 宽高乘积(即图像面积)不超过 1024×1024 像素;

示例值:1024:1024
Seed Integer

随机种子,默认随机。
不传:随机种子生成。
正数:固定种子生成。
扩写开启时固定种子不生效,将保持随机。


示例值:148237123
LogoAdd Integer

为生成结果图添加显式水印标识的开关,默认为1。
1:添加。
0:不添加。
其他数值:默认按1处理。
建议您使用显著标识来提示结果图使用了 AI 绘画技术,是 AI 生成的图片。


示例值:1
LogoParam LogoParam

标识内容设置。
默认在生成结果图右下角添加“图片由 AI 生成”字样,您可根据自身需要替换为其他的标识图片。

Revise Integer

是否开启prompt改写,为空时默认开启,改写预计会增加20s左右耗时。
0:关闭改写
1:开启改写
建议默认开启,如果关闭改写,需要调用方自己接改写,否则对生图效果有较大影响,改写方法可以参考:改写
示例值:1


示例值:0

3. 输出参数

参数名称 类型 描述
JobId String

任务 ID。


示例值:1259388371-1764399486-fd7b5e60-b633-11f0-827b-52540087afa5-0
RequestId String 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 正常调用场景

输入示例

POST / HTTP/1.1
Host: aiart.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: SubmitTextToImageJob
<公共请求参数>

{
    "Prompt": "生成一张配图**一个日历显示‘Monday’,旁边有一个闹钟指向7:00,窗外阳光明媚代表早晨,书包放在桌边。画面无文字。**;\\n风格要求:**真实风格**,色彩鲜亮、温暖、饱和度高。\\n画面细节:线条简洁流畅,背景柔和,聚焦主体。\\n视觉效果:摄影风,适合儿童教学用途。\\n\\n要求点:\\n- 如果涉及人物的话,人物形象积极健康,充满活力和阳光感;\\n- 图片中的场景、人物都必须是真实世界的事物,不要出现幻想、想象、虚拟等非真实世界的事物;\\n- 图片不得包含任何文本(数字、单词、符号、句子等),如果上面提示词有的话,也要去掉;\\n- 图片内容必须精准匹配描述,避免错误元素(如逻辑不符,图片表示跳出箱子、正确项却为跳进箱子);\\n- 生成注意符合生活常识(如太阳应出现在室外,而不是房间里面,如大象出现在野外,不在桌子上);\\n- 涉及到钟表显示,使用电子表,不要使用指针钟表;\\n- 图片中的元素比较精简,不要堆砌多个元素、模糊重点;",
    "Resolution": "1248:832",
    "Revise": 0
}

输出示例

{
    "Response": {
        "JobId": "251197765-1769741457-80b5b8df-fd86-11f0-ad04-525400647112-0",
        "RequestId": "ee8f21db-e724-4333-8130-e0520ac73e4f"
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。

命令行工具

6. 错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码

错误码 描述
AuthFailure.UnauthorizedOperation 无权执行该操作,请检查您的CAM策略,确保您拥有对应的CAM权限。
FailedOperation.ConsoleServerError 控制台服务异常。
FailedOperation.GenerateImageFailed 生成图片审核不通过,请重试。
FailedOperation.ImageDecodeFailed 图片解码失败。
FailedOperation.ImageDownloadError 图片下载错误。
FailedOperation.InnerError 服务内部错误,请稍后重试。
FailedOperation.RequestEntityTooLarge 整个请求体太大(通常主要是图片)。
FailedOperation.RequestTimeout 后端服务超时。
FailedOperation.RpcFail RPC请求失败,一般为算法微服务故障。
FailedOperation.ServerError 服务内部错误。
FailedOperation.Unknown 未知错误。
InvalidParameter.InvalidParameter 参数不合法。
InvalidParameterValue.ImageEmpty 图片为空。
InvalidParameterValue.LogoParamErr 当前引擎不支持自定义水印。
InvalidParameterValue.ParameterValueError 参数字段或者值有误
InvalidParameterValue.TextLengthExceed 输入文本过长,请更换短一点的文本后重试。
InvalidParameterValue.UrlIllegal URL格式不合法。
OperationDenied.ImageIllegalDetected 图片包含违法违规信息,审核不通过。
OperationDenied.TextIllegalDetected 文本包含违法违规信息,审核不通过。
RequestLimitExceeded 请求的次数超过了频率限制。
RequestLimitExceeded.JobNumExceed 同时处理的任务数过多,请稍后重试。
ResourceUnavailable.InArrears 账号已欠费。
ResourceUnavailable.LowBalance 余额不足。
ResourceUnavailable.NotExist 计费状态未知,请确认是否已在控制台开通服务。
ResourceUnavailable.StopUsing 账号已停服。
ResourcesSoldOut.ChargeStatusException 计费状态异常。