1. Replicate
梧柏API使用文档
WHBAI · Replicate
  • WHBAI · Google Gemini 原生 (v1alpha)
  • WHBAI · Google Gemini 原生
  • WHBAI · Ideogram
  • WHBAI · Ideogram V3
  • WHBAI · Midjourney
  • WHBAI · Jimeng
  • WHBAI · Kling
  • WHBAI · Luma
  • WHBAI · Luma V1
  • WHBAI · Omni 视频
  • WHBAI · Pixverse
  • WHBAI · Runway
  • WHBAI · Sora2
  • WHBAI · 统一视频 VEO
  • WHBAI · Vidu
  • WHBAI · 豆包 Volc
  • WHBAI · Suno
  • WHBAI · Playground
  • WHBAI · 账号与令牌
  • WHBAI · 阿里 Pix
  • WHBAI · 阿里百炼
  • WHBAI · 私域人像
  • WHBAI · Fal.ai
  • WHBAI · Replicate
  • WHBAI · 腾讯云 VOD
  • WHBAI · MiniMax
  • WHBAI · 支持模型列表
  • WHBAI · Grok Imagine
  • WHBAI · Seedance 2.0
  • WHBAI · TypeSafe
  • WHBAI · OpenAI 兼容
  • Replicate
    • 按模型路径创建预测
      POST
    • 创建任务 black-forest-labs/flux-kontext-dev
      POST
    • 按 version 创建预测
      POST
    • 查询预测任务
      GET
    • 创建任务 ideogram-ai/ideogram-v2-turbo
      POST
    • 创建任务 minimax/video-01-live
      POST
    • 创建任务 minimax/video-01
      POST
    • 创建任务 recraft-ai/recraft-v3
      POST
    • 创建任务 recraft-ai/recraft-v3-svg
      POST
    • 创建任务 black-forest-labs/flux-1.1-pro-ultra
      POST
    • 创建任务 black-forest-labs/flux-kontext-pro
      POST
    • 创建任务 black-forest-labs/flux-kontext-max
      POST
    • 创建任务 flux-kontext-apps/multi-image-kontext-max
      POST
    • 创建任务 flux-kontext-apps/multi-image-kontext-pro
      POST
    • 创建任务 riffusion/riffusion
      POST
    • 创建任务 black-forest-labs/flux-fill-dev
      POST
    • 创建任务 black-forest-labs/flux-fill-pro
      POST
    • 创建任务 google/imagen-4-fast
      POST
    • 创建任务 google/imagen-4-ultra
      POST
    • 创建任务 google/imagen-4
      POST
    • 创建任务 prunaai/vace-14b
      POST
    • 创建任务 bytedance/seedream-4
      POST
  • 数据模型
    • PostReplicateV1ModelsBlackForestLabsFluxKontextDevPredictionsResponse
    • GetReplicateV1PredictionsIdResponse
    • PostReplicateV1PredictionsRequest
    • PostReplicateV1PredictionsResponse
    • PostReplicateV1ModelsIdeogramAiIdeogramV2TurboPredictionsResponse
    • PostReplicateV1ModelsMinimaxVideo01LivePredictionsResponse
    • PostReplicateV1ModelsMinimaxVideo01PredictionsResponse
    • PostReplicateV1ModelsRecraftAiRecraftV3PredictionsResponse
    • PostReplicateV1ModelsRecraftAiRecraftV3SvgPredictionsResponse
    • PostReplicateV1ModelsBlackForestLabsFluxKontextMaxPredictionsResponse
    • PostReplicateV1ModelsFluxKontextAppsMultiImageKontextMaxPredictionsResponse
    • PostReplicateV1ModelsFluxKontextAppsMultiImageKontextProPredictionsResponse
    • PostReplicateV1ModelsRiffusionRiffusionPredictionsRequest
    • PostReplicateV1ModelsRiffusionRiffusionPredictionsResponse
    • PostReplicateV1ModelsBlackForestLabsFluxFillDevPredictionsResponse
    • PostReplicateV1ModelsBlackForestLabsFluxFillProPredictionsResponse
    • PostReplicateV1ModelsGoogleImagen4FastPredictionsResponse
    • PostReplicateV1ModelsGoogleImagen4UltraPredictionsResponse
    • PostReplicateV1ModelsGoogleImagen4PredictionsResponse
    • PostReplicateV1ModelsPrunaaiVace14bPredictionsRequest
    • PostReplicateV1ModelsPrunaaiVace14bPredictionsResponse
    • NewApiError
  1. Replicate

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

