black-forest-labs/flux-2-dev/editDesde 4 créditos por imagen· Editar imagen

Edición de imagen con FLUX.2 [dev], el modelo de pesos abiertos de Black Forest Labs. Toma de una a tres imágenes de origen y un prompt, mantiene los rostros reconocibles y puede combinar personas de fotos distintas en una sola escena.

Llámalo con el nombre de modelo black-forest-labs/flux-2-dev/edit en POST /jobs/createTask, desde 4 créditos por imagen (0,04 US$). Las cuentas nuevas reciben 30 créditos gratis para que lo pruebes primero en el Playground.

  • Crear imagen
  • Editar imagen
  • Hasta 2K
  • Hasta 3 imágenes de referencia
  • 9 relaciones de aspecto

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

Parámetros de la petición

ParámetroObligatorioDescripción
aspect_ratioNoLa forma del encuadre: horizontal, cuadrado o vertical. auto · 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 · Por defecto: auto
image_urlsSíFotos para editar o combinar. Di en el prompt qué aporta cada una.
promptSíSay what to change and what must stay the same.
resolutionNoTamaño de salida. Más grande es más nítido y cuesta más. 1k · 2k · Por defecto: 1k
seedNoRepite el mismo número para obtener un resultado reproducible. ≥ 0 · ≤ 2147483647

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ándar3,470,035 US$

Cada tarea se redondea al alza a créditos enteros, así que una ejecución en el nivel más bajo cuesta 4 créditos por imagen (0,04 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.2 Dev 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-2-dev/edit 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-2-dev/edit",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "image_urls": [
      "https://media.popnow.ai/influencer/examples/marco.webp"
    ],
    "aspect_ratio": "auto",
    "resolution": "1k"
  }
}'

# 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.2 Dev

¿Cuánto cuesta la API de FLUX.2 Dev?

FLUX.2 Dev cuesta desde 4 créditos (0,04 US$) por imagen con Editar imagen, su tarea más barata. 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.2 Dev en la API?

Pon black-forest-labs/flux-2-dev/text-to-image para Crear imagen; black-forest-labs/flux-2-dev/edit para Editar imagen en el campo model de POST /jobs/createTask.

¿Puede escribir texto dentro de la imagen?

Sí, el texto corto funciona bien: en nuestras pruebas, los letreros entrecomillados salieron escritos tal como los pedimos. Pon las palabras exactas entre comillas e indica dónde van. Los párrafos largos aún pueden contener errores.

¿Funcionan los colores hex?

Sí, como una pista firme. Un código como #FF4F8B junto al letrero de neón tiñó la habitación de magenta. No es una coincidencia exacta de color.

¿Cuántas imágenes de referencia puedo usar?

De una a tres en el modo de edición, en el orden en que las menciona tu prompt. Escribe “la mujer de la imagen 1” y “el hombre de la imagen 2” cuando combines personas.

¿Qué límites tiene la API de FLUX.2 Dev?

Resoluciones: 1K · 2K; Relaciones de aspecto: auto · 1:1 · 16:9 · 9:16 · 4:3 · 3:4 +4; Imágenes de referencia: 3; 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.2 Dev sin escribir código?

Sí. El Playground ejecuta FLUX.2 Dev 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.2 Pro es más constante con el texto y las caras; Dev es el modelo abierto de la familia.

Más sobre FLUX.2 Dev