Modelos

Cada modelo que puedes llamar tiene un ID de modelo, que va en el campo model de createTask. La tabla al final de esta página los lista todos con su precio de partida; cada nombre lleva a una página de referencia con la lista completa de parámetros, los tramos de precio y una solicitud lista para copiar.

Cómo se forma un ID de modelo

<maker>/<model>/<task>
alibaba/wan-3.0/image-to-video
google/nano-banana-2.1/edit
popnow/background-remover-v1/edit

• maker es quien creó el modelo. Las herramientas hechas por PopNow usan popnow.
• model conserva los puntos de la versión: seedance-2.0, no seedance-2-0.
• task dice qué hace la llamada: text-to-image, edit, image-to-video, reference-to-video, video-extend, text-to-speech, text-to-audio, etc. La edición de imágenes siempre es edit.

Una familia de modelos suele tener varios IDs, uno por tarea. Elige el que encaje con lo que envías: .../text-to-video solo lleva prompt; .../image-to-video necesita una imagen inicial.

Lee el catálogo desde el código

La referencia es el catálogo en vivo: incluye qué está disponible ahora mismo y los precios que se aplican a tu cuenta.

# Every video model, with input schemas
curl "https://api.popnow.ai/api/v1/models?modality=video&includeSchema=1" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

# One model. The ID contains slashes; send it as it is.
curl "https://api.popnow.ai/api/v1/models/alibaba/wan-3.0/image-to-video" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Filtros de la lista: modality (image, video, audio), provider, task, search, además de includeSchema=1 e includeExamples=1 para añadir esquemas de entrada y ejemplos de entrada validados. Si tu cliente HTTP trata un parámetro de ruta como un único segmento, codifica las barras como %2F.

Campos que conviene leer

Leer precios

credits es el mismo precio que muestra popnow.ai, en créditos (1 crédito = 0,01 USD):

"credits": {
  "unit": "per_second",
  "perUnit": 6.75,
  "rules": [
    { "when": { "*": "480p" }, "perUnit": 6.75 },
    { "when": { "*": "720p" }, "perUnit": 13.5 },
    { "when": { "*": "1080p" }, "perUnit": 27 }
  ]
}

unit dice cómo escala el precio (per_image, per_second, per_request, per_1k_characters), perUnit es el precio de partida y cada regla se aplica cuando la solicitud coincide con sus valores when (* representa el ajuste que decide el tramo, aquí resolution). El cargo final de una tarea se redondea hacia arriba a créditos enteros.

Para saber el importe exacto de una solicitud concreta, pregunta a jobs/quote con el mismo cuerpo que enviarías a createTask.

Esquemas de entrada

inputSchema es JSON Schema estándar (draft 2020-12). Algunas reglas valen para todos los modelos:

• Los campos desconocidos se rechazan. Un aspect_ration mal escrito devuelve 400 en lugar de ignorarse en silencio.
• Los nombres de campo son comunes entre modelos. Una misma idea siempre tiene el mismo nombre: prompt, negative_prompt, image_url, image_urls, video_url, audio_url, duration_seconds, aspect_ratio, resolution, seed, generate_audio.
• Los valores por defecto se rellenan solos. Envía solo lo que quieras cambiar.
• Los campos de medios aceptan una URL HTTPS pública, un archivo popnow:// que subiste o un recurso guardado. Mira Medios.
• Las pistas de presentación van en un objeto x-ui en cada propiedad (etiquetas, orden, pasos de los deslizadores). Nunca cambian la validación; ignora las claves que no conozcas.

Si omites seed en un modelo que lo tiene, se elige uno al azar y se devuelve en el input de la tarea, para que puedas repetir un resultado que te guste.

Caché

Las respuestas del catálogo son privadas de tu cuenta y se pueden cachear 60 segundos. Un buen patrón: cachear la lista unos minutos, volver a leer un modelo cuando cambie su version y tratar available: false como «inténtalo más tarde o elige otro modelo».

Todos los modelos que puedes llamar

Los precios son el tramo más bajo por unidad; resoluciones más altas, clips más largos y opciones extra cuestan más. La página de cada modelo muestra todos los tramos.