Ask questions (synchronous)
POST/api/v1/systemone
Send state and typed questions and get typed probabilities back in the same response. Use this for text or other short inputs; for a video use POST /v1/systemone/jobs (videos here returns 422 with code: systemone_video_requires_job).
Each request counts as one video against your organization's video quota (GET /v1/usage); a request that gets no answer (400, 404, 503, or a job that ends as failed) is not charged, or is returned to the quota. When the quota is exhausted the response is 422 with code: quota_exceeded_videos. A key that belongs to no organization gets 422 with code: systemone_no_org.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 422
- 500
- 503
{id, created, model, answers, usage, partial_failures?}. Each answer has a type: noul → noul; choice → choice, probabilities, confidence; score → score, legend, probabilities, confidence. Questions that failed appear only in partial_failures.
The model rejected the request (code: systemone_invalid_request); detail carries its reason. Returned to the quota.
Missing or invalid API key. Add Authorization: Bearer vuf_live_<keyid>.<secret>.
Key used outside the public API roots (/api/v1, /api/v1.1).
model is not a served model (code: systemone_model_not_found). Returned to the quota.
Request body failed validation.
Upstream service error — usually safe to retry.
Inference (or the job queue) is temporarily unavailable; nothing was charged. Retry with backoff.