{ "info": { "_postman_id": "1e04818f-367c-439f-bf61-bb9c2c68f3e6", "name": "Replicate", "description": "AI can do extraordinary things, but its still too hard to use. We don't believe AI is inherently hard. We just don't have the right tools and abstractions yet. Were building tools so all software engineers can use AI as if it were normal software. You should be able to import an image generator the same way you import an npm package. You should be able to customize a model as easily as you can fork something on GitHub.\n\nContact Support:\n Email: team@replicate.com", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "lastUpdatedBy": "35240", "uid": "35240-1e04818f-367c-439f-bf61-bb9c2c68f3e6" }, "item": [ { "name": "account", "item": [ { "name": "Get the Authenticated Account", "id": "9e3cb30f-37e5-4d76-b128-8cbf09267ae9", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/account", "host": [ "{{baseUrl}}" ], "path": [ "account" ] }, "description": "Returns information about the user or organization associated with the provided API token.\n\nExample cURL request:\n\n```console\ncurl -s \\\n -H \"Authorization: Bearer $REPLICATE_API_TOKEN\" \\\n https://api.replicate.com/v1/account\n```\n\nThe response will be a JSON object describing the account:\n\n```json\n{\n \"type\": \"organization\",\n \"username\": \"acme\",\n \"name\": \"Acme Corp, Inc.\",\n \"github_url\": \"https://github.com/acme\",\n}\n```\n" }, "response": [ { "id": "3f4d81e4-fd2f-4f56-b3e9-ecbac4f13369", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/account", "host": [ "{{baseUrl}}" ], "path": [ "account" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"github_url\": \"\",\n \"name\": \"\",\n \"type\": \"user\",\n \"username\": \"\"\n}", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-3f4d81e4-fd2f-4f56-b3e9-ecbac4f13369" } ], "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-9e3cb30f-37e5-4d76-b128-8cbf09267ae9" } ], "id": "5f6b818d-1a91-4b46-8517-f44b46e9f298", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-5f6b818d-1a91-4b46-8517-f44b46e9f298" }, { "name": "collections", "item": [ { "name": "{collection_slug}", "item": [ { "name": "Get a Collection of Models", "id": "40c8092e-c870-4da7-bf93-64ac55fd0eff", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/collections/:collection_slug", "host": [ "{{baseUrl}}" ], "path": [ "collections", ":collection_slug" ], "variable": [ { "id": "dce969eb-79cd-4478-a1ce-935fcbf52f04", "key": "collection_slug", "value": "", "description": "(Required) The slug of the collection, like `super-resolution` or `image-restoration`. See [replicate.com/collections](https://replicate.com/collections).\n" } ] }, "description": "Example cURL request:\n\n```console\ncurl -s \\\n -H \"Authorization: Bearer $REPLICATE_API_TOKEN\" \\\n https://api.replicate.com/v1/collections/super-resolution\n```\n\nThe response will be a collection object with a nested list of the models in that collection:\n\n```json\n{\n \"name\": \"Super resolution\",\n \"slug\": \"super-resolution\",\n \"description\": \"Upscaling models that create high-quality images from low-quality images.\",\n \"models\": [...]\n}\n```\n" }, "response": [ { "id": "10b0e1b4-2f63-4d49-8405-91e19a61ec73", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/collections/:collection_slug", "host": [ "{{baseUrl}}" ], "path": [ "collections", ":collection_slug" ], "variable": [ { "key": "collection_slug" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-10b0e1b4-2f63-4d49-8405-91e19a61ec73" } ], "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-40c8092e-c870-4da7-bf93-64ac55fd0eff" } ], "id": "e1969879-3718-4705-b13e-656fc2c7921d", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-e1969879-3718-4705-b13e-656fc2c7921d" }, { "name": "List Collections of Models", "id": "fb615256-c6f3-411f-92cb-a269af725fad", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/collections", "host": [ "{{baseUrl}}" ], "path": [ "collections" ] }, "description": "Example cURL request:\n\n```console\ncurl -s \\\n -H \"Authorization: Bearer $REPLICATE_API_TOKEN\" \\\n https://api.replicate.com/v1/collections\n```\n\nThe response will be a paginated JSON list of collection objects:\n\n```json\n{\n \"next\": \"null\",\n \"previous\": null,\n \"results\": [\n {\n \"name\": \"Super resolution\",\n \"slug\": \"super-resolution\",\n \"description\": \"Upscaling models that create high-quality images from low-quality images.\"\n }\n ]\n}\n```\n" }, "response": [ { "id": "005733e5-0003-448a-9c26-e12b01a282bc", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/collections", "host": [ "{{baseUrl}}" ], "path": [ "collections" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-005733e5-0003-448a-9c26-e12b01a282bc" } ], "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-fb615256-c6f3-411f-92cb-a269af725fad" } ], "id": "72a1ab47-93d1-437e-85ae-dea15daf6710", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-72a1ab47-93d1-437e-85ae-dea15daf6710" }, { "name": "deployments", "item": [ { "name": "{deployment_owner}", "item": [ { "name": "{deployment_name}", "item": [ { "name": "predictions", "item": [ { "name": "Create a Prediction Using a Deployment", "id": "1a8be9c4-5044-4474-b3ec-c2a0439ab777", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "description": "Leave the request open and wait for the model to finish generating output. Set to `wait=n` where n is a number of seconds between 1 and 60.\n\nSee https://replicate.com/docs/topics/predictions/create-a-prediction#sync-mode for more information.", "key": "Prefer", "value": "wait" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"input\": {},\n \"stream\": \"\",\n \"webhook\": \"\",\n \"webhook_events_filter\": [\n \"completed\",\n \"start\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/deployments/:deployment_owner/:deployment_name/predictions", "host": [ "{{baseUrl}}" ], "path": [ "deployments", ":deployment_owner", ":deployment_name", "predictions" ], "variable": [ { "id": "c4928fd9-128e-45ee-b03e-5be67ad5b2ba", "key": "deployment_owner", "value": "", "description": "(Required) The name of the user or organization that owns the deployment.\n" }, { "id": "9f8f0960-d97d-49ba-8330-c17f28820475", "key": "deployment_name", "value": "", "description": "(Required) The name of the deployment.\n" } ] }, "description": "Create a prediction for the deployment and inputs you provide.\n\nExample cURL request:\n\n```console\ncurl -s -X POST -H 'Prefer: wait' \\\n -d '{\"input\": {\"prompt\": \"A photo of a bear riding a bicycle over the moon\"}}' \\\n -H \"Authorization: Bearer $REPLICATE_API_TOKEN\" \\\n -H 'Content-Type: application/json' \\\n https://api.replicate.com/v1/deployments/acme/my-app-image-generator/predictions\n```\n\nThe request will wait up to 60 seconds for the model to run. If this time is exceeded the prediction will be returned in a `\"starting\"` state and need to be retrieved using the `predictions.get` endpiont.\n\nFor a complete overview of the `deployments.predictions.create` API check out our documentation on [creating a prediction](https://replicate.com/docs/topics/predictions/create-a-prediction) which covers a variety of use cases.\n" }, "response": [ { "id": "37a7af81-db11-47c1-863b-6f18027920ac", "name": "Prediction has been created. If the `Prefer: wait` header is provided it will contain the final output.", "originalRequest": { "method": "POST", "header": [ { "description": "Leave the request open and wait for the model to finish generating output. Set to `wait=n` where n is a number of seconds between 1 and 60.\n\nSee https://replicate.com/docs/topics/predictions/create-a-prediction#sync-mode for more information.", "key": "Prefer", "value": "wait" }, { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"input\": {},\n \"stream\": \"\",\n \"webhook\": \"\",\n \"webhook_events_filter\": [\n \"completed\",\n \"start\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/deployments/:deployment_owner/:deployment_name/predictions", "host": [ "{{baseUrl}}" ], "path": [ "deployments", ":deployment_owner", ":deployment_name", "predictions" ], "variable": [ { "key": "deployment_owner" }, { "key": "deployment_name" } ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-37a7af81-db11-47c1-863b-6f18027920ac" }, { "id": "0a2303fb-66e6-4a03-8dee-d4408d0061b8", "name": "Prediction has been created but does not yet have all outputs", "originalRequest": { "method": "POST", "header": [ { "description": "Leave the request open and wait for the model to finish generating output. Set to `wait=n` where n is a number of seconds between 1 and 60.\n\nSee https://replicate.com/docs/topics/predictions/create-a-prediction#sync-mode for more information.", "key": "Prefer", "value": "wait" }, { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"input\": {},\n \"stream\": \"\",\n \"webhook\": \"\",\n \"webhook_events_filter\": [\n \"completed\",\n \"start\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/deployments/:deployment_owner/:deployment_name/predictions", "host": [ "{{baseUrl}}" ], "path": [ "deployments", ":deployment_owner", ":deployment_name", "predictions" ], "variable": [ { "key": "deployment_owner" }, { "key": "deployment_name" } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-0a2303fb-66e6-4a03-8dee-d4408d0061b8" } ], "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-1a8be9c4-5044-4474-b3ec-c2a0439ab777" } ], "id": "ddc70bcf-e021-4c8d-a243-c788bf1cc8d6", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-ddc70bcf-e021-4c8d-a243-c788bf1cc8d6" }, { "name": "Delete a Deployment", "id": "bc361a29-5fa0-4c42-89c1-3d107ea6a22a", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/deployments/:deployment_owner/:deployment_name", "host": [ "{{baseUrl}}" ], "path": [ "deployments", ":deployment_owner", ":deployment_name" ], "variable": [ { "id": "dad4fab9-d7cf-4378-91b9-2a454ba5a84d", "key": "deployment_owner", "value": "", "description": "(Required) The name of the user or organization that owns the deployment.\n" }, { "id": "2d7ddc8b-676e-4351-8ea4-3465750df6fa", "key": "deployment_name", "value": "", "description": "(Required) The name of the deployment.\n" } ] }, "description": "Delete a deployment\n\nDeployment deletion has some restrictions:\n\n- You can only delete deployments that have been offline and unused for at least 15 minutes.\n\nExample cURL request:\n\n```command\ncurl -s -X DELETE \\\n -H \"Authorization: Bearer $REPLICATE_API_TOKEN\" \\\n https://api.replicate.com/v1/deployments/acme/my-app-image-generator\n```\n\nThe response will be an empty 204, indicating the deployment has been deleted.\n" }, "response": [ { "id": "aa201e16-8bcc-44f6-87c8-54f591bcdf1e", "name": "Success", "originalRequest": { "method": "DELETE", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/deployments/:deployment_owner/:deployment_name", "host": [ "{{baseUrl}}" ], "path": [ "deployments", ":deployment_owner", ":deployment_name" ], "variable": [ { "key": "deployment_owner" }, { "key": "deployment_name" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-aa201e16-8bcc-44f6-87c8-54f591bcdf1e" } ], "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-bc361a29-5fa0-4c42-89c1-3d107ea6a22a" }, { "name": "Get a Deployment", "id": "d4be8f30-2135-4ade-9bed-a9a365c49c08", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/deployments/:deployment_owner/:deployment_name", "host": [ "{{baseUrl}}" ], "path": [ "deployments", ":deployment_owner", ":deployment_name" ], "variable": [ { "id": "1b750a3e-125e-4f58-9eea-c221cffcf46c", "key": "deployment_owner", "value": "", "description": "(Required) The name of the user or organization that owns the deployment.\n" }, { "id": "c5116631-ced9-44f3-82ad-589a5865e57e", "key": "deployment_name", "value": "", "description": "(Required) The name of the deployment.\n" } ] }, "description": "Get information about a deployment by name including the current release.\n\nExample cURL request:\n\n```console\ncurl -s \\\n -H \"Authorization: Bearer $REPLICATE_API_TOKEN\" \\\n https://api.replicate.com/v1/deployments/replicate/my-app-image-generator\n```\n\nThe response will be a JSON object describing the deployment:\n\n```json\n{\n \"owner\": \"acme\",\n \"name\": \"my-app-image-generator\",\n \"current_release\": {\n \"number\": 1,\n \"model\": \"stability-ai/sdxl\",\n \"version\": \"da77bc59ee60423279fd632efb4795ab731d9e3ca9705ef3341091fb989b7eaf\",\n \"created_at\": \"2024-02-15T16:32:57.018467Z\",\n \"created_by\": {\n \"type\": \"organization\",\n \"username\": \"acme\",\n \"name\": \"Acme Corp, Inc.\",\n \"github_url\": \"https://github.com/acme\",\n },\n \"configuration\": {\n \"hardware\": \"gpu-t4\",\n \"min_instances\": 1,\n \"max_instances\": 5\n }\n }\n}\n```\n" }, "response": [ { "id": "c66037f0-e0c5-4957-ba46-b4d5bcb46da4", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/deployments/:deployment_owner/:deployment_name", "host": [ "{{baseUrl}}" ], "path": [ "deployments", ":deployment_owner", ":deployment_name" ], "variable": [ { "key": "deployment_owner" }, { "key": "deployment_name" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"current_release\": {\n \"configuration\": {\n \"hardware\": \"\",\n \"max_instances\": \"\",\n \"min_instances\": \"\"\n },\n \"created_at\": \"\",\n \"created_by\": {\n \"github_url\": \"\",\n \"name\": \"\",\n \"type\": \"organization\",\n \"username\": \"\"\n },\n \"model\": \"\",\n \"number\": \"\",\n \"version\": \"\"\n },\n \"name\": \"\",\n \"owner\": \"\"\n}", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-c66037f0-e0c5-4957-ba46-b4d5bcb46da4" } ], "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-d4be8f30-2135-4ade-9bed-a9a365c49c08" }, { "name": "Update a Deployment", "id": "3a027590-7de3-4117-b7b9-8eac4803dddf", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"hardware\": \"\",\n \"max_instances\": \"\",\n \"min_instances\": \"\",\n \"version\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/deployments/:deployment_owner/:deployment_name", "host": [ "{{baseUrl}}" ], "path": [ "deployments", ":deployment_owner", ":deployment_name" ], "variable": [ { "id": "c4339514-3ddb-44c1-8f47-0cb73907da12", "key": "deployment_owner", "value": "", "description": "(Required) The name of the user or organization that owns the deployment.\n" }, { "id": "a76f9582-7c62-4b89-971b-79a61200bb07", "key": "deployment_name", "value": "", "description": "(Required) The name of the deployment.\n" } ] }, "description": "Update properties of an existing deployment, including hardware, min/max instances, and the deployment's underlying model [version](https://replicate.com/docs/how-does-replicate-work#versions).\n\nExample cURL request:\n\n```console\ncurl -s \\\n -X PATCH \\\n -H \"Authorization: Bearer $REPLICATE_API_TOKEN\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"min_instances\": 3, \"max_instances\": 10}' \\\n https://api.replicate.com/v1/deployments/acme/my-app-image-generator\n```\n\nThe response will be a JSON object describing the deployment:\n\n```json\n{\n \"owner\": \"acme\",\n \"name\": \"my-app-image-generator\",\n \"current_release\": {\n \"number\": 2,\n \"model\": \"stability-ai/sdxl\",\n \"version\": \"da77bc59ee60423279fd632efb4795ab731d9e3ca9705ef3341091fb989b7eaf\",\n \"created_at\": \"2024-02-15T16:32:57.018467Z\",\n \"created_by\": {\n \"type\": \"organization\",\n \"username\": \"acme\",\n \"name\": \"Acme Corp, Inc.\",\n \"github_url\": \"https://github.com/acme\",\n },\n \"configuration\": {\n \"hardware\": \"gpu-t4\",\n \"min_instances\": 3,\n \"max_instances\": 10\n }\n }\n}\n```\n\nUpdating any deployment properties will increment the `number` field of the `current_release`.\n" }, "response": [ { "id": "5355b029-8dc1-400a-9fa2-74467300e2d7", "name": "Success", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"hardware\": \"\",\n \"max_instances\": \"\",\n \"min_instances\": \"\",\n \"version\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/deployments/:deployment_owner/:deployment_name", "host": [ "{{baseUrl}}" ], "path": [ "deployments", ":deployment_owner", ":deployment_name" ], "variable": [ { "key": "deployment_owner" }, { "key": "deployment_name" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"current_release\": {\n \"configuration\": {\n \"hardware\": \"\",\n \"max_instances\": \"\",\n \"min_instances\": \"\"\n },\n \"created_at\": \"\",\n \"created_by\": {\n \"github_url\": \"\",\n \"name\": \"\",\n \"type\": \"organization\",\n \"username\": \"\"\n },\n \"model\": \"\",\n \"number\": \"\",\n \"version\": \"\"\n },\n \"name\": \"\",\n \"owner\": \"\"\n}", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-5355b029-8dc1-400a-9fa2-74467300e2d7" } ], "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-3a027590-7de3-4117-b7b9-8eac4803dddf" } ], "id": "b9428303-498f-4435-8632-5098df8c9136", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-b9428303-498f-4435-8632-5098df8c9136" } ], "id": "87a00cf9-8ab6-4321-aaaf-098619d20153", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-87a00cf9-8ab6-4321-aaaf-098619d20153" }, { "name": "List Deployments", "id": "ac5e2e27-47a9-42eb-8af5-2c5768b34d09", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/deployments", "host": [ "{{baseUrl}}" ], "path": [ "deployments" ] }, "description": "Get a list of deployments associated with the current account, including the latest release configuration for each deployment.\n\nExample cURL request:\n\n```console\ncurl -s \\\n -H \"Authorization: Bearer $REPLICATE_API_TOKEN\" \\\n https://api.replicate.com/v1/deployments\n```\n\nThe response will be a paginated JSON array of deployment objects, sorted with the most recent deployment first:\n\n```json\n{\n \"next\": \"http://api.replicate.com/v1/deployments?cursor=cD0yMDIzLTA2LTA2KzIzJTNBNDAlM0EwOC45NjMwMDAlMkIwMCUzQTAw\",\n \"previous\": null,\n \"results\": [\n {\n \"owner\": \"replicate\",\n \"name\": \"my-app-image-generator\",\n \"current_release\": {\n \"number\": 1,\n \"model\": \"stability-ai/sdxl\",\n \"version\": \"da77bc59ee60423279fd632efb4795ab731d9e3ca9705ef3341091fb989b7eaf\",\n \"created_at\": \"2024-02-15T16:32:57.018467Z\",\n \"created_by\": {\n \"type\": \"organization\",\n \"username\": \"acme\",\n \"name\": \"Acme Corp, Inc.\",\n \"github_url\": \"https://github.com/acme\",\n },\n \"configuration\": {\n \"hardware\": \"gpu-t4\",\n \"min_instances\": 1,\n \"max_instances\": 5\n }\n }\n }\n ]\n}\n```\n" }, "response": [ { "id": "462e4177-e8e1-4656-8bea-b83c6f51bd16", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/deployments", "host": [ "{{baseUrl}}" ], "path": [ "deployments" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"next\": \"\",\n \"previous\": \"\",\n \"results\": [\n {\n \"current_release\": {\n \"configuration\": {\n \"hardware\": \"\",\n \"max_instances\": \"\",\n \"min_instances\": \"\"\n },\n \"created_at\": \"\",\n \"created_by\": {\n \"github_url\": \"\",\n \"name\": \"\",\n \"type\": \"organization\",\n \"username\": \"\"\n },\n \"model\": \"\",\n \"number\": \"\",\n \"version\": \"\"\n },\n \"name\": \"\",\n \"owner\": \"\"\n },\n {\n \"current_release\": {\n \"configuration\": {\n \"hardware\": \"\",\n \"max_instances\": \"\",\n \"min_instances\": \"\"\n },\n \"created_at\": \"\",\n \"created_by\": {\n \"github_url\": \"\",\n \"name\": \"\",\n \"type\": \"organization\",\n \"username\": \"\"\n },\n \"model\": \"\",\n \"number\": \"\",\n \"version\": \"\"\n },\n \"name\": \"\",\n \"owner\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-462e4177-e8e1-4656-8bea-b83c6f51bd16" } ], "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-ac5e2e27-47a9-42eb-8af5-2c5768b34d09" }, { "name": "Create a Deployment", "id": "1f255ad4-8e35-4159-a3d7-42231ed0ffd6", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"model\": \"\",\n \"version\": \"\",\n \"hardware\": \"\",\n \"min_instances\": \"\",\n \"max_instances\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/deployments", "host": [ "{{baseUrl}}" ], "path": [ "deployments" ] }, "description": "Create a new deployment:\n\nExample cURL request:\n\n```console\ncurl -s \\\n -X POST \\\n -H \"Authorization: Bearer $REPLICATE_API_TOKEN\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"my-app-image-generator\",\n \"model\": \"stability-ai/sdxl\",\n \"version\": \"da77bc59ee60423279fd632efb4795ab731d9e3ca9705ef3341091fb989b7eaf\",\n \"hardware\": \"gpu-t4\",\n \"min_instances\": 0,\n \"max_instances\": 3\n }' \\\n https://api.replicate.com/v1/deployments\n```\n\nThe response will be a JSON object describing the deployment:\n\n```json\n{\n \"owner\": \"acme\",\n \"name\": \"my-app-image-generator\",\n \"current_release\": {\n \"number\": 1,\n \"model\": \"stability-ai/sdxl\",\n \"version\": \"da77bc59ee60423279fd632efb4795ab731d9e3ca9705ef3341091fb989b7eaf\",\n \"created_at\": \"2024-02-15T16:32:57.018467Z\",\n \"created_by\": {\n \"type\": \"organization\",\n \"username\": \"acme\",\n \"name\": \"Acme Corp, Inc.\",\n \"github_url\": \"https://github.com/acme\",\n },\n \"configuration\": {\n \"hardware\": \"gpu-t4\",\n \"min_instances\": 1,\n \"max_instances\": 5\n }\n }\n}\n```\n" }, "response": [ { "id": "6b3b10e5-0096-44fb-b3d5-34db4ba156bd", "name": "Success", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"model\": \"\",\n \"version\": \"\",\n \"hardware\": \"\",\n \"min_instances\": \"\",\n \"max_instances\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/deployments", "host": [ "{{baseUrl}}" ], "path": [ "deployments" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"current_release\": {\n \"configuration\": {\n \"hardware\": \"\",\n \"max_instances\": \"\",\n \"min_instances\": \"\"\n },\n \"created_at\": \"\",\n \"created_by\": {\n \"github_url\": \"\",\n \"name\": \"\",\n \"type\": \"organization\",\n \"username\": \"\"\n },\n \"model\": \"\",\n \"number\": \"\",\n \"version\": \"\"\n },\n \"name\": \"\",\n \"owner\": \"\"\n}", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-6b3b10e5-0096-44fb-b3d5-34db4ba156bd" } ], "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-1f255ad4-8e35-4159-a3d7-42231ed0ffd6" } ], "id": "23111193-708e-4790-aa34-d78c706d205b", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-23111193-708e-4790-aa34-d78c706d205b" }, { "name": "hardware", "item": [ { "name": "List Available Hardware for Models", "id": "631c4f04-518f-48af-9619-c672af1baef6", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/hardware", "host": [ "{{baseUrl}}" ], "path": [ "hardware" ] }, "description": "Example cURL request:\n\n```console\ncurl -s \\\n -H \"Authorization: Bearer $REPLICATE_API_TOKEN\" \\\n https://api.replicate.com/v1/hardware\n```\n\nThe response will be a JSON array of hardware objects:\n\n```json\n[\n {\"name\": \"CPU\", \"sku\": \"cpu\"},\n {\"name\": \"Nvidia T4 GPU\", \"sku\": \"gpu-t4\"},\n {\"name\": \"Nvidia A40 GPU\", \"sku\": \"gpu-a40-small\"},\n {\"name\": \"Nvidia A40 (Large) GPU\", \"sku\": \"gpu-a40-large\"},\n]\n```\n" }, "response": [ { "id": "958c6c90-e059-41fa-b5cb-f5cf4c77a54e", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/hardware", "host": [ "{{baseUrl}}" ], "path": [ "hardware" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "[\n {\n \"name\": \"\",\n \"sku\": \"\"\n },\n {\n \"name\": \"\",\n \"sku\": \"\"\n }\n]", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-958c6c90-e059-41fa-b5cb-f5cf4c77a54e" } ], "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-631c4f04-518f-48af-9619-c672af1baef6" } ], "id": "d7ff742c-404f-4c3b-8c93-705074fffacc", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-d7ff742c-404f-4c3b-8c93-705074fffacc" }, { "name": "models", "item": [ { "name": "{model_owner}", "item": [ { "name": "{model_name}", "item": [ { "name": "predictions", "item": [ { "name": "Create a Prediction Using an Official Model", "id": "ca9ff56d-18f6-4fd9-a66a-2e36a576db55", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "description": "Leave the request open and wait for the model to finish generating output. Set to `wait=n` where n is a number of seconds between 1 and 60.\n\nSee https://replicate.com/docs/topics/predictions/create-a-prediction#sync-mode for more information.", "key": "Prefer", "value": "wait" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"input\": {},\n \"stream\": \"\",\n \"webhook\": \"\",\n \"webhook_events_filter\": [\n \"completed\",\n \"start\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/models/:model_owner/:model_name/predictions", "host": [ "{{baseUrl}}" ], "path": [ "models", ":model_owner", ":model_name", "predictions" ], "variable": [ { "id": "50868db6-5789-4ef1-98bb-d324a0c68c0a", "key": "model_owner", "value": "", "description": "(Required) The name of the user or organization that owns the model.\n" }, { "id": "ecdfc4b7-3099-496a-af81-8cfa76a5c12b", "key": "model_name", "value": "", "description": "(Required) The name of the model.\n" } ] }, "description": "Create a prediction for the deployment and inputs you provide.\n\nExample cURL request:\n\n```console\ncurl -s -X POST -H 'Prefer: wait' \\\n -d '{\"input\": {\"prompt\": \"Write a short poem about the weather.\"}}' \\\n -H \"Authorization: Bearer $REPLICATE_API_TOKEN\" \\\n -H 'Content-Type: application/json' \\\n https://api.replicate.com/v1/models/meta/meta-llama-3-70b-instruct/predictions\n```\n\nThe request will wait up to 60 seconds for the model to run. If this time is exceeded the prediction will be returned in a `\"starting\"` state and need to be retrieved using the `predictions.get` endpiont.\n\nFor a complete overview of the `deployments.predictions.create` API check out our documentation on [creating a prediction](https://replicate.com/docs/topics/predictions/create-a-prediction) which covers a variety of use cases.\n" }, "response": [ { "id": "20d34b18-55a4-4ce8-be44-719ac26e8490", "name": "Prediction has been created. If the `Prefer: wait` header is provided it will contain the final output.", "originalRequest": { "method": "POST", "header": [ { "description": "Leave the request open and wait for the model to finish generating output. Set to `wait=n` where n is a number of seconds between 1 and 60.\n\nSee https://replicate.com/docs/topics/predictions/create-a-prediction#sync-mode for more information.", "key": "Prefer", "value": "wait" }, { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"input\": {},\n \"stream\": \"\",\n \"webhook\": \"\",\n \"webhook_events_filter\": [\n \"completed\",\n \"start\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/models/:model_owner/:model_name/predictions", "host": [ "{{baseUrl}}" ], "path": [ "models", ":model_owner", ":model_name", "predictions" ], "variable": [ { "key": "model_owner" }, { "key": "model_name" } ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-20d34b18-55a4-4ce8-be44-719ac26e8490" }, { "id": "046fba8a-fe91-4b12-a08f-73f54eb9f0e6", "name": "Prediction has been created but does not yet have all outputs", "originalRequest": { "method": "POST", "header": [ { "description": "Leave the request open and wait for the model to finish generating output. Set to `wait=n` where n is a number of seconds between 1 and 60.\n\nSee https://replicate.com/docs/topics/predictions/create-a-prediction#sync-mode for more information.", "key": "Prefer", "value": "wait" }, { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"input\": {},\n \"stream\": \"\",\n \"webhook\": \"\",\n \"webhook_events_filter\": [\n \"completed\",\n \"start\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/models/:model_owner/:model_name/predictions", "host": [ "{{baseUrl}}" ], "path": [ "models", ":model_owner", ":model_name", "predictions" ], "variable": [ { "key": "model_owner" }, { "key": "model_name" } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-046fba8a-fe91-4b12-a08f-73f54eb9f0e6" } ], "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-ca9ff56d-18f6-4fd9-a66a-2e36a576db55" } ], "id": "0b533f8d-ccef-4147-82f4-6fa14eafe3ea", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-0b533f8d-ccef-4147-82f4-6fa14eafe3ea" }, { "name": "versions", "item": [ { "name": "{version_id}", "item": [ { "name": "trainings", "item": [ { "name": "Create a Training", "id": "f75a0e11-d11d-4a65-9c96-c7c0988712f4", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"destination\": \"\",\n \"input\": {},\n \"webhook\": \"\",\n \"webhook_events_filter\": [\n \"completed\",\n \"output\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/models/:model_owner/:model_name/versions/:version_id/trainings", "host": [ "{{baseUrl}}" ], "path": [ "models", ":model_owner", ":model_name", "versions", ":version_id", "trainings" ], "variable": [ { "id": "5db88ab4-036d-4ccb-b0e8-db2f440a433e", "key": "model_owner", "value": "", "description": "(Required) The name of the user or organization that owns the model.\n" }, { "id": "885d6533-a288-418e-90c3-55d3222f034c", "key": "model_name", "value": "", "description": "(Required) The name of the model.\n" }, { "id": "3fa12ca7-ab74-482e-ad0e-46deca365fb1", "key": "version_id", "value": "", "description": "(Required) The ID of the version.\n" } ] }, "description": "Start a new training of the model version you specify.\n\nExample request body:\n\n```json\n{\n \"destination\": \"{new_owner}/{new_name}\",\n \"input\": {\n \"train_data\": \"https://example.com/my-input-images.zip\",\n },\n \"webhook\": \"https://example.com/my-webhook\",\n}\n```\n\nExample cURL request:\n\n```console\ncurl -s -X POST \\\n -d '{\"destination\": \"{new_owner}/{new_name}\", \"input\": {\"input_images\": \"https://example.com/my-input-images.zip\"}}' \\\n -H \"Authorization: Bearer $REPLICATE_API_TOKEN\" \\\n -H 'Content-Type: application/json' \\\n https://api.replicate.com/v1/models/stability-ai/sdxl/versions/da77bc59ee60423279fd632efb4795ab731d9e3ca9705ef3341091fb989b7eaf/trainings\n```\n\nThe response will be the training object:\n\n```json\n{\n \"id\": \"zz4ibbonubfz7carwiefibzgga\",\n \"model\": \"stability-ai/sdxl\",\n \"version\": \"da77bc59ee60423279fd632efb4795ab731d9e3ca9705ef3341091fb989b7eaf\",\n \"input\": {\n \"input_images\": \"https://example.com/my-input-images.zip\"\n },\n \"logs\": \"\",\n \"error\": null,\n \"status\": \"starting\",\n \"created_at\": \"2023-09-08T16:32:56.990893084Z\",\n \"urls\": {\n \"cancel\": \"https://api.replicate.com/v1/predictions/zz4ibbonubfz7carwiefibzgga/cancel\",\n \"get\": \"https://api.replicate.com/v1/predictions/zz4ibbonubfz7carwiefibzgga\"\n }\n}\n```\n\nAs models can take several minutes or more to train, the result will not be available immediately. To get the final result of the training you should either provide a `webhook` HTTPS URL for us to call when the results are ready, or poll the [get a training](#trainings.get) endpoint until it has finished.\n\nWhen a training completes, it creates a new [version](https://replicate.com/docs/how-does-replicate-work#terminology) of the model at the specified destination.\n\nTo find some models to train on, check out the [trainable language models collection](https://replicate.com/collections/trainable-language-models).\n" }, "response": [ { "id": "51452d5d-5dc3-4b02-b75f-8ec7740bec30", "name": "Success", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"destination\": \"\",\n \"input\": {},\n \"webhook\": \"\",\n \"webhook_events_filter\": [\n \"completed\",\n \"output\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/models/:model_owner/:model_name/versions/:version_id/trainings", "host": [ "{{baseUrl}}" ], "path": [ "models", ":model_owner", ":model_name", "versions", ":version_id", "trainings" ], "variable": [ { "key": "model_owner" }, { "key": "model_name" }, { "key": "version_id" } ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-51452d5d-5dc3-4b02-b75f-8ec7740bec30" } ], "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-f75a0e11-d11d-4a65-9c96-c7c0988712f4" } ], "id": "cce787d0-5f6d-4d6b-8727-78f2e636d768", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-cce787d0-5f6d-4d6b-8727-78f2e636d768" }, { "name": "Delete a Model Version", "id": "345c963a-1445-4fb6-9b87-0304f5e060d2", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/models/:model_owner/:model_name/versions/:version_id", "host": [ "{{baseUrl}}" ], "path": [ "models", ":model_owner", ":model_name", "versions", ":version_id" ], "variable": [ { "id": "92edc514-adfc-463b-94d5-08670bdb14a2", "key": "model_owner", "value": "", "description": "(Required) The name of the user or organization that owns the model.\n" }, { "id": "f6d82d86-1d5a-4ace-aae5-2648ae79b5c0", "key": "model_name", "value": "", "description": "(Required) The name of the model.\n" }, { "id": "27f5166b-d38e-43ef-9a25-dde7e8faad51", "key": "version_id", "value": "", "description": "(Required) The ID of the version.\n" } ] }, "description": "Delete a model version and all associated predictions, including all output files.\n\nModel version deletion has some restrictions:\n\n- You can only delete versions from models you own.\n- You can only delete versions from private models.\n- You cannot delete a version if someone other than you has run predictions with it.\n- You cannot delete a version if it is being used as the base model for a fine tune/training.\n- You cannot delete a version if it has an associated deployment.\n- You cannot delete a version if another model version is overridden to use it.\n\nExample cURL request:\n\n```command\ncurl -s -X DELETE \\\n -H \"Authorization: Bearer $REPLICATE_API_TOKEN\" \\\n https://api.replicate.com/v1/models/replicate/hello-world/versions/5c7d5dc6dd8bf75c1acaa8565735e7986bc5b66206b55cca93cb72c9bf15ccaa\n```\n\nThe response will be an empty 202, indicating the deletion request has been accepted. It might take a few minutes to be processed.\n" }, "response": [ { "id": "533dd2ef-bb01-4ecf-934b-ead99ce8554d", "name": "Deletion request has been accepted. It might take a few minutes to be processed.", "originalRequest": { "method": "DELETE", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/models/:model_owner/:model_name/versions/:version_id", "host": [ "{{baseUrl}}" ], "path": [ "models", ":model_owner", ":model_name", "versions", ":version_id" ], "variable": [ { "key": "model_owner" }, { "key": "model_name" }, { "key": "version_id" } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-533dd2ef-bb01-4ecf-934b-ead99ce8554d" } ], "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-345c963a-1445-4fb6-9b87-0304f5e060d2" }, { "name": "Get a Model Version", "id": "3bb51c10-9f8a-46ba-bb81-7edab1aaa552", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/models/:model_owner/:model_name/versions/:version_id", "host": [ "{{baseUrl}}" ], "path": [ "models", ":model_owner", ":model_name", "versions", ":version_id" ], "variable": [ { "id": "ade6f320-e720-41a7-8a10-59d1e57e1b66", "key": "model_owner", "value": "", "description": "(Required) The name of the user or organization that owns the model.\n" }, { "id": "11e1f8cf-2ead-4aaf-9817-30aea995b017", "key": "model_name", "value": "", "description": "(Required) The name of the model.\n" }, { "id": "749ca0dc-011e-4813-863a-b64110ebdf06", "key": "version_id", "value": "", "description": "(Required) The ID of the version.\n" } ] }, "description": "Example cURL request:\n\n```console\ncurl -s \\\n -H \"Authorization: Bearer $REPLICATE_API_TOKEN\" \\\n https://api.replicate.com/v1/models/replicate/hello-world/versions/5c7d5dc6dd8bf75c1acaa8565735e7986bc5b66206b55cca93cb72c9bf15ccaa\n```\n\nThe response will be the version object:\n\n```json\n{\n \"id\": \"5c7d5dc6dd8bf75c1acaa8565735e7986bc5b66206b55cca93cb72c9bf15ccaa\",\n \"created_at\": \"2022-04-26T19:29:04.418669Z\",\n \"cog_version\": \"0.3.0\",\n \"openapi_schema\": {...}\n}\n```\n\nEvery model describes its inputs and outputs with [OpenAPI Schema Objects](https://spec.openapis.org/oas/latest.html#schemaObject) in the `openapi_schema` property.\n\nThe `openapi_schema.components.schemas.Input` property for the [replicate/hello-world](https://replicate.com/replicate/hello-world) model looks like this:\n\n```json\n{\n \"type\": \"object\",\n \"title\": \"Input\",\n \"required\": [\n \"text\"\n ],\n \"properties\": {\n \"text\": {\n \"x-order\": 0,\n \"type\": \"string\",\n \"title\": \"Text\",\n \"description\": \"Text to prefix with 'hello '\"\n }\n }\n}\n```\n\nThe `openapi_schema.components.schemas.Output` property for the [replicate/hello-world](https://replicate.com/replicate/hello-world) model looks like this:\n\n```json\n{\n \"type\": \"string\",\n \"title\": \"Output\"\n}\n```\n\nFor more details, see the docs on [Cog's supported input and output types](https://github.com/replicate/cog/blob/75b7802219e7cd4cee845e34c4c22139558615d4/docs/python.md#input-and-output-types)\n" }, "response": [ { "id": "fedf7432-fbcc-4c41-b771-e284041f3db6", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/models/:model_owner/:model_name/versions/:version_id", "host": [ "{{baseUrl}}" ], "path": [ "models", ":model_owner", ":model_name", "versions", ":version_id" ], "variable": [ { "key": "model_owner" }, { "key": "model_name" }, { "key": "version_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-fedf7432-fbcc-4c41-b771-e284041f3db6" } ], "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-3bb51c10-9f8a-46ba-bb81-7edab1aaa552" } ], "id": "44b52ecf-d388-4ce5-be05-9e2d3771572d", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-44b52ecf-d388-4ce5-be05-9e2d3771572d" }, { "name": "List Model Versions", "id": "0d97d44b-e3e2-4c6f-9c84-6e202c83e0f7", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/models/:model_owner/:model_name/versions", "host": [ "{{baseUrl}}" ], "path": [ "models", ":model_owner", ":model_name", "versions" ], "variable": [ { "id": "5b62c5d1-3bb9-44c9-8c08-acd55e63f782", "key": "model_owner", "value": "", "description": "(Required) The name of the user or organization that owns the model.\n" }, { "id": "237f1d9d-6a40-4568-ae8c-0f1b762c3db0", "key": "model_name", "value": "", "description": "(Required) The name of the model.\n" } ] }, "description": "Example cURL request:\n\n```console\ncurl -s \\\n -H \"Authorization: Bearer $REPLICATE_API_TOKEN\" \\\n https://api.replicate.com/v1/models/replicate/hello-world/versions\n```\n\nThe response will be a JSON array of model version objects, sorted with the most recent version first:\n\n```json\n{\n \"next\": null,\n \"previous\": null,\n \"results\": [\n {\n \"id\": \"5c7d5dc6dd8bf75c1acaa8565735e7986bc5b66206b55cca93cb72c9bf15ccaa\",\n \"created_at\": \"2022-04-26T19:29:04.418669Z\",\n \"cog_version\": \"0.3.0\",\n \"openapi_schema\": {...}\n }\n ]\n}\n```\n" }, "response": [ { "id": "e94d75e1-2174-46c1-8a23-2150065be915", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/models/:model_owner/:model_name/versions", "host": [ "{{baseUrl}}" ], "path": [ "models", ":model_owner", ":model_name", "versions" ], "variable": [ { "key": "model_owner" }, { "key": "model_name" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-e94d75e1-2174-46c1-8a23-2150065be915" } ], "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-0d97d44b-e3e2-4c6f-9c84-6e202c83e0f7" } ], "id": "77097e9d-d045-4280-8c2c-946c90631e24", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-77097e9d-d045-4280-8c2c-946c90631e24" }, { "name": "Delete a Model", "id": "48584457-690a-4e7e-9e0f-e05ade1ff9da", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/models/:model_owner/:model_name", "host": [ "{{baseUrl}}" ], "path": [ "models", ":model_owner", ":model_name" ], "variable": [ { "id": "06fbd811-6018-4b4d-a21b-646cccaa984e", "key": "model_owner", "value": "", "description": "(Required) The name of the user or organization that owns the model.\n" }, { "id": "769887f8-3b83-412d-8622-359131ef7b16", "key": "model_name", "value": "", "description": "(Required) The name of the model.\n" } ] }, "description": "Delete a model\n\nModel deletion has some restrictions:\n\n- You can only delete models you own.\n- You can only delete private models.\n- You can only delete models that have no versions associated with them. Currently you'll need to [delete the model's versions](#models.versions.delete) before you can delete the model itself.\n\nExample cURL request:\n\n```command\ncurl -s -X DELETE \\\n -H \"Authorization: Bearer $REPLICATE_API_TOKEN\" \\\n https://api.replicate.com/v1/models/replicate/hello-world\n```\n\nThe response will be an empty 204, indicating the model has been deleted.\n" }, "response": [ { "id": "c5765dfb-250d-4406-bc87-70e568195ca4", "name": "Success", "originalRequest": { "method": "DELETE", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/models/:model_owner/:model_name", "host": [ "{{baseUrl}}" ], "path": [ "models", ":model_owner", ":model_name" ], "variable": [ { "key": "model_owner" }, { "key": "model_name" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-c5765dfb-250d-4406-bc87-70e568195ca4" } ], "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-48584457-690a-4e7e-9e0f-e05ade1ff9da" }, { "name": "Get a Model", "id": "37020377-1c2f-4a82-afd1-4367770cfe04", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/models/:model_owner/:model_name", "host": [ "{{baseUrl}}" ], "path": [ "models", ":model_owner", ":model_name" ], "variable": [ { "id": "f4763e4f-6aa1-421a-85bb-e6d0cf87a665", "key": "model_owner", "value": "", "description": "(Required) The name of the user or organization that owns the model.\n" }, { "id": "6c891974-7496-4ba3-a802-1920b313cd13", "key": "model_name", "value": "", "description": "(Required) The name of the model.\n" } ] }, "description": "Example cURL request:\n\n```console\ncurl -s \\\n -H \"Authorization: Bearer $REPLICATE_API_TOKEN\" \\\n https://api.replicate.com/v1/models/replicate/hello-world\n```\n\nThe response will be a model object in the following format:\n\n```json\n{\n \"url\": \"https://replicate.com/replicate/hello-world\",\n \"owner\": \"replicate\",\n \"name\": \"hello-world\",\n \"description\": \"A tiny model that says hello\",\n \"visibility\": \"public\",\n \"github_url\": \"https://github.com/replicate/cog-examples\",\n \"paper_url\": null,\n \"license_url\": null,\n \"run_count\": 5681081,\n \"cover_image_url\": \"...\",\n \"default_example\": {...},\n \"latest_version\": {...},\n}\n```\n\nThe `cover_image_url` string is an HTTPS URL for an image file. This can be:\n\n- An image uploaded by the model author.\n- The output file of the example prediction, if the model author has not set a cover image.\n- The input file of the example prediction, if the model author has not set a cover image and the example prediction has no output file.\n- A generic fallback image.\n\nThe `default_example` object is a [prediction](#predictions.get) created with this model.\n\nThe `latest_version` object is the model's most recently pushed [version](#models.versions.get).\n" }, "response": [ { "id": "9aebd486-288f-415a-9cde-5f06f742271f", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/models/:model_owner/:model_name", "host": [ "{{baseUrl}}" ], "path": [ "models", ":model_owner", ":model_name" ], "variable": [ { "key": "model_owner" }, { "key": "model_name" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-9aebd486-288f-415a-9cde-5f06f742271f" } ], "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-37020377-1c2f-4a82-afd1-4367770cfe04" } ], "id": "7f311f95-c09d-4a76-85d2-33f7c59c4f65", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-7f311f95-c09d-4a76-85d2-33f7c59c4f65" } ], "id": "b7bdcc69-4b7c-4f8a-9a5f-fb128ac2de40", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-b7bdcc69-4b7c-4f8a-9a5f-fb128ac2de40" }, { "name": "List Public Models", "id": "fb2876db-bc0b-47f2-8084-5b057429e515", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/models", "host": [ "{{baseUrl}}" ], "path": [ "models" ] }, "description": "Get a paginated list of public models.\n\nExample cURL request:\n\n```console\ncurl -s \\\n -H \"Authorization: Bearer $REPLICATE_API_TOKEN\" \\\n https://api.replicate.com/v1/models\n```\n\nThe response will be a paginated JSON array of model objects:\n\n```json\n{\n \"next\": null,\n \"previous\": null,\n \"results\": [\n {\n \"url\": \"https://replicate.com/acme/hello-world\",\n \"owner\": \"acme\",\n \"name\": \"hello-world\",\n \"description\": \"A tiny model that says hello\",\n \"visibility\": \"public\",\n \"github_url\": \"https://github.com/replicate/cog-examples\",\n \"paper_url\": null,\n \"license_url\": null,\n \"run_count\": 5681081,\n \"cover_image_url\": \"...\",\n \"default_example\": {...},\n \"latest_version\": {...}\n }\n ]\n}\n```\n\nThe `cover_image_url` string is an HTTPS URL for an image file. This can be:\n\n- An image uploaded by the model author.\n- The output file of the example prediction, if the model author has not set a cover image.\n- The input file of the example prediction, if the model author has not set a cover image and the example prediction has no output file.\n- A generic fallback image.\n" }, "response": [ { "id": "2bc5d216-1d97-4763-a13a-8b9ca5c2f4c0", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/models", "host": [ "{{baseUrl}}" ], "path": [ "models" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-2bc5d216-1d97-4763-a13a-8b9ca5c2f4c0" } ], "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-fb2876db-bc0b-47f2-8084-5b057429e515" }, { "name": "Create a Model", "id": "790c7169-ec7e-4429-a04d-a3ef0709ea6e", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"owner\": \"\",\n \"name\": \"\",\n \"visibility\": \"private\",\n \"hardware\": \"\",\n \"cover_image_url\": \"\",\n \"description\": \"\",\n \"github_url\": \"\",\n \"license_url\": \"\",\n \"paper_url\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/models", "host": [ "{{baseUrl}}" ], "path": [ "models" ] }, "description": "Create a model.\n\nExample cURL request:\n\n```console\ncurl -s -X POST \\\n -H \"Authorization: Bearer $REPLICATE_API_TOKEN\" \\\n -H 'Content-Type: application/json' \\\n -d '{\"owner\": \"alice\", \"name\": \"my-model\", \"description\": \"An example model\", \"visibility\": \"public\", \"hardware\": \"cpu\"}' \\\n https://api.replicate.com/v1/models\n```\n\nThe response will be a model object in the following format:\n\n```json\n{\n \"url\": \"https://replicate.com/alice/my-model\",\n \"owner\": \"alice\",\n \"name\": \"my-model\",\n \"description\": \"An example model\",\n \"visibility\": \"public\",\n \"github_url\": null,\n \"paper_url\": null,\n \"license_url\": null,\n \"run_count\": 0,\n \"cover_image_url\": null,\n \"default_example\": null,\n \"latest_version\": null,\n}\n```\n\nNote that there is a limit of 1,000 models per account. For most purposes, we recommend using a single model and pushing new [versions](https://replicate.com/docs/how-does-replicate-work#versions) of the model as you make changes to it.\n" }, "response": [ { "id": "82d648fd-f752-43c7-bdf5-6365cda39d92", "name": "Success", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"owner\": \"\",\n \"name\": \"\",\n \"visibility\": \"private\",\n \"hardware\": \"\",\n \"cover_image_url\": \"\",\n \"description\": \"\",\n \"github_url\": \"\",\n \"license_url\": \"\",\n \"paper_url\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/models", "host": [ "{{baseUrl}}" ], "path": [ "models" ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-82d648fd-f752-43c7-bdf5-6365cda39d92" } ], "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-790c7169-ec7e-4429-a04d-a3ef0709ea6e" } ], "id": "d14836c4-51ab-40ee-aa00-e10353b4a653", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-d14836c4-51ab-40ee-aa00-e10353b4a653" }, { "name": "predictions", "item": [ { "name": "{prediction_id}", "item": [ { "name": "cancel", "item": [ { "name": "Cancel a Prediction", "id": "dbdd2fe0-e480-4408-b0a5-62a521d45ec2", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/predictions/:prediction_id/cancel", "host": [ "{{baseUrl}}" ], "path": [ "predictions", ":prediction_id", "cancel" ], "variable": [ { "id": "7b015cc6-1772-472b-bd08-a8bd5540c262", "key": "prediction_id", "value": "", "description": "(Required) The ID of the prediction to cancel.\n" } ] } }, "response": [ { "id": "a32d4116-431f-42ab-a09b-bfbe8abd77e8", "name": "Success", "originalRequest": { "method": "POST", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/predictions/:prediction_id/cancel", "host": [ "{{baseUrl}}" ], "path": [ "predictions", ":prediction_id", "cancel" ], "variable": [ { "key": "prediction_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-a32d4116-431f-42ab-a09b-bfbe8abd77e8" } ], "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-dbdd2fe0-e480-4408-b0a5-62a521d45ec2" } ], "id": "9e7d8457-f2e8-4c6f-806f-15379d81d3d2", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-9e7d8457-f2e8-4c6f-806f-15379d81d3d2" }, { "name": "Get a Prediction", "id": "e9a94328-7dd6-4c5e-9d48-00b14a5104b2", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/predictions/:prediction_id", "host": [ "{{baseUrl}}" ], "path": [ "predictions", ":prediction_id" ], "variable": [ { "id": "a3dc1c01-bd9f-4a5e-80ee-3dff7a74b5e8", "key": "prediction_id", "value": "", "description": "(Required) The ID of the prediction to get.\n" } ] }, "description": "Get the current state of a prediction.\n\nExample cURL request:\n\n```console\ncurl -s \\\n -H \"Authorization: Bearer $REPLICATE_API_TOKEN\" \\\n https://api.replicate.com/v1/predictions/gm3qorzdhgbfurvjtvhg6dckhu\n```\n\nThe response will be the prediction object:\n\n```json\n{\n \"id\": \"gm3qorzdhgbfurvjtvhg6dckhu\",\n \"model\": \"replicate/hello-world\",\n \"version\": \"5c7d5dc6dd8bf75c1acaa8565735e7986bc5b66206b55cca93cb72c9bf15ccaa\",\n \"input\": {\n \"text\": \"Alice\"\n },\n \"logs\": \"\",\n \"output\": \"hello Alice\",\n \"error\": null,\n \"status\": \"succeeded\",\n \"created_at\": \"2023-09-08T16:19:34.765994Z\",\n \"data_removed\": false,\n \"started_at\": \"2023-09-08T16:19:34.779176Z\",\n \"completed_at\": \"2023-09-08T16:19:34.791859Z\",\n \"metrics\": {\n \"predict_time\": 0.012683\n },\n \"urls\": {\n \"cancel\": \"https://api.replicate.com/v1/predictions/gm3qorzdhgbfurvjtvhg6dckhu/cancel\",\n \"get\": \"https://api.replicate.com/v1/predictions/gm3qorzdhgbfurvjtvhg6dckhu\"\n }\n}\n```\n\n`status` will be one of:\n\n- `starting`: the prediction is starting up. If this status lasts longer than a few seconds, then it's typically because a new worker is being started to run the prediction.\n- `processing`: the `predict()` method of the model is currently running.\n- `succeeded`: the prediction completed successfully.\n- `failed`: the prediction encountered an error during processing.\n- `canceled`: the prediction was canceled by its creator.\n\nIn the case of success, `output` will be an object containing the output of the model. Any files will be represented as HTTPS URLs. You'll need to pass the `Authorization` header to request them.\n\nIn the case of failure, `error` will contain the error encountered during the prediction.\n\nTerminated predictions (with a status of `succeeded`, `failed`, or `canceled`) will include a `metrics` object with a `predict_time` property showing the amount of CPU or GPU time, in seconds, that the prediction used while running. It won't include time waiting for the prediction to start.\n\nAll input parameters, output values, and logs are automatically removed after an hour, by default, for predictions created through the API.\n\nYou must save a copy of any data or files in the output if you'd like to continue using them. The `output` key will still be present, but it's value will be `null` after the output has been removed.\n\nOutput files are served by `replicate.delivery` and its subdomains. If you use an allow list of external domains for your assets, add `replicate.delivery` and `*.replicate.delivery` to it.\n" }, "response": [ { "id": "e9fc3577-6fbc-4c7d-bdd8-b2e86e2b45b2", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/predictions/:prediction_id", "host": [ "{{baseUrl}}" ], "path": [ "predictions", ":prediction_id" ], "variable": [ { "key": "prediction_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-e9fc3577-6fbc-4c7d-bdd8-b2e86e2b45b2" } ], "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-e9a94328-7dd6-4c5e-9d48-00b14a5104b2" } ], "id": "b996c839-3037-4e2d-a007-e9cae1cfc740", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-b996c839-3037-4e2d-a007-e9cae1cfc740" }, { "name": "List Predictions", "id": "71c4836e-169a-4c31-be6c-2c63d56ea4a2", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/predictions", "host": [ "{{baseUrl}}" ], "path": [ "predictions" ] }, "description": "Get a paginated list of all predictions created by the user or organization associated with the provided API token.\n\nThis will include predictions created from the API and the website. It will return 100 records per page.\n\nExample cURL request:\n\n```console\ncurl -s \\\n -H \"Authorization: Bearer $REPLICATE_API_TOKEN\" \\\n https://api.replicate.com/v1/predictions\n```\n\nThe response will be a paginated JSON array of prediction objects, sorted with the most recent prediction first:\n\n```json\n{\n \"next\": null,\n \"previous\": null,\n \"results\": [\n {\n \"completed_at\": \"2023-09-08T16:19:34.791859Z\",\n \"created_at\": \"2023-09-08T16:19:34.907244Z\",\n \"data_removed\": false,\n \"error\": null,\n \"id\": \"gm3qorzdhgbfurvjtvhg6dckhu\",\n \"input\": {\n \"text\": \"Alice\"\n },\n \"metrics\": {\n \"predict_time\": 0.012683\n },\n \"output\": \"hello Alice\",\n \"started_at\": \"2023-09-08T16:19:34.779176Z\",\n \"source\": \"api\",\n \"status\": \"succeeded\",\n \"urls\": {\n \"get\": \"https://api.replicate.com/v1/predictions/gm3qorzdhgbfurvjtvhg6dckhu\",\n \"cancel\": \"https://api.replicate.com/v1/predictions/gm3qorzdhgbfurvjtvhg6dckhu/cancel\"\n },\n \"model\": \"replicate/hello-world\",\n \"version\": \"5c7d5dc6dd8bf75c1acaa8565735e7986bc5b66206b55cca93cb72c9bf15ccaa\",\n }\n ]\n}\n```\n\n`id` will be the unique ID of the prediction.\n\n`source` will indicate how the prediction was created. Possible values are `web` or `api`.\n\n`status` will be the status of the prediction. Refer to [get a single prediction](#predictions.get) for possible values.\n\n`urls` will be a convenience object that can be used to construct new API requests for the given prediction. If the requested model version supports streaming, this will have a `stream` entry with an HTTPS URL that you can use to construct an [`EventSource`](https://developer.mozilla.org/en-US/docs/Web/API/EventSource).\n\n`model` will be the model identifier string in the format of `{model_owner}/{model_name}`.\n\n`version` will be the unique ID of model version used to create the prediction.\n\n`data_removed` will be `true` if the input and output data has been deleted.\n" }, "response": [ { "id": "27dba87d-c01c-43f4-abb9-4cf309a6695c", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/predictions", "host": [ "{{baseUrl}}" ], "path": [ "predictions" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-27dba87d-c01c-43f4-abb9-4cf309a6695c" } ], "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-71c4836e-169a-4c31-be6c-2c63d56ea4a2" }, { "name": "Create a Prediction", "id": "48c416d1-5f5c-4974-8899-5cf515f97a83", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "description": "Leave the request open and wait for the model to finish generating output. Set to `wait=n` where n is a number of seconds between 1 and 60.\n\nSee https://replicate.com/docs/topics/predictions/create-a-prediction#sync-mode for more information.", "key": "Prefer", "value": "wait" }, { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"version\": \"\",\n \"input\": {},\n \"stream\": \"\",\n \"webhook\": \"\",\n \"webhook_events_filter\": [\n \"start\",\n \"output\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/predictions", "host": [ "{{baseUrl}}" ], "path": [ "predictions" ] }, "description": "Create a prediction for the model version and inputs you provide.\n\nExample cURL request:\n\n```console\ncurl -s -X POST -H 'Prefer: wait' \\\n -d '{\"version\": \"5c7d5dc6dd8bf75c1acaa8565735e7986bc5b66206b55cca93cb72c9bf15ccaa\", \"input\": {\"text\": \"Alice\"}}' \\\n -H \"Authorization: Bearer $REPLICATE_API_TOKEN\" \\\n -H 'Content-Type: application/json' \\\n https://api.replicate.com/v1/predictions\n```\n\nThe request will wait up to 60 seconds for the model to run. If this time is exceeded the prediction will be returned in a `\"starting\"` state and need to be retrieved using the `predictions.get` endpiont.\n\nFor a complete overview of the `predictions.create` API check out our documentation on [creating a prediction](https://replicate.com/docs/topics/predictions/create-a-prediction) which covers a variety of use cases.\n" }, "response": [ { "id": "b13e5386-8bc6-4de7-9048-fcef3d12f1d1", "name": "Prediction has been created. If the `Prefer: wait` header is provided it will contain the final output.", "originalRequest": { "method": "POST", "header": [ { "description": "Leave the request open and wait for the model to finish generating output. Set to `wait=n` where n is a number of seconds between 1 and 60.\n\nSee https://replicate.com/docs/topics/predictions/create-a-prediction#sync-mode for more information.", "key": "Prefer", "value": "wait" }, { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"version\": \"\",\n \"input\": {},\n \"stream\": \"\",\n \"webhook\": \"\",\n \"webhook_events_filter\": [\n \"start\",\n \"output\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/predictions", "host": [ "{{baseUrl}}" ], "path": [ "predictions" ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-b13e5386-8bc6-4de7-9048-fcef3d12f1d1" }, { "id": "0eb7f94c-f91d-4a25-b1f2-c829af727f3a", "name": "Prediction has been created but does not yet have all outputs", "originalRequest": { "method": "POST", "header": [ { "description": "Leave the request open and wait for the model to finish generating output. Set to `wait=n` where n is a number of seconds between 1 and 60.\n\nSee https://replicate.com/docs/topics/predictions/create-a-prediction#sync-mode for more information.", "key": "Prefer", "value": "wait" }, { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"version\": \"\",\n \"input\": {},\n \"stream\": \"\",\n \"webhook\": \"\",\n \"webhook_events_filter\": [\n \"start\",\n \"output\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/predictions", "host": [ "{{baseUrl}}" ], "path": [ "predictions" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-0eb7f94c-f91d-4a25-b1f2-c829af727f3a" } ], "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-48c416d1-5f5c-4974-8899-5cf515f97a83" } ], "id": "18df94ee-6631-46dd-a8f9-ee7262faa83f", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-18df94ee-6631-46dd-a8f9-ee7262faa83f" }, { "name": "trainings", "item": [ { "name": "{training_id}", "item": [ { "name": "cancel", "item": [ { "name": "Cancel a Training", "id": "8338d7ee-fd15-4067-a084-950d1c90d895", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/trainings/:training_id/cancel", "host": [ "{{baseUrl}}" ], "path": [ "trainings", ":training_id", "cancel" ], "variable": [ { "id": "5fbdb144-64dc-4eac-97ba-e371fc7f14dc", "key": "training_id", "value": "", "description": "(Required) The ID of the training you want to cancel.\n" } ] } }, "response": [ { "id": "9b78963a-318b-44dd-b6d8-630e2d231f34", "name": "Success", "originalRequest": { "method": "POST", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/trainings/:training_id/cancel", "host": [ "{{baseUrl}}" ], "path": [ "trainings", ":training_id", "cancel" ], "variable": [ { "key": "training_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-9b78963a-318b-44dd-b6d8-630e2d231f34" } ], "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-8338d7ee-fd15-4067-a084-950d1c90d895" } ], "id": "7703a2c4-5338-4c5e-ac95-c291ea8137e0", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-7703a2c4-5338-4c5e-ac95-c291ea8137e0" }, { "name": "Get a Training", "id": "a063e742-8e55-4259-a400-ee9aa1ba84ce", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/trainings/:training_id", "host": [ "{{baseUrl}}" ], "path": [ "trainings", ":training_id" ], "variable": [ { "id": "8c1ea92f-256d-4ff8-a1c3-2141343f01a0", "key": "training_id", "value": "", "description": "(Required) The ID of the training to get.\n" } ] }, "description": "Get the current state of a training.\n\nExample cURL request:\n\n```console\ncurl -s \\\n -H \"Authorization: Bearer $REPLICATE_API_TOKEN\" \\\n https://api.replicate.com/v1/trainings/zz4ibbonubfz7carwiefibzgga\n```\n\nThe response will be the training object:\n\n```json\n{\n \"completed_at\": \"2023-09-08T16:41:19.826523Z\",\n \"created_at\": \"2023-09-08T16:32:57.018467Z\",\n \"error\": null,\n \"id\": \"zz4ibbonubfz7carwiefibzgga\",\n \"input\": {\n \"input_images\": \"https://example.com/my-input-images.zip\"\n },\n \"logs\": \"...\",\n \"metrics\": {\n \"predict_time\": 502.713876\n },\n \"output\": {\n \"version\": \"...\",\n \"weights\": \"...\"\n },\n \"started_at\": \"2023-09-08T16:32:57.112647Z\",\n \"status\": \"succeeded\",\n \"urls\": {\n \"get\": \"https://api.replicate.com/v1/trainings/zz4ibbonubfz7carwiefibzgga\",\n \"cancel\": \"https://api.replicate.com/v1/trainings/zz4ibbonubfz7carwiefibzgga/cancel\"\n },\n \"model\": \"stability-ai/sdxl\",\n \"version\": \"da77bc59ee60423279fd632efb4795ab731d9e3ca9705ef3341091fb989b7eaf\",\n}\n```\n\n`status` will be one of:\n\n- `starting`: the training is starting up. If this status lasts longer than a few seconds, then it's typically because a new worker is being started to run the training.\n- `processing`: the `train()` method of the model is currently running.\n- `succeeded`: the training completed successfully.\n- `failed`: the training encountered an error during processing.\n- `canceled`: the training was canceled by its creator.\n\nIn the case of success, `output` will be an object containing the output of the model. Any files will be represented as HTTPS URLs. You'll need to pass the `Authorization` header to request them.\n\nIn the case of failure, `error` will contain the error encountered during the training.\n\nTerminated trainings (with a status of `succeeded`, `failed`, or `canceled`) will include a `metrics` object with a `predict_time` property showing the amount of CPU or GPU time, in seconds, that the training used while running. It won't include time waiting for the training to start.\n" }, "response": [ { "id": "e64e3e6c-af05-4bc6-97f3-ecbd8fb863dc", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/trainings/:training_id", "host": [ "{{baseUrl}}" ], "path": [ "trainings", ":training_id" ], "variable": [ { "key": "training_id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-e64e3e6c-af05-4bc6-97f3-ecbd8fb863dc" } ], "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-a063e742-8e55-4259-a400-ee9aa1ba84ce" } ], "id": "d3ca9e11-3b1b-42b6-87b2-32fd0f65a5da", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-d3ca9e11-3b1b-42b6-87b2-32fd0f65a5da" }, { "name": "List Trainings", "id": "40ca9463-7c0f-4c1f-aaca-040eebdcd5be", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/trainings", "host": [ "{{baseUrl}}" ], "path": [ "trainings" ] }, "description": "Get a paginated list of all trainings created by the user or organization associated with the provided API token.\n\nThis will include trainings created from the API and the website. It will return 100 records per page.\n\nExample cURL request:\n\n```console\ncurl -s \\\n -H \"Authorization: Bearer $REPLICATE_API_TOKEN\" \\\n https://api.replicate.com/v1/trainings\n```\n\nThe response will be a paginated JSON array of training objects, sorted with the most recent training first:\n\n```json\n{\n \"next\": null,\n \"previous\": null,\n \"results\": [\n {\n \"completed_at\": \"2023-09-08T16:41:19.826523Z\",\n \"created_at\": \"2023-09-08T16:32:57.018467Z\",\n \"error\": null,\n \"id\": \"zz4ibbonubfz7carwiefibzgga\",\n \"input\": {\n \"input_images\": \"https://example.com/my-input-images.zip\"\n },\n \"metrics\": {\n \"predict_time\": 502.713876\n },\n \"output\": {\n \"version\": \"...\",\n \"weights\": \"...\"\n },\n \"started_at\": \"2023-09-08T16:32:57.112647Z\",\n \"source\": \"api\",\n \"status\": \"succeeded\",\n \"urls\": {\n \"get\": \"https://api.replicate.com/v1/trainings/zz4ibbonubfz7carwiefibzgga\",\n \"cancel\": \"https://api.replicate.com/v1/trainings/zz4ibbonubfz7carwiefibzgga/cancel\"\n },\n \"model\": \"stability-ai/sdxl\",\n \"version\": \"da77bc59ee60423279fd632efb4795ab731d9e3ca9705ef3341091fb989b7eaf\",\n }\n ]\n}\n```\n\n`id` will be the unique ID of the training.\n\n`source` will indicate how the training was created. Possible values are `web` or `api`.\n\n`status` will be the status of the training. Refer to [get a single training](#trainings.get) for possible values.\n\n`urls` will be a convenience object that can be used to construct new API requests for the given training.\n\n`version` will be the unique ID of model version used to create the training.\n" }, "response": [ { "id": "d8769536-d92b-4e44-9ce5-8fb75f17f929", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/trainings", "host": [ "{{baseUrl}}" ], "path": [ "trainings" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-d8769536-d92b-4e44-9ce5-8fb75f17f929" } ], "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-40ca9463-7c0f-4c1f-aaca-040eebdcd5be" } ], "id": "46ba9598-03df-4f9b-964d-8253fd7c3b58", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-46ba9598-03df-4f9b-964d-8253fd7c3b58" }, { "name": "webhooks", "item": [ { "name": "default", "item": [ { "name": "secret", "item": [ { "name": "Get the Signing Secret for the Default Webhook", "id": "88e3d074-091d-43c2-9985-e997a8605979", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/webhooks/default/secret", "host": [ "{{baseUrl}}" ], "path": [ "webhooks", "default", "secret" ] }, "description": "Get the signing secret for the default webhook endpoint. This is used to verify that webhook requests are coming from Replicate.\n\nExample cURL request:\n\n```console\ncurl -s \\\n -H \"Authorization: Bearer $REPLICATE_API_TOKEN\" \\\n https://api.replicate.com/v1/webhooks/default/secret\n```\n\nThe response will be a JSON object with a `key` property:\n\n```json\n{\n \"key\": \"...\"\n}\n```\n" }, "response": [ { "id": "775c2ccc-90b1-4189-b363-300788a12cfd", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/webhooks/default/secret", "host": [ "{{baseUrl}}" ], "path": [ "webhooks", "default", "secret" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"key\": \"\"\n}", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-775c2ccc-90b1-4189-b363-300788a12cfd" } ], "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-88e3d074-091d-43c2-9985-e997a8605979" } ], "id": "aef79046-1fa6-4bf7-898f-7c925b294074", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-aef79046-1fa6-4bf7-898f-7c925b294074" } ], "id": "1fb4aeef-7874-481f-817b-57c186e17d7b", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-1fb4aeef-7874-481f-817b-57c186e17d7b" } ], "id": "85aa4156-3edc-4c6b-b3f7-ec4fa6e4fdfd", "createdAt": "2026-06-05T15:15:06.000Z", "updatedAt": "2026-06-05T15:15:06.000Z", "uid": "35240-85aa4156-3edc-4c6b-b3f7-ec4fa6e4fdfd" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.replicate.com/v1" } ] }