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. Uploads
(Detail L)
llms.txt

Uploads

A presigned PUT for task inputs only. The gateway never receives the bytes: the client declares the file, PUTs it to the returned address with the given headers, then names the upl_ id in a task input. A customer model is never uploaded: it is imported from a model hub in the Console, as Import and run your model describes.

Note

Uploads are not offered in production yet: every route here answers 404 route_not_available until the upload limits are set. Send a task's input inline (data, base64) meanwhile.

POST/v1/uploadsnot offered

A presigned PUT for a task input. Not offered in production yet: 404 route_not_available.

GET/v1/uploads/{id}not offered

The upload's status. Not offered in production yet: 404 route_not_available.

DELETE/v1/uploads/{id}not offered

Deletes the upload and its bytes. Not offered in production yet: 404 route_not_available.

F
Fig. 1, sheet 18API reference

Request

00000000000000000000000000000000000000001{"purpose": "input", "filename": "call.wav", "content_type": "audio/wav", "size_bytes": 10485760, "sha256": "<hex>"}
Request sample

answers 201:

Response

00000000000000000000000000000000000000001{2  "object": "upload",3  "id": "upl_...",4  "purpose": "input",5  "status": "pending",6  "upload_url": "<presigned PUT>",7  "upload_headers": {"Content-Type": "audio/wav"},8  "upload_expires_at": "...",9  "expires_at": "..."10}
Response sample

The client PUTs the bytes to upload_url with the given headers, then names upl_... in inputs[].upload_id.

Parts list: Rules

  1. 01
    purpose

    input (a task or job input), the only purpose. The model purpose is withdrawn: a customer model is imported from a model hub, never uploaded. purpose: "model" answers 400 invalid_value with param: "purpose" and a message naming the Console's import. The field stays required.

  2. 02
    status

    pending (no bytes yet), ready (bytes received, size and type match), consumed (an input upload used by a job on a workspace whose policy deletes inputs after use), expired. GET /v1/uploads/{id} returns it.

  3. 03
    Mismatch

    Bytes whose size, type or sha256 differ from the declaration make the upload failed and its use a 400 upload_mismatch.

  4. 04
    Limits

    Size per upload and uploads per day by plan Not decided yet; multipart for large inputs (long audio and video) Not decided yet.

  5. 05
    Retention

    An upload is deleted at expires_at Not decided yet or when consumed; where a region requirement applies, it is stored in that region Not decided yet.

  6. 06
    Customer models

    Not an upload. A customer model version comes from an import from a model hub, a Console action; this contract addresses only its deployment (dep_). A public import route is open Not decided yet.

  7. 07
    The PUT

    To upload_url, carrying exactly the upload_headers of the answer: Content-Type, If-None-Match: *, and x-amz-checksum-sha256 (the declared sha256, 64 hex characters in the request, sent as base64 of its 32 bytes) when one was declared, so the store checks the bytes on arrival.

  8. 08
    DELETE /v1/uploads/{id}

    Deletes the upload and its bytes, answered whatever the workspace's state, since a customer may delete at any time. A full key reaches every upload of its workspace; any other key, and a person's token, the uploads it created.

  9. 09
    Daily cap

    Under the workspace's daily cap on uploads, a presign and its 429 carry x-ratelimit-limit-uploads, x-ratelimit-remaining-uploads and x-ratelimit-reset-uploads (headers). Every answer of these routes carries Cache-Control: no-store.

  10. 10
    Replays

    POST /v1/uploads takes an idempotency-key; a replay answers the first upload with idempotent-replayed: true.

Errors these routes can answer

StatusTypeCodeSituationRetry
400invalid_request_errorrequest_too_large, input_too_large, too_many_inputs, upload_too_largeA limit of the Limits pageNo
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_idempotency_key, idempotency_key_reused, idempotency_in_progressThe idempotency rulesThe last one, later
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_errorroute_not_availableA route that is built and not offered on this gateway: uploads, files and batches in production, and POST /v1/messages/count_tokensNo
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
  • 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
    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_idempotency_key, idempotency_key_reused, idempotency_in_progress
    Situation
    The idempotency rules
    Retry
    The last one, later
  • 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
    route_not_available
    Situation
    A route that is built and not offered on this gateway: uploads, files and batches in production, and POST /v1/messages/count_tokens
    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

Related sheets

  • Import and run your model
Previous sheetJobs
Next sheetFiles
Sheet
18 of 20
Detail
L
Updated
2026-11-11
Sign in to the Console

On this sheet

  1. Errors these routes 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Ü