FLUX 3 Image Klein

Быстрый пример

Отправьте запрос на изображение, сохраните полученный id и опрашивайте задачу до completed или failed. API использует асинхронные задачи и выдаёт результат по URL.

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"flux-3-image-klein","prompt":"An amber bottle on pale limestone in soft morning light","resolution":"1k","aspect_ratio":"3:2"}'

Конечная точка и заголовки

POST https://api.seedrouter.ai/v1/images/generations

Храните ключ на сервере. Успех HTTP подтверждает задачу, но не готовность изображения.

Параметры

Принимаются 11 полей. Обязательны только model и prompt. Пропустите необязательные поля для значений по умолчанию; null не принимается.

Пропорции: auto, 21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4, 1:1, 4:5, 3:4, 5:7, 2:3, 9:16, 1:2, 9:21.

В Playground фиксированная модель и десять элементов ввода, включая n, равное 1. Значения безопасности выше 2 доступны только через API, кроме администраторов.

Режимы и ограничения

Без референсов работает генерация по тексту. Один референс позволяет правку, несколько — композицию из разных изображений. С auto правки следуют пропорциям первого референса. Генерация по тексту определяет пропорции из промпта и использует 1:1, если определить их нельзя. Разрешение по умолчанию во всех режимах — 1k.

Уровни обозначают примерный масштаб: 768sq — около 768 × 768; 1K — около 1 MP; 1.5K — около 2 MP; 2K — около 4 MP; 4K — около 16 MP. Реальные размеры проверяйте в возвращённом файле.

Точка не принимает width, height, пиксельные размеры в size, negative_prompt, guidance, grounding, prompt_upsampling, mask или mask_url. Неизвестные поля дают HTTP 400 до оплаты. Вывод WebP, ввод base64, стриминг и обратные вызовы не предлагаются.

Референсы и правки по областям

Перед отправкой загрузите референсы на публичный URL. В теле запроса — URL, не байты файлов и не data URL.

{
  "model": "flux-3-image-klein",
  "prompt": "Use Image 1 as the subject and Image 2 as the setting; match the perspective and light",
  "image_urls": ["https://example.com/subject.png", "https://example.com/setting.png"],
  "aspect_ratio": "auto",
  "resolution": "2k",
  "seed": 0,
  "steps": 16,
  "output_format": "png"
}

Замените URL-заглушки своими доступными изображениями. Референсы упорядочены: первый — ref_image_0. Указания ограничивающих рамок входят в строку prompt, а не в отдельное поле. Координаты [y1, x1, y2, x2] нормируются на 0–1000. Объект компоновки может содержать id, bbox, desc; правка — id, from, src_bbox, tgt_bbox, desc. Кодируйте весь запрос в JSON для правильного экранирования кавычек внутри промпта.

Оплата

Один успешный запрос — одно изображение. Цена определяется только разрешением; шаги, seed, пропорции, число референсов и формат не требуют доплаты. Генерация по тексту и правка тарифицируются одинаково. Неудачные запросы не оплачиваются. См. текущие цены.

Ответ задачи и опрос

Отправка:

{"id":"task_example","model":"flux-3-image-klein","status":"processing"}

curl https://api.seedrouter.ai/v1/tasks/task_example \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

Завершённая задача (пример URL):

{
  "id": "task_example",
  "model": "flux-3-image-klein",
  "status": "completed",
  "output": {"data": [{"url": "https://file.deepytb.com/generated/example.png"}]}
}

Читайте output.data[0].url. Заложите до десяти минут на генерацию, особенно в 4K. Опрос доступен только для чтения; тайм-аут клиента не разрешает отправку ещё одного платного запроса. Публичные ответы не содержат стоимости и баланса.

Ошибки

Ошибки HTTP имеют вид {"error": {"code": integer, "message": string}}. См. общий каталог ошибок. Неудачная задача показывает ошибку вместе с status: "failed". Исправляйте параметры перед повторной отправкой; сохраняйте ID для проверки уже отправленного запроса.

Советы и связанные руководства

Описывайте желаемое и указывайте сохраняемые области или детали. Снижение шагов может менять качество без снижения цены. Сравнивайте по одному изменению.

• FLUX 3 Image Klein Playground
• Скачивание, веса и руководство ComfyUI
• Жизненный цикл задач