black-forest-labs/flux-kontext-max/text-to-image API
本文介绍 black-forest-labs/flux-kontext-max/text-to-image 模型调用 API 的输入输出参数，供您使用接口时查阅字段含义。
请求参数
请求体
| 字段名 | 类型 | 是否必须 | 默认值 | 描述 |
|---|---|---|---|---|
| prompt | string | 必须 | - | 提示词 |
| model | string | 必须 | - | 本次请求使用的模型名称，此处为 black-forest-labs/flux-kontext-max/text-to-image。 |
| n | int | 可选 | 1 | 生成图片数量，取值范围 1~4 |
| aspect_ratio | string | 可选 | "1:1" | 图像的宽高比，格式为 "宽度:高度"，例如 "16:9" 或 "1:1"。 支持尺寸："21:9", "16:9", "4:3", "3:2", "1:1", "2:3", "3:4", "9:16", "9:21" |
| seed | int | 可选 | -1 | 随机数种子，用于控制模型生成内容的随机性。如果希望生成内容保持一致，可以使用相同的 seed 参数值。 |
| steps | int | 可选 | 20 | 推理次数, 取值范围 1~50 |
| guidance_scale | float | 可选 | 2.5 | 模型输出结果与 prompt 的一致程度，即生成图像的自由度；值越大，模型自由度越小，与用户输入的提示词相关性越强。 取值[1, 10]。 |
| negative_prompt | string | 可选 | - | 负面提示词，用于指定不希望在生成图像中出现的内容 |
| response_format | string | 可选 | "url" | 指定返回生成图像的格式，默认为 url，可选 b64_json |
响应参数
| 字段名 | 类型 | 描述 |
|---|---|---|
| created | integer | 本次请求创建时间的 Unix 时间戳（秒）。 |
| data | array | 输出图像的信息，包括图像下载的 URL 或 Base64。 • 当指定返回生成图像的格式为 url 时，则相应参数的子字段为 url； • 当指定返回生成图像的格式为 b64_json 时，则相应参数的子字段为 b64_json。 注意：链接将在生成后 7 天内失效，请务必及时保存图像。 |
| error | Object | 错误信息对象 |
| error.code | string | 错误码 |
| error.message | string | 错误提示信息 |
| error.param | string | 请求 id |
示例
OPENAI 兼容接口
POST https://api.modelverse.cn/v1/images/generations
同步请求
curl --location 'https://api.modelverse.cn/v1/images/generations' \
--header "Authorization: Bearer $MODELVERSE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "black-forest-labs/flux-kontext-max/text-to-image",
"prompt": "Convert to quick pencil sketch",
"aspect_ratio": "16:9"
}'import os
from openai import OpenAI
client = OpenAI(
base_url=os.getenv("BASE_URL", "https://api.modelverse.cn/v1"),
api_key=os.getenv("API_KEY", "$MODELVERSE_API_KEY")
)
response = client.images.generate(
model="black-forest-labs/flux-kontext-max/text-to-image",
prompt="Convert to quick pencil sketch",
extra_body={
"aspect_ratio": "16:9"
}
)
print(response.data[0].url)响应
{
"created": 1750667997,
"data": [
{
"url": "https://xxxxx/xxxx.png",
"b64_json": "data:image/png;base64,{image_base64_string}"
}
],
"usage": {
"input_tokens_details": {}
}
}{
"error": {
"message": "error_message",
"type": "error_type",
"param": "request_id",
"code": "error_code"
}
}