Enviar um arquivo
POST /api/v1/uploads — obtenha uma URL assinada, envie um vídeo local para ela com PUT e depois faça o upscale.
Se o seu vídeo não está em uma URL pública, envie-o primeiro. O upload leva duas requisições: peça uma URL de upload assinada e depois envie o arquivo direto para o armazenamento com PUT.
POST https://videoupscaler.co/api/v1/uploadsRequisição
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
content_type | string | Sim | video/mp4, video/quicktime ou video/webm |
size | integer | Sim | Tamanho do arquivo em bytes, até 100MB (104857600) |
Para arquivos acima de 100MB, hospede o arquivo você mesmo e passe a URL dele para /upscale (até 500MB).
Resposta
201 Created:
{
"upload_url": "https://api.videoupscaler.co/uploads/eyJrZXki…",
"method": "PUT",
"headers": { "Content-Type": "video/mp4" },
"video_url": "https://storage.videoupscaler.co/videos/api/5f0c…mp4",
"max_bytes": 7340032,
"expires_at": "2026-09-30T09:00:00.000Z"
}| Campo | Descrição |
|---|---|
upload_url | Para onde fazer o PUT do arquivo. Não é preciso cabeçalho Authorization; a própria URL concede a permissão. |
headers | Envie estes cabeçalhos junto com o PUT. O Content-Type precisa ser igual ao que você declarou. |
video_url | Passe este valor para /upscale quando o upload terminar. |
max_bytes | O upload é rejeitado se o arquivo for maior que o size declarado. |
expires_at | A URL de upload vale por 1 hora. |
Exemplo completo
FILE=clip.mp4
SIZE=$(wc -c < "$FILE" | tr -d ' ')
# 1. Get an upload URL
UPLOAD=$(curl -s https://videoupscaler.co/api/v1/uploads \
-H "Authorization: Bearer $VIDEOUPSCALER_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"content_type\": \"video/mp4\", \"size\": $SIZE}")
# 2. Upload the file
curl -X PUT "$(echo "$UPLOAD" | jq -r .upload_url)" \
-H "Content-Type: video/mp4" \
--data-binary @"$FILE"
# 3. Upscale it
curl https://videoupscaler.co/api/v1/upscale \
-H "Authorization: Bearer $VIDEOUPSCALER_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"video_url\": \"$(echo "$UPLOAD" | jq -r .video_url)\", \"resolution\": \"1080p\"}"import { readFile } from 'node:fs/promises';
const api = 'https://videoupscaler.co/api/v1';
const auth = { Authorization: `Bearer ${process.env.VIDEOUPSCALER_API_KEY}` };
const file = await readFile('clip.mp4');
// 1. Get an upload URL
const upload = await fetch(`${api}/uploads`, {
method: 'POST',
headers: { ...auth, 'Content-Type': 'application/json' },
body: JSON.stringify({ content_type: 'video/mp4', size: file.length }),
}).then((r) => r.json());
// 2. Upload the file
await fetch(upload.upload_url, { method: 'PUT', headers: upload.headers, body: file });
// 3. Upscale it
const task = await fetch(`${api}/upscale`, {
method: 'POST',
headers: { ...auth, 'Content-Type': 'application/json' },
body: JSON.stringify({ video_url: upload.video_url, resolution: '1080p' }),
}).then((r) => r.json());import os, requests
api = "https://videoupscaler.co/api/v1"
auth = {"Authorization": f"Bearer {os.environ['VIDEOUPSCALER_API_KEY']}"}
path = "clip.mp4"
# 1. Get an upload URL
upload = requests.post(f"{api}/uploads", headers=auth,
json={"content_type": "video/mp4", "size": os.path.getsize(path)}).json()
# 2. Upload the file
with open(path, "rb") as f:
requests.put(upload["upload_url"], headers=upload["headers"], data=f).raise_for_status()
# 3. Upscale it
task = requests.post(f"{api}/upscale", headers=auth,
json={"video_url": upload["video_url"], "resolution": "1080p"}).json()Um PUT bem-sucedido retorna 200 com {"video_url": "…"}.
Observações
- Pedir uma URL de upload é gratuito, mas exige um saldo de pelo menos 1 crédito.
- Os arquivos enviados são mantidos apenas para o processamento e podem ser excluídos após 7 dias.
Erros
| Status | Código | Quando |
|---|---|---|
400 | invalid_request | content_type não suportado, size inválido, ou o PUT enviou um Content-Type diferente ou foi interrompido |
403 | paid_plan_required | A conta nunca comprou créditos nem fez uma assinatura |
402 | insufficient_credits | Seu saldo de créditos está zerado |
403 | invalid_upload_token | A URL de upload é inválida ou expirou (PUT) |
411 | invalid_request | O PUT não tinha corpo ou Content-Length |
413 | file_too_large | O arquivo tem mais de 100MB ou é maior que o size declarado |