Skip to content
HIPS
  • Earn with your GPU
  • Pricing
  • Docs
Sign inJoin early access
⌘K

Get started

  1. 01Developer hub
  2. 02Quickstart
  3. 03Migrate to HIPS

Guides

  1. 04HIPS SDK
  2. 05Import and run your model
  3. 06Model and task guides
    1. ATask guides
    2. BLanguage (chat)
    3. CClassification
    4. DImage
    5. EVideo
    6. FAudio
    7. GDocument processing
  4. 07Batch jobs
  5. 08Prompt caching
  6. 09Code with HIPS
  7. 10Coding-tool setup
    1. AHIPS Code
    2. BClaude Code
    3. CCodex
    4. DOpenCode
    5. EKilo
    6. FPi
    7. GQwen Code
    8. HCrush
    9. ICline
    10. JPrime Agent
    11. KAider
    12. LGoose
    13. MHermes Agent
    14. NGrok Build
    15. ODeepSeek Harness
    16. POther coding tools and editor integrations
  8. 11Command line
    1. AInstall and update
    2. BSign in
    3. CStatus and models
    4. DCoding agents
  9. 12Console
    1. AAccount
    2. BWorkspaces
    3. CAPI keys
    4. DSettings
    5. EUsage
    6. FModels
    7. GPlayground
    8. HDeployments
  10. 13Billing
  11. 14Provider setup
    1. AWhen it works
    2. BCommands
    3. CSettings
    4. DProvider Console
    5. EEarnings
    6. FCrash reports
    7. GData centers
  12. 15Semantic routing
  13. 16Guardrails
  14. 17Knowledge

Reference

  1. 18API reference
    1. AAuthentication
    2. BChat completions
    3. CResponses
    4. DMessages
    5. ECount tokens
    6. FModels
    7. GPrices API
    8. HTasks
    9. IEmbeddings and rerank
    10. JImages
    11. KJobs
    12. LUploads
    13. MFiles
    14. NBatches
    15. OWebhooks
    16. PVector stores
    17. QDeployments
    18. RRequirements and headers
    19. SErrors
    20. TUsage
    21. UVersioning
  2. 19Operating guidance
    1. ALimits
    2. BErrors
    3. CRetries and billing outcomes
    4. DIdempotency
    5. EStreaming
    6. FData handling
    7. GCompatibility matrix
  3. 20Changelog
Sheet indexAPI reference

Get started

  1. 01Developer hub
  2. 02Quickstart
  3. 03Migrate to HIPS

Guides

  1. 04HIPS SDK
  2. 05Import and run your model
  3. 06Model and task guides
    1. ATask guides
    2. BLanguage (chat)
    3. CClassification
    4. DImage
    5. EVideo
    6. FAudio
    7. GDocument processing
  4. 07Batch jobs
  5. 08Prompt caching
  6. 09Code with HIPS
  7. 10Coding-tool setup
    1. AHIPS Code
    2. BClaude Code
    3. CCodex
    4. DOpenCode
    5. EKilo
    6. FPi
    7. GQwen Code
    8. HCrush
    9. ICline
    10. JPrime Agent
    11. KAider
    12. LGoose
    13. MHermes Agent
    14. NGrok Build
    15. ODeepSeek Harness
    16. POther coding tools and editor integrations
  8. 11Command line
    1. AInstall and update
    2. BSign in
    3. CStatus and models
    4. DCoding agents
  9. 12Console
    1. AAccount
    2. BWorkspaces
    3. CAPI keys
    4. DSettings
    5. EUsage
    6. FModels
    7. GPlayground
    8. HDeployments
  10. 13Billing
  11. 14Provider setup
    1. AWhen it works
    2. BCommands
    3. CSettings
    4. DProvider Console
    5. EEarnings
    6. FCrash reports
    7. GData centers
  12. 15Semantic routing
  13. 16Guardrails
  14. 17Knowledge

Reference

  1. 18API reference
    1. AAuthentication
    2. BChat completions
    3. CResponses
    4. DMessages
    5. ECount tokens
    6. FModels
    7. GPrices API
    8. HTasks
    9. IEmbeddings and rerank
    10. JImages
    11. KJobs
    12. LUploads
    13. MFiles
    14. NBatches
    15. OWebhooks
    16. PVector stores
    17. QDeployments
    18. RRequirements and headers
    19. SErrors
    20. TUsage
    21. UVersioning
  2. 19Operating guidance
    1. ALimits
    2. BErrors
    3. CRetries and billing outcomes
    4. DIdempotency
    5. EStreaming
    6. FData handling
    7. GCompatibility matrix
  3. 20Changelog
18
  1. Docs/
  2. API reference/
  3. Jobs
(Detail K)
llms.txt

Jobs

On this sheet2 sections
  1. The contract, once built
  2. Errors these routes answer today

The asynchronous job routes are not built yet: the gateway mounts none of them, so each answers 404 route_not_found. Until they are, every task type that is served runs synchronously, on POST /v1/tasks (Tasks) or on POST /v1/embeddings and POST /v1/rerank (Embeddings and rerank), and many requests at once will run as a batch once batches are offered. The contract below is what the routes will answer when they are built.

