创建任务 stability-ai/sdxl

POST /replicate/v1/predictions

MethodPOST
Path/replicate/v1/predictions
Typehttp
Status1
Module2102810
Folder62419371

说明

概览

MethodPOST
Path/replicate/v1/predictions
Typehttp
Status1
Module2102810
Folder62419371

参数

{
  "query": [],
  "path": [],
  "cookie": [],
  "header": [
    {
      "required": false,
      "description": "",
      "type": "string",
      "id": "GTujCrB2It",
      "enable": true,
      "name": "Authorization",
      "sampleValue": "Bearer {{YOUR_API_KEY}}"
    }
  ]
}

请求体

{
  "type": "application/json",
  "parameters": [],
  "jsonSchema": {
    "type": "object",
    "properties": {
      "input": {
        "type": "object",
        "properties": {
          "width": {
            "type": "integer",
            "description": "输出图像的宽度。默认值:1024。"
          },
          "height": {
            "type": "integer",
            "description": "输出图像的高度。默认值:1024。"
          },
          "prompt": {
            "type": "string",
            "description": "输入提示。"
          },
          "refine": {
            "type": "string",
            "description": "使用哪种精炼风格。默认值:“no_refiner”。"
          },
          "scheduler": {
            "type": "string",
            "description": "调度程序。默认值:“K_EULER”。"
          },
          "lora_scale": {
            "type": "number",
            "description": "LoRA 加法缩放。仅适用于经过训练的模型。默认值:0.6。"
          },
          "num_outputs": {
            "type": "integer",
            "description": "要输出的图像数量。默认值:1。最小值:1,最大值:4。"
          },
          "guidance_scale": {
            "type": "number",
            "description": "无分类器引导尺度。默认值:7.5。最小值:1,最大值:50。"
          },
          "apply_watermark": {
            "type": "boolean",
            "description": "应用水印,以便确定图像是否在下游应用程序中生成。如果您有其他安全生成或部署图像的规定,则可以使用此方法禁用水印。默认值:true。"
          },
          "high_noise_frac": {
            "type": "number",
            "description": "对于 expert_ensemble_refiner,要使用的噪声分数。默认值:0.8。最小值:0,最大值:1。"
          },
          "negative_prompt": {
            "type": "string",
            "description": "输入否定提示。默认:””。"
          },
          "prompt_strength": {
            "type": "number",
            "description": "使用 img2img / inpaint 时的提示强度。1.0 对应于完全破坏图像中的信息。默认值:0.8。最小值:0,最大值:1。"
          },
          "num_inference_steps": {
            "type": "integer",
            "description": "去噪步骤数。默认值:50。最小值:1,最大值:500。"
          }
        },
        "x-apifox-orders": [
          "width",
          "height",
          "prompt",
          "refine",
          "scheduler",
          "lora_scale",
          "num_outputs",
          "guidance_scale",
          "apply_watermark",
          "high_noise_frac",
          "negative_prompt",
          "prompt_strength",
          "num_inference_steps"
        ]
      }
    },
    "x-apifox-orders": [
      "input"
    ]
  },
  "mediaType": "",
  "examples": [
    {
      "value": "{\n     \"version\": \"stability-ai/sdxl:7762fd07cf82c948538e41f63f77d685e02b063e37e496e96eefd46c929f9bdc\",\n    \"input\": {\n      \"width\": 768,\n      \"height\": 768,\n      \"prompt\": \"An astronaut riding a rainbow unicorn, cinematic, dramatic\",\n      \"refine\": \"expert_ensemble_refiner\",\n      \"scheduler\": \"K_EULER\",\n      \"lora_scale\": 0.6,\n      \"num_outputs\": 1,\n      \"guidance_scale\": 7.5,\n      \"apply_watermark\": false,\n      \"high_noise_frac\": 0.8,\n      \"negative_prompt\": \"\",\n      \"prompt_strength\": 0.8,\n      \"num_inference_steps\": 25\n    }\n  }",
      "mediaType": "application/json",
      "description": ""
    }
  ],
  "oasExtensions": ""
}

响应

[
  {
    "id": 728553463,
    "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"
          ]
        },
        "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"
          ]
        }
      },
      "required": [
        "id",
        "model",
        "version",
        "input",
        "logs",
        "output",
        "data_removed",
        "error",
        "status",
        "created_at",
        "urls"
      ]
    },
    "itemSchema": {},
    "description": "",
    "mediaType": "",
    "headers": [],
    "oasExtensions": ""
  }
]

响应示例

[
  {
    "name": "Create image",
    "responseId": 728553463,
    "data": "{\n    \"created\": 1589478378,\n    \"data\": [\n        {\n            \"url\": \"https://...\"\n        },\n        {\n            \"url\": \"https://...\"\n        }\n    ]\n}",
    "description": "",
    "oasKey": "",
    "oasExtensions": "",
    "id": 648850336
  },
  {
    "name": "成功示例",
    "responseId": 728553463,
    "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": 648850337
  }
]