POST/replicate/v1/predictions

创建任务 stability-ai/stable-diffusion-inpainting

官方文档: https://replicate.com/stability-ai/stable-diffusion-inpainting

API Key application/json

请求示例

curl -X POST https://top.qingyuntop.ai/replicate/v1/predictions \
  -H "Authorization: Bearer ${QINGYUN_TOP_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "version": "stability-ai/stable-diffusion-inpainting:95b7223104132402a9ae91cc677285bc5eb997834bd2349fa486f53910fd68b3",
    "input": {
      "mask": "https://replicate.delivery/pbxt/HtGQBqO9MtVbPm0G0K43nsvvjBB0E0PaWOhuNRrRBBT4ttbf/mask.png",
      "image": "https://replicate.delivery/pbxt/HtGQBfA5TrqFYZBf0UL18NTqHrzt8UiSIsAkUuMHtjvFDO6p/overture-creations-5sI6fQgYIuo.png",
      "width": 512,
      "height": 512,
      "prompt": "Face of a yellow cat, high resolution, sitting on a park bench",
      "scheduler": "DPMSolverMultistep",
      "num_outputs": 1,
      "guidance_scale": 7.5,
      "num_inference_steps": 25
    }
  }'

请求参数

参数	位置	类型	必填	说明	示例
`Authorization`	Header	string	否	-	Bearer {{YOUR_API_KEY}}
`input`	JSON body	object	否	-	-
`input.mask`	JSON body	string	是	黑白图像，用作遮罩，用于对提供的图像进行修复。白色像素将被修复，黑色像素将被保留。	-
`input.image`	JSON body	string	是	用于生成变体的初始图像。将调整为高 x 宽。	-
`input.width`	JSON body	integer	否	生成图像的宽度（以像素为单位）。需要为 64 的倍数。默认值：512。	-
`input.height`	JSON body	integer	否	生成图像的高度（以像素为单位）。需要为 64 的倍数。默认值：512。	-
`input.prompt`	JSON body	string	否	输入提示。	-
`input.scheduler`	JSON body	string	否	选择一个调度程序。默认值：“DPMSolverMultistep”。	-
`input.num_outputs`	JSON body	integer	否	要生成的图像数量。默认值：1。最小值：1，最大值：4。	-
`input.guidance_scale`	JSON body	number	否	无分类器引导尺度。默认值：7.5。最小值：1，最大值：20。	-
`input.num_inference_steps`	JSON body	integer	否	去噪步骤数。默认值：50。最小值：1，最大值：500。	-

返回响应 (200)

参数	位置	类型	必填	说明	示例
`id`	响应 JSON	string	是	-	-
`model`	响应 JSON	string	是	-	-
`version`	响应 JSON	string	是	-	-
`input`	响应 JSON	object	是	-	-
`input.aspect_ratio`	响应 JSON	string	是	-	-
`input.input_image`	响应 JSON	string	是	-	-
`input.output_format`	响应 JSON	string	是	-	-
`input.prompt`	响应 JSON	string	是	-	-
`input.prompt_upsampling`	响应 JSON	boolean	是	-	-
`input.safety_tolerance`	响应 JSON	integer	是	-	-
`logs`	响应 JSON	string	是	-	-
`output`	响应 JSON	null	是	-	-
`data_removed`	响应 JSON	boolean	是	-	-
`error`	响应 JSON	null	是	-	-
`status`	响应 JSON	string	是	-	-
`created_at`	响应 JSON	string	是	-	-
`urls`	响应 JSON	object	是	-	-
`urls.cancel`	响应 JSON	string	是	-	-
`urls.get`	响应 JSON	string	是	-	-
`urls.stream`	响应 JSON	string	是	-	-
`urls.web`	响应 JSON	string	是	-	-

响应示例

{
    "created": 1589478378,
    "data": [
        {
            "url": "https://..."
        },
        {
            "url": "https://..."
        }
    ]
}

来源原始接口定义（用于追溯）

以下内容来自 Apifox 快照，可能包含兼容层字段或旧示例；公开调用请以本页的协议说明和当前模型列表为准。

