OHGROK / Integration guide
Query a video task
Track the same task until completion or failure.
On this page
Authentication
Use Authorization: Bearer YOUR_API_KEY. The selected model must be enabled for that key’s group. JSON requests use Content-Type: application/json.
Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| video_id | path string | Required | The id returned by submission. |
Request example
cURL
VIDEO_ID='YOUR_VIDEO_ID'
curl --fail-with-body --silent --show-error \
"https://api.ohgrok.com/v1/videos/$VIDEO_ID" \
-H "Authorization: Bearer $OHGROK_API_KEY"Response structure
Public status values are queued, in_progress, completed, failed or unknown. Continue polling with a delay for queued/in_progress; stop on completed/failed. Inspect unknown without resubmitting. Progress, if present, is not an ETA.
Illustrative structure — not a live receipt
{"id":"YOUR_VIDEO_ID","status":"completed"}Error handling
Read the HTTP status together with the returned error message. Check your key and group for authentication or model-access failures. Inspect balance and upstream limits for quota/rate errors; retain task IDs on timeouts.