Serverless Quick Start

Get your first serverless endpoint running in minutes.

Prerequisites

• A WaveSpeedAI account with Serverless access
• A container image with your worker code (or use our examples)

Step 1: Access the Serverless Console

1. Log in to wavespeed.ai
2. Navigate to Serverless in the top menu
3. You’ll see the GPU Specs dashboard

Step 2: Create an Endpoint

1. Click Endpoints in the left sidebar
2. Click Create Endpoint
3. Configure your endpoint:

4. Click Create

Step 3: Submit a Task

Once your endpoint is running, submit a task via API:

curl --location --request POST 'https://api.wavespeed.ai/serverless/v1/run' \
--header 'Authorization: Bearer ${WAVESPEED_API_KEY}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "endpoint": "my-inference-endpoint",
    "input": {
        "prompt": "Hello, Waverless!"
    }
}'

Response:

{
    "id": "task_abc123",
    "status": "PENDING"
}

Step 4: Get the Result

Poll for the result:

curl --location --request GET 'https://api.wavespeed.ai/serverless/v1/status/task_abc123' \
--header 'Authorization: Bearer ${WAVESPEED_API_KEY}'

Response when completed:

{
    "id": "task_abc123",
    "status": "COMPLETED",
    "output": {
        "result": "Processed: Hello, Waverless!"
    }
}

Step 5: Monitor Your Tasks

1. Click Tasks in the left sidebar
2. View task status: Completed, In Progress, Pending, Failed
3. Search by Task ID or filter by Endpoint

What’s Next?

• Create Endpoint — Detailed endpoint configuration
• Build Worker — Write your handler code
• API Reference — Full API documentation

Troubleshooting

Task stuck in PENDING

• Check if workers are running (Endpoints → Status)
• Verify your endpoint has available replicas

Task FAILED

• Check worker logs (Tasks → Click task → View Logs)
• Verify your handler code handles the input correctly

Authentication Error

• Ensure your API key has Serverless access
• Check the Authorization header format

Related Pages

• Serverless Overview
• GPU Pricing
• API Reference