跳转到内容

执行 AI 图片扩展 任务。

请求

查询任务状态请参见轮询指南。本接口需要 3 个关键参数:输入图片、锚点、输出图片。

安全
BearerAuthenticationV2
正文application/json必需
Any of:

AI 图片扩展接口需要 3 个关键参数:输入图片、锚点与输出图片。 输出图片的尺寸必须大于输入图片。

output_widthinteger, [ 1 .. 4096 ]必需

输出图片宽度,取值范围 [1 - 4096]

示例:960
output_heightinteger, [ 1 .. 4096 ]必需

输出图片高度,取值范围 [1 - 4096]

示例:1280
input_xinteger, [ 0 .. 4096 ]必需

源图片在输出图片中的左侧位置。坐标按从上到下、从左到右排列。取值范围:[0 - 4096]

示例:240
input_yinteger, [ 0 .. 4096 ]必需

源图片在输出图片中的顶部位置。坐标按从上到下、从左到右排列。取值范围:[0 - 4096]

示例:320
input_widthinteger, [ 1 .. 4096 ]必需

源图片宽度。input_x + input_width 必须 <= output_width。取值范围:[1 - 4096]

示例:480
input_heightinteger, [ 1 .. 4096 ]必需

源图片高度。input_y + input_height 必须 <= output_height。取值范围:[1 - 4096]

示例:640
crop_input_xinteger, [ 0 .. 4096 ]必需

从 x 处裁切源图片。坐标按从上到下、从左到右排列。取值范围:[0 - 4096]

示例:0
crop_input_yinteger, [ 0 .. 4096 ]必需

从 y 处裁切源图片。坐标按从上到下、从左到右排列。取值范围:[0 - 4096]

示例:0
crop_input_widthinteger, [ 1 .. 4096 ]必需

按 crop_input_width 的宽度裁切源图片。取值范围:[1 - 4096]

示例:480
crop_input_heightinteger, [ 1 .. 4096 ]必需

按 crop_input_height 的高度裁切源图片。取值范围:[1 - 4096]

示例:640
src_file_urlstring必需

用于运行任务的文件 URL,该 URL 需可公开访问。

示例:"https://example.com/selfie.jpg"
curl -i -X POST \
  https://yce-api-01.makeupar.com/s2s/v2.0/task/out-paint \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "src_file_url": "https://example.com/selfie.jpg",
    "output_width": 960,
    "output_height": 1280,
    "input_x": 240,
    "input_y": 320,
    "input_width": 480,
    "input_height": 640,
    "crop_input_x": 0,
    "crop_input_y": 0,
    "crop_input_width": 480,
    "crop_input_height": 640
  }'

响应

任务执行成功

正文application/json
statusinteger

响应状态

示例:200
dataobject
响应
{ "status": 200, "data": { "task_id": "grH0CvsgXuAIHLUzD0V1Ol34hoet3R1tvdbtiVHrDb6_UqCLKIejAIajwxrhOAfe" } }