Create a vision annotation for a single frame
POST
/v1/vision/annotationscurl -X POST 'https://api.embodiflow.io/v1/vision/annotations' \
-H 'Authorization: Bearer $EMBODIFLOW_PAT' \
-H 'Content-Type: application/json' \
-d '{
"imageBase64": "string",
"mimeType": "image/jpeg",
"context": "string"
}'Authorization
Send a personal access token with every request.
- Authorization: Bearer PAT
Header parameters
- Idempotency-Keystring
Optional idempotency key, at most 255 characters (UUIDv4 recommended). A repeated key returns the first response byte-for-byte, including a 5xx. The same key with a different body, or a second in-flight request, returns 409 IDEMPOTENCY_CONFLICT. Keys are unique per tenant and retained for 24 hours.
Request body
Content-Typeapplication/json
- imageBase64stringrequired
- mimeTypestringAllowed valuesimage/jpegimage/pngimage/webp
- contextstring
Responses
Success
- dataobjectrequired
- modelstringrequired
- latencyMsnumberrequired
- annotationobjectrequired
Response example
{
"data": {
"model": "string",
"latencyMs": 0,
"annotation": {
"scene": "string",
"objects": [
{
"name": "string",
"role": "robot",
"state": "unknown"
}
],
"action": "unknown"
}
}
}Servershttps://api.embodiflow.io/v1https://api.embodiflow.dev/v1