Cargar archivo

Propósitos de los archivosCopy Anchor Link

• Archivos por lotes (batch): utilice purpose=batch para /v1/batches.
• Archivos de imagen/referencia: utilice purpose=user_data o purpose=vision para solicitudes de imagen respaldadas por archivos.
• Archivos de Anthropic: añada la cabecera 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 archivos de imagenCopy Anchor Link

Esta misma ruta /v1/files puede cargar archivos de referencia de imagen para /v1/images/edits.

• Utilice purpose=user_data o purpose=vision.
• Opcionalmente, incluya model para seleccionar el modelo de edición de imágenes; el valor predeterminado es gpt-image-2.
• El file_id devuelto está vinculado a la configuración de edición de imagen seleccionada y puede reutilizarse en images[].file_id.

Modo API de archivos de AnthropicCopy Anchor Link

• Añada anthropic-beta: files-api-2025-04-14 para utilizar los archivos de Anthropic.
• En el modo Anthropic, cargue el archivo original directamente y no envíe purpose=batch.
• El file_id devuelto solo está disponible en el Workspace actual y puede reutilizarse en solicitudes a /v1/messages.
• Si planea hacer referencia al archivo cargado desde el contenido de un mensaje de Anthropic, siga utilizando las cabeceras nativas de Anthropic (x-api-key, anthropic-version y la cabecera beta cuando sea necesario).

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

Campos importantesCopy Anchor Link