任务：图片添加背景

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数multipart/form-data

image_file

file

必需

源图像文件（二进制），与 image_url 参数二选一

image_url

string

必需

源图像URL，与 image_file 参数二选一

batch_size

enum<integer>

可选

每次生成图片数，默认为2张。不可超过4张。

枚举值:

12

默认值:

2

prompt

string

可选

背景提示词，各种语言都支持，但英文效果最好，字符串最高为1024。（prompt、scene_type二选一）

callback_url

string

可选

回调通知地址：如若需要回调通知，可设置该参数，填写API通知url地址

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.gpt.ge/visual/r-background' \
--form 'image_file=@""' \
--form 'image_url=""' \
--form 'batch_size=""' \
--form 'prompt=""' \
--form 'callback_url=""'

返回响应

🟢200成功

application/json

Body

status

integer

必需

data

object

必需

completed_at

integer

必需

created_at

integer

必需

download_time

integer

必需

err_info

string

必需

foreground_rect

object

必需

image

string

必需

image_height

integer

必需

image_width

integer

必需

output_type

integer

必需

processed_at

integer

必需

progress

integer

必需

result_type

string

必需

return_type

integer

必需

state

integer

必需

state_detail

string

必需

task_id

string

必需

time_elapsed

number

必需

type

string

必需

示例

成功示例1（sync=1）成功示例2（sync=0）

{
  "status": 200,
  "data": {
    "completed_at": 1742670627,
    "created_at": 1742670626,
    "download_time": 488,
    "err_info": "",
    "foreground_rect": {
      "x": 133,
      "y": 110,
      "width": 604,
      "height": 952
    },
    "image": "https://wxtechsz.oss-cn-shenzhen.aliyuncs.com/tasks/output/segmentation/3b950563-e53f-4036-a581-5ac04d0829b3-image.png?x-oss-credential=LTAI5tGjJnh66c1txANiRBQN/20250322/cn-shenzhen/oss/aliyun_v4_request&x-oss-date=20250322T191028Z&x-oss-expires=3600&x-oss-signature=67a3fda34dcf0827e9ec9eae3e84f134a59dedff406a4a79fa5b76bbe16a007c&x-oss-signature-version=OSS4-HMAC-SHA256",
    "image_height": 1152,
    "image_width": 864,
    "output_type": 2,
    "processed_at": 1742670626,
    "progress": 100,
    "result_type": "object",
    "return_type": 1,
    "state": 1,
    "state_detail": "Complete",
    "task_id": "3b950563-e53f-4036-a581-5ac04d0829b3",
    "time_elapsed": 384.54998779296875,
    "type": "auto"
  }
}