POST
/replicate/v1/models/black-forest-labs/flux-kontext-dev/predictions
官方文档: https://replicate.com/black-forest-labs/flux-kontext-dev

网站中的模型与调用示例#

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

官方文档: https://replicate.com/black-forest-labs/flux-kontext-dev

请求参数#

{
  "contentType": "application/json",
  "properties": {
    "input": {
      "properties": {
        "aspect_ratio": {
          "description": "生成图像的长宽比。使用“match_input_image”来匹配输入图像的长宽比。默认值:“match_input_image”。",
          "type": "string",
          "x-i18n": {
            "en-US": {
              "description": "The aspect ratio of the generated image. Use \"match_input_image\" to match the aspect ratio of the input image. Default value: \"match_input_image\"."
            }
          }
        },
        "go_fast": {
          "description": "使模型运行速度更快,对于更困难的提示,输出质量可能会略有下降。默认值:true。",
          "type": "boolean",
          "x-i18n": {
            "en-US": {
              "description": "Makes the model run faster, output quality may suffer slightly for more difficult prompts. Default value: true."
            }
          }
        },
        "guidance": {
          "description": "提示词引导强度。默认值: 2.5。最小值:0,最大值:10",
          "type": "number",
          "x-i18n": {
            "en-US": {
              "description": "Cue words guide intensity. Default value: 2.5. Minimum value: 0, maximum value: 10"
            }
          }
        },
        "input_image": {
          "description": "用作参考的图片。必须是 jpeg、png、gif 或 webp 格式。",
          "type": "string",
          "x-i18n": {
            "en-US": {
              "description": "Pictures to use as reference. Must be in jpeg, png, gif or webp format."
            }
          }
        },
        "num_inference_steps": {
          "description": "推理步骤数,默认值:28。最小值:4,最大值:50。",
          "type": "integer",
          "x-i18n": {
            "en-US": {
              "description": "Number of inference steps, default: 28. Minimum value: 4, maximum value: 50."
            }
          }
        },
        "output_format": {
          "description": "输出图像格式。默认值:“webp”。",
          "type": "string",
          "x-i18n": {
            "en-US": {
              "description": "Output image format. Default: \"webp\"."
            }
          }
        },
        "output_quality": {
          "description": "保存输出图像时的质量,范围为 0 至 100。100 为最佳质量,0 为最低质量。与 .png 输出无关。默认值:80。最小值:0,最大值:100。",
          "type": "integer",
          "x-i18n": {
            "en-US": {
              "description": "The quality at which the output image is saved, from 0 to 100. 100 is the best quality, 0 is the lowest quality. Has nothing to do with .png output. Default value: 80. Minimum value: 0, maximum value: 100."
            }
          }
        },
        "prompt": {
          "description": "您想要生成的内容的文本描述,或有关如何编辑给定图像的说明。",
          "type": "string",
          "x-i18n": {
            "en-US": {
              "description": "A text description of what you want generated, or instructions on how to edit a given image."
            }
          }
        }
      },
      "required": [
        "prompt",
        "input_image"
      ],
      "type": "object"
    }
  },
  "required": []
}

请求示例 · 示例 1#

{
  "input": {
    "aspect_ratio": "match_input_image",
    "go_fast": true,
    "guidance": 2.5,
    "input_image": "https://replicate.delivery/pbxt/N5YURZv4ifaW2bMwU7hmrwzgtxf99DTQXpBeobLt1O7dEc3h/pexels-jmark-253096.jpg",
    "num_inference_steps": 30,
    "output_format": "jpg",
    "output_quality": 80,
    "prompt": "Change the car color to red, turn the headlights on"
  }
}

