Files API Overview

# Example: File library implementation

class FileLibrary:
    """
    Manages file uploads and reuse for Incredible API.
    Upload once, store file_id, reuse forever.
    """
    
    def __init__(self, api_key, database):
        self.api_key = api_key
        self.db = database
    
    def upload_file(self, user_id, file_path, filename):
        """
        Upload a file ONCE and store the file_id.
        Call this only when user first adds a file.
        """
        # Check if file already uploaded
        existing = self.db.get_file_by_name(user_id, filename)
        if existing:
            print(f"✓ File already uploaded, reusing file_id: {existing['file_id']}")
            return existing['file_id']
        
        # Step 1: Get upload URL
        response = requests.post(
            "https://api.incredible.one/v1/files/upload-url",
            headers={"Authorization": f"Bearer {self.api_key}"},
            json={"filename": filename}
        )
        data = response.json()
        file_id = data["file_id"]
        upload_url = data["upload_url"]
        
        # Step 2: Upload to storage
        with open(file_path, 'rb') as f:
            file_bytes = f.read()
        
        requests.put(upload_url, data=file_bytes)
        
        # Step 3: Confirm upload
        response = requests.post(
            "https://api.incredible.one/v1/files/confirm-upload",
            headers={"Authorization": f"Bearer {self.api_key}"},
            json={
                "file_id": file_id,
                "filename": filename,
                "file_size": len(file_bytes)
            }
        )
        
        # Step 4: Store file_id in database (CRITICAL!)
        self.db.save_file({
            "user_id": user_id,
            "file_id": file_id,
            "filename": filename,
            "file_size": len(file_bytes),
            "uploaded_at": datetime.now()
        })
        
        print(f"✓ File uploaded successfully: {file_id}")
        return file_id
    
    def get_user_files(self, user_id):
        """
        Retrieve all files for a user.
        Show these in your UI so users can reuse them.
        """
        return self.db.get_files_by_user(user_id)
    
    def chat_with_files(self, user_id, message, file_ids):
        """
        Use stored file_ids in chat - no re-uploading!
        """
        response = requests.post(
            "https://api.incredible.one/v1/chat/completions",
            headers={"Authorization": f"Bearer {self.api_key}"},
            model="small-2",
            json={
                "messages": [
                    {
                        "role": "user",
                        "content": message,
                        "file_ids": file_ids  # ← Reuse stored file_ids
                    }
                ]
            }
        )
        return response.json()

# Usage Example:
library = FileLibrary(api_key="ik_...", database=db)

# Upload once (only when user first adds file)
file_id = library.upload_file(
    user_id="user123",
    file_path="report.pdf",
    filename="Q4_Report.pdf"
)

# Later: Show user their file library
user_files = library.get_user_files("user123")
print("Your files:")
for file in user_files:
    print(f"  - {file['filename']} (ID: {file['file_id']})")

# Use file in unlimited chats (no re-upload needed!)
response1 = library.chat_with_files(
    user_id="user123",
    message="Summarize this report",
    file_ids=[file_id]
)

response2 = library.chat_with_files(
    user_id="user123",
    message="What are the key metrics?",
    file_ids=[file_id]  # ← Same file_id, instant access!
)

{
  "messages": [
    {
      "role": "user",
      "content": "Analyze the sales data and create a chart",
      "file_ids": ["550e8400-...", "660e8400-..."]
    }
  ]
}

# The agent can write Python code like this:
import pandas as pd
import matplotlib.pyplot as plt

# Files are automatically available in the sandbox
df = pd.read_csv("data.csv")
summary = df.describe()

plt.plot(df['date'], df['sales'])
plt.savefig("chart.png")