{
  "id": 497673396,
  "name": "创建任务 stability-ai/stable-diffusion-inpainting",
  "type": "http",
  "serverId": "",
  "preProcessors": [],
  "postProcessors": [
    {
      "type": "customScript",
      "data": "// 将接口返回数据，封装成自己需要的结构\r\nvar resp = {\r\n    response: pm.response.json().data[0].url\r\n}\r\n\r\n// html 模板字符\r\nvar template = `<html><img src=\"{{response}}\" /></html>`;\r\n\r\n// 设置 visualizer 数据。传模板、解析对象。\r\npm.visualizer.set(template, resp);",
      "defaultEnable": true,
      "enable": true,
      "id": "dVmGXhQ9PKRnJxPKOmOd5bStWtKm1e90"
    }
  ],
  "inheritPreProcessors": {},
  "inheritPostProcessors": {},
  "description": "官方文档: https://replicate.com/stability-ai/stable-diffusion-inpainting",
  "operationId": "",
  "sourceUrl": "",
  "method": "post",
  "path": "/replicate/v1/predictions",
  "tags": [],
  "status": 1,
  "requestBody": {
    "type": "application/json",
    "parameters": [],
    "jsonSchema": {
      "type": "object",
      "properties": {
        "input": {
          "type": "object",
          "properties": {
            "mask": {
              "type": "string",
              "description": "黑白图像，用作遮罩，用于对提供的图像进行修复。白色像素将被修复，黑色像素将被保留。"
            },
            "image": {
              "type": "string",
              "description": "用于生成变体的初始图像。将调整为高 x 宽。"
            },
            "width": {
              "type": "integer",
              "description": "生成图像的宽度（以像素为单位）。需要为 64 的倍数。默认值：512。"
            },
            "height": {
              "type": "integer",
              "description": "生成图像的高度（以像素为单位）。需要为 64 的倍数。默认值：512。"
            },
            "prompt": {
              "type": "string",
              "description": "输入提示。"
            },
            "scheduler": {
              "type": "string",
              "description": "选择一个调度程序。默认值：“DPMSolverMultistep”。"
            },
            "num_outputs": {
              "type": "integer",
              "description": "要生成的图像数量。默认值：1。最小值：1，最大值：4。"
            },
            "guidance_scale": {
              "type": "number",
              "description": "无分类器引导尺度。默认值：7.5。最小值：1，最大值：20。"
            },
            "num_inference_steps": {
              "type": "integer",
              "description": "去噪步骤数。默认值：50。最小值：1，最大值：500。"
            }
          },
          "required": [
            "mask",
            "image"
          ],
          "x-apifox-orders": [
            "mask",
            "image",
            "width",
            "height",
            "prompt",
            "scheduler",
            "num_outputs",
            "guidance_scale",
            "num_inference_steps"
          ]
        }
      },
      "x-apifox-orders": [
        "input"
      ]
    },
    "examples": [
      {
        "value": "{\n    \"version\": \"stability-ai/stable-diffusion-inpainting:95b7223104132402a9ae91cc677285bc5eb997834bd2349fa486f53910fd68b3\",\n    \"input\": {\n      \"mask\": \"https://replicate.delivery/pbxt/HtGQBqO9MtVbPm0G0K43nsvvjBB0E0PaWOhuNRrRBBT4ttbf/mask.png\",\n      \"image\": \"https://replicate.delivery/pbxt/HtGQBfA5TrqFYZBf0UL18NTqHrzt8UiSIsAkUuMHtjvFDO6p/overture-creations-5sI6fQgYIuo.png\",\n      \"width\": 512,\n      \"height\": 512,\n      \"prompt\": \"Face of a yellow cat, high resolution, sitting on a park bench\",\n      \"scheduler\": \"DPMSolverMultistep\",\n      \"num_outputs\": 1,\n      \"guidance_scale\": 7.5,\n      \"num_inference_steps\": 25\n    }\n  }",
        "mediaType": "application/json",
        "description": ""
      }
    ],
    "mediaType": "",
    "oasExtensions": "",
    "required": false,
    "additionalContentTypes": []
  },
  "parameters": {
    "path": [],
    "query": [],
    "cookie": [],
    "header": [
      {
        "id": "GTujCrB2It",
        "name": "Authorization",
        "required": false,
        "enable": true,
        "description": "",
        "type": "string",
        "sampleValue": "Bearer {{YOUR_API_KEY}}"
      }
    ]
  },
  "commonParameters": {
    "query": [],
    "body": [],
    "cookie": [],
    "header": []
  },
  "auth": {},
  "responses": [
    {
      "id": 105925208,
      "name": "成功",
      "code": 200,
      "contentType": "json",
      "jsonSchema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "model": {
            "type": "string"
          },
          "version": {
            "type": "string"
          },
          "input": {
            "type": "object",
            "properties": {
              "aspect_ratio": {
                "type": "string"
              },
              "input_image": {
                "type": "string"
              },
              "output_format": {
                "type": "string"
              },
              "prompt": {
                "type": "string"
              },
              "prompt_upsampling": {
                "type": "boolean"
              },
              "safety_tolerance": {
                "type": "integer"
              }
            },
            "required": [
              "aspect_ratio",
              "input_image",
              "output_format",
              "prompt",
              "prompt_upsampling",
              "safety_tolerance"
            ],
            "x-apifox-orders": [
              "aspect_ratio",
              "input_image",
              "output_format",
              "prompt",
              "prompt_upsampling",
              "safety_tolerance"
            ]
          },
          "logs": {
            "type": "string"
          },
          "output": {
            "type": "null"
          },
          "data_removed": {
            "type": "boolean"
          },
          "error": {
            "type": "null"
          },
          "status": {
            "type": "string"
          },
          "created_at": {
            "type": "string"
          },
          "urls": {
            "type": "object",
            "properties": {
              "cancel": {
                "type": "string"
              },
              "get": {
                "type": "string"
              },
              "stream": {
                "type": "string"
              },
              "web": {
                "type": "string"
              }
            },
            "required": [
              "cancel",
              "get",
              "stream",
              "web"
            ],
            "x-apifox-orders": [
              "cancel",
              "get",
              "stream",
              "web"
            ]
          }
        },
        "required": [
          "id",
          "model",
          "version",
          "input",
          "logs",
          "output",
          "data_removed",
          "error",
          "status",
          "created_at",
          "urls"
        ],
        "x-apifox-orders": [
          "id",
          "model",
          "version",
          "input",
          "logs",
          "output",
          "data_removed",
          "error",
          "status",
          "created_at",
          "urls"
        ]
      },
      "itemSchema": {},
      "description": "",
      "mediaType": "",
      "headers": [],
      "oasExtensions": ""
    }
  ],
  "responseExamples": [
    {
      "name": "Create image",
      "responseId": 105925208,
      "data": "{\n    \"created\": 1589478378,\n    \"data\": [\n        {\n            \"url\": \"https://...\"\n        },\n        {\n            \"url\": \"https://...\"\n        }\n    ]\n}",
      "description": "",
      "oasKey": "",
      "oasExtensions": "",
      "id": "019fd25e-4be9-7338-9c8f-76a91d842b51"
    },
    {
      "name": "成功示例",
      "responseId": 105925208,
      "data": "{\n    \"id\": \"w44zs9cet5rmc0cqzp49gpkhf8\",\n    \"model\": \"black-forest-labs/flux-kontext-dev\",\n    \"version\": \"hidden\",\n    \"input\": {\n        \"aspect_ratio\": \"match_input_image\",\n        \"input_image\": \"https://replicate.delivery/xezq/XfwWjHJ7HfrmXE6ukuLVEpXWfeQ3PQeRI5mApuLXRxST7XMmC/tmpc91tlq20.png\",\n        \"output_format\": \"jpg\",\n        \"prompt\": \"Make the letters 3D, floating in space on a city street\",\n        \"prompt_upsampling\": false,\n        \"safety_tolerance\": 2\n    },\n    \"logs\": \"\",\n    \"output\": null,\n    \"data_removed\": false,\n    \"error\": null,\n    \"status\": \"starting\",\n    \"created_at\": \"2025-07-12T07:27:54.577Z\",\n    \"urls\": {\n        \"cancel\": \"https://api.replicate.com/v1/predictions/w44zs9cet5rmc0cqzp49gpkhf8/cancel\",\n        \"get\": \"https://api.replicate.com/v1/predictions/w44zs9cet5rmc0cqzp49gpkhf8\",\n        \"stream\": \"https://stream.replicate.com/v1/files/bcwr-h7bu76ujftxzwih5u35puoysogps56mqvpvjz4nrxskhfe7ks42a\",\n        \"web\": \"https://replicate.com/p/w44zs9cet5rmc0cqzp49gpkhf8\"\n    }\n}",
      "description": "",
      "oasKey": "",
      "oasExtensions": "",
      "id": "019fd25e-4be9-7338-9c8f-786a6553313b"
    }
  ],
  "codeSamples": [],
  "projectId": 8662722,
  "moduleId": 8310462,
  "folderId": 92436086,
  "ordering": 24,
  "responsibleId": 0,
  "commonResponseStatus": {},
  "advancedSettings": {
    "disabledSystemHeaders": {},
    "isDefaultUrlEncoding": 1
  },
  "customApiFields": {},
  "oasExtensions": "",
  "mockScript": {},
  "createdAt": "2026-08-05T14:40:23.000Z",
  "updatedAt": "2026-08-06T12:15:55.000Z",
  "creatorId": 2863449,
  "editorId": 2863449,
  "creatorUserId": 2863449,
  "editorUserId": 2863449,
  "responseChildren": [
    "BLANK.105925208"
  ],
  "visibility": "INHERITED",
  "securityScheme": {},
  "callbacks": ""
}