Skip to main content

Quick Start

Get started with Modal in under 2 minutes:
Tip: You can also send x-portkey-provider: @modal as a header and use just model="your-model-name" in the request.

Add Provider in Model Catalog

Before making requests, add Modal to your Model Catalog:
  1. Go to Model Catalog → Add Provider
  2. Select Modal
  3. Enter your Modal API credentials
    • Modal supports API Key (Bearer token) or Custom Headers (modal-key and modal-secret)
  4. Custom Host: Enter your Modal deployment endpoint (e.g., https://your-modal-deployment.modal.run)
  5. Name your provider (e.g., modal)
Note: Custom host configuration is set once in Model Catalog and applies to all requests using this provider.

Complete Setup Guide

See all setup options and detailed configuration instructions

Modal Documentation

Explore the official Modal documentation

Streaming

Stream responses for real-time output:

Supported Endpoints and Parameters


Next Steps

Gateway Configs

Add fallbacks, load balancing, and more

Observability

Monitor and trace your Modal requests

Metadata

Add custom metadata to requests
Last modified on September 15, 2026