Carregar Arquivos

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

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

Próximos Passos

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