Technical Task Router
Prediction Endpoint
https://api.hokus.ai/api/v1/models/30/predicttask_type
language
domain
complexity
repo_size_bucket
files_touched_bucket
description_length_bucket
is_greenfield
is_migration
requires_tests
cross_service
ui_heavy
risk_level
max_cost_usd
available_planner_models
available_coder_models
available_reviewer_models
planner_model
planner_agent
coder_model
coder_agent
reviewer_model
reviewer_agent
plan_depth
code_depth
review_mode
route_source
router_mode
routing_mode
expected_success_probability
expected_cost_usd
confidence
risk_score
score
score_band
under_budget
actual_cost_usd
actual_time_seconds
intervention_count
workflow_cost_status
budget_violation
rubric_version
rubric_criterion_count
rubric_mean_score
rubric_completeness
rubric_correctness
rubric_code_quality
rubric_intervention_impact
rubric_autonomy
rubric_determinative_boundary
rubric_provenance
Execute the model to see the response
Include your API key in the Authorization header of every request. You can obtain your API key from the developer portal.
Header Format
Authorization: Bearer hk_live_your_api_key_here| Field | Type | Required | Description | Constraints |
|---|---|---|---|---|
| task_type | string | Optional | task_type | - |
| language | string | Optional | language | - |
| domain | string | Optional | domain | - |
| complexity | string | Optional | complexity | - |
| repo_size_bucket | string | Optional | repo_size_bucket | - |
| files_touched_bucket | string | Optional | files_touched_bucket | - |
| description_length_bucket | string | Optional | description_length_bucket | - |
| is_greenfield | string | Optional | is_greenfield | - |
| is_migration | string | Optional | is_migration | - |
| requires_tests | string | Optional | requires_tests | - |
| cross_service | string | Optional | cross_service | - |
| ui_heavy | string | Optional | ui_heavy | - |
| risk_level | string | Optional | risk_level | - |
| max_cost_usd | string | Optional | max_cost_usd | - |
| available_planner_models | string | Optional | available_planner_models | - |
| available_coder_models | string | Optional | available_coder_models | - |
| available_reviewer_models | string | Optional | available_reviewer_models | - |
| planner_model | string | Optional | planner_model | - |
| planner_agent | string | Optional | planner_agent | - |
| coder_model | string | Optional | coder_model | - |
| coder_agent | string | Optional | coder_agent | - |
| reviewer_model | string | Optional | reviewer_model | - |
| reviewer_agent | string | Optional | reviewer_agent | - |
| plan_depth | string | Optional | plan_depth | - |
| code_depth | string | Optional | code_depth | - |
| review_mode | string | Optional | review_mode | - |
| route_source | string | Optional | route_source | - |
| router_mode | string | Optional | router_mode | - |
| routing_mode | string | Optional | routing_mode | - |
| expected_success_probability | string | Optional | expected_success_probability | - |
| expected_cost_usd | string | Optional | expected_cost_usd | - |
| confidence | string | Optional | confidence | - |
| risk_score | string | Optional | risk_score | - |
| score | string | Optional | score | - |
| score_band | string | Optional | score_band | - |
| under_budget | string | Optional | under_budget | - |
| actual_cost_usd | string | Optional | actual_cost_usd | - |
| actual_time_seconds | string | Optional | actual_time_seconds | - |
| intervention_count | string | Optional | intervention_count | - |
| workflow_cost_status | string | Optional | workflow_cost_status | - |
| budget_violation | string | Optional | budget_violation | - |
| rubric_version | string | Optional | rubric_version | - |
| rubric_criterion_count | string | Optional | rubric_criterion_count | - |
| rubric_mean_score | string | Optional | rubric_mean_score | - |
| rubric_completeness | string | Optional | rubric_completeness | - |
| rubric_correctness | string | Optional | rubric_correctness | - |
| rubric_code_quality | string | Optional | rubric_code_quality | - |
| rubric_intervention_impact | string | Optional | rubric_intervention_impact | - |
| rubric_autonomy | string | Optional | rubric_autonomy | - |
| rubric_determinative_boundary | string | Optional | rubric_determinative_boundary | - |
| rubric_provenance | string | Optional | rubric_provenance | - |
Example Response
{
"metadata": {},
"completed_successfully": ""
}Response Fields
| Field | Type | Description |
|---|---|---|
| metadata | object | Request metadata |
| completed_successfully | string | completed_successfully |
curl -X POST "https://api.hokus.ai/api/v1/models/30/predict" \
-H "Authorization: Bearer hk_live_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"inputs": {
"task_type": "",
"language": "",
"domain": "",
"complexity": "",
"repo_size_bucket": "",
"files_touched_bucket": "",
"description_length_bucket": "",
"is_greenfield": "",
"is_migration": "",
"requires_tests": "",
"cross_service": "",
"ui_heavy": "",
"risk_level": "",
"max_cost_usd": "",
"available_planner_models": "",
"available_coder_models": "",
"available_reviewer_models": "",
"planner_model": "",
"planner_agent": "",
"coder_model": "",
"coder_agent": "",
"reviewer_model": "",
"reviewer_agent": "",
"plan_depth": "",
"code_depth": "",
"review_mode": "",
"route_source": "",
"router_mode": "",
"routing_mode": "",
"expected_success_probability": "",
"expected_cost_usd": "",
"confidence": "",
"risk_score": "",
"score": "",
"score_band": "",
"under_budget": "",
"actual_cost_usd": "",
"actual_time_seconds": "",
"intervention_count": "",
"workflow_cost_status": "",
"budget_violation": "",
"rubric_version": "",
"rubric_criterion_count": "",
"rubric_mean_score": "",
"rubric_completeness": "",
"rubric_correctness": "",
"rubric_code_quality": "",
"rubric_intervention_impact": "",
"rubric_autonomy": "",
"rubric_determinative_boundary": "",
"rubric_provenance": ""
}
}'| Code | Error | Description | Resolution |
|---|---|---|---|
401 | Unauthorized | Missing or invalid API key | Include a valid API key in the Authorization header |
404 | Not Found | Model not found | Verify the model ID is correct |
422 | Unprocessable Entity | Invalid input | Check input format and required fields |