> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cdn-fly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# FLUX.1 Kontext [pro]

> 通过 Starrise AI API 调用 Black Forest Labs FLUX.1 Kontext [pro] 图片编辑与生成模型。

FLUX.1 Kontext \[pro] 是 Black Forest Labs 推出的上下文感知图片生成模型，通过 Starrise AI 提供。可以根据文字生成图片，也可以根据文字指令编辑已有图片。两个接口均为**同步调用** — 直接返回 Base64 编码的图片数据。

* **文生图** — POST JSON 到 `/v1/images/generations`
* **图片编辑** — POST multipart 表单到 `/v1/images/edits`

## 核心能力

* **图片编辑** — 根据文字指令修改已有图片（如"把红色汽车换成蓝色"）
* **文生图** — 根据文字描述生成图片
* **上下文感知** — 理解并保留参考图的上下文信息
* **可复现** — 使用 `seed` 实现确定性生成

## 快速示例

### 文生图

```bash cURL theme={null}
curl https://dayu.cdn-fly.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-1-kontext-pro",
    "prompt": "A cute baby polar bear",
    "size": "1024x1024"
  }'
```

```python Python theme={null}
import requests

response = requests.post(
    "https://dayu.cdn-fly.com/v1/images/generations",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "model": "flux-1-kontext-pro",
        "prompt": "A cute baby polar bear",
        "size": "1024x1024"
    }
)

result = response.json()
# result["data"][0]["b64_json"] 包含 Base64 编码的图片
```

### 图片编辑

```bash cURL theme={null}
curl https://dayu.cdn-fly.com/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=flux-1-kontext-pro" \
  -F "image=@/path/to/photo.jpg" \
  -F "prompt=Change the background to a sunset beach" \
  -F "size=1024x1024"
```

```python Python theme={null}
import requests

response = requests.post(
    "https://dayu.cdn-fly.com/v1/images/edits",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    files={"image": open("/path/to/photo.jpg", "rb")},
    data={
        "model": "flux-1-kontext-pro",
        "prompt": "Change the background to a sunset beach",
        "size": "1024x1024"
    }
)

result = response.json()
# result["data"][0]["b64_json"] 包含 Base64 编码的图片
```

## 文生图参数

| 参数 | 类型 | 必填 | 说明 |
| - | - | - | - |
| `model` | string | 是 | 固定为 `flux-1-kontext-pro` |
| `prompt` | string | 是 | 图片描述。**⚠️ 提示词必须为英文** |
| `n` | integer | 否 | 生成张数。仅支持 `1` |
| `size` | string | 否 | 输出尺寸，如 `1024x1024` |
| `output_format` | string | 否 | `jpeg` 或 `png` |
| `seed` | integer | 否 | 随机种子，用于复现 |

## 图片编辑参数

| 参数 | 类型 | 必填 | 说明 |
| - | - | - | - |
| `model` | string | 是 | 固定为 `flux-1-kontext-pro` |
| `image` | file | 是 | 需要编辑的图片文件（multipart 上传） |
| `prompt` | string | 是 | 编辑指令。**⚠️ 提示词必须为英文** |
| `n` | integer | 否 | 生成张数。仅支持 `1` |
| `size` | string | 否 | 输出尺寸，如 `1024x1024` |

## 响应字段

| 字段 | 说明 |
| - | - |
| `data[].b64_json` | Base64 编码的图片数据 |
| `created` | 创建时间戳 |

> **[API 参考](/zh/api-reference/model-api/blackforestlabs/flux-1-kontext-pro)**
>
> 查看 FLUX.1 Kontext \[pro] 的交互式 API Playground。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.