Voltar à documentação

Carregar Arquivos

Aprenda a fazer upload e anexar arquivos às suas consultas da API

por Arkangel AI Team•1 min de leitura

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