F
Fig. 1, sheet 18API reference
RouteToday
POST /v1/jobsNot built: 404 route_not_found
GET /v1/jobs/{id}Not built: 404 route_not_found
GET /v1/jobsNot built: 404 route_not_found
POST /v1/jobs/{id}/cancelNot built: 404 route_not_found
  • Route
    POST /v1/jobs
    Today
    Not built: 404 route_not_found
  • Route
    GET /v1/jobs/{id}
    Today
    Not built: 404 route_not_found
  • Route
    GET /v1/jobs
    Today
    Not built: 404 route_not_found
  • Route
    POST /v1/jobs/{id}/cancel
    Today
    Not built: 404 route_not_found

Note

Not built. A task type that runs only as a job (video_generation) answers 400 use_jobs on POST /v1/tasks, and no model of that type is priced yet.

The contract, once built

Job object

00000000000000000000000000000000000000001{2  "object": "job",3  "id": "job_...",4  "status": "queued",5  "model": "<pinned id>",6  "task": "video_generation",7  "created_at": "2026-10-20T12:00:00Z",8  "transitions": [{"status": "queued", "at": "2026-10-20T12:00:00Z"}],9  "requirements": {"pool": "certified", "pricing_mode": "market", "region": null, "fallback": false},10  "quote": "quote_...",11  "result": null,12  "error": null,13  "usage": null,14  "expires_at": null15}
Job object sample
StatusMeaningTerminal
queuedAccepted, quote bound, no worker yetNo
assignedA worker took it; the attempt is att_No
runningThe worker reported a startNo
completedresult is set; usage and the cost are finalYes
failederror is set (the envelope's shape); nothing billed unless the retries page says otherwiseYes
canceledBy POST /v1/jobs/{id}/cancel, by a client disconnect or by the workspace being paused; the running attempt, if any, ends interrupted with reason canceledYes
interruptedAn attempt was interrupted after a streamed partial answer had already reached the client, or the attempt limit was reached after an interruption; nothing billedYes
  • Status
    queued
    Meaning
    Accepted, quote bound, no worker yet
    Terminal
    No
  • Status
    assigned
    Meaning
    A worker took it; the attempt is att_
    Terminal
    No
  • Status
    running
    Meaning
    The worker reported a start
    Terminal
    No
  • Status
    completed
    Meaning
    result is set; usage and the cost are final
    Terminal
    Yes
  • Status
    failed
    Meaning
    error is set (the envelope's shape); nothing billed unless the retries page says otherwise
    Terminal
    Yes
  • Status
    canceled
    Meaning
    By POST /v1/jobs/{id}/cancel, by a client disconnect or by the workspace being paused; the running attempt, if any, ends interrupted with reason canceled
    Terminal
    Yes
  • Status
    interrupted
    Meaning
    An attempt was interrupted after a streamed partial answer had already reached the client, or the attempt limit was reached after an interruption; nothing billed
    Terminal
    Yes

Parts list: Routes

  1. 01
    POST /v1/jobs

    The same body as a task, answered 202 at once with the job object.

  2. 02
    GET /v1/jobs/{id}

    The job object. result holds inline results or, for media, outputs with a presigned GET.

  3. 03
    GET /v1/jobs

    The workspace's jobs, newest first, cursor-paginated.

  4. 04
    POST /v1/jobs/{id}/cancel

    queued: canceled at once, nothing billed. assigned or running: the attempt ends interrupted and the job canceled; the charge for work done is Not decided yet.

Errors these routes answer today

StatusTypeCodeSituationRetry
400invalid_request_erroruse_jobsA task type that runs only as an asynchronous job (video_generation); the job routes are not built yetNo
404not_found_errorroute_not_foundUnknown path, among them every /v1/jobs path (not built) and Knowledge's paths while Knowledge is switched offNo
  • Status
    400
    Type
    invalid_request_error
    Code
    use_jobs
    Situation
    A task type that runs only as an asynchronous job (video_generation); the job routes are not built yet
    Retry
    No
  • Status
    404
    Type
    not_found_error
    Code
    route_not_found
    Situation
    Unknown path, among them every /v1/jobs path (not built) and Knowledge's paths while Knowledge is switched off
    Retry
    No

Related sheets

  • Tasks
  • Batch jobs
Previous sheetImages
Next sheetUploads
Sheet
18 of 20
Detail
K
Updated
2026-11-11
Sign in to the Console

On this sheet

  1. The contract, once built
  2. Errors these routes answer today

Product

  • Inference
  • Models
  • Deploy your model
  • Always-on GPU capacity
  • How it works
  • Use cases
  • Pricing

Developer

  • Docs
  • Quickstart
  • Migrate to HIPS
  • HIPS SDK
  • Batch jobs
  • API reference

Provider

  • Earn with your GPU
  • Register GPU interest
  • Download for Mac
  • Download for Windows
  • Download for Linux

Resource

  • Security and Data
  • Resources
  • llms.txt

Compare

  • OpenRouter alternatives
  • Together AI alternatives
  • Groq alternatives
  • All comparisons

Company

  • About
  • Contact
  • Affiliate program
  • HIPS Payments

Legal

  • Legal
  • Consumer Health Data Privacy Policy
  • Report content
  • Cookie preferences

Support

  • Contact HIPS
  • Looking for payments support?

HIPS. AI inference for builders.

hips.com

Hyperscale Inference Processing Systems OÜ