> ## Documentation Index
> Fetch the complete documentation index at: https://docs.myunite.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Envio de arquivos

> Como enviar imagens e vídeos antes de criar um pré-teste.

A criação do pré-teste recebe um `uploadId`, nunca uma URL. O envio tem três passos: pedir o endereço, enviar o arquivo e usar o `uploadId`.

## Tipos e tamanhos

| Tipo (`contentType`) | Extensão | Tamanho máximo |
| - | - | - |
| `image/png` | png | 25 MB |
| `image/jpeg` | jpg | 25 MB |
| `image/webp` | webp | 25 MB |
| `image/gif` | gif | 25 MB |
| `video/mp4` | mp4 | 200 MB |
| `video/quicktime` | mov | 200 MB |

Vídeos têm no máximo **30 segundos**. A duração é lida do arquivo antes de qualquer cobrança. Acima disso a criação responde [`video_too_long`](https://docs.myunite.ai/errors#video_too_long) e nenhuma unidade da cota é usada.

Outros tipos respondem [`upload_invalid`](https://docs.myunite.ai/errors#upload_invalid). Tamanho acima do limite responde [`file_too_large`](https://docs.myunite.ai/errors#file_too_large).

## 1. Peça o endereço de envio

Requer o escopo `pretests:write`.

```bash curl theme={null}
SIZE=$(wc -c < verao-relogio-urbano.mp4 | tr -d ' ')

curl -s -X POST https://myunite.ai/api/v1/uploads \
  -H "Authorization: Bearer $UNITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"contentType\":\"video/mp4\",\"sizeBytes\":$SIZE,\"filename\":\"verao-relogio-urbano.mp4\"}" \
  -o upload.json

export UPLOAD_ID=$(jq -r '.uploadId' upload.json)
export UPLOAD_URL=$(jq -r '.uploadUrl' upload.json)
export CACHE_CONTROL=$(jq -r '.headers["Cache-Control"]' upload.json)
```

```javascript JavaScript theme={null}
const res = await fetch("https://myunite.ai/api/v1/uploads", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.UNITE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    contentType: "video/mp4",
    sizeBytes: 8123456,
    filename: "verao-relogio-urbano.mp4",
  }),
});
const target = await res.json();
```

```python Python theme={null}
import os
import requests

target = requests.post(
    "https://myunite.ai/api/v1/uploads",
    headers={"Authorization": f"Bearer {os.environ['UNITE_API_KEY']}"},
    json={
        "contentType": "video/mp4",
        "sizeBytes": 8123456,
        "filename": "verao-relogio-urbano.mp4",
    },
).json()
```

A resposta traz `uploadId`, `uploadUrl`, `method` (sempre `PUT`), `headers` e `expiresAt`. A URL vale **15 minutos**. Se expirar, peça outra.

## 2. Envie o arquivo

Faça um `PUT` na `uploadUrl` com o conteúdo do arquivo no corpo.

> [!WARNING]
>
> Envie **todos** os cabeçalhos de `headers`, com exatamente os mesmos valores, incluindo `Cache-Control`. Se faltar um cabeçalho ou o valor for diferente, o envio falha.

Não envie o cabeçalho `Authorization` nesta chamada: a URL já carrega a autorização.

```bash curl theme={null}
curl -X PUT "$UPLOAD_URL" \
  -H "Content-Type: video/mp4" \
  -H "Cache-Control: $CACHE_CONTROL" \
  --data-binary @verao-relogio-urbano.mp4
```

```javascript JavaScript theme={null}
import { readFile } from "node:fs/promises";

const put = await fetch(target.uploadUrl, {
  method: target.method,
  headers: target.headers, // todos, sem alterar
  body: await readFile("verao-relogio-urbano.mp4"),
});
if (!put.ok) throw new Error(`Envio falhou: ${put.status}`);
```

```python Python theme={null}
with open("verao-relogio-urbano.mp4", "rb") as f:
    put = requests.put(target["uploadUrl"], headers=target["headers"], data=f)
put.raise_for_status()
```

## 3. Use o `uploadId`

Passe o `uploadId` na [criação do pré-teste](https://docs.myunite.ai/quickstart.md). Na criação, a Unite confere o arquivo enviado:

* Se o arquivo não existe (você não enviou, ou o `uploadId` é de outro workspace), a resposta é [`upload_not_found`](https://docs.myunite.ai/errors#upload_not_found).
* Se o conteúdo não corresponde ao tipo, ou o vídeo não tem duração legível, a resposta é [`upload_invalid`](https://docs.myunite.ai/errors#upload_invalid).
* O tamanho declarado é só uma dica. O limite vale para o tamanho real do arquivo.

O mesmo `uploadId` pode ser usado em mais de um pré-teste do mesmo workspace.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.