创建任务 black-forest-labs/flux-kontext-dev

POST /replicate/v1/models/black-forest-labs/flux-kontext-dev/predictions

MethodPOST
Path/replicate/v1/models/black-forest-labs/flux-kontext-dev/predictions
Typehttp
Status1
Module2102810
Folder62419371

说明

概览

MethodPOST
Path/replicate/v1/models/black-forest-labs/flux-kontext-dev/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": {
          "prompt": {
            "type": "string",
            "description": "您想要生成的内容的文本描述,或有关如何编辑给定图像的说明。"
          },
          "go_fast": {
            "type": "boolean",
            "description": "使模型运行速度更快,对于更困难的提示,输出质量可能会略有下降。默认值:true。"
          },
          "guidance": {
            "type": "number",
            "description": "提示词引导强度。默认值: 2.5。最小值:0,最大值:10"
          },
          "input_image": {
            "type": "string",
            "description": "用作参考的图片。必须是 jpeg、png、gif 或 webp 格式。"
          },
          "aspect_ratio": {
            "type": "string",
            "description": "生成图像的长宽比。使用“match_input_image”来匹配输入图像的长宽比。默认值:“match_input_image”。"
          },
          "output_format": {
            "type": "string",
            "description": "输出图像格式。默认值:“webp”。"
          },
          "output_quality": {
            "type": "integer",
            "description": "保存输出图像时的质量,范围为 0 至 100。100 为最佳质量,0 为最低质量。与 .png 输出无关。默认值:80。最小值:0,最大值:100。"
          },
          "num_inference_steps": {
            "type": "integer",
            "description": "推理步骤数,默认值:28。最小值:4,最大值:50。"
          }
        },
        "required": [
          "prompt",
          "input_image"
        ],
        "x-apifox-orders": [
          "prompt",
          "go_fast",
          "guidance",
          "input_image",
          "aspect_ratio",
          "output_format",
          "output_quality",
          "num_inference_steps"
        ]
      }
    },
    "x-apifox-orders": [
      "input"
    ]
  },
  "mediaType": "",
  "examples": [
    {
      "value": "{\n    \"input\": {\n      \"prompt\": \"Change the car color to red, turn the headlights on\",\n      \"go_fast\": true,\n      \"guidance\": 2.5,\n      \"input_image\": \"https://replicate.delivery/pbxt/N5YURZv4ifaW2bMwU7hmrwzgtxf99DTQXpBeobLt1O7dEc3h/pexels-jmark-253096.jpg\",\n      \"aspect_ratio\": \"match_input_image\",\n      \"output_format\": \"jpg\",\n      \"output_quality\": 80,\n      \"num_inference_steps\": 30\n    }\n  }",
      "mediaType": "application/json",
      "description": ""
    }
  ],
  "oasExtensions": ""
}

响应

[
  {
    "id": 728542223,
    "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": [
            "input_image",
            "prompt"
          ],
          "x-apifox-orders": [
            "aspect_ratio",
            "input_image",
            "output_format",
            "prompt",
            "prompt_upsampling",
            "safety_tolerance"
          ]
        }
      },
      "x-apifox-orders": [
        "id",
        "model",
        "version",
        "input"
      ]
    },
    "itemSchema": {},
    "description": "",
    "mediaType": "",
    "headers": [],
    "oasExtensions": ""
  }
]

响应示例

[
  {
    "name": "成功示例",
    "responseId": 728542223,
    "data": "{\n    \"id\": \"tpdf40dypdrma0cram394vvzkg\",\n    \"model\": \"black-forest-labs/flux-kontext-dev\",\n    \"version\": \"hidden\",\n    \"input\": {\n        \"aspect_ratio\": \"match_input_image\",\n        \"go_fast\": true,\n        \"guidance\": 2.5,\n        \"input_image\": \"https://replicate.delivery/pbxt/N5YURZv4ifaW2bMwU7hmrwzgtxf99DTQXpBeobLt1O7dEc3h/pexels-jmark-253096.jpg\",\n        \"num_inference_steps\": 30,\n        \"output_format\": \"jpg\",\n        \"output_quality\": 80,\n        \"prompt\": \"Change the car color to red, turn the headlights on\"\n    },\n    \"logs\": \"\",\n    \"output\": null,\n    \"data_removed\": false,\n    \"error\": null,\n    \"status\": \"starting\",\n    \"created_at\": \"2025-07-29T07:12:42.163Z\",\n    \"urls\": {\n        \"cancel\": \"https://api.replicate.com/v1/predictions/tpdf40dypdrma0cram394vvzkg/cancel\",\n        \"get\": \"https://api.replicate.com/v1/predictions/tpdf40dypdrma0cram394vvzkg\",\n        \"stream\": \"https://stream.replicate.com/v1/files/bcwr-6rywfvqq3376h7243k7xrgtnkaqpwiogzgh7kcehtx7kz3nre6fq\",\n        \"web\": \"https://replicate.com/p/tpdf40dypdrma0cram394vvzkg\"\n    }\n}",
    "description": "",
    "oasKey": "",
    "oasExtensions": "",
    "id": 648839027
  }
]