Por capacidad
Imágenes
Elige un modelo, copia la solicitud y obtén la imagen. Todo lo de abajo se adapta al modelo que elijas.
#1. Elige un modelo
#3. Obtén el resultado
La llamada de envío responde de inmediato con un task_id. Consulta la tarea cada pocos segundos hasta que status sea completed, o pasa webhook_url y te llamaremos cuando termine.
GET https://www.aisplice.store/v1/images/tasks/{task_id}
GET https://www.aisplice.store/v1/images/tasks/{task_id}/content
Solo se cobra si tiene éxito
Valores de estado y consulta periódica →Recibe un callback en lugar de consultar →
#Si algo sale mal
- 400 con un nombre de campo: este modelo no acepta esa opción; usa los valores indicados en el paso 2.
- Contenido rechazado por el modelo: reformula el prompt; las solicitudes rechazadas no se cobran.
- 402: el saldo no cubre esta solicitud; recarga en Billetera y reintenta.
- 429: reduce el ritmo y reintenta después de los segundos indicados en Retry-After.
- 503 model_not_found: el nombre del modelo es incorrecto o el modelo está fuera de línea; elige uno del paso 1.
#Imágenes de referencia
Pasa URL públicas de imágenes en el campo de imagen de referencia indicado en el paso 2. Si es un archivo local, súbelo primero y usa la URL que recibas.
Integrarlo en tu productoQué opciones mostrar primero a tus usuarios y cuáles dejar para más adelante.
Qué opciones mostrar primero a tus usuariosEmpieza con el prompt y un ajuste de precio; añade el resto cuando el flujo básico funcione.+
Intención creativa
Los campos como prompt van en la UI porque el usuario entiende directamente el resultado que cambian.
Multiplicador de costo
Los campos como duración, resolución, tamaño y cantidad solo deben introducirse cuando el precio ya se pueda explicar.
Cambio de modo
Los campos como imagen, máscara o ID de continuación cambian el propio flujo de trabajo y solo deben aparecer en modos dedicados.
Infraestructura del sistema
Los campos como webhook_secret son para integradores, no para creadores habituales, así que déjalos fuera de la UI predeterminada.
prompt- Cuándo mostrarlo
- Siempre. Es la entrada creativa principal de las tareas de imagen.
- Valor predeterminado recomendado
- Obligatorio en la UI.
- Por qué importa
- Controla el resultado directamente; ocultarlo deja la función inutilizable.
size- Cuándo mostrarlo
- Muéstralo en la primera versión si la facturación cambia según las dimensiones de salida.
- Valor predeterminado recomendado
- Empieza con una proporción recomendada, como 1:1.
- Por qué importa
- Afecta tanto al costo como a la composición del resultado, así que los usuarios necesitan pronto una opción de tamaño sencilla.
quality- Cuándo mostrarlo
- Muéstralo solo cuando los usuarios pidan claramente un nivel más alto o más barato.
- Valor predeterminado recomendado
- Mantenlo en el servidor con el valor predeterminado del modelo.
- Por qué importa
- Cambia el precio y la latencia, pero normalmente no necesita ser un control desde el primer día.
n- Cuándo mostrarlo
- Muéstralo solo cuando la generación por lotes sea un flujo de trabajo central.
- Valor predeterminado recomendado
- Por defecto, 1.
- Por qué importa
- Multiplica el costo de inmediato y puede generar una primera experiencia confusa.
mask / image- Cuándo mostrarlo
- Muéstralo solo en productos de edición o de imagen de referencia.
- Valor predeterminado recomendado
- Ocúltalo en el modo de texto a imagen.
- Por qué importa
- Estos campos convierten el producto de generación en edición, así que no deben filtrarse al flujo básico.
Phase 1
- prompt
- one size or one duration default
- submit -> poll -> content
Phase 2
- one quality or resolution selector
- clear pricing hint
Phase 3
- advanced controls such as reference media, continuation, webhook, or vendor-specific tuningMantén una única fuente de verdad para los resultados
¿Sigues con el problema?
Envíanos el ID de solicitud o el mensaje de error y lo revisaremos.