You need to enable JavaScript to run this app.
导航
ImageToImage
最近更新时间:2025.04.27 10:31:44首次发布时间:2025.04.27 10:31:44
我的收藏
有用
有用
无用
无用

功能描述

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

请求消息样式

GET /?x-tos-process=aigc/image_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": "image_to_image",
    "InputDataSource": {
        "Prompt": "千军万马",
        "ImageUri": "https://xxx"
    },
    "InputProcessing": {
        "ProcessStyle": "",
        "ProcessActions": "image/resize,w_100"
    },
    "OutputProcessing": {
        "Bucket": "tostest",
        "Object": "newgen.jpg",
        "ForbiddenOverwrite": false,
        "ProcessStyle": "",
        "ProcessActions": "image/rotate,90"
    },
    "ModelConfig": {
        "ModelAction": "CVProcess",
        "ModelVersion": "2022-08-31",
        "ReqJson": {
            "req_key": "i2i_xl_sft"
        }
    }
}

请求参数和消息头

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

名称

位置

参数类型

是否必选

示例值

说明

x-tos-process

Query

String

-

代表 ImageToImage 接口请求的特殊标识,取值 aigc/image_to_image

请求元素

名称

参数类型

是否必填

示例值

说明

TaskType

String

image_to_image

任务类型,该场景下,取值 image_to_image,表示组合使用图片处理功能和图生图模型。

InputDataSource

Array of String

-

待处理的原图。

ImageUri

String

1171.jpeg

待处理的原图名称。
父节点:InputDataSource

说明

使用图片处理功能和图生图模型对原图进行处理时,会从请求访问的存储桶中读取图片,所以您只需要填写原图在存储桶中的名称,即可指定原图。

Prompt

String

千军万马

生成图像的提示词。
父节点:InputDataSource

InputProcessing

Array of String

-

在使用图生图模型前,根据需要使用对象存储的图片处理功能对图片进行预处理。

ProcessStyle

String

style01

图片预处理时,通过图片样式指定对象存储的图片处理方式。关于图片样式的详细介绍,请参见创建图片样式
父节点:InputProcessing

ProcessActions

String

image/resize,w_100

图片预处理时,通过图片处理参数指定对象存储的图片处理方式。关于图片处理参数的详细介绍,请参见图片处理概述
父节点:InputProcessing

说明

仅支持配置 ProcessStyleProcessActions 参数中的一个,不支持同时配置这两个参数。

OutputProcessing

Array of String

-

在使用图生图模型生成图片后,根据需要使用对象存储的图片处理功能对图片进行后处理。

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

说明

仅支持配置 ProcessStyleProcessActions 参数中的一个,不支持同时配置这两个参数。

ModelConfig

String

-

配置豆包图生图模型。

ModelAction

String

CVProcess

豆包图生图模型接口名称。

父节点:ModelConfig

ModelVersion

String

2022-08-31

豆包图生图模型接口版本号。
父节点:ModelConfig

ReqJson

String

"req_key": "high_aes"

豆包图生图模型接口的请求 body 参数,即您需要在 ReqJson 处设置图生图模型的配置参数,定义期望图生图模型生成的图片样式和内容。详细参数介绍,请参见图生图模型的接口文档。
以下介绍本接口支持的图生图模型以及对应模型的接口文档:

父节点:ModelConfig

说明

如果同时配置了 InputDataSource.PromptReqJson.Prompt 参数,最终实现的效果以 InputDataSource.Prompt 参数设置的为准。

响应消息头

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

响应元素

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

请求示例

GET /?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": "image_to_image",
    "InputDataSource": {
        "Prompt": "千军万马",
        "ImageUri": "1171.jpeg"
    },
    "InputProcessing": {
        "ProcessStyle": "",
        "ProcessActions": "image/resize,w_100"
    },
    "OutputProcessing": {
        "Bucket": "tostest",
        "Object": "newgen.jpg",
        "ForbiddenOverwrite": false,
        "ProcessStyle": "",
        "ProcessActions": "image/rotate,90"
    },
    "ModelConfig": {
        "ModelAction": "CVProcess",
        "ModelVersion": "2022-08-31",
        "ReqJson": {
            "req_key": "i2i_xl_sft"
        }
    }
}

响应示例

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,
            "comfyui_cost": 5,
            "controlnet_args.canny.binary_data_index": 0,
            "controlnet_args.canny.strength": 0,
            "controlnet_args.depth.binary_data_index": 0,
            "controlnet_args.depth.strength": 0,
            "controlnet_args.pose.binary_data_index": 0,
            "controlnet_args.pose.strength": 0,
            "etta_args.binary_data_index": 1,
            "image_urls": null,
            "multi_pipeline_select_key": "i2i",
            "request_id": "b98ab7c4d28203683e22b80e3da0b6e9cc58aab1ef0ac5efc28724f261acd5a3",
            "style_reference_args.binary_data_index": 0,
            "style_reference_args.id_weight": 0,
            "style_reference_args.style_weight": 0
        },
        "message": "Success",
        "request_id": "202504231214007C87515990141CB30ED2",
        "status": 10000,
        "time_elapsed": "6.430430379s"
    }
}