Upload file (OpenAI format)
Uploads a file for use with batch processing or other features.
Note: This endpoint also works without the /v1 prefix (e.g., /openai/files).
AuthorizationBearer <token>
Bearer token authentication. Use your MPilot virtual-key JWT or admin JWT.
Virtual keys (prefixed with sk-bf-) can also be passed here.
In: header
filefile
File to upload
Format
binarypurposestring
Purpose of the file
Value in
"assistants" | "assistants_output" | "batch" | "batch_output" | "fine-tune" | "fine-tune-results" | "vision" | "user_data" | "evals"provider?string
Provider for file storage
storage_config?object
Storage configuration for cloud storage backends
Response Body
curl -X POST "https://loading/{AI_GATEWAY_URL}/openai/v1/files" \ -F file="string" \ -F purpose="assistants"{
"id": "string",
"object": "string",
"bytes": 0,
"created_at": 0,
"filename": "string",
"purpose": "batch",
"status": "uploaded",
"status_details": "string",
"expires_at": 0,
"storage_backend": "string",
"storage_uri": "string",
"extra_fields": {
"request_type": "string",
"provider": "openai",
"model_requested": "string",
"model_deployment": "string",
"latency": 0,
"chunk_index": 0,
"raw_request": {},
"raw_response": {},
"cache_debug": {
"cache_hit": true,
"cache_id": "string",
"hit_type": "string",
"requested_provider": "string",
"requested_model": "string",
"provider_used": "string",
"model_used": "string",
"input_tokens": 0,
"threshold": 0,
"similarity": 0
}
}
}{
"event_id": "string",
"type": "string",
"is_bifrost_error": true,
"status_code": 0,
"error": {
"type": "string",
"code": "string",
"message": "string",
"param": "string",
"event_id": "string"
},
"extra_fields": {
"provider": "openai",
"model_requested": "string",
"request_type": "string"
}
}{
"event_id": "string",
"type": "string",
"is_bifrost_error": true,
"status_code": 0,
"error": {
"type": "string",
"code": "string",
"message": "string",
"param": "string",
"event_id": "string"
},
"extra_fields": {
"provider": "openai",
"model_requested": "string",
"request_type": "string"
}
}