创建背景生成任务

图片大小: 不超过 15 MB
图片来源：文件上传（二进制）或从 URL 下载
图片内容: 必须是透明PNG图片，仅有前景。

请求参数

Header 参数

X-API-KEY

string

必需

Body 参数multipart/form-data

image_file

string

可选

源图像文件（二进制）。（如果此参数存在，则其他图像源参数必须为空）

image_url

string

可选

源图像URL。(如果存在此参数，则其他图像源参数必须为空)

batch_size

integer

可选

每次生成图片数，默认为2张

prompt

string

可选

背景提示词，各种语言都支持，但英文效果最好，字符串最高为1024。

scene_type

integer

可选

背景模版，默认提供随机模版，可从接口中获取最新模版ID。（prompt、scene_type二选一）

返回响应

🟢200成功

application/json

Body

status

string

必需

200
任务创建成功。
400
客户端参数传递错误。请检查参数是否缺失或值是否正确
401
认证失败。请检查X-API-KEY是否正确或者服务是否开通
429
请求频率超出QPS限制（默认QPS为2）。请放缓请求速率，或者联系商务提升QPS限制

message

string

必需

data

object

必需

task_id

string

必需

示例

{
    "status": 200,
    "message": "ok",
    "data": {
        "task_id": "94806a3f-1173-4afb-9bcc-3ff19c0981f4"
    }
}

创建背景生成任务

请求参数

示例代码

返回响应