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 · Por defecto: 1:1 |
guidance_scale | No | Con qué rigor sigue el modelo el prompt. ≥ 1 · ≤ 20 · Por defecto: 3.5 |
loras | No | Carga tus archivos LoRA para fijar un estilo o un personaje. Por defecto: [] |
output_format | No | Tipo de archivo del resultado. jpeg · png · webp · Por defecto: jpeg |
prompt | Sí | Comma-separated tags with score tags first. Put LoRA trigger words at the start. |
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,01 $). 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 | 3,6 | 0,036 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 Prefect Pony XL LoRA 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 prefect/pony-xl-lora/text-to-image 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": "prefect/pony-xl-lora/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1: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 Prefect Pony XL LoRA
¿Cuánto cuesta la API de Prefect Pony XL LoRA?
Prefect Pony XL LoRA cuesta 4 créditos (0,04 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 Prefect Pony XL LoRA en la API?
Pon prefect/pony-xl-lora/text-to-image para Crear imagen en el campo model de POST /jobs/createTask.
¿Qué LoRA funcionan aquí?
Los archivos entrenados para checkpoints SDXL de la familia Pony, pasados como enlace de descarga directa al archivo .safetensors. Los LoRA hechos para otras bases, como Z-Image, FLUX o Anima, no se transfieren: en nuestra prueba uno cargó sin error y no cambió nada.
¿En qué se diferencia de Prefect Pony XL?
Este endpoint agrega un espacio para LoRA, un control de guidance y nueve relaciones de aspecto. La página de Prefect Pony XL ofrece Prefect Pony XL sin espacio para LoRA. Ambos se escriben igual, con las etiquetas de score primero.
¿Por qué solo nueve tamaños?
Los checkpoints SDXL se entrenan con un conjunto fijo de formas de alrededor de un megapíxel. En nuestras pruebas, los tamaños mayores dibujaron personas duplicadas, así que el endpoint expone solo los tamaños nativos.
¿Qué límites tiene la API de Prefect Pony XL LoRA?
Relaciones de aspecto: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +3; Longitud del prompt (caracteres): 5,000. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.
¿Puedo probar Prefect Pony XL LoRA sin escribir código?
Sí. El Playground ejecuta Prefect Pony XL LoRA con tus créditos de PopNow, no necesita clave API y te muestra el código de cada generación.


