POST /images/generations

Genera imágenes según los límites de salida del modelo seleccionado. La Base URL es https://api.modelrush.ai/v1.

Campos: model, prompt. Consulta los campos y límites de cada modelo en GET /models → operations.input_schema. Z-Image usa width/height y n=1; Z-Image Pro también acepta prompt_extend. Otros modelos pueden usar size, quality, output_format, watermark o thinking_mode. Envía Authorization: Bearer $MODELRUSH_API_KEY en las rutas autenticadas y Content-Type: application/json en los cuerpos JSON.

Campos: Modelos asíncronos: HTTP 202 con id y poll_url; consulta GET /predictions/:id hasta succeeded o failed y lee outputs. Modelos síncronos: id, generation_request_id, model, modelrush_region, data. Conserva los identificadores de petición o de generación devueltos. Las salidas generadas y sus referencias de archivo en el proveedor se eliminan de la base de datos de ModelRush 24 horas después de completarse la petición; descarga lo que necesites conservar.

Las entradas no válidas devuelven una respuesta 4xx con un error estructurado. Un 403 con adult_attestation_required, portrait_rights_attestation_required o person_rights_confirmation_required debe resolverlo la persona titular de la cuenta y nunca debe reintentarse automáticamente. Reintenta los 429 según Retry-After; reintenta los fallos 5xx solo con una política de retroceso acotada.

Abre la página del modelo para consultar parámetros y precios actuales. Las cuatro páginas de Wan 3 incluyen una sección API debajo del Playground. GET /v1/models ofrece los esquemas y el acceso permitido a tu clave; GET /api/model-pricing devuelve precios públicos sin autenticación; con una clave API Bearer válida, devuelve los precios aplicables a esa cuenta.

Las solicitudes de imagen de ModelRush pueden devolver HTTP 202, id y poll_url. Consulta esa URL con la misma clave; GET /v1/predictions/:id termina con succeeded y outputs. Z-Image Pro Spicy acepta width y height de 256 a 2560 (1024 por defecto), n = 1 y prompt_extend = false por defecto. Z-Image Spicy también genera una imagen por solicitud. No copies los límites de tamaño o cantidad de otro modelo.