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. Tasks
(Detail H)
llms.txt

Tasks

On this sheet5 sections
  1. Task types
  2. OpenAI's routes for types not served yet
  3. Batching
  4. The response
  5. Errors this route can answer

The versioned contract the HIPS SDK wraps: the envelope, the routes, the states and the rules that hold for every task. Task types, their inputs, options and output shapes are the catalog's.

POST/v1/tasksserved

A synchronous task: one request, one batch of inputs, one result array.

F
Fig. 1, sheet 18API reference

Request

00000000000000000000000000000000000000001{2  "model": "<catalog id>",3  "task": "classification",4  "inputs": [5    {"id": "a", "type": "image", "data": "<base64>"},6    {"id": "b", "type": "image", "upload_id": "upl_..."}7  ],8  "options": {"top_k": 3},9  "hips": {"pool": "community", "pricing_mode": "market", "fallback": false}10}
Request sample

Parts list: Fields

  1. 01
    model or deploymentExactly one

    model is a catalog id, alias or pinned id; deployment is a dep_ id. A dep_ in model is a 400 invalid_value that points at deployment.

  2. 02
    taskRequired

    Must be the model's task, or one of them for a model advertising several; otherwise a 400 task_mismatch.

  3. 03
    inputsRequired

    An array; each input an object with an optional id (unique within the request; the index is used when absent), a type (text, image, audio, file) and exactly one of text, data (base64 inline, within the limits) or upload_id (an upl_ of the key's workspace, once uploads are offered). No url at launch Not decided yet. An image_edit task's image inputs may carry a role, reference (the default) or mask (Image generation and editing); on any other task a role is a 400 unsupported_parameter.

  4. 04
    optionsPer task

    The task's options as the catalog defines them per task (labels for a zero-shot classifier, top_k, image size, voice, language). An unknown option is a 400 unknown_parameter.

  5. 05
    hipsOptional

    The request requirements: pool (auto, the default, community or certified), pricing_mode, region, fallback.

Task types

The task values the gateway takes, with the inputs and options each accepts. A type is served once it has a price kind and a model of it is published and priced: today classification, embedding, rerank, image_generation and image_edit. Embeddings and rerank also have routes of their own in OpenAI's and Cohere's shapes, POST /v1/embeddings and POST /v1/rerank, and the image tasks OpenAI's POST /v1/images/generations and POST /v1/images/edits. A language model's chat is never the task API's: it goes to chat completions, Responses or Messages.

TaskInputsOptionsUnitPriced now
classificationtext, image, audio, filelabels, top_k, threshold, multi_labelclassification, priced per 1,000Yes
embeddingtext, imagedimensions, normalizesecond (H109)Yes
reranktext, each a documentquery (required)second (H109)Yes
detectionimagelabels, top_k, thresholddetectionNo
transcriptionaudio, filelanguage, timestamps, diarizationaudio_secondNo
translationaudio, filelanguage, timestampsaudio_secondNo
speechtextvoice, language, format, speedcharacterNo
image_generation, image_edittext, the prompt; for an edit also image, each with an optional role (reference or mask)width, height, count, steps, seed, negative_prompt, sampler, scheduler, cfg_scale, guidance, output_format, output_qualityimage, a fixed price per image at its sizeYes
video_generationtext, imageduration_s, width, height, fps, count, seedvideo_second; a job onlyNo
  • Task
    classification
    Inputs
    text, image, audio, file
    Options
    labels, top_k, threshold, multi_label
    Unit
    classification, priced per 1,000
    Priced now
    Yes
  • Task
    embedding
    Inputs
    text, image
    Options
    dimensions, normalize
    Unit
    second (H109)
    Priced now
    Yes
  • Task
    rerank
    Inputs
    text, each a document
    Options
    query (required)
    Unit
    second (H109)
    Priced now
    Yes
  • Task
    detection
    Inputs
    image
    Options
    labels, top_k, threshold
    Unit
    detection
    Priced now
    No
  • Task
    transcription
    Inputs
    audio, file
    Options
    language, timestamps, diarization
    Unit
    audio_second
    Priced now
    No
  • Task
    translation
    Inputs
    audio, file
    Options
    language, timestamps
    Unit
    audio_second
    Priced now
    No
  • Task
    speech
    Inputs
    text
    Options
    voice, language, format, speed
    Unit
    character
    Priced now
    No
  • Task
    image_generation, image_edit
    Inputs
    text, the prompt; for an edit also image, each with an optional role (reference or mask)
    Options
    width, height, count, steps, seed, negative_prompt, sampler, scheduler, cfg_scale, guidance, output_format, output_quality
    Unit
    image, a fixed price per image at its size
    Priced now
    Yes
  • Task
    video_generation
    Inputs
    text, image
    Options
    duration_s, width, height, fps, count, seed
    Unit
    video_second; a job only
    Priced now
    No

OpenAI's routes for types not served yet

Each model type that is not a language model gets OpenAI's own route as well, a thin front door on the same task workers, opened type by type (decided 2026-11-04). Until its type is served, each answers 400 type_not_served at model, naming the type, never a guess at a shape. The image routes are open: Images documents them.

POST/v1/audio/transcriptionsnot served

Answers 400 type_not_served: no speech-to-text model is served yet. Opens once the type is served.

POST/v1/audio/speechnot served

Answers 400 type_not_served: no text-to-speech model is served yet. Opens once the type is served.

An option a type does not take is a 400 unknown_parameter; a model's own task decides which type a request may name (400 task_mismatch otherwise). Rerank, detection and embedding have no task guide yet; their fields are here and on the Usage page. The image tasks' options, bounds and answer are on Image generation and editing.

Batching

The inputs array is the batch. One request is one job, one quote, one usage record and one x-hips-cost-micros; the cost is the number of inputs times the model's unit price. The maximum inputs per request and the maximum inline bytes are the model's hips.limits and the plan's limit. The whole batch runs on one worker; it is not split across pools.

The response

Response

00000000000000000000000000000000000000001{2  "object": "task",3  "id": "job_...",4  "model": "<pinned id>",5  "task": "classification",6  "results": [7    {"input": "a", "labels": [{"label": "invoice", "score": 0.91}, {"label": "receipt", "score": 0.07}]},8    {"input": "b", "error": {"message": "...", "type": "invalid_request_error", "param": "inputs[1].data", "code": "invalid_image"}}9  ],10  "usage": {"units": 2, "unit": "classification", "billed_units": 1}11}
Response sample

Parts list: Rules

  1. 01
    results

    One entry per input, in request order, with input the input's id. A task's result shape (labels with scores, a vector, an image, a transcript with segments) is the catalog's per task type.

  2. 02
    Per-input failure

    An input the worker cannot read gets an error entry in the envelope's shape and is not billed; the other inputs are answered. usage.billed_units counts the answered ones.

  3. 03
    Image tasks

    One entry per image asked, in order, each with input the prompt's id and its index: the image inline, or the image_withheld error of an image the content checks withheld, which is not billed. The answer adds the seed the images were made with (Image generation and editing).

  4. 04
    Request failure

    A request that is malformed, over a limit, or names a model, task or requirement it cannot use is a 400 before any work; nothing is billed.

  5. 05
    Time limit

    An embedding or rerank request the measured speed of every GPU serving the model shows cannot finish within the gateway's time limit is refused with a 400 exceeds_time_limit before it starts. A type that runs only as a job (video_generation) is a 400 use_jobs; the job routes are not built yet.

  6. 06
    id

    The request's job id, job_..., the key of its usage record. The job routes that would read it again are not built yet.

  7. 07
    idempotency-key

    Taken on this route: a retry while the first runs answers 400 idempotency_in_progress, and once it completed 404 result_expired, its message naming the first request's req_ id. No answer is kept; nothing runs or is billed again (Idempotency).

Errors this route can answer

StatusTypeCodeSituationRetry
400invalid_request_errorinvalid_jsonThe body is not JSON, or not an objectNo
400invalid_request_errormissing_required_parameterA required field or header is absent; param names itNo
400invalid_request_errorinvalid_typeA field has the wrong JSON typeNo
400invalid_request_errorinvalid_valueA value is out of range or malformed: stop with more than 16 entries, a prompt_cache_key over 512 characters, a string holding a lone surrogate escape, a router name with an empty or unknown suffix, both max_tokens names with different valuesNo
400invalid_request_errorunknown_parameterA field the gateway does not know, at any depth; param names itNo
400invalid_request_errorunsupported_parameterA known field HIPS does not accept, or a feature the named model does not advertise in the pool the request resolves to; param names it and message names the modelNo
400invalid_request_errorunsupported_valuen other than 1, stream_options without stream, a message role, part, item or tool type not accepted, a hosted tool that is not servedNo
400invalid_request_errorinvalid_imageAn image part or input cannot be decoded, is of an unsupported type or over the pixel limitNo
400invalid_request_errorrequest_too_large, input_too_large, too_many_inputs, upload_too_largeA limit of the Limits pageNo
400invalid_request_errorexceeds_time_limitAn embedding or rerank request that the measured speed of every GPU serving the model shows cannot finish within its time limit; the message says how long it would take. Sent before any work, unchargedNo; send fewer or shorter inputs
400invalid_request_errortask_mismatchtask is not the model's task, or the model is not an embedding model or a reranker on its routeNo
400invalid_request_erroruse_jobsA task type that runs only as an asynchronous job (video_generation); the job routes are not built yetNo
400invalid_request_errordeployment_stoppedThe dep_ is in stopped; start it in the ConsoleNo
400invalid_request_errorupload_not_found, upload_expired, upload_incomplete, upload_mismatch, upload_consumed, upload_purpose_mismatch, upload_region_mismatchAn upload_id that is unknown or another workspace's, past expires_at, without bytes, with bytes that differ from the declaration, already consumed, of another purpose than the request needs, or stored in another region than the request's region requirement. Uploads are not offered in production yetNo (upload_incomplete: after the PUT)
400invalid_request_errorinvalid_requirementA requirement header or field with an unknown valueNo
400invalid_request_errorrequirement_conflictTwo requirements that cannot both hold, a header and a hips field that differ, a pool the model is never offered in, community with an always-on deployment, a knowledge base whose requirements the request cannot meetNo
400invalid_request_errorinvalid_idempotency_key, idempotency_key_reused, idempotency_in_progressThe idempotency rulesThe last one, later
400invalid_request_errorcontent_refusedAn image request the content checks refused: its prompt or an input image asks for content the Acceptable Use Policy prohibits (param the prompt, inputs[0].text, for a generation, inputs for an edit; before any work), or every image made was withheld (param task). The message is the statement of reasons. Nothing chargedNo
402insufficient_creditinsufficient_creditThe balance does not cover the request's maximum cost at the bound quoteAfter a top-up
402insufficient_creditbudget_exceededA budget guardrail of the workspace, the key or the person is at its limit with block; the error carries guardrail and resets_at (null for a budget that never resets). Never a payment challengeAfter resets_at, or once the limit is raised
403permission_errormodel_not_on_planA model or feature the workspace's plan does not include, read from the plan's terms: on Free a model outside the Free plan's models (today gemma-4-e4b-it-8b, gpt-oss-120b, gpt-oss-20b and qwen3-14b), a router or Knowledge; on Free and Pro a deployment (dep_). The error adds feature and required_plan, the lowest plan that includes it. Answered before any placement, uncharged. A deployment refused this way is kept and answers again once the workspace is on a plan with deploymentsAfter an owner or admin chooses a plan that includes it
403permission_errorpool_not_allowedA pool the workspace may not use for this model: one an access guardrail keeps out (named in the error), or a customer model's pool whose runtime-access conditions were not acceptedNo
403permission_errormodel_not_allowed, region_not_allowedA model, or a region requirement, that an access guardrail keeps out, the guardrail named in the error's guardrail memberNo
403permission_errorguardrail_unsupportedA content moderation guardrail applies to text it does not scan yet: a batch, or a task request with text; the guardrail named, unchargedNo
404not_found_errormodel_not_foundUnknown catalog id, alias, pinned id or dep_; another workspace's dep_; a name starting with hips-router that is not one of the four routersNo
404not_found_errorupload_not_found, file_not_found, batch_not_foundAn id in the path, or input_file_id, that is unknown, deleted, expired, another workspace's, or out of the credential's reach. Batches and files are not offered in production yetNo
404not_found_errorresult_expiredA task, embeddings or rerank request retried with its idempotency-key after the first completed: no answer is kept, and the message names the first request's req_ id. It ran and was billed onceNo
429rate_limit_errorrate_limit_exceededA rate limit; param is requests, tokens, uploads, batches (batches created per hour) or knowledge_search; Retry-AfterYes, after Retry-After
503overloaded_errorno_capacityNo eligible worker under the request's requirements, in any pool the requirements allow; Retry-After. The message says what those pools can do now: a GPU that fits the model takes it when free or loads it when asked, which can take minutes or longer; or nothing can serve it, and a retry sooner than the given delay gets the same answerYes, after the given delay
503overloaded_errorpool_unavailableThe named pool has no eligible supply for this model now and fallback is off; the other pool may have; Retry-AfterYes, or with fallback
503overloaded_erroroverloadedEligible workers exist and every one is saturated, or the queue is full; Retry-AfterYes
503overloaded_errorcontent_check_unavailableThe content checks of an image request could not run (the decision service failed or did not answer in time), and HIPS sends no image request unchecked; Retry-After; unchargedYes, after Retry-After
500api_errorinternal_errorA fault in HIPS. Nothing billedOnce
500api_errorattempt_failedEvery attempt failed for a reason that is not the client's and retries are exhausted. Nothing billedOnce
  • Status
    400
    Type
    invalid_request_error
    Code
    invalid_json
    Situation
    The body is not JSON, or not an object
    Retry
    No
  • Status
    400
    Type
    invalid_request_error
    Code
    missing_required_parameter
    Situation
    A required field or header is absent; param names it
    Retry
    No
  • Status
    400
    Type
    invalid_request_error
    Code
    invalid_type
    Situation
    A field has the wrong JSON type
    Retry
    No
  • Status
    400
    Type
    invalid_request_error
    Code
    invalid_value
    Situation
    A value is out of range or malformed: stop with more than 16 entries, a prompt_cache_key over 512 characters, a string holding a lone surrogate escape, a router name with an empty or unknown suffix, both max_tokens names with different values
    Retry
    No
  • Status
    400
    Type
    invalid_request_error
    Code
    unknown_parameter
    Situation
    A field the gateway does not know, at any depth; param names it
    Retry
    No
  • Status
    400
    Type
    invalid_request_error
    Code
    unsupported_parameter
    Situation
    A known field HIPS does not accept, or a feature the named model does not advertise in the pool the request resolves to; param names it and message names the model
    Retry
    No
  • Status
    400
    Type
    invalid_request_error
    Code
    unsupported_value
    Situation
    n other than 1, stream_options without stream, a message role, part, item or tool type not accepted, a hosted tool that is not served
    Retry
    No
  • Status
    400
    Type
    invalid_request_error
    Code
    invalid_image
    Situation
    An image part or input cannot be decoded, is of an unsupported type or over the pixel limit
    Retry
    No
  • Status
    400
    Type
    invalid_request_error
    Code
    request_too_large, input_too_large, too_many_inputs, upload_too_large
    Situation
    A limit of the Limits page
    Retry
    No
  • Status
    400
    Type
    invalid_request_error
    Code
    exceeds_time_limit
    Situation
    An embedding or rerank request that the measured speed of every GPU serving the model shows cannot finish within its time limit; the message says how long it would take. Sent before any work, uncharged
    Retry
    No; send fewer or shorter inputs
  • Status
    400
    Type
    invalid_request_error
    Code
    task_mismatch
    Situation
    task is not the model's task, or the model is not an embedding model or a reranker on its route
    Retry
    No
  • 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
    400
    Type
    invalid_request_error
    Code
    deployment_stopped
    Situation
    The dep_ is in stopped; start it in the Console
    Retry
    No
  • Status
    400
    Type
    invalid_request_error
    Code
    upload_not_found, upload_expired, upload_incomplete, upload_mismatch, upload_consumed, upload_purpose_mismatch, upload_region_mismatch
    Situation
    An upload_id that is unknown or another workspace's, past expires_at, without bytes, with bytes that differ from the declaration, already consumed, of another purpose than the request needs, or stored in another region than the request's region requirement. Uploads are not offered in production yet
    Retry
    No (upload_incomplete: after the PUT)
  • Status
    400
    Type
    invalid_request_error
    Code
    invalid_requirement
    Situation
    A requirement header or field with an unknown value
    Retry
    No
  • Status
    400
    Type
    invalid_request_error
    Code
    requirement_conflict
    Situation
    Two requirements that cannot both hold, a header and a hips field that differ, a pool the model is never offered in, community with an always-on deployment, a knowledge base whose requirements the request cannot meet
    Retry
    No
  • Status
    400
    Type
    invalid_request_error
    Code
    invalid_idempotency_key, idempotency_key_reused, idempotency_in_progress
    Situation
    The idempotency rules
    Retry
    The last one, later
  • Status
    400
    Type
    invalid_request_error
    Code
    content_refused
    Situation
    An image request the content checks refused: its prompt or an input image asks for content the Acceptable Use Policy prohibits (param the prompt, inputs[0].text, for a generation, inputs for an edit; before any work), or every image made was withheld (param task). The message is the statement of reasons. Nothing charged
    Retry
    No
  • Status
    402
    Type
    insufficient_credit
    Code
    insufficient_credit
    Situation
    The balance does not cover the request's maximum cost at the bound quote
    Retry
    After a top-up
  • Status
    402
    Type
    insufficient_credit
    Code
    budget_exceeded
    Situation
    A budget guardrail of the workspace, the key or the person is at its limit with block; the error carries guardrail and resets_at (null for a budget that never resets). Never a payment challenge
    Retry
    After resets_at, or once the limit is raised
  • Status
    403
    Type
    permission_error
    Code
    model_not_on_plan
    Situation
    A model or feature the workspace's plan does not include, read from the plan's terms: on Free a model outside the Free plan's models (today gemma-4-e4b-it-8b, gpt-oss-120b, gpt-oss-20b and qwen3-14b), a router or Knowledge; on Free and Pro a deployment (dep_). The error adds feature and required_plan, the lowest plan that includes it. Answered before any placement, uncharged. A deployment refused this way is kept and answers again once the workspace is on a plan with deployments
    Retry
    After an owner or admin chooses a plan that includes it
  • Status
    403
    Type
    permission_error
    Code
    pool_not_allowed
    Situation
    A pool the workspace may not use for this model: one an access guardrail keeps out (named in the error), or a customer model's pool whose runtime-access conditions were not accepted
    Retry
    No
  • Status
    403
    Type
    permission_error
    Code
    model_not_allowed, region_not_allowed
    Situation
    A model, or a region requirement, that an access guardrail keeps out, the guardrail named in the error's guardrail member
    Retry
    No
  • Status
    403
    Type
    permission_error
    Code
    guardrail_unsupported
    Situation
    A content moderation guardrail applies to text it does not scan yet: a batch, or a task request with text; the guardrail named, uncharged
    Retry
    No
  • Status
    404
    Type
    not_found_error
    Code
    model_not_found
    Situation
    Unknown catalog id, alias, pinned id or dep_; another workspace's dep_; a name starting with hips-router that is not one of the four routers
    Retry
    No
  • Status
    404
    Type
    not_found_error
    Code
    upload_not_found, file_not_found, batch_not_found
    Situation
    An id in the path, or input_file_id, that is unknown, deleted, expired, another workspace's, or out of the credential's reach. Batches and files are not offered in production yet
    Retry
    No
  • Status
    404
    Type
    not_found_error
    Code
    result_expired
    Situation
    A task, embeddings or rerank request retried with its idempotency-key after the first completed: no answer is kept, and the message names the first request's req_ id. It ran and was billed once
    Retry
    No
  • Status
    429
    Type
    rate_limit_error
    Code
    rate_limit_exceeded
    Situation
    A rate limit; param is requests, tokens, uploads, batches (batches created per hour) or knowledge_search; Retry-After
    Retry
    Yes, after Retry-After
  • Status
    503
    Type
    overloaded_error
    Code
    no_capacity
    Situation
    No eligible worker under the request's requirements, in any pool the requirements allow; Retry-After. The message says what those pools can do now: a GPU that fits the model takes it when free or loads it when asked, which can take minutes or longer; or nothing can serve it, and a retry sooner than the given delay gets the same answer
    Retry
    Yes, after the given delay
  • Status
    503
    Type
    overloaded_error
    Code
    pool_unavailable
    Situation
    The named pool has no eligible supply for this model now and fallback is off; the other pool may have; Retry-After
    Retry
    Yes, or with fallback
  • Status
    503
    Type
    overloaded_error
    Code
    overloaded
    Situation
    Eligible workers exist and every one is saturated, or the queue is full; Retry-After
    Retry
    Yes
  • Status
    503
    Type
    overloaded_error
    Code
    content_check_unavailable
    Situation
    The content checks of an image request could not run (the decision service failed or did not answer in time), and HIPS sends no image request unchecked; Retry-After; uncharged
    Retry
    Yes, after Retry-After
  • Status
    500
    Type
    api_error
    Code
    internal_error
    Situation
    A fault in HIPS. Nothing billed
    Retry
    Once
  • Status
    500
    Type
    api_error
    Code
    attempt_failed
    Situation
    Every attempt failed for a reason that is not the client's and retries are exhausted. Nothing billed
    Retry
    Once

Related sheets

  • Task guides
  • Idempotency
Previous sheetPrices API
Next sheetEmbeddings and rerank
Sheet
18 of 20
Detail
H
Updated
2026-11-16
Sign in to the Console

On this sheet

  1. Task types
  2. OpenAI's routes for types not served yet
  3. Batching
  4. The response
  5. Errors this route can answer

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Ü