Introducción
Astra está pensado para imágenes cuyo acabado puede cambiar al ampliarlas. Un interior generado con IA o una secuencia estilizada puede ganar materiales nuevos; la decisión consiste en aprobar una interpretación, no en confirmar una recuperación documental.
Funciones y aspectos destacados
Tres niveles de creatividad y una descripción opcional permiten variar la libertad del modelo. Las entregas son 720p, 1080p y 4K, sin escalón 2K.
La cava con low y sin prompt ganó cabello y bordes de vidrio, pero también cambió ojo y perfil. Los tres segundos a 1080p tardaron unos 210 segundos; incluso el nivel contenido puede modificar una cara.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
video_url | Sí | Envía un MP4 por enlace o carga de 1–60 segundos. Si dura menos o más, se rechaza antes de aceptar; la versión creativa mantiene duración y audio. mínimo 1 caracteres |
prompt | No | Texto opcional sobre la escena visible o el acabado buscado; vacío deja que la imagen guíe la interpretación. Agregar descripción no cambia la tarifa. máximo 2000 caracteres |
resolution | No | Salida en |
creativity_level | No |
|
Precios
En Astra, el nivel de salida fija tarifa y duración del paso; prompt y creatividad no cambian el precio. El tiempo fuente se eleva al siguiente segundo y después al paso completo siguiente, mínimo uno. La cifra por segundo divide el precio del paso entre su duración. Se reserva la carga conocida o 60 segundos para enlaces y se reintegra lo sobrante al terminar; un fallo no se cobra. 720p y 1080p cuestan igual, mientras 4K tiene tarifa mayor.
| Especificación | Precio |
|---|---|
| $0.36 / segundo |
| $0.36 / segundo |
| $0.60 / segundo |
Casos de uso
En un inserto estilizado, compara telas y cristal con la dirección artística y con el resto de la secuencia.
Al terminar video de IA, valida personas y objetos importantes antes de pedir otras resoluciones de entrega.
Guía de prompts y consejos prácticos
Crea primero una versión low sin texto. Si hace falta dirección, describe materiales y luz visibles en una frase coherente y cambia un control por prueba.
Reproduce giros de cabeza y texturas móviles antes de aprobar el aspecto. Después decide el tamaño final y verifica que la pista sonora se conserve correctamente.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "topaz/astra/upscale",
"input": {
"creativity_level": "low",
"resolution": "1080p",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.
