青云TOP API使用教程&开发文档小白用户&专业开发者快速使用指南
控制台
返回模型调用 API 参考
POST/replicate/v1/models/black-forest-labs/flux-kontext-dev/predictions

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

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

API Key application/json
Replicate Predictions 协议

调用与返回说明

Replicate 图片接口采用 prediction 创建与查询流程。模型版本和输入字段属于具体模型契约，不能把不同模型的 input 对象互相套用。

请求时注意

  • 请求头使用 Authorization: Bearer YOUR_API_KEY 和页面声明的 Content-Type。路径中的厂商名称不改变青云TOP API 的鉴权方式，也不要求客户端携带厂商密钥。
  • 模型 ID、模型版本和后缀必须使用当前账号 GET /v1/models 返回且与本页协议匹配的值；旧示例中的固定型号不能视为永久可用。
  • 异步创建返回的是公开任务或 request ID。请原样保存 ID，并只使用页面对应的查询接口继续读取，不要猜测其他前缀或把上游 ID 当作本站 ID。

返回时注意

  • HTTP 2xx 只表示创建或查询请求被接受；业务成功要检查响应体中的状态字段和结果字段。失败、取消、超时或未完成状态不能当作可下载图片。
  • 查询接口返回的结果 URL、文件 key 或 output 字段可能为空，直到任务进入终态；下载时按页面返回的地址和有效期处理。
Request

请求

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

Body

可选
Bodyapplication/json
Bodyobject
inputobject
promptstring必填

您想要生成的内容的文本描述，或有关如何编辑给定图像的说明。

go_fastboolean

使模型运行速度更快，对于更困难的提示，输出质量可能会略有下降。默认值：true。

guidancenumber

提示词引导强度。默认值: 2.5。最小值：0，最大值：10

input_imagestring必填

用作参考的图片。必须是 jpeg、png、gif 或 webp 格式。

aspect_ratiostring

生成图像的长宽比。使用“match_input_image”来匹配输入图像的长宽比。默认值：“match_input_image”。

output_formatstring

输出图像格式。默认值：“webp”。

output_qualityinteger

保存输出图像时的质量，范围为 0 至 100。100 为最佳质量，0 为最低质量。与 .png 输出无关。默认值：80。最小值：0，最大值：100。

num_inference_stepsinteger

推理步骤数，默认值：28。最小值：4，最大值：50。

路径、查询与 Header 参数

参数位置类型必填说明示例
AuthorizationHeaderstring是必填。使用青云TOP API 的 API Key，保留 Bearer 后的空格。Bearer YOUR_API_KEY
Response

返回响应 200

HTTP 响应
响应 200json
响应 200object
idstring
modelstring
versionstring
inputobject
aspect_ratiostring
input_imagestring必填
output_formatstring
promptstring必填
prompt_upsamplingboolean
safety_toleranceinteger
Replicate Predictions 协议

调用与返回说明

Replicate 图片接口采用 prediction 创建与查询流程。模型版本和输入字段属于具体模型契约，不能把不同模型的 input 对象互相套用。

请求时注意

  • 请求头使用 Authorization: Bearer YOUR_API_KEY 和页面声明的 Content-Type。路径中的厂商名称不改变青云TOP API 的鉴权方式，也不要求客户端携带厂商密钥。
  • 模型 ID、模型版本和后缀必须使用当前账号 GET /v1/models 返回且与本页协议匹配的值；旧示例中的固定型号不能视为永久可用。
  • 异步创建返回的是公开任务或 request ID。请原样保存 ID，并只使用页面对应的查询接口继续读取，不要猜测其他前缀或把上游 ID 当作本站 ID。

返回时注意

  • HTTP 2xx 只表示创建或查询请求被接受；业务成功要检查响应体中的状态字段和结果字段。失败、取消、超时或未完成状态不能当作可下载图片。
  • 查询接口返回的结果 URL、文件 key 或 output 字段可能为空，直到任务进入终态；下载时按页面返回的地址和有效期处理。