feat(toolkit): input types

[badayvedat]

Proposed Interface

import os
from pydantic import BaseModel


from fal.toolkit.types import FileInput, ImageInput

class Input(BaseModel):
    image: ImageInput
    file: FileInput

input = Input(
    image="https://storage.googleapis.com/falserverless/model_tests/remove_background/elephant.jpg",
    file="https://raw.githubusercontent.com/fal-ai/fal/refs/heads/main/README.md"
)

with input.image.as_file() as file_path:
    # Path("/tmp/...")
    print(file_path)

with input.image.as_pil_image() as pil_image:
    # PIL.JpegImagePlugin.JpegImageFile ...
    print(pil_image)

with input.file.as_file() as file_path:
    # Path("/tmp/...")
    print(file_path)