Carregar Arquivos - Documentação

A API Arkangel AI permite anexar arquivos às suas consultas para análise contextual.

Tipos de Arquivos Suportados

Tipo	Extensões	Tamanho Máximo
Documentos	`.pdf`, `.doc`, `.docx`	10 MB
Imagens	`.jpg`, `.png`, `.webp`	5 MB
Texto	`.txt`, `.md`	2 MB

Fazendo Upload de um Arquivo

Endpoint

POST https://api.arkangelai.com/v1/files

Exemplo cURL

curl -X POST https://api.arkangelai.com/v1/files \
  -H "Authorization: Bearer sua_chave_api" \
  -F "file=@documento.pdf" \
  -F "purpose=analysis"

Exemplo JavaScript

const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('purpose', 'analysis');

const response = await fetch('https://api.arkangelai.com/v1/files', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sua_chave_api'
  },
  body: formData
});

const result = await response.json();
console.log('Arquivo carregado:', result.file_id);

Resposta do Upload

{
  "file_id": "file_abc123",
  "filename": "documento.pdf",
  "size": 1024000,
  "mime_type": "application/pdf",
  "purpose": "analysis",
  "status": "processed",
  "created_at": "2026-01-19T10:30:00Z"
}

Usando Arquivos nas Consultas

Depois que o arquivo for carregado, você pode referenciá-lo em suas mensagens:

const response = await fetch('https://api.arkangelai.com/v1/chat', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sua_chave_api',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    message: 'Analise este documento médico',
    file_ids: ['file_abc123']
  })
});

Listar Arquivos

curl https://api.arkangelai.com/v1/files \
  -H "Authorization: Bearer sua_chave_api"

Resposta

{
  "files": [
    {
      "file_id": "file_abc123",
      "filename": "documento.pdf",
      "size": 1024000,
      "created_at": "2026-01-19T10:30:00Z"
    }
  ],
  "total": 1
}

Excluir um Arquivo

curl -X DELETE https://api.arkangelai.com/v1/files/file_abc123 \
  -H "Authorization: Bearer sua_chave_api"

Tratamento de Erros

Código	Erro	Descrição
400	`invalid_file_type`	Tipo de arquivo não suportado
400	`file_too_large`	Arquivo excede o tamanho máximo
404	`file_not_found`	Arquivo não existe
422	`file_processing_failed`	Erro ao processar arquivo

Melhores Práticas

Valide o tipo de arquivo antes de fazer upload
Comprima imagens grandes antes do upload
Exclua arquivos que você não precisa mais
Use nomes descritivos para seus arquivos

Próximos Passos

Revisar Chats - Gerencie conversas com arquivos anexados
Exemplos de Uso - Veja exemplos completos