Introdução
MiniMax H3 360 Orbit Imagem para vídeo transforma uma foto em uma órbita de câmera de 360 graus em volta de um momento congelado, que termina no quadro em que começou.
Recursos e destaques
- Uma foto de entrada, uma órbita completa de 360 graus na saída: sua foto é usada como primeiro e último quadro, então o clipe volta ao ponto de partida.
- O adaptador 360 Orbit roda em força 1 com a instrução exata com que foi treinado, então não há prompt para escrever.
- Sem o adaptador, o mesmo modelo base lê um início e um fim iguais como imagem parada e quase não se mexe.
- A saída mantém o formato da sua foto: uma foto quadrada gera um clipe quadrado.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
image_url | Sim | A foto a ser orbitada. Ela é usada como primeiro e último quadro, então o clipe faz loop. pelo menos 1 caracteres |
resolution | Não | 480p (padrão), 540p, 768p ou 1080p. Faixas mais altas custam mais por segundo; o formato sempre segue a sua foto. |
duration_seconds | Não | De 3 a 6 segundos (padrão 3). Três segundos é uma volta limpa e congelada; clipes mais longos orbitam mais devagar e as pessoas podem começar a se mexer. |
seed | Não | Mantém as execuções comparáveis enquanto você testa fotos ou durações diferentes. Não promete um clipe idêntico quadro a quadro. |
Preços
Cobrado por segundo de saída na resolução escolhida.
| Especificação | Preço |
|---|---|
| $0.05 / segundo |
| $0.075 / segundo |
| $0.10 / segundo |
| $0.20 / segundo |
Casos de uso
- Retratos de momento congelado: uma pessoa, o cabelo e detalhes suspensos ficam parados enquanto a câmera gira.
- Looks e roupas mostrados de todos os lados a partir de uma única foto.
- Clipes curtos em loop para posts em redes sociais, que terminam exatamente onde começam.
Guia de prompt e dicas práticas
- 3 segundos dão o congelamento mais limpo: nos nossos testes, o sujeito, o cabelo e as pétalas suspensas ficaram parados durante toda a volta.
- Com 6 segundos a órbita é mais lenta e as pessoas podem começar a se mexer, como um casal dançando nos nossos testes.
- Primeiros planos cheios podem cruzar a lente: em um pomar cheio, troncos passaram brevemente entre a câmera e o sujeito.
- Escolha o formato de foto que você quer para o clipe.
Início rápido da 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"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.
















