You need to enable JavaScript to run this app.
文档中心
对象存储

对象存储

复制全文
下载 pdf
AIGC
TextToImage
复制全文
下载 pdf
TextToImage
功能描述​
此接口用于组合使用对象存储的图片处理功能和豆包的文生图模型,并将处理后的图片存储到指定存储桶。​
说明​
分层桶暂不支持 TextToImage 接口。​
请求消息样式​
​
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 参数设置的为准。​
​
响应消息头​
该请求返回公共响应消息头。更多信息,请参见公共参数。​
响应元素​
该请求响应会返回调用的豆包文生图模型接口的响应元素,详细参数介绍,请参见文生图模型的接口文档。​
请求示例​
​
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"​
}​
}​
}​
​
响应示例​
​
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"​
}​
}​
​
​
最近更新时间:2026.06.17 16:43:35
这个页面对您有帮助吗?
有用
有用
无用
无用