curl --request POST \
--url https://api.apiyi.com/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "flux-2-pro",
"prompt": "Naturally blend these two images",
"input_image": "https://static.apiyi.com/apiyi-logo.png"
}
'import requests
url = "https://api.apiyi.com/v1/images/generations"
payload = {
"model": "flux-2-pro",
"prompt": "Naturally blend these two images",
"input_image": "https://static.apiyi.com/apiyi-logo.png"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
model: 'flux-2-pro',
prompt: 'Naturally blend these two images',
input_image: 'https://static.apiyi.com/apiyi-logo.png'
})
};
fetch('https://api.apiyi.com/v1/images/generations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.apiyi.com/v1/images/generations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'model' => 'flux-2-pro',
'prompt' => 'Naturally blend these two images',
'input_image' => 'https://static.apiyi.com/apiyi-logo.png'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.apiyi.com/v1/images/generations"
payload := strings.NewReader("{\n \"model\": \"flux-2-pro\",\n \"prompt\": \"Naturally blend these two images\",\n \"input_image\": \"https://static.apiyi.com/apiyi-logo.png\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.apiyi.com/v1/images/generations")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"model\": \"flux-2-pro\",\n \"prompt\": \"Naturally blend these two images\",\n \"input_image\": \"https://static.apiyi.com/apiyi-logo.png\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.apiyi.com/v1/images/generations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"model\": \"flux-2-pro\",\n \"prompt\": \"Naturally blend these two images\",\n \"input_image\": \"https://static.apiyi.com/apiyi-logo.png\"\n}"
response = http.request(request)
puts response.read_body{
"created": 1776832476,
"data": [
{
"url": "https://delivery-eu.bfl.ai/results/xxx/sample.jpeg?signature=..."
}
]
}Справочник API по редактированию изображений
Справочник API по редактированию изображений FLUX и интерактивный отладчик — загружайте до 8 эталонных изображений + инструкции для редактирования одного изображения, слияния нескольких эталонных изображений. Работает с FLUX.2 и FLUX.1 Kontext.
curl --request POST \
--url https://api.apiyi.com/v1/images/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "flux-2-pro",
"prompt": "Naturally blend these two images",
"input_image": "https://static.apiyi.com/apiyi-logo.png"
}
'import requests
url = "https://api.apiyi.com/v1/images/generations"
payload = {
"model": "flux-2-pro",
"prompt": "Naturally blend these two images",
"input_image": "https://static.apiyi.com/apiyi-logo.png"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
model: 'flux-2-pro',
prompt: 'Naturally blend these two images',
input_image: 'https://static.apiyi.com/apiyi-logo.png'
})
};
fetch('https://api.apiyi.com/v1/images/generations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.apiyi.com/v1/images/generations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'model' => 'flux-2-pro',
'prompt' => 'Naturally blend these two images',
'input_image' => 'https://static.apiyi.com/apiyi-logo.png'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.apiyi.com/v1/images/generations"
payload := strings.NewReader("{\n \"model\": \"flux-2-pro\",\n \"prompt\": \"Naturally blend these two images\",\n \"input_image\": \"https://static.apiyi.com/apiyi-logo.png\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.apiyi.com/v1/images/generations")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"model\": \"flux-2-pro\",\n \"prompt\": \"Naturally blend these two images\",\n \"input_image\": \"https://static.apiyi.com/apiyi-logo.png\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.apiyi.com/v1/images/generations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"model\": \"flux-2-pro\",\n \"prompt\": \"Naturally blend these two images\",\n \"input_image\": \"https://static.apiyi.com/apiyi-logo.png\"\n}"
response = http.request(request)
puts response.read_body{
"created": 1776832476,
"data": [
{
"url": "https://delivery-eu.bfl.ai/results/xxx/sample.jpeg?signature=..."
}
]
}Bearer sk-xxx). Вставьте публичный URL референсного изображения 1 в input_image; для нескольких референсов заполните URL дополнительных изображений в input_image_2 … input_image_8. Затем заполните prompt / model и отправьте. Playground принимает только URL; для входных данных base64 data URL скопируйте приведенные ниже примеры кода и запустите их локально.- Вариант A (Playground этой страницы, рекомендуется): JSON +
input_imageдо/v1/images/generations(общий с text-to-image — отправкаinput_imageактивирует режим редактирования). Работает для всех моделей FLUX (включая Kontext, подтверждено) и поддерживает объединение нескольких референсов (input_image_2~input_image_8). - Вариант B: multipart-эндпоинт
/v1/images/edits, совместимый с OpenAI (см. раздел «Вариант B» ниже) — редактирование одного изображения, напрямую совместимое сclient.images.edit()в OpenAI SDK.
- Путь эндпоинта:
/v1/images/generations(общий с text-to-image; также существует совместимый с OpenAI однокадровый/v1/images/editsэндпоинт — см. Вариант B) - Content-Type:
application/json(эндпоинт/editsв Варианте B вместо этого используетmultipart/form-data) - Каждое поле референсного изображения является строкой:
input_image/input_image_2…input_image_8принимают публичный URL (рекомендуется) или data URLdata:image/...;base64,xxx - Максимальное число референсных изображений зависит от модели: FLUX.2 [pro/max/flex] до 8, FLUX.2 [klein] до 4, FLUX.1 Kontext нативно поддерживает 1
- Каждое изображение ≤ 20MB или 20MP, форматы
png/jpg/webp - Входное разрешение: минимум 64×64, максимум 4MP; размеры должны быть кратны 16
- URL результата действителен только 10 минут —
data[0].urlнеобходимо скачать немедленно - Если
aspect_ratioне указан, размеры выхода будут соответствовать первому входному изображению
input_image / input_image_2 / input_image_3 … точно соответствует индексу, используемому для “image 1 / image 2 / image 3” в вашем prompt:Поместите человека из image 1 в сцену из image 2, применив цветовую палитру image 3.Каждое значение должно быть общедоступным URL (рекомендуется ≤ 20MB) или data URL
data:image/png;base64,xxx.Примеры кода
cURL (слияние двух изображений · URL)
curl -X POST "https://api.apiyi.com/v1/images/generations" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-2-pro",
"prompt": "Naturally blend these two images",
"input_image": "https://static.apiyi.com/apiyi-logo.png",
"input_image_2": "https://images.unsplash.com/photo-1762138012600-2ab523f8b35a",
"seed": 42,
"output_format": "jpeg"
}'
cURL (слияние трёх изображений · URL)
curl -X POST "https://api.apiyi.com/v1/images/generations" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-2-pro",
"prompt": "The person from image 1 is petting the cat from image 2, the bird from image 3 is next to them",
"input_image": "https://example.com/person.jpg",
"input_image_2": "https://example.com/cat.jpg",
"input_image_3": "https://example.com/bird.jpg",
"seed": 42,
"output_format": "jpeg"
}'
cURL (редактирование одного изображения · Kontext)
curl -X POST "https://api.apiyi.com/v1/images/generations" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-kontext-pro",
"prompt": "Convert this architectural photo into a pencil sketch style, preserve all structural details",
"input_image": "https://your-oss.example.com/architecture.jpg"
}'
cURL (локальный файл · data URL base64)
# Encode local image as base64 data URL (macOS / Linux)
B64=$(base64 -w0 < person.png 2>/dev/null || base64 < person.png | tr -d '\n')
curl -X POST "https://api.apiyi.com/v1/images/generations" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d "$(jq -nc --arg img "data:image/png;base64,$B64" '{
model: "flux-2-pro",
prompt: "Stylize image 1 as an oil painting",
input_image: $img
}')"
Python (requests · слияние двух изображений)
import requests
resp = requests.post(
"https://api.apiyi.com/v1/images/generations",
headers={
"Authorization": "Bearer sk-your-api-key",
"Content-Type": "application/json",
},
json={
"model": "flux-2-pro",
"prompt": "Naturally blend these two images",
"input_image": "https://static.apiyi.com/apiyi-logo.png",
"input_image_2": "https://images.unsplash.com/photo-1762138012600-2ab523f8b35a",
"seed": 42,
"output_format": "jpeg",
},
timeout=120,
)
image_url = resp.json()["data"][0]["url"]
# data[0].url is valid for only 10 minutes — download immediately
with open("fused.jpg", "wb") as f:
f.write(requests.get(image_url, timeout=30).content)
Python (requests · локальный файл как base64)
import base64, requests, mimetypes
def to_data_url(path: str) -> str:
mime = mimetypes.guess_type(path)[0] or "image/png"
with open(path, "rb") as f:
b64 = base64.b64encode(f.read()).decode()
return f"data:{mime};base64,{b64}"
resp = requests.post(
"https://api.apiyi.com/v1/images/generations",
headers={
"Authorization": "Bearer sk-your-api-key",
"Content-Type": "application/json",
},
json={
"model": "flux-2-pro",
"prompt": "Place the person from image 1 into the scene from image 2",
"input_image": to_data_url("person.png"),
"input_image_2": "https://your-oss.example.com/scene.jpg",
},
timeout=120,
)
print(resp.json()["data"][0]["url"])
Python (OpenAI SDK · передача input_image через extra_body)
from openai import OpenAI
import requests
client = OpenAI(
api_key="sk-your-api-key",
base_url="https://api.apiyi.com/v1"
)
# OpenAI SDK images.generate() targets /v1/images/generations with JSON;
# BFL-native fields are added straight into the body via extra_body.
resp = client.images.generate(
model="flux-2-pro",
prompt="Naturally blend these two images",
extra_body={
"input_image": "https://static.apiyi.com/apiyi-logo.png",
"input_image_2": "https://images.unsplash.com/photo-1762138012600-2ab523f8b35a",
"seed": 42,
"output_format": "jpeg",
},
)
image_url = resp.data[0].url
with open("fused.jpg", "wb") as f:
f.write(requests.get(image_url, timeout=30).content)
Node.js (fetch · слияние нескольких референсов)
const resp = await fetch('https://api.apiyi.com/v1/images/generations', {
method: 'POST',
headers: {
'Authorization': 'Bearer sk-your-api-key',
'Content-Type': 'application/json',
},
body: JSON.stringify({
model: 'flux-2-pro',
prompt: 'Naturally blend these two images',
input_image: 'https://static.apiyi.com/apiyi-logo.png',
input_image_2: 'https://images.unsplash.com/photo-1762138012600-2ab523f8b35a',
seed: 42,
output_format: 'jpeg',
}),
});
const { data } = await resp.json();
const img = await fetch(data[0].url);
const fs = await import('node:fs');
fs.writeFileSync('fused.jpg', Buffer.from(await img.arrayBuffer()));
Вариант B: совместимый с OpenAI эндпоинт редактирования (multipart)
Помимо JSON-варианта выше, редактирование изображений FLUX также поддерживает стандартный эндпоинт редактирования OpenAI Images API, напрямую совместимый сclient.images.edit() (проверено 2026-07-04 с flux-kontext-max, генерация выполнена успешно):
- Эндпоинт:
POST https://api.apiyi.com/v1/images/edits - Content-Type:
multipart/form-data(устанавливается автоматически SDK и curl-F— не задавайте его вручную, иначе boundary будет потерян и разбор завершится с ошибкой)
input_image ~ input_image_8). Вариант B на данный момент проверен на серии Kontext.Параметры запроса (поля формы)
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
model | string | ✓ | Напр. flux-kontext-max / flux-kontext-pro |
prompt | string | ✓ | Инструкция редактирования |
image | file | ✓ | Бинарные данные исходного изображения (png/jpg/webp, ≤ 20MB). Имя поля должно быть image — если его опустить, возвращается image is required |
aspect_ratio | string | ✗ | Напр. 1:1 / 16:9, передается как поле формы верхнего уровня; пользователи OpenAI SDK передают его через extra_body |
safety_tolerance | integer | ✗ | 0 (самый строгий) – 6 (самый мягкий) |
Пример cURL
curl -X POST "https://api.apiyi.com/v1/images/edits" \
-H "Authorization: Bearer sk-your-api-key" \
-F "model=flux-kontext-max" \
-F "prompt=Change the outfit to a fashion look" \
-F "aspect_ratio=16:9" \
-F "[email protected]"
Пример на Python (OpenAI SDK)
from openai import OpenAI
client = OpenAI(
api_key="sk-your-api-key",
base_url="https://api.apiyi.com/v1",
)
result = client.images.edit(
model="flux-kontext-max",
image=open("input.jpg", "rb"),
prompt="Change the outfit to a fashion look",
extra_body={"aspect_ratio": "16:9"}, # FLUX-specific params go through extra_body
)
print(result.data[0].url)
Пример на Node.js (fetch + FormData)
const form = new FormData();
form.append('model', 'flux-kontext-max');
form.append('prompt', 'Change the outfit to a fashion look');
form.append('aspect_ratio', '16:9');
form.append('image', imageBlob, 'input.jpg'); // browser Blob or Node's fs.openAsBlob()
const resp = await fetch('https://api.apiyi.com/v1/images/edits', {
method: 'POST',
headers: { 'Authorization': 'Bearer sk-your-api-key' },
// Note: do NOT set Content-Type manually — let the runtime generate the multipart boundary
body: form,
});
const data = await resp.json();
console.log(data.data[0].url);
data[0].url, подписанный URL BFL, действительный 10 минут — в production загружайте его на стороне сервера в собственное хранилище).
Какой вариант следует использовать?
Вариант A (JSON input_image) | Вариант B (multipart /edits) | |
|---|---|---|
| Лучше всего подходит для | Прямого HTTP / frontend-приложений / объединения нескольких референсов | Существующего кода на OpenAI SDK, миграции с client.images.edit() |
| Несколько изображений | Да (flux-2 до 8) | Только одно изображение |
| Входное изображение | Публичный URL или base64 data URL | Бинарный файл |
Справочник параметров
| Поле | Тип | Обязательно | Значение по умолчанию | Описание |
|---|---|---|---|---|
model | string | Yes | — | Идентификатор модели FLUX. Для слияния нескольких референсов предпочтительнее flux-2-pro / flux-2-max; для редактирования одного изображения также flux-kontext-max / flux-kontext-pro |
prompt | string | Yes | — | Инструкция для редактирования / слияния, до 32K token. Используйте «image 1 / image 2 / image 3», чтобы указать порядок image / input_image_2 / input_image_3 |
input_image | string | Yes | — | Референсное изображение 1. Публичный URL (рекомендуется) или data:image/...;base64,xxx data URL |
input_image_2 … input_image_8 | string | No | — | Референсные изображения 2–8 — URL или data URL. FLUX.2 [pro/max/flex] до 8, [klein] 4, Kontext не поддерживает дополнительные |
aspect_ratio | string | No | matches first input | Напр. 1:1 / 16:9 / 9:16 / 4:3 / 3:2 |
seed | integer | No | random | Фиксированное значение для воспроизводимости |
safety_tolerance | integer | No | 2 | 0 (самый строгий) – 6 (наиболее свободный) |
output_format | string | No | jpeg | jpeg / png |
prompt_upsampling | boolean | No | false | Автоматически апскейлить prompt |
steps | integer | No | 50 | Только flux-2-flex, максимум 50 |
guidance | number | No | 4.5 | Только flux-2-flex, 1.5–10 |
Стратегии с несколькими референсами
Согласованность персонажа (до 8 изображений)
Согласованность персонажа (до 8 изображений)
Eight consistent characters from the reference images,
in a fashion editorial set on a Tokyo rooftop at golden hour
Перенос стиля
Перенос стиля
Using the style of image 2, render the subject from image 1
Композиция объектов
Композиция объектов
The person from image 1 is petting the cat from image 2,
the bird from image 3 is next to them
Замена наряда / товара
Замена наряда / товара
Replace the top of the person in image 1 with the one from image 2,
keep the pose and background unchanged
data[0].url, передайте его обратно как input_image в следующем вызове с новой инструкцией и постепенно уточняйте результат. Каждый раунд тарифицируется как одно изображение.Формат ответа
{
"created": 1776832476,
"data": [
{
"url": "https://delivery-eu.bfl.ai/results/xxx/sample.jpeg?signature=..."
}
]
}
data[0].url действует только 10 минут- URL размещен на
delivery-eu.bfl.ai/delivery-us.bfl.ai, срок действия подписи истекает через 10 мин - CORS отключен — браузер
fetchзаблокирован - В production необходимо выполнять загрузку на стороне сервера в ваш собственный OSS / CDN
- Эндпоинт редактирования FLUX не возвращает
b64_json— только url
Вопросы и ответы
Из-за чего возникает ошибка image is required (shell_api_error)?
Из-за чего возникает ошибка image is required (shell_api_error)?
/v1/images/edits (вариант B), но шлюз не смог найти изображение в теле запроса. Типичные причины:- В multipart form нет поля файла
image, либо имя поля указано неверно (например,image[],file) Content-Type: multipart/form-dataбыл установлен вручную без boundary (не задавайте этот заголовок самостоятельно при использовании SDK / fetch / curl)- Конвертация изображения на стороне клиента не удалась, но запрос все равно был отправлен (проверьте, что поле
imageдействительно содержит больше 0 байт) - Вы хотели отправить изображение через JSON, но попали в
/edits— JSON +input_imageидет в/v1/images/generations(вариант A)
Авторизации
API Key from the APIYI Console
Тело
FLUX model ID. For multi-reference fusion prefer flux-2-pro / flux-2-max; for single-image edits also flux-kontext-max / flux-kontext-pro.
flux-2-pro, flux-2-max, flux-2-flex, flux-2-klein-9b, flux-2-klein-4b, flux-kontext-max, flux-kontext-pro Edit / fusion instruction. In multi-reference scenarios, refer to images by index: 'image 1' / 'image 2' / 'image 3' map to input_image / input_image_2 / input_image_3.
"Naturally blend these two images"
Public URL for reference image 1 (required). Use plain URLs in the Playground; for local code you can also pass a data:image/png;base64,xxx data URL.
"https://static.apiyi.com/apiyi-logo.png"
Public URL for reference image 2 (optional)
Public URL for reference image 3 (optional)
Public URL for reference image 4 (optional)
Public URL for reference image 5 (optional)
Public URL for reference image 6 (optional)
Public URL for reference image 7 (optional)
Public URL for reference image 8 (optional, only FLUX.2 [pro/max/flex] supports up to 8)
Aspect ratio, e.g. 1:1 / 16:9 / 9:16 / 4:3 / 3:4. Defaults to first input image.
Fix for reproducibility.
Moderation level. 0 = strictest, 6 = most permissive. Default 2.
0 <= x <= 6Output format. Default jpeg.
jpeg, png Auto-upsample the prompt. Default false.
Only flux-2-flex. Inference steps. Default 50.
1 <= x <= 50Only flux-2-flex. Guidance scale. Default 4.5.
1.5 <= x <= 10Была ли эта страница полезной?