Getting a Results Download URL
Batch API
Getting a Results Download URL
Materialize a cached unified results artifact in R2 and return presigned GET/HEAD URLs
GET
Getting a Results Download URL
This endpoint creates (or reuses) one unified results artifact for a job in object storage (R2) and returns presigned URLs you can use to download it.
If the job was submitted with
id_column_name, the unified artifact always includes that user-provided ID column, even when include_inputs is false.
This route is built for large results and “real download tooling”:
- Use
urls.headto fetch metadata (Content-Length,ETag) without downloading the file. - Use
urls.getto download the artifact, including HTTP Range requests for resumable downloads.
Once you have the presigned URLs, do not send your Sutro
Authorization header to R2.
The presigned URL already contains the credentials.Path Parameters
string
required
The job_id returned when you submitted the batch inference job.
Query Parameters
enum
default:"parquet"
The artifact format.Currently supported values:
parquet(only)
boolean
default:"false"
Whether to include the input prompts as columns in the unified artifact.
boolean
default:"false"
Whether to include cumulative log probabilities in the unified artifact.
integer
default:"3600"
TTL for the returned presigned URLs.
- Minimum: 1
- Maximum: 604800 (7 days)
Headers
string
required
Your Sutro API key using Key authentication scheme.Format:
Key YOUR_API_KEYExample: Authorization: Key sk_live_abc123...Response
Returns a JSON payload that describes the artifact and provides method-specific presigned URLs.string
The job ID you requested.
string
The artifact format (currently
parquet).boolean
Echoes whether inputs were included in the artifact.
boolean
Echoes whether cumulative logprobs were included in the artifact.
integer
TTL (in seconds) for the returned presigned URLs.
object
Metadata describing the stored object (bucket/key/filename/size).
object
Presigned URLs:
urls.get— use with GET (supportsRangerequests)urls.head— use with HEAD (metadata only)
Download behavior
HEAD (metadata)
Useurls.head with the HEAD method to read headers like:
Content-Length— total bytesETag— object hash identifier (useful to detect changes)
GET (download)
Useurls.get with GET to download:
- Supports
Range: bytes=...for partial reads - Enables resumable downloads (append remaining bytes)
Code Examples
Notes
- Only
format=parquetis supported on this route today.