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
    1. APython
    2. BTypeScript and JavaScript
    3. CGo
    4. DRust
    5. EJava
    6. F.NET
    7. GPHP
    8. HRuby
  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. 09Coding-tool setup
    1. AClaude Code
    2. BOther coding tools and editor integrations
  7. 10Command line
    1. ASign in

Reference

  1. 11API reference
    1. AAuthentication
    2. BChat completions
    3. CResponses
    4. DModels
    5. ETasks
    6. FJobs
    7. GUploads
    8. HDeployments
    9. IRequirements and headers
    10. JErrors
    11. KUsage
    12. LVersioning
  2. 12Operating guidance
    1. ALimits
    2. BErrors
    3. CRetries and billing outcomes
    4. DIdempotency
    5. EStreaming
    6. FData handling
    7. GCompatibility matrix
  3. 13Changelog
Sheet indexAPI reference

Get started

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

Guides

  1. 04HIPS SDK
    1. APython
    2. BTypeScript and JavaScript
    3. CGo
    4. DRust
    5. EJava
    6. F.NET
    7. GPHP
    8. HRuby
  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. 09Coding-tool setup
    1. AClaude Code
    2. BOther coding tools and editor integrations
  7. 10Command line
    1. ASign in

Reference

  1. 11API reference
    1. AAuthentication
    2. BChat completions
    3. CResponses
    4. DModels
    5. ETasks
    6. FJobs
    7. GUploads
    8. HDeployments
    9. IRequirements and headers
    10. JErrors
    11. KUsage
    12. LVersioning
  2. 12Operating guidance
    1. ALimits
    2. BErrors
    3. CRetries and billing outcomes
    4. DIdempotency
    5. EStreaming
    6. FData handling
    7. GCompatibility matrix
  3. 13Changelog
11
  1. Docs/
  2. API reference/
  3. Uploads
(Detail G)

PreviewNot yet validated. Join early access

llms.txt

Uploads

A presigned PUT for task and job 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.

POST/v1/uploadspreview

A presigned PUT for a task or job input. The gateway never receives the bytes.

GET/v1/uploads/{id}preview

The upload's status.

F
Fig. 1, sheet 11API 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.

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_consumedAn upload_id that is unknown or another workspace's, past expires_at, without bytes, with bytes that differ from the declaration, or already consumedNo (upload_incomplete: after the PUT)
400invalid_request_errorinvalid_idempotency_key, idempotency_key_reused, idempotency_in_progressThe idempotency rulesThe last one, later
404not_found_errorjob_not_found, upload_not_foundAn id in the path that is unknown or another workspace'sNo
  • 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
    Situation
    An upload_id that is unknown or another workspace's, past expires_at, without bytes, with bytes that differ from the declaration, or already consumed
    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
    job_not_found, upload_not_found
    Situation
    An id in the path that is unknown or another workspace's
    Retry
    No

Related sheets

  • Import and run your model
Previous sheetJobs
Next sheetDeployments
Sheet
11 of 13
Detail
G
Updated
2026-10-21
Status
Preview
Join early access

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 preview
  • 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

Company

  • About
  • Contact
  • Affiliate program
  • HIPS Payments

Legal

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

Support

  • Contact HIPS
  • Looking for payments support?

HIPS. AI inference for builders.

hips.com

Hyperscale Inference Processing Systems OÜ