First Successful Workflow

Goal

Validate a stream, run one synchronous check, then start async monitoring and read job status.

Prerequisites

API key from console.machinefi.com
A live stream URL (YouTube Live, Twitch, RTSP, or RTSPS)

Step 1: Validate Stream Liveness

curl -X POST https://trio.machinefi.com/api/streams/validate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"stream_url":"https://www.youtube.com/watch?v=jfKfPfyJRdk"}'

If this fails, resolve URL issues first before starting jobs.

Step 2: Run One Immediate Check

curl -X POST https://trio.machinefi.com/api/check-once \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "stream_url":"https://www.youtube.com/watch?v=jfKfPfyJRdk",
    "condition":"Is there an animated character visible?"
  }'

The response includes:

triggered: boolean
explanation: model explanation
latency_ms: request latency

Step 3: Start Continuous Monitoring

curl -X POST https://trio.machinefi.com/api/live-monitor \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "stream_url":"https://www.youtube.com/watch?v=jfKfPfyJRdk",
    "condition":"Is there a cat visible?"
  }'

You receive a job_id and status.

Step 4: Poll Job Status

curl https://trio.machinefi.com/api/jobs/YOUR_JOB_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

Terminal statuses are completed, stopped, and failed.

Step 5: Stop Early (Optional)

curl -X DELETE https://trio.machinefi.com/api/jobs/YOUR_JOB_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

What You Just Completed

Pre-flight URL validation
One synchronous condition check
One async monitoring job
Job lifecycle tracking via /jobs/{job_id}

Next Steps

Choose best mode for your app: Choose Your Workflow
Write stronger prompts: Writing Reliable Conditions
Production delivery patterns: Guides

​Goal

​Prerequisites

​Step 1: Validate Stream Liveness

​Step 2: Run One Immediate Check

​Step 3: Start Continuous Monitoring

​Step 4: Poll Job Status

​Step 5: Stop Early (Optional)

​What You Just Completed

​Next Steps