Introdução
Astra foi pensado para tomadas cuja aparência pode evoluir durante a ampliação. Um interior criado por IA ou uma sequência estilizada pode ganhar materiais inventados; você aprova uma interpretação visual, não uma recuperação documental.
Recursos e destaques
Três níveis de criatividade e uma descrição opcional regulam a liberdade do modelo. As entregas incluem 720p, 1080p e 4K, sem degrau 2K.
A adega em low sem prompt ganhou cabelo e bordas de vidro, mas mudou olho e perfil. Os três segundos em 1080p levaram cerca de 210 segundos; até o nível contido pode alterar um rosto.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
video_url | Sim | Envie um MP4 por link ou upload de 1–60 segundos. Uma duração menor ou maior é rejeitada antes da aceitação; a versão criativa mantém tempo de reprodução e áudio. pelo menos 1 caracteres |
prompt | Não | Texto opcional sobre a cena visível ou o acabamento desejado; vazio deixa a imagem guiar a interpretação. Adicionar descrição não altera a tarifa. no máximo 2000 caracteres |
resolution | Não | Saída em |
creativity_level | Não |
|
Preços
No Astra, o nível de saída define tarifa e duração do passo; prompt e criatividade não mudam o preço. O tempo fonte sobe ao próximo segundo e depois ao próximo passo inteiro, com mínimo de um. O valor por segundo divide o preço do passo pela extensão dele. Reserva-se o upload conhecido ou 60 segundos de um link, devolve-se o excedente ao concluir e falhas não custam. 720p e 1080p têm a mesma tarifa, e 4K uma maior.
| Especificação | Preço |
|---|---|
| $0.36 / segundo |
| $0.36 / segundo |
| $0.60 / segundo |
Casos de uso
Para uma inserção estilizada, compare tecidos e vidro com a direção de arte e as tomadas ao redor.
Para finalizar vídeo de IA, aprove pessoas e objetos importantes antes de solicitar vários tamanhos de entrega.
Guia de prompt e dicas práticas
Crie primeiro uma versão low sem texto. Se necessário, descreva materiais e luz visíveis em uma frase coerente e mude um controle por tentativa.
Reproduza giros de cabeça e texturas móveis antes de aprovar o aspecto. Escolha então o tamanho final e confirme que a trilha sonora foi conservada.
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": "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"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.
