功能描述

此接口用于组合使用对象存储的图片处理功能和豆包的文生图模型，并将处理后的图片存储到指定存储桶。

请求消息样式

POST /?x-tos-process=aigc/text_to_image HTTP/1.1​
Host: bucketname.tos-cn-beijing.volces.com​
Date: Mon, 31 Oct 2016 12:00:00 GMT​
Authorization: authorization string​
Content-Length: length​
{​
    "TaskType": "text_to_image",​
    "InputDataSource": {​
        "Prompt": "千军万马"​
    },​
    "OutputProcessing": {​
        "Bucket": "tostext",​
        "Object": "newgen.jpg",​
        "ForbiddenOverwrite": false,​
        "ProcessStyle": "",​
        "ProcessActions": "image/rotate,90"​
    },​
    "ModelConfig": {​
        "ModelAction": "CVProcess",​
        "ModelVersion": "2022-08-31",​
        "ReqJson": {​
            "req_key": "high_aes_general_v21_L"​
        }​
    }​
}​

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

名称	位置	参数类型	是否必选	示例值	说明
x-tos-process	Query	String	是	-	代表 TextToImage 接口请求的特殊标识，取值 aigc/text_to_image。

请求元素

名称	参数类型	是否必填	示例值	说明
TaskType	String	是	text_to_image	任务类型，该场景下，取值 text_to_image，表示组合使用图片处理功能和文生图模型。
InputDataSource	Arrary	是	-	文生图模型提示词。
Prompt	String	是	千军万马	使用文生图模型时，用于生成图像的提示词。父节点：InputDataSource
OutputProcessing	Arrary	是	-	在使用文生图模型生成图片后，使用对象存储的图片处理功能对图片进行后处理。
Bucket	String	是	tostest	存储处理后图片的存储桶。父节点：OutputProcessing
Object	String	是	save_img	处理后图片的名称。父节点：OutputProcessing
ForbiddenOverwrite	String	是	false	将处理后的图片存储到存储桶时，如果存储桶中有同名文件，是否覆盖该文件，说明如下： true：不覆盖同名文件，直接报错，并禁止写入到存储桶。 false：覆盖同名文件。父节点：OutputProcessing
ProcessStyle	String	是	style01	图片后处理时，通过图片样式指定对象存储的图片处理方式。关于图片样式的详细介绍，请参见创建图片样式。父节点：OutputProcessing
ProcessActions	String	是	image/resize,w_100	图片后处理时，通过图片处理参数指定对象存储的图片处理方式。关于图片处理参数的详细介绍，请参见图片处理概述。父节点：OutputProcessing 说明仅支持配置 ProcessStyle 和 ProcessActions 参数中的一个，不支持同时配置这两个参数。
ModelConfig	String	是	-	配置豆包文生图模型。
ModelAction	String	是	CVProcess	豆包文生图模型接口名称。父节点：ModelConfig
ModelVersion	String	是	2022-08-31	豆包文生图模型接口版本号。父节点：ModelConfig
ReqJson	String	是	"req_key": "high_aes_general_v21_L"	豆包文生图模型接口的请求 body 参数，即您需要在 ReqJson 处设置文生图模型的配置参数，定义期望文生图模型生成的图片样式和内容。详细参数介绍，请参见文生图模型的接口文档。父节点：ModelConfig 说明如果同时配置了 InputDataSource.Prompt 和 ReqJson.Prompt 参数，最终实现的效果以 InputDataSource.Prompt 参数设置的为准。

响应消息头

该请求返回公共响应消息头。更多信息，请参见公共参数。

响应元素

该请求响应会返回调用的豆包文生图模型接口的响应元素，详细参数介绍，请参见文生图模型的接口文档。

请求示例

响应示例