Introducción
3D to Video transforma una animación 3D preliminar en una toma con acabado final. Puedes decidir el movimiento en una herramienta 3D, renderizarlo en gris y dejar que el modelo lo pinte a partir de un fotograma al que ya diste estilo, sin esperar a que un modelo de texto a video elija el ángulo de cámara adecuado. El resultado mantiene tus tiempos y composición, y toma el color, la luz y los materiales de ese fotograma.
Funciones y aspectos destacados
La escena preliminar define el movimiento
Nuestro clip gris de 3 segundos de un astronauta de juguete caminando, con una cámara que giraba despacio a su alrededor, regresó con 3.0 segundos a 24 fps. Cada zancada y el arco de cámara permanecieron donde los definía el video preliminar. La duración de salida siempre coincide con la de entrada, hasta dos minutos.
Un fotograma con estilo define el aspecto visual
Transformamos el primer fotograma en una llanura marciana a la hora dorada, y todo el clip siguió ese estilo: suelo rojo polvoriento, mesetas bajas, luz de contorno cálida y sombras largas. Al añadir un último fotograma con el mismo estilo como last_image_url, la versión de 4 segundos mantuvo la coherencia hasta el final.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
video_url | Sí | Escena preliminar: render gris o sin materiales de tu escena 3D, en MP4 o WebM y de hasta 120 segundos; funciona mejor a 24 fps. mínimo 1 caracteres |
image_url | Sí | Referencia visual: primer fotograma del video preliminar al que diste estilo con un modelo de imagen (color, luz, materiales y entorno). No envíes el fotograma gris sin modificar. mínimo 1 caracteres |
last_image_url | No | Opcional. Último fotograma del video preliminar con el mismo estilo, para mantener la coherencia visual en tomas de más de unos tres segundos. mínimo 1 caracteres |
prompt | Sí | Una o dos frases que describan la toma terminada y coincidan con la imagen de referencia visual. Omite menciones al render sin materiales, al 3D o a la escena preliminar. mínimo 1 caracteres · máximo 2000 caracteres |
resolution | No | 720p o 1080p (predeterminado). Conserva la relación de aspecto del video preliminar. |
seed | No | Entero opcional para repetir un resultado. No cambia el precio. |
Precios
Cobro por segundo de video preliminar, redondeado hacia arriba, con un mínimo de 3 y un máximo de 120 segundos. La tarifa por segundo depende de resolution y es mayor en 1080p que en 720p. La referencia visual del último fotograma, prompt y seed no cambian el precio. Las ejecuciones fallidas no se cobran.
| Especificación | Precio |
|---|---|
| $0.048 / segundo |
| $0.12 / segundo |
Casos de uso
De la previsualización a la presentación
Prepara una escena con modelos provisionales y un movimiento de cámara definido. Después, conviértela en un clip con estilo para una presentación, una revisión del guion gráfico o un avance en redes sociales. Nadie tiene que crear materiales, sistemas de iluminación ni un entorno completo antes de que se apruebe la idea.
Una animación en varios entornos
Conserva un único video preliminar y cambia solo la imagen de referencia visual y la frase. El mismo personaje caminando o producto girando puede aparecer en un bosque, una ciudad nocturna de neón o un mundo de dibujos pintados. Todas las versiones conservan los mismos tiempos para que los clips encajen al editarlos juntos.
Guía de prompts y consejos prácticos
Prepara con cuidado la referencia visual
Exporta el primer fotograma exacto del video preliminar que vas a enviar y dale estilo con cualquier modelo de imagen, manteniendo la pose, el encuadre y el horizonte en su lugar. Cuanto mejor coincida la referencia visual con la escena preliminar, más limpios serán los bordes y más estable el resultado. No subas el fotograma gris sin modificar: la salida también quedaría gris.
Escribe un prompt breve y visual
Describe la escena terminada en una o dos frases sencillas, por ejemplo: "A small astronaut in a white spacesuit walks across a dusty red Martian plain at golden hour while the camera slowly circles." Explica lo que ve el espectador y no menciones renders sin materiales, modelos grises, 3D ni la propia escena preliminar.
Divide las tomas largas
Si la toma supera unos tres segundos, da estilo también al último fotograma del video preliminar y envíalo como last_image_url. Debes dividir las tomas de más de dos minutos; renderiza cada parte por separado con las mismas imágenes de referencia visual y seed para que las partes coincidan.
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": "spicyapi/3d-to-video-v1/video-edit",
"input": {
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"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.