File Upload — Nyqo API

Requisição

curl -X POST "https://api.nyqo.dev/api/upload" \
  -H "Authorization: Bearer nyq_sua_chave_aqui" \
  -F "file=@/caminho/para/arquivo.png"

Troque nyq_sua_chave_aqui pela sua chave do painel. Também aceito via header X-API-Key — nunca na query string.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`file`	`file`	sim	Arquivo enviado via multipart/form-data. Suporta imagem, vídeo, áudio e documentos seguros.

Resposta

Campo	Tipo	Descrição
`success`	`boolean`	Indica se o upload foi concluído
`url`	`string`	URL pública raw do arquivo hospedado
`content_type`	`string`	MIME type final aceito pelo sistema
`category`	`string`	Categoria inferida: image, video, audio ou document
`filename`	`string`	Nome final salvo no storage

Exemplo de resposta real

{
	"success": true,
	"url": "https://gitlab.com/namespace/projeto/-/raw/main/users/user_123/uploads/image/1730000000000_upload.png",
	"content_type": "image/png",
	"category": "image",
	"filename": "1730000000000_upload.png"
}

Levar essa referência para o seu agente/LLM

Copie a doc em Markdown — mesmo formato das skills e do llms.txt.

# File Upload

`POST https://api.nyqo.dev/api/upload`

Faz upload de imagem, vídeo, áudio ou documento e retorna uma URL pública raw. Aceita multipart/form-data com o campo `file`. Limite de 20MB por arquivo.

Categoria: Utilitários · Slug: `file-upload`

## Autenticação

```http
Authorization: Bearer nyq_sua_chave_aqui
```

Também aceito: `X-API-Key: nyq_sua_chave_aqui`. Nunca via query string (`?api_key`).

## Parâmetros

| Nome | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `file` | `file` | sim | Arquivo enviado via multipart/form-data. Suporta imagem, vídeo, áudio e documentos seguros. |

## Resposta

| Campo | Tipo | Descrição |
| --- | --- | --- |
| `success` | `boolean` | Indica se o upload foi concluído |
| `url` | `string` | URL pública raw do arquivo hospedado |
| `content_type` | `string` | MIME type final aceito pelo sistema |
| `category` | `string` | Categoria inferida: image, video, audio ou document |
| `filename` | `string` | Nome final salvo no storage |

## Exemplo (curl)

```bash
curl -X POST "https://api.nyqo.dev/api/upload" \
  -H "Authorization: Bearer nyq_sua_chave_aqui" \
  -F "file=@/caminho/para/arquivo.png"
```

## Exemplo de resposta

```json
{
	"success": true,
	"url": "https://gitlab.com/namespace/projeto/-/raw/main/users/user_123/uploads/image/1730000000000_upload.png",
	"content_type": "image/png",
	"category": "image",
	"filename": "1730000000000_upload.png"
}
```

Erros comuns

· 401 unauthorized — sem chave ou chave inválida. Confira autenticação.
· 403 forbidden — plano sem esta rota ou chave fora do escopo. Veja planos.
· 429 rate_limited — quota estourada; aguarde Retry-After. Detalhes em rate limits.

Tabela completa em /docs — códigos de erro.

Estamos em manutenção

Requisição

Parâmetros

Resposta

Levar essa referência para o seu agente/LLM

Erros comuns