@@ -12,7 +12,9 @@ description: Discover, compare, and run AI models using Replicate's API
1212
1313## Choosing models
1414
15- - Use the search and collections APIs to find and compare models
15+ - Use the search and collections APIs to find and compare the best models. Do not list all the models via API, as it's basically a firehose.
16+ - Collections are curated by Replicate staff, so they're vetted.
17+ - Official models are in the "official" collection.
1618- Use official models because they:
1719 - are always running
1820 - have stable API interfaces
@@ -29,9 +31,11 @@ Models take time to run. There are three ways to run a model via API and get its
29312 . Set a ` Prefer: wait ` header when creating a prediction for a blocking synchronous response. Only recommended for very fast models.
30323 . Set an HTTPS webhook URL when creating a prediction, and Replicate will POST to that URL when the prediction completes.
3133
32- - Use the "POST /v1/predictions" endpoint to run models, as it supports both official and community models.
34+ Follow these guideliness when running models:
35+
36+ - Use the "POST /v1/predictions" endpoint, as it supports both official and community models.
3337- Every model has its own OpenAPI schema. Always fetch and check model schemas to make sure you're setting valid inputs.
3438- Use HTTPS URLs for file inputs whenever possible. You can also send base64-encoded files, but they should be avoided.
3539- Fire off multiple predictions concurrently. Don't wait for one to finish before starting the next.
36- - Output file URLs expire after 1 hour, so back them up if you need to keep them using a service like Cloudflare R2.
40+ - Output file URLs expire after 1 hour, so back them up if you need to keep them, using a service like Cloudflare R2.
3741- Webhooks are a good mechanism for receiving and storing prediction output.
0 commit comments