Introdução
O que este endpoint faz
Ele recebe um clipe de vídeo e devolve o mesmo clipe em um nível de resolução mais alto. Duração, proporção, movimento, cortes e faixa de áudio ficam como você enviou, e não há prompt.
Entradas que importam
video_url é o clipe, de 3 a 60 segundos, como link direto para o arquivo. resolution escolhe o nível de saída: 720p, 1080p (o padrão), 2k ou 4k. O nível é um orçamento de pixels, então um clipe de 832×480 volta em 1896×1094 com 1080p.
O que você recebe
Um MP4 por requisição, com a mesma duração da original, servido pelo armazenamento da plataforma quando a tarefa termina.
| Campo | Valor |
|---|---|
| Entrada | Vídeo |
| Saída | Vídeo |
| Endpoint | Upscale |
| Níveis | 720p, 1080p, 2K, 4K |
| Cobrança | Por segundo do clipe de origem, arredondada para cima, mínimo de 3 segundos |
| Controles | Sem prompt: só resolution |
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
video_url | Sim | O clipe para fazer o upscale, de 3 a 60 segundos. pelo menos 1 caracteres |
resolution | Não | 720p, 1080p (o padrão), 2k ou 4k: um orçamento de pixels com a proporção do clipe mantida, então um clipe de 832×480 em 1080p volta em 1896×1094. |
Preços
Cobrado por segundo do clipe de origem, arredondado para o próximo segundo inteiro, com mínimo de 3 segundos; o nível de saída define a tarifa por segundo. A estimativa antes do envio usa a duração de um clipe enviado mais um segundo, ou o máximo de 60 segundos para uma URL de vídeo, e a diferença é liberada na liquidação.
| Especificação | Preço |
|---|---|
| $0.006 / segundo |
| $0.006 / segundo |
| $0.012 / segundo |
| $0.024 / segundo |
Casos de uso
Rascunhos em 480p com qualidade de entrega
Gere barato em 480p ou 720p, fique com o take de que gostou e faça o upscale só dele, em vez de pagar cada tentativa em alta resolução.
Cortes para redes e anúncios
Leve clipes curtos à resolução que um feed, uma landing page ou um espaço de anúncio espera, com a trilha sonora no lugar.
Material antigo em telas grandes
Dê a pequenos clipes de arquivo ou gravações de tela uma imagem mais limpa e maior para apresentações e telas grandes.
Guia de prompt e dicas práticas
Termine a edição e depois faça o upscale
Faça o upscale da versão final. Caso contrário, cada etapa seguinte teria de processar várias vezes mais pixels.
Envie
video_urle resolutionvideo_urlé o clipe, de 3 a 60 segundos; resolution escolhe 720p, 1080p (padrão), 2k ou 4k. Não há mais nada para configurar.Consulte e baixe
A chamada é assíncrona: crie a tarefa, consulte até terminar e baixe o MP4 do armazenamento da plataforma. Um clipe de 5 segundos em 4K tem cerca de 19 MB.
Introdução
Video Upscaler recebe um clipe finalizado e o devolve em um nível de resolução mais alto. É uma passada de resolução, não um editor: enquadramento, movimento, cortes, ritmo e a faixa de áudio original ficam como você enviou. Não há prompt.
Requisição
{
"video_url": "https://example.com/clip.mp4",
"resolution": "1080p"
}
Só video_url é obrigatório. resolution é 1080p por padrão; os outros níveis são 720p, 2k e 4k.
Duração do clipe e cobrança
O clipe precisa ter de 3 a 60 segundos. Se a duração for conhecida no aceite, um clipe fora dessa faixa é recusado na hora; caso contrário, ela é verificada antes de o processo começar, e a tarefa falha com reembolso total. A cobrança é por segundo do clipe de origem, arredondada para o próximo segundo inteiro com mínimo de 3 segundos, na tarifa do nível escolhido. A estimativa antes do envio usa a duração de um clipe enviado mais um segundo, ou o máximo de 60 segundos para uma URL de vídeo; a parte não usada da reserva é liberada na liquidação.
O que volta
O nível é um orçamento de pixels e a proporção é mantida. Um clipe de 832×480 voltou em 1896×1094 com 1080p depois de cerca de 33 segundos de processo, e em 3792×2188 com 4k depois de cerca de 103 segundos; um MP4 de 5 segundos em 4k tem cerca de 19 MB. Um clipe de 854×480 com faixa AAC voltou em 1922×1080 com a mesma faixa. Em todos os testes a duração bateu com a original quadro a quadro.
Fluxo da tarefa
A chamada é assíncrona. Crie a tarefa, consulte até ela chegar a um estado final e baixe o MP4 do armazenamento da plataforma.
Dicas
- Faça o upscale da montagem final, depois de todas as edições.
- Escolha um nível acima da resolução atual do clipe.
- Use um link direto para o arquivo de vídeo. Uma página web que reproduz o vídeo devolve HTML, a duração não pode ser lida e a chamada falha com reembolso; enviar o arquivo por upload é o caminho mais confiável.
- Comece pela original mais limpa que você tiver: blocos de compressão e ruído também são ampliados.
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": "spicyapi/video-upscaler-v1/upscale",
"input": {
"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.
