ReiluminarAcerca de Relight
Describe la nueva luz y obtén la misma foto reiluminada.
Llámalo con el nombre de modelo popnow/relight-v1/edit en POST /jobs/createTask, desde 30 créditos por imagen (0,03 US$).
Por ahora esta guía solo está en inglés. →
Parámetros de la petición
| Parámetro | Obligatorio | Descripción |
|---|---|---|
aspect_ratio | No | La forma del encuadre: horizontal, cuadrado o vertical. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 |
image_url | Sí | La imagen de partida. |
output_format | No | Tipo de archivo del resultado. jpeg · png · webp · Por defecto: jpeg |
prompt | Sí | The new light: source, direction, colour and hardness, e.g. "Relight the image with warm golden sunset light from a window on the left." |
seed | No | Repite 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,001 $). El importe se retiene cuando se acepta la tarea y se liquida al coste real cuando termina; las tareas fallidas se reembolsan.
| Opción | Créditos por imagen | ≈ USD |
|---|---|---|
| Estándar | 30 | 0,03 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 Relight en tres pasos
- 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.
- Envía la solicitud. Haz POST /jobs/createTask con model popnow/relight-v1/edit y un objeto input según la tabla de parámetros. La respuesta devuelve un ID de tarea al instante.
- 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": "popnow/relight-v1/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"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 Relight
¿Cuánto cuesta la API de Relight?
Relight cuesta 30 créditos (0,03 US$) por imagen. Los créditos son los mismos que en la web (1 crédito = 0,001 $) y las tareas fallidas se reembolsan.
¿Cuál es el nombre de modelo de Relight en la API?
Pon popnow/relight-v1/edit para Reiluminar en el campo model de POST /jobs/createTask.
¿Cómo debo describir la luz?
Nombra la fuente, la dirección, el color y qué tan dura es: "warm golden sunset light coming through a window on the left, hard light with window-frame shadows" o "a single hard spotlight from directly above in a dark studio".
¿Cambiarán la persona o la pose?
No. En nuestras pruebas, los rostros, los atuendos, las poses y el encuadre se mantuvieron; solo cambiaron la luz, la gradación de color y las sombras.
¿Puede cambiar el día por la noche?
Sí, dentro de lo razonable. Una foto de salar al mediodía se convirtió en hora azul con los faros de la camioneta encendidos, y una orilla con niebla al amanecer se convirtió en un atardecer dorado.
¿Qué aporta el LoRA Relight?
Con la misma foto, prompt y seed, el LoRA dio una luz más dura y más direccional, y patrones de cristal de ventana en la pared, donde el modelo base hizo un cambio más suave.
¿Qué límites tiene la API de Relight?
Relaciones de aspecto: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +3; Longitud del prompt (caracteres): 1,000; Subida máxima: 10 MB. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.
¿Puedo probar Relight sin escribir código?
Sí. El Playground ejecuta Relight con tus créditos de PopNow, no necesita clave API y te muestra el código de cada generación.