Quickstart

from perceptron import configure, question, video

configure(
    provider="perceptron",
    model="perceptron-mk1",
    api_key="YOUR_API_KEY",  # Get yours at platform.perceptron.inc
)

result = question(
    video("https://raw.githubusercontent.com/perceptron-ai-inc/perceptron/main/cookbook/_shared/assets/tutorials/isaac_frame_by_frame/surf.mp4"),
    "What happens in this video?",
    reasoning=True,
)
print(result.text)

curl -X POST "https://api.perceptron.inc/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $PERCEPTRON_API_KEY" \
  -d '{
  "model": "perceptron-mk1",
  "messages": [
    {
      "role": "user",
      "content": [
        {"type": "video_url", "video_url": {"url": "https://raw.githubusercontent.com/perceptron-ai-inc/perceptron/main/cookbook/_shared/assets/tutorials/isaac_frame_by_frame/surf.mp4"}},
        {"type": "text", "text": "What happens in this video?"}
      ]
    }
  ],
  "vision_config": { "enable_thinking": true }
}'

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",  # Get yours at platform.perceptron.inc
    base_url="https://api.perceptron.inc/v1",
)

response = client.chat.completions.create(
    model="perceptron-mk1",
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "video_url", "video_url": {"url": "https://raw.githubusercontent.com/perceptron-ai-inc/perceptron/main/cookbook/_shared/assets/tutorials/isaac_frame_by_frame/surf.mp4"}},
                {"type": "text", "text": "What happens in this video?"}
            ],
        }
    ],
    extra_body={"vision_config": {"enable_thinking": True}},
)

print(response.choices[0].message.content)