Consigue tu clave API

de Black Forest Labs

Control de pose, profundidad o bordes en FLUX.1, con tus LoRA

black-forest-labs/flux-1-dev-controlnet-lora/text-to-imageDesde 6 créditospor imagen · 0,06 US$
  • Hasta 1.5K
  • Hasta 4 por generación
  • Carga tus propios LoRA
  • Crear imagen
Atelier night grayscaleVer ejemplos

Acerca de FLUX.1 Dev ControlNet LoRA

FLUX.1 Dev ControlNet LoRA genera imágenes con FLUX.1 [dev] de Black Forest Labs, guiado por ControlNet Union Pro 2.0 de Shakker Labs, con hasta tres archivos LoRA entrenados para FLUX.1 dev. Una imagen de control (un esqueleto de pose, un mapa de profundidad, líneas canny o soft-edge, o una foto en escala de grises) fija la composición; el prompt decide todo lo demás, y nada se filtra.

Llámalo con el nombre de modelo black-forest-labs/flux-1-dev-controlnet-lora/text-to-image en POST /jobs/createTask, desde 6 créditos por imagen (0,06 US$). Las cuentas nuevas reciben 30 créditos gratis para que lo pruebes primero en el Playground.

Por ahora esta guía solo está en inglés. →

Parámetros de la petición

ParámetroObligatorioDescripción
control_guidance_endNoFraction of the denoising steps at which the control image stops applying, from 0 to 1; not before the start. ≥ 0 · ≤ 1 · Por defecto: 0.8
control_guidance_startNoFraction of the denoising steps at which the control image starts to apply, from 0 to 1. ≥ 0 · ≤ 1 · Por defecto: 0
control_image_urlSíControl image: a pose skeleton, depth map, canny or soft-edge line map, or a grayscale or plain photo. The result keeps its aspect ratio.
control_strengthNoHow strongly the result follows the control image, from 0 to 1. ≥ 0 · ≤ 1 · Por defecto: 0.7
guidance_scaleNoCon qué rigor sigue el modelo el prompt. ≥ 0 · ≤ 20 · Por defecto: 3.5
lorasNoCarga tus archivos LoRA para fijar un estilo o un personaje. Por defecto: []
num_outputsNoCuántos resultados crear de una vez. ≥ 1 · ≤ 4 · Por defecto: 1
output_formatNoTipo de archivo del resultado. jpeg · png · webp · Por defecto: jpeg
promptSíDescribe the picture you want: subject, clothing, setting and light. The control image only sets the layout.
resolutionNoTamaño de salida. Más grande es más nítido y cuesta más. 1k · 1.5k · Por defecto: 1k
seedNoRepite el mismo número para obtener un resultado reproducible. ≥ 0 · ≤ 2147483647
stepsNoMás pasos dan más detalle, pero tardan más. ≥ 1 · ≤ 50 · Por defecto: 28

Precios

Los precios están en créditos, los mismos que usas en la web (1 crédito = 0,01 $). El importe se retiene cuando se acepta la tarea y se liquida al coste real cuando termina; las tareas fallidas se reembolsan.

OpciónCréditos por imagen≈ USD
Estándar5,40,054 US$

Cada tarea se redondea al alza a créditos enteros, así que una ejecución en el nivel más bajo cuesta 6 créditos por imagen (0,06 US$).

Para saber la cifra exacta antes de ejecutar, envía el mismo cuerpo a POST /jobs/quote.

Inicio rápido de la API

Llama a la API de FLUX.1 Dev ControlNet LoRA en tres pasos

  1. Crea una clave de API. Inicia sesión en PopNow y crea una clave en la consola de la API. Las claves empiezan por sk-popnow- y usan los mismos créditos que el sitio web.
  2. Envía la solicitud. Haz POST /jobs/createTask con model black-forest-labs/flux-1-dev-controlnet-lora/text-to-image y un objeto input según la tabla de parámetros. La respuesta devuelve un ID de tarea al instante.
  3. Obtén el resultado. Consulta GET /jobs/recordInfo con el ID de tarea, o pasa una callBackUrl y te enviamos el resultado ahí. Descarga los enlaces de salida cuando la tarea termine bien.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "black-forest-labs/flux-1-dev-controlnet-lora/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "control_image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "resolution": "1k",
    "num_outputs": 1,
    "output_format": "jpeg"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Sustituye el prompt y los enlaces por los tuyos. La pestaña API tiene la referencia de la respuesta, el sondeo y el callback.

Preguntas sobre la API de FLUX.1 Dev ControlNet LoRA

¿Cuánto cuesta la API de FLUX.1 Dev ControlNet LoRA?

FLUX.1 Dev ControlNet LoRA cuesta 6 créditos (0,06 US$) por imagen. Los créditos son los mismos que en la web (1 crédito = 0,01 $), las cuentas nuevas reciben 30 créditos gratis y las tareas fallidas se reembolsan.

¿Cuál es el nombre de modelo de FLUX.1 Dev ControlNet LoRA en la API?

Pon black-forest-labs/flux-1-dev-controlnet-lora/text-to-image para Crear imagen en el campo model de POST /jobs/createTask.

¿Qué es una imagen de control?

Un mapa de la estructura que quieres: un esqueleto de pose en colores, un mapa de profundidad en escala de grises, líneas canny o soft-edge blancas sobre negro, o una foto en escala de grises. El modelo copia su composición y su pose, y toma todo lo demás del prompt.

¿Detecta la pose o la profundidad por mí?

No. Envía el mapa ya hecho. También se acepta una foto normal, pero condiciona la imagen igual que un mapa en escala de grises, así que los contornos y las formas de la ropa se trasladan al resultado.

¿Qué LoRA funcionan aquí?

Los LoRA entrenados para FLUX.1 dev, pasados como un enlace de descarga directa al archivo .safetensors. En nuestras pruebas, un LoRA de SDXL hizo fallar la solicitud, así que revisa el modelo base en la página del LoRA antes de cargarlo.

¿Puedo usar las imágenes con fines comerciales?

La licencia de FLUX.1 [dev] de Black Forest Labs te permite usar las imágenes generadas con fines personales, científicos y comerciales. La licencia de cada LoRA que cargues la define su autor, así que revisa su ficha de modelo.

¿Qué límites tiene la API de FLUX.1 Dev ControlNet LoRA?

Resoluciones: 1K · 1.5K; Resultados por llamada: 1–4; Longitud del prompt (caracteres): 5,000; Subida máxima: 10 MB. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.

¿Puedo probar FLUX.1 Dev ControlNet LoRA sin escribir código?

Sí. El Playground ejecuta FLUX.1 Dev ControlNet LoRA con tus créditos de PopNow, no necesita clave API y te muestra el código de cada generación.

Todos los modelos de FLUX

FLUX.1 Dev LoRA no tiene imagen de control y encaja con la composición libre.

Más sobre FLUX.1 Dev ControlNet LoRA