Vídeo
Topaz Video Upscale video
Topaz Labs video upscale — MP4/MOV/MKV até 50MB, fator 1×/2×/4×.
Categoria: Upscale · topaz-video-upscale
Como usar & limites
- Aumenta a resolução de um vídeo existente (upscale), sem prompt.
- Entrada: um vídeo MP4/MOV/MKV de até 50MB.
- Fator de escala: 1×, 2× ou 4×.
- Não gera conteúdo novo — apenas amplia o vídeo enviado.
Capacidades
O que este modelo suporta, direto do schema — sem preços, sem detalhes de infraestrutura.
| Capacidade | Valor |
|---|---|
upscale Upscale | Sim |
iconSlug Família | topaz |
modelModes Modos | tool |
max_input_mb Tamanho máx. de entrada (MB) | 50 |
accepted_mimes Formatos aceitos | video/mp4, video/quicktime, video/x-matroska |
Parâmetros
Campos aceitos em params (ou de primeira classe, quando aplicável) para POST /generations.
| Nome | Rótulo | Tipo | Obrigatório | Padrão | Opções | Mín / Máx | Descrição |
|---|---|---|---|---|---|---|---|
video_url | Video | video | Obrigatório | — | — | — | Vídeo de origem MP4/MOV/MKV, até 50MB. |
upscale_factor | Fator de escala | select | Opcional | 2 | 1 · 2 · 4 | — | Fator de ampliação: 1×, 2× ou 4×. |
Exemplo de requisição
curl -X POST https://caranguejo.art/api/v1/dev/generations \
-H "Authorization: Bearer $CK" \
-H "Content-Type: application/json" \
-d '{
"model": "topaz-video-upscale",
"params": {
"upscale_factor": "2"
}
}'
const res = await fetch("https://caranguejo.art/api/v1/dev/generations", {
method: "POST",
headers: {
"Authorization": "Bearer " + process.env.CK,
"Content-Type": "application/json",
},
body: JSON.stringify({
"model": "topaz-video-upscale",
"params": {
"upscale_factor": "2"
}
}),
});
const { data } = await res.json();
Exemplo de resposta
{
"id": "9f0c1a7e-…",
"object": "generation",
"model": "topaz-video-upscale",
"type": "video",
"status": "completed",
"output": {
"assets": [
{
"url": "https://media.caranguejo.art/outputs/example.mp4",
"type": "video"
}
]
}
}
O custo real do job é retornado em credits_charged na resposta concluída — consulte GET /balance para o saldo da conta.
Erros comuns deste tipo de job:
insufficient_credits | Saldo insuficiente para cobrir o job. |
generation_timeout | O job excedeu o tempo máximo de processamento. |
rate_limited | Limite de requisições por minuto excedido. |
invalid_input | Parâmetro obrigatório ausente ou fora do schema do modelo. |
generation_failed | Falha genérica no processamento do job. |