Skip to main content
POST
/
check-once
Check Once
curl --request POST \
  --url https://trio.machinefi.com/api/check-once \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "stream_url": "https://www.youtube.com/watch?v=jfKfPfyJRdk",
  "condition": "Is there an animated character visible?"
}
'
{
  "triggered": true,
  "explanation": "Yes, there is an animated character visible. The frame shows an anime-style girl with headphones sitting at a desk.",
  "latency_ms": 2134
}

Authorizations

​
Authorization
string
header
required

Get your API key at console.machinefi.com

Body

application/json
​
stream_url
string
required

YouTube Live URL to check

Example:

"https://www.youtube.com/watch?v=jfKfPfyJRdk"

​
condition
string
required

Yes/no question to evaluate

Example:

"Is there an animated character visible?"

Response

Successful check

​
triggered
boolean

Whether the condition was met

Example:

true

​
explanation
string

AI explanation of what was observed

Example:

"Yes, there is an animated character visible."

​
latency_ms
integer

Processing time in milliseconds

Example:

2134