## 功能描述此接口用于组合使用对象存储的图片处理功能和豆包的文生图模型，并将处理后的图片存储到指定存储桶。 :::tip [分层桶](/docs/6349/1282866)暂不支持 TextToImage 接口。 ::: ## 请求消息样式 ```JSON 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" } } } ``` ## 请求参数和消息头该请求使用的公共请求消息头，请参见[公共参数](/docs/6349/75044)。 |**名称** |**位置** |**参数类型** |**是否必选** |**示例值** |**说明** | |---|---|---|---|---|---| |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 |图片后处理时，通过图片样式指定对象存储的图片处理方式。关于图片样式的详细介绍，请参见[创建图片样式](/docs/6349/805508)。|\ | | | | |父节点：OutputProcessing | |ProcessActions |String |是 |image/resize,w_100 |图片后处理时，通过图片处理参数指定对象存储的图片处理方式。关于图片处理参数的详细介绍，请参见[图片处理概述](/docs/6349/153623)。|\ | | | | |父节点：OutputProcessing|\ | | | | |:::tip|\ | | | | |仅支持配置 `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` 处设置文生图模型的配置参数，定义期望文生图模型生成的图片样式和内容。详细参数介绍，请参见文生图模型的接口文档。|\ | | | | |以下介绍本接口支持的文生图模型以及对应模型的接口文档：|\ | | | | ||\ | | | | |* [通用2.1-文生图](https://www.volcengine.com/docs/6791/1366783)|\ | | | | |* [通用2.0Pro-文生图](https://www.volcengine.com/docs/6791/1339374)|\ | | | | |* [通用2.0-文生图](https://www.volcengine.com/docs/6791/1333839)|\ | | | | |* [通用XL pro-文生图](https://www.volcengine.com/docs/6791/1330195)|\ | | | | |* [通用1.4-文生图](https://www.volcengine.com/docs/6791/1278096)|\ | | | | |* [动漫1.3.X-文生图/图生图](https://www.volcengine.com/docs/6791/1213131)|\ | | | | ||\ | | | | |父节点：ModelConfig|\ | | | | |:::tip|\ | | | | |如果同时配置了 `InputDataSource.Prompt` 和 `ReqJson.Prompt` 参数，最终实现的效果以 `InputDataSource.Prompt` 参数设置的为准。|\ | | | | ||\ | | | | |:::| ## 响应消息头该请求返回公共响应消息头。更多信息，请参见[公共参数](/docs/6349/75044)。 ## 响应元素该请求响应会返回调用的豆包文生图模型接口的响应元素，详细参数介绍，请参见文生图模型的接口文档。 ## 请求示例 ```JSON POST /?x-tos-process=aigc/text_to_imgage HTTP/1.1 Host: examplebucket.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" } } } ``` ## 响应示例 ```JSON HTTP/1.1 200 OK x-tos-id-2: f91b0c03a01300c1-a444ed0 x-tos-request-id: f91b0c03a01300c1-a444ed0 Date: Fri, 30 Jul 2021 06:45:39 GMT server: TosServer Content-Length: 340 { "resp_json": { "code": 10000, "data": { "algorithm_base_resp": { "status_code": 0, "status_message": "Success" }, "binary_data_base64": null, "image_urls": null, "infer_ctx": { "algorithm_key": "high_aes_scheduler_general_v2.1_L", "app_key": "2100428692", "created_at": "2025-04-11T17:09:07.059326209+08:00", "generate_id": "", "log_id": "202504111708592790B4A5F2D6FB08****", "params": { "app_id": "", "aspect_ratio": "", "common_params": "", "ddim_steps": 25, "edit_session_id": "", "fps": 0, "frames": 0, "group_name": "", "height": 512, "input_image_url": "", "is_only_sr": false, "is_pe": true, "llm_result": "", "media_source": "", "n_samples": 0, "negative_prompt": "nsfw, nude, smooth skin, unblemished skin, mole, low resolution, blurry, worst quality, mutated hands and fingers, poorly drawn face, bad anatomy, distorted hands, limbless, 国旗, national flag.", "ori_prompt": "千军万马", "origin_request_id": "", "output_height": 1024, "output_width": 1024, "pe_result": "工笔画风格，展现了千军万马的宏大场面；画面中，士兵们骑着马，手持武器，身穿铠甲，旗帜飘扬，准备战斗。他们站在战场上，周围是烟尘滚滚、硝烟弥漫的战场环境，远处隐约可见敌旗和战马。背景以淡墨勾勒出天空的阴沉，整个作品通过精细的线条和色彩过渡，呈现出一种深邃的历史感和战争氛围。水墨画风格，宣纸质感，俯视视角，全景景别，冷色调，低饱和度色彩，侧面视角。", "predict_tags_result": "", "rephraser_result": "", "req_key": "high_aes_general_v21_L", "rescale": 0, "resolution": "", "scale": 3.5, "seed": -1, "shift": 0, "sr_img2img_fix_steps": 0, "sr_scale": 0, "sr_strength": 0.4, "sr_upscaler": "", "steps": 0, "strength": 0.4, "trace_id": "", "translate_negative_prompt": "nsfw, nude, smooth skin, unblemished skin, mole, low resolution, blurry, worst quality, mutated hands and fingers, poorly drawn face, bad anatomy, distorted hands, limbless, 国旗, national flag.", "translate_prompt": "千军万马", "use_pre_llm": false, "use_prompt_aug": false, "use_sr": true, "version_id": "", "video_url": "", "vlm_edit": "", "vlm_input": "", "vlm_output": "", "width": 512 }, "request_id": "05115c4406066dfb355b94239453c05bae110e6c57470c67999ad0c40c3e91c3", "session_id": "", "time_stamp": "1744362547" }, "llm_result": "工笔画风格，展现了千军万马的宏大场面；画面中，士兵们骑着马，手持武器，身穿铠甲，旗帜飘扬，准备战斗。他们站在战场上，周围是烟尘滚滚、硝烟弥漫的战场环境，远处隐约可见敌旗和战马。背景以淡墨勾勒出天空的阴沉，整个作品通过精细的线条和色彩过渡，呈现出一种深邃的历史感和战争氛围。水墨画风格，宣纸质感，俯视视角，全景景别，冷色调，低饱和度色彩，侧面视角。", "pe_result": "工笔画风格，展现了千军万马的宏大场面；画面中，士兵们骑着马，手持武器，身穿铠甲，旗帜飘扬，准备战斗。他们站在战场上，周围是烟尘滚滚、硝烟弥漫的战场环境，远处隐约可见敌旗和战马。背景以淡墨勾勒出天空的阴沉，整个作品通过精细的线条和色彩过渡，呈现出一种深邃的历史感和战争氛围。水墨画风格，宣纸质感，俯视视角，全景景别，冷色调，低饱和度色彩，侧面视角。", "predict_tags_result": "", "rephraser_result": "", "request_id": "05115c4406066dfb355b94239453c05bae110e6c57470c67999ad0c40c3e91c3", "vlm_result": "" }, "message": "Success", "request_id": "202504111708592790B4A5F2D6FB08CAAC", "status": 10000, "time_elapsed": "7.645061602s" } } ```