Upload de Arquivo

Propósitos do ArquivoCopy Anchor Link

• Arquivos de lote: use purpose=batch para /v1/batches.
• Arquivos de imagem/referência: use purpose=user_data ou purpose=vision para solicitações de imagem baseadas em arquivo.
• Arquivos Anthropic: adicione o header anthropic-beta: files-api-2025-04-14.

curl -X POST "https://api.tokenlab.sh/v1/files" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "purpose=batch" \
  -F "file=@batch-input.jsonl;type=application/jsonl"

Entradas de Arquivo de ImagemCopy Anchor Link

Esta mesma rota /v1/files pode fazer upload de arquivos de referência de imagem para /v1/images/edits.

• Use purpose=user_data ou purpose=vision.
• Opcionalmente, inclua model para selecionar o modelo de edição de imagem; o padrão é gpt-image-2.
• O file_id retornado é vinculado à configuração de edição de imagem selecionada e pode ser reutilizado em images[].file_id.

Modo da API de Arquivos AnthropicCopy Anchor Link

• Adicione anthropic-beta: files-api-2025-04-14 para usar Arquivos Anthropic.
• No modo Anthropic, faça o upload do arquivo original diretamente e não envie purpose=batch.
• O file_id retornado está disponível apenas no Workspace atual e pode ser reutilizado em solicitações /v1/messages.
• Se você planeja referenciar o arquivo enviado a partir do conteúdo de uma mensagem Anthropic, continue usando os headers nativos da Anthropic (x-api-key, anthropic-version e o header beta quando necessário).

{
  "id": "file_abc123",
  "object": "file",
  "bytes": 32768,
  "created_at": 1706000000,
  "filename": "batch-input.jsonl",
  "purpose": "batch"
}

Campos importantesCopy Anchor Link