# What changed in replicate

> 41 changes in replicate 1 from its official release notes, upgrade guides and advisories: 3 breaking, 1 deprecations, 33 new APIs and options. Each one cited. Sources checked 2026-10-28. HTML: https://unstale.sh/npm/replicate/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## replicate 1

### Breaking changes

- In sync mode, output.url() may contain a data-uri instead of a remote URL; pass wait: { mode: "poll" } to replicate.run() if a URL is required. (1.0.0) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.0.0)
- For models that output files, replicate.run() now returns FileObjects rather than URL strings by default. (1.0.0) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.0.0)
- Pass useFileOutput: false to the Replicate constructor to opt out of FileOutput and revert to the previous behavior. (1.0.0) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.0.0)

### Deprecations

- The prediction request field is deprecated because supported models always include a stream entry in the returned prediction URLs. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)

### New APIs and options

- The useFileOutput option can be set to false to output the HTTP or data URL directly. (1.4.0) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.4.0)
- The request header sets the maximum prediction runtime before automatic cancellation; durations support seconds, minutes, and hours, with a minimum of 5 seconds. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- Prediction responses expose the absolute time at which a running prediction will be automatically canceled if it has not completed. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- Create a deployment by specifying its name, model, version, hardware, and minimum and maximum instances. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- Delete a deployment if it has been offline and unused for at least 15 minutes. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- Retrieve a deployment by name, including its current release. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- Create a prediction using a deployment; `Prefer: wait` waits up to 60 seconds before returning a prediction that may still be starting. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- Update deployment hardware, minimum or maximum instances, or its underlying model version; each update increments the current release number. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- Upload a file with optional JSON metadata; file content and a filename are required, and files must be less than 100MB. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- Delete a file; subsequent requests to the deleted file resource return 404 Not found. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- Download a file using its owner, an expiration timestamp, and an HMAC-SHA256 signature. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- Get the details of a file by its ID. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- List files created by the user or organization associated with the API token, with pagination. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- List available hardware SKUs for running models. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- Create a model by providing its owner, name, visibility, and hardware. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- Delete a model you own if it is private and has no associated versions. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- List example predictions saved by a model author, so developers can retrieve a model’s illustrative predictions. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- Get a model and its latest version's input and output schema. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- List public models with pagination and optional sorting by model creation time or latest-version creation time. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- Choose ascending or descending model-list sort order; descending is the default. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- Create predictions directly using official models. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- Retrieve a model’s README content as plain-text Markdown. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- Search public models using a text query, returning paginated model results. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- Update a model's description, README, GitHub URL, paper URL, weights URL, or license URL. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- Request deletion of an eligible private model version and its associated predictions and output files. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- Filter listed predictions to those created at or after a specified ISO 8601 date-time. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- Filter listed predictions to those created before a specified ISO 8601 date-time. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- Set the request header to wait for model output, using wait=n for a value from 1 to 60 seconds. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- Search public models, collections, and documentation; model results include generated descriptions, tags, and relevance scores. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- A training can be retrieved by ID, with status, output or error details, and metrics for terminated trainings. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- A training can be canceled by its ID. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- The default webhook endpoint's signing secret can be retrieved to verify that webhook requests are from Replicate. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- FileObject implements ReadableStream, so developers can access its URL, write it to disk, stream it, or read it in chunks without an additional fetch(). (1.0.0) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.0.0)

### Behavior and default changes

- For models that output files, event.data is a FileOutput instance by default and can be written to disk. (1.4.0) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.4.0)
- Prediction and training statuses include aborted for work terminated before it starts running, such as when a deadline is reached before startup. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)
- Filter predictions by creation source; filtering for web predictions limits results to the last 14 days. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)

### Fixes and other changes

- Types are updated to match the current HTTP API. (1.3.1) — [release notes](https://github.com/replicate/replicate-javascript/releases/tag/v1.3.1)