响应示例 · Create image#

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

响应示例 · 成功示例#

{
  "created_at": "2025-07-12T07:27:54.577Z",
  "data_removed": false,
  "error": null,
  "id": "w44zs9cet5rmc0cqzp49gpkhf8",
  "input": {
    "aspect_ratio": "match_input_image",
    "input_image": "https://replicate.delivery/xezq/XfwWjHJ7HfrmXE6ukuLVEpXWfeQ3PQeRI5mApuLXRxST7XMmC/tmpc91tlq20.png",
    "output_format": "jpg",
    "prompt": "Make the letters 3D, floating in space on a city street",
    "prompt_upsampling": false,
    "safety_tolerance": 2
  },
  "logs": "",
  "model": "black-forest-labs/flux-kontext-dev",
  "output": null,
  "status": "starting",
  "urls": {
    "cancel": "https://api.replicate.com/v1/predictions/w44zs9cet5rmc0cqzp49gpkhf8/cancel",
    "get": "https://api.replicate.com/v1/predictions/w44zs9cet5rmc0cqzp49gpkhf8",
    "stream": "https://stream.replicate.com/v1/files/bcwr-h7bu76ujftxzwih5u35puoysogps56mqvpvjz4nrxskhfe7ks42a",
    "web": "https://replicate.com/p/w44zs9cet5rmc0cqzp49gpkhf8"
  },
  "version": "hidden"
}

请求参数

Authorization
Bearer Token
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
or
Header 参数

Body 参数application/json

示例
{
    "input": {
        "prompt": "Change the car color to red, turn the headlights on",
        "go_fast": true,
        "guidance": 2.5,
        "input_image": "https://replicate.delivery/pbxt/N5YURZv4ifaW2bMwU7hmrwzgtxf99DTQXpBeobLt1O7dEc3h/pexels-jmark-253096.jpg",
        "aspect_ratio": "match_input_image",
        "output_format": "jpg",
        "output_quality": 80,
        "num_inference_steps": 30
    }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location '/replicate/v1/models/black-forest-labs/flux-kontext-dev/predictions' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "input": {
        "prompt": "Change the car color to red, turn the headlights on",
        "go_fast": true,
        "guidance": 2.5,
        "input_image": "https://replicate.delivery/pbxt/N5YURZv4ifaW2bMwU7hmrwzgtxf99DTQXpBeobLt1O7dEc3h/pexels-jmark-253096.jpg",
        "aspect_ratio": "match_input_image",
        "output_format": "jpg",
        "output_quality": 80,
        "num_inference_steps": 30
    }
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "id": "tpdf40dypdrma0cram394vvzkg",
    "model": "black-forest-labs/flux-kontext-dev",
    "version": "hidden",
    "input": {
        "aspect_ratio": "match_input_image",
        "go_fast": true,
        "guidance": 2.5,
        "input_image": "https://replicate.delivery/pbxt/N5YURZv4ifaW2bMwU7hmrwzgtxf99DTQXpBeobLt1O7dEc3h/pexels-jmark-253096.jpg",
        "num_inference_steps": 30,
        "output_format": "jpg",
        "output_quality": 80,
        "prompt": "Change the car color to red, turn the headlights on"
    },
    "logs": "",
    "data_removed": false,
    "status": "starting",
    "created_at": "2025-07-29T07:12:42.163Z",
    "urls": {
        "cancel": "https://api.replicate.com/v1/predictions/tpdf40dypdrma0cram394vvzkg/cancel",
        "get": "https://api.replicate.com/v1/predictions/tpdf40dypdrma0cram394vvzkg",
        "stream": "https://stream.replicate.com/v1/files/bcwr-6rywfvqq3376h7243k7xrgtnkaqpwiogzgh7kcehtx7kz3nre6fq",
        "web": "https://replicate.com/p/tpdf40dypdrma0cram394vvzkg"
    }
}
🟠400请求有误
🟠401没有权限
修改于 2026-10-24 18:33:16
上一页
按模型路径创建预测
下一页
按 version 创建预测
Built with