Quickstart - Overshoot

Authenticate

Get your API Key

Create a stream

We call the /streams endpoint to create a Stream.

curl -X POST https://api.overshoot.ai/v1beta/streams \
-H "Authorization: Bearer $OVERSHOOT_API_KEY"

The command above returns a Room URL and a Token. Save those for the next step.

Sample Response

{
    "id": "2ea5a604-d225-4cd2-82ac-b907cb0b4f63",
    "state": "active",
    "publish": {
        "type": "livekit",
        "url": "wss://livekit.overshoot.ai",
        "token": "ey...k"
    },
    "expires_at_ms": 1777529931184,
    "ttl_seconds": 300
}

Connect your webcam to the stream

Paste your Room URL and Token to generate a one-click LiveKit Meet link, or use your favorite LiveKit SDK.

Ask the model what it can see

Once the camera is connected, send a simple Chat Completion request to the model.

curl -X POST https://api.overshoot.ai/v1beta/chat/completions \
-H "Authorization: Bearer $OVERSHOOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "google/gemma-4-26B-A4B-it",
"messages": [
    {
    "role": "user",
    "content": [
        {"type": "text", "text": "What am I wearing?"},
        {"type": "image_url", "image_url": {
            "url": "ovs://streams/{stream_id}?frame_index=-1"
        }}
    ]
    }]}'

Sample Response

{
    "id": "34225b75-abae-4c58-8191-2abdc8f437de",
    "object": "chat.completion",
    "created": 1777530304,
    "model": "google/gemma-4-26B-A4B-it",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "Plaid robe, t-shirt."
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 307,
        "completion_tokens": 9,
        "total_tokens": 316
    }
}

Welcome to Overshoot The Stream

⌘I