新网开放接口 Help

flux-kontext-pro

本文介绍 flux-kontext-pro 模型调用 API 的输入输出参数,供您使用接口时查阅字段含义。

以下只展示部分使用到的字段说明,flux-kontext-pro API 详细字段见flux-kontext-pro 官网文档

请求地址

POST https://airouter.xincache.cn/v1/flux-kontext-pro

认证方式

API Key

与官方不同,我们不使用 x-key ,而是使用 Authorization。

请求参数

请求体

字段名

类型

是否必须

默认值

描述

prompt

string

是

无

提示词

input_image

string

否

无

图片base64

input_image_2

string

否

无

图片base64

input_image_3

string

否

无

图片base64

input_image_4

string

否

无

图片base64

seed

int

否

无

种子,可选种子以保证可重复性。

aspect_ratio

string

否

无

图像的宽高比介于21:9到9:21之间

output_format

jpeg/png

否

png

输出格式,可选值为png,jpg。

webhook_url

string

否

无

Webhook URL,用于接收生成结果。

webhook_secret

string

否

无

Webhook Secret,用于验证Webhook请求。

prompt_upsampling

bool

否

false

是否对提示进行上采样。如果激活,会自动修改提示词以实现更具创意的生成。

safety_tolerance

string

否

无

输入和输出调节的容忍水平,可选值为1-6。0表示最严格,6表示最不严格。

响应参数

字段名

类型

描述

createed

int

创建时间

data

[object]

图片数据

data.[].b64_json

string

图片base64

示例

curl

curl -X POST "https://airouter.xincache.cn/v1/flux-kontext-pro" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $XINNETMODEL_API_KEY" \ -d '{ "prompt" : "A photograph of a red fox in an autumn forest" }' | jq -r '.data[0].b64_json' | base64 --decode > flux-pro-1.1.png

python

import requests import os url = "https://airouter.xincache.cn/v1/flux-kontext-pro" headers = { "Content-Type": "application/json", "Authorization": f"Bearer {os.getenv('XINNETMODEL_API_KEY')}" } payload = { "prompt": "A photograph of a red fox in an autumn forest" } response = requests.post(url, headers=headers, json=payload) result = response.json() print(result)
Last modified: 25 April 2026