Створення зображення FLUX

POST

flux

{model}

curl https://api.cometapi.com/flux/v1/flux-2-pro \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A clean editorial photograph of a red ceramic teapot on a pale blue table, a small yellow lemon on the right, soft window light, no text.",
    "seed": 424242,
    "width": 1280,
    "height": 768,
    "output_format": "png"
  }'

{
  "id": "<task_id>",
  "status": "Pending",
  "result": {},
  "polling_url": "https://api.cometapi.com/flux/v1/get_result?id=<task_id>"
}

Огляд

POST /flux/v1/\{model\} створює зображення за допомогою нативного запиту у форматі BFL. За замовчуванням запити виконуються асинхронно. Збережіть id верхнього рівня відповіді, а потім опитуйте GET /flux/v1/get_result за допомогою цього ID завдання. Щоб дочекатися зображення в межах того самого запиту, надішліть "async": false у тілі JSON. Успішна синхронна відповідь містить status: "Ready" і URL-адресу зображення в result.sample. Пісочниця API містить приклади запитів із тексту в зображення для FLUX.2 Pro, Flex і Max. Перегляньте сторінку Моделі або /v1/models, щоб дізнатися ID моделей і доступність для облікового запису.

Поля запиту

Почніть із prompt, width, height і output_format. Також можна надіслати seed; завершений результат може містити використаний seed, але саме це поле не гарантує відтворюваного результату. Необов’язкове поле async визначає спосіб повернення відповіді на запит. Для синхронного генерування використовуйте булеве значення JSON false. Для асинхронного генерування використовуйте true або не вказуйте це поле. Не надсилайте рядок на кшталт "false". Для редагування з еталонним зображенням надішліть загальнодоступну HTTPS URL-адресу зображення в input_image. Це поле підтримується для трьох наведених вище моделей FLUX.2. FLUX.2 Pro також приймає другу загальнодоступну HTTPS URL-адресу в input_image_2; додавайте input_image щоразу, коли надсилаєте input_image_2.

Синхронне генерування

Виберіть Синхронне перетворення тексту на зображення (FLUX.2 Pro) у прикладах запитів, щоб надіслати "async": false. Не закривайте з’єднання, доки генерується зображення. У прикладі використовується 300-секундне обмеження часу клієнта; це налаштування клієнта, а не крайній термін завершення. Коли відповідь містить status: "Ready", зчитайте result.sample безпосередньо. Опитування результату не потрібне. Якщо запит не вдається, обробіть помилку HTTP перед читанням результату. Не поєднуйте async: false з webhook_url або webhook_secret. Синхронні запити повертають результат безпосередньо та відхиляють ці поля webhook.

Надсилання асинхронно та опитування

Коли async має значення true або не вказано, відповідь на створення повертає ID завдання, а генерування триває. Використовуйте його id верхнього рівня з endpoint результатів CometAPI; клієнти не повинні залежати від polling_url, наданого у відповіді. Опитуйте, доки endpoint результатів не поверне status: "Ready". Розглядайте Error, Failed, Failure, Task not found, Request Moderated і Content Moderated як помилки. Для інших станів продовжуйте опитування в межах обмежень повторних спроб і часу очікування вашої програми.

Коли завдання готове, result.sample є тимчасовою URL-адресою зображення. Завантажте або передайте його якнайшвидше; не покладайтеся на фіксований строк дії.

Авторизації

Authorization

string

header

обов'язково

Bearer token authentication. Use your CometAPI key.

Параметри шляху

model

string

обов'язково

FLUX.2 model ID in the URL path. Check /v1/models or the Models page for account availability.

Тіло

application/json

prompt

string

обов'язково

Text prompt describing the image or reference-image edit.

Приклад:

"A clean editorial photograph of a red ceramic teapot on a pale blue table, soft window light, no text."

async

boolean

за замовчуванням:true

Controls whether generation returns asynchronously. Set false to wait for the finished image and read result.sample from the successful response. Set true or omit this field to receive a task ID for polling. Use a JSON boolean, not a string. Do not combine false with webhook_url or webhook_secret.

input_image

string

Public HTTPS URL of the first reference image. Replace the example URL with a publicly accessible image. This editing field is available for the FLUX.2 models covered by this reference.

Приклад:

"https://your-image-host/reference-one.jpg"

input_image_2

string

Public HTTPS URL of a second reference image for flux-2-pro. Replace the example URL and also send input_image.

Приклад:

"https://your-image-host/reference-two.jpg"

seed

integer

Optional seed value. A completed result can report the used seed; that field alone does not establish repeatable output.

width

integer

Requested output width in pixels. Use a dimension supported by the selected model.

Приклад:

1280

height

integer

Requested output height in pixels. Use a dimension supported by the selected model.

Приклад:

768

output_format

string

Requested output image format supported by the selected model. The examples use png.

Приклад:

"png"

Відповідь

200 - application/json

With async: false, successful generation returns status: "Ready" and the image URL in result.sample. With async: true or no async field, save the top-level id and poll the CometAPI result endpoint.

string

обов'язково

Task ID to pass to GET /flux/v1/get_result?id=....

status

string

обов'язково

Task state. A successful synchronous response returns Ready. An asynchronous submission can return Pending while generation continues.

result

object | null

Generation result. A successful synchronous response contains the finished image. An asynchronous submission can return an empty or null result.

Show child attributes

polling_url

string | null

Response-supplied convenience URL when returned. Clients should poll the documented CometAPI result route by the top-level id.

cost

number | null

Numeric billing coefficient when returned. This field is not documented as a currency or credit amount.

input_mp

number | null

Input image megapixels when returned.

output_mp

number | null

Output image megapixels when returned.

progress

number | null

Task progress when returned.

details

any

Additional task details when returned.

preview

any

Task preview data when returned.

Останнє оновлення 21 вересня 2026 р.

curl https://api.cometapi.com/flux/v1/flux-2-pro \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A clean editorial photograph of a red ceramic teapot on a pale blue table, a small yellow lemon on the right, soft window light, no text.",
    "seed": 424242,
    "width": 1280,
    "height": 768,
    "output_format": "png"
  }'

{
  "id": "<task_id>",
  "status": "Pending",
  "result": {},
  "polling_url": "https://api.cometapi.com/flux/v1/get_result?id=<task_id>"
}

Модерація контенту

API-ключі

Створення зображення FLUX

Огляд

Поля запиту

Синхронне генерування

Надсилання асинхронно та опитування

Авторизації

Параметри шляху

Тіло

Відповідь

​Огляд

​Поля запиту

​Синхронне генерування

​Надсилання асинхронно та опитування

Авторизації

Параметри шляху

Тіло

Відповідь

Огляд

Поля запиту

Синхронне генерування

Надсилання асинхронно та опитування