Introducción
MiniMax H3 360 Orbit Image to video convierte una foto en una órbita de cámara de 360 grados alrededor de un momento congelado que termina en el cuadro con el que empezó.
Funciones y aspectos destacados
- Una foto de entrada, una órbita completa de 360 grados de salida: tu foto se usa como primer y último cuadro, así que el clip vuelve al punto de partida.
- El adaptador 360 Orbit funciona a intensidad 1 con la instrucción exacta con la que se entrenó, así que no hay que escribir ningún prompt.
- Sin el adaptador, el mismo modelo base interpreta un inicio y un final iguales como una imagen fija y apenas se mueve.
- La salida conserva el formato de tu foto: una foto cuadrada da un clip cuadrado.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
image_url | Sí | La foto que se orbita. Se usa como primer y último cuadro, así que el clip se repite en bucle. mínimo 1 caracteres |
resolution | No | 480p (predeterminado), 540p, 768p o 1080p. Las resoluciones más altas cuestan más por segundo; el formato siempre sigue a tu foto. |
duration_seconds | No | De 3 a 6 segundos (predeterminado 3). Tres segundos son un giro limpio y completamente congelado; los clips más largos orbitan más despacio y las personas pueden empezar a moverse. |
seed | No | Mantiene comparables las ejecuciones mientras pruebas distintas fotos o duraciones. No promete un clip idéntico cuadro por cuadro. |
Precios
Se cobra por segundo de salida a la resolución elegida.
| Especificación | Precio |
|---|---|
| $0.05 / segundo |
| $0.075 / segundo |
| $0.10 / segundo |
| $0.20 / segundo |
Casos de uso
- Retratos de momento congelado: una persona, el pelo y los detalles en suspensión quedan quietos mientras la cámara gira.
- Looks de moda y de vestuario mostrados desde todos los lados a partir de una sola toma.
- Clips cortos en bucle para publicaciones en redes que terminan justo donde empiezan.
Guía de prompts y consejos prácticos
- 3 segundos dan el congelado más limpio: en nuestras pruebas el sujeto, el pelo y los pétalos suspendidos se mantuvieron quietos durante toda la vuelta.
- A 6 segundos la órbita es más lenta y las personas pueden empezar a moverse, como una pareja que bailaba en nuestras pruebas.
- Los primeros planos muy cargados pueden cruzarse con la lente: en un huerto con mucha gente, los troncos pasaron brevemente entre la cámara y el sujeto.
- Elige el formato de foto que quieres que tenga el clip.
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": "minimax/h3-360-orbit/image-to-video",
"input": {
"duration_seconds": 3,
"image_url": "https://example.com/reference.png",
"resolution": "480p"
}
}'
# 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.
