Carregar Arquivo

Visão GeralCopy Anchor Link

Este endpoint faz parte da API em Lote compatível com OpenAI da TokenLab. Os trabalhos em lote usam arquivos JSONL carregados, são executados de forma assíncrona e podem retornar arquivos de saída/erro posteriormente.

Modos de arquivo compatíveisCopy Anchor Link

A TokenLab trata /v1/files como três modos explícitos:

• 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.
• Modo Anthropic Files API: adicione anthropic-beta: files-api-2025-04-14 para armazenamento de arquivos nativo da Anthropic.

ObservaçõesCopy Anchor Link

• Os arquivos de entrada em lote devem usar purpose=batch.
• completion_window é atualmente 24h.
• A ordenação da saída não é garantida; sempre combine pelo custom_id.
• Streaming não é suportado dentro dos itens em lote.

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"

Solicitação / RespostaCopy Anchor Link

Use o painel interativo OpenAPI acima para o esquema exato.

Dicas OperacionaisCopy Anchor Link

• Use custom_id para reconciliação idempotente a montante.
• Espere output_file_id e error_file_id somente após o trabalhador finalizar o lote.

Entradas de arquivos de imagemCopy Anchor Link

A mesma rota /v1/files também pode enviar arquivos de imagem de referência 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 Anthropic Files APICopy Anchor Link

Esta mesma rota /v1/files também oferece suporte ao caminho Anthropic Files API.

• Adicione o cabeçalho anthropic-beta: files-api-2025-04-14 para alternar para o modo Anthropic.
• No modo Anthropic, envie o arquivo original diretamente e não envie purpose=batch.
• O file_id retornado fica vinculado ao mesmo espaço de trabalho compatível com Anthropic e deve ser reutilizado em solicitações /v1/messages.
• Se você pretende referenciar esse arquivo no conteúdo de uma mensagem Anthropic, continue usando os cabeçalhos nativos da Anthropic (x-api-key, anthropic-version e, quando necessário, o beta header).

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

Campos importantesCopy Anchor Link