{"openapi":"3.1.0","info":{"title":"Replicate (BYOK) API","version":"0.1.0","description":"Replicate (BYOK) lets an AI assistant read your own Replicate data through the Replicate API with a key you supply (API token). Read-only: 12 tools (get_account, list_models, get_model, list_model_versions, search_models, list_collections, get_collection, list_predictions, get_prediction, list_trainings, list_deployments, list_hardware). The BYOK key travels with each request, is used for that...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-replicate.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-replicate/docs"},"termsOfService":"https://connectorbay.com/byok-replicate/terms"},"servers":[{"url":"https://byok-replicate.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-replicate/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_account":{"post":{"operationId":"get_account","summary":"Show the Replicate account the token belongs to: username, display name, account type and GitHub URL. Use for \"Which Rep","description":"Show the Replicate account the token belongs to: username, display name, account type and GitHub URL. Use for \"Which Replicate account is my token for\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_accountArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_models":{"post":{"operationId":"list_models","summary":"List public Replicate models with owner, description and run count. Returns about 100 per call, newest first. Use for \"W","description":"List public Replicate models with owner, description and run count. Returns about 100 per call, newest first. Use for \"What are the newest public models on Replicate\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"sort_by":{"anyOf":[{"enum":["model_created_at","latest_version_created_at"],"type":"string"},{"type":"null"}],"default":"latest_version_created_at","description":"Order by model_created_at or latest_version_created_at.","title":"Sort By"},"sort_direction":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":"desc","description":"asc or desc.","title":"Sort Direction"}},"title":"list_modelsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_model":{"post":{"operationId":"get_model","summary":"Get one Replicate model: description, run count, visibility, license and links. Use list_model_versions for version ids.","description":"Get one Replicate model: description, run count, visibility, license and links. Use list_model_versions for version ids. Use for \"How many times has black-forest-labs/flux-schnell been run\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"model_owner":{"description":"Account that owns the model, for example 'black-forest-labs'.","maxLength":200,"title":"Model Owner","type":"string"},"model_name":{"description":"Model name without the owner, for example 'flux-schnell'.","maxLength":200,"title":"Model Name","type":"string"}},"required":["model_owner","model_name"],"title":"get_modelArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_model_versions":{"post":{"operationId":"list_model_versions","summary":"List the versions of a Replicate model with id, creation time and Cog version, newest first. Use for \"What versions does","description":"List the versions of a Replicate model with id, creation time and Cog version, newest first. Use for \"What versions does black-forest-labs/flux-schnell have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"model_owner":{"description":"Account that owns the model, for example 'black-forest-labs'.","maxLength":200,"title":"Model Owner","type":"string"},"model_name":{"description":"Model name without the owner, for example 'flux-schnell'.","maxLength":200,"title":"Model Name","type":"string"}},"required":["model_owner","model_name"],"title":"list_model_versionsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_models":{"post":{"operationId":"search_models","summary":"Search Replicate models and collections by text. Returns matching models with description and run count. Use for \"Find R","description":"Search Replicate models and collections by text. Returns matching models with description and run count. Use for \"Find Replicate models for removing image backgrounds\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Search text, for example 'remove background'.","maxLength":200,"title":"Query","type":"string"},"limit":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many results (1 to 50).","title":"Limit"}},"required":["query"],"title":"search_modelsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_collections":{"post":{"operationId":"list_collections","summary":"List curated Replicate model collections with name, slug and description. Use for \"What model collections does Replicate","description":"List curated Replicate model collections with name, slug and description. Use for \"What model collections does Replicate have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_collectionsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_collection":{"post":{"operationId":"get_collection","summary":"List the models inside one Replicate collection, with description and run count. Use for \"Which models are in the text-t","description":"List the models inside one Replicate collection, with description and run count. Use for \"Which models are in the text-to-image collection on Replicate\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"collection_slug":{"description":"Collection slug, for example 'text-to-image'.","maxLength":200,"title":"Collection Slug","type":"string"}},"required":["collection_slug"],"title":"get_collectionArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_predictions":{"post":{"operationId":"list_predictions","summary":"List your recent Replicate predictions, newest first (up to 100), with status, model, timing and error. Input and output","description":"List your recent Replicate predictions, newest first (up to 100), with status, model, timing and error. Input and output are not returned. Use for \"Did my last Replicate predictions succeed and how long did they take\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"created_after":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only predictions created after this ISO 8601 time, for example 2026-10-01T00:00:00Z.","title":"Created After"},"created_before":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only predictions created before this ISO 8601 time.","title":"Created Before"}},"title":"list_predictionsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_prediction":{"post":{"operationId":"get_prediction","summary":"Get one Replicate prediction by id: status, model, version, error, timing and links. Input and output are not returned. ","description":"Get one Replicate prediction by id: status, model, version, error, timing and links. Input and output are not returned. Use for \"What is the status of Replicate prediction abcd1234efgh5678\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"prediction_id":{"description":"Prediction id as returned when it was created.","maxLength":200,"title":"Prediction Id","type":"string"}},"required":["prediction_id"],"title":"get_predictionArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_trainings":{"post":{"operationId":"list_trainings","summary":"List your Replicate fine-tuning trainings, newest first, with status, model, version, timing and error. Use for \"Which o","description":"List your Replicate fine-tuning trainings, newest first, with status, model, version, timing and error. Use for \"Which of my Replicate trainings are still running\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_trainingsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_deployments":{"post":{"operationId":"list_deployments","summary":"List your Replicate deployments with owner, name, current model version, hardware and instance limits. Use for \"Which Re","description":"List your Replicate deployments with owner, name, current model version, hardware and instance limits. Use for \"Which Replicate deployments do I have and on what hardware\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_deploymentsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_hardware":{"post":{"operationId":"list_hardware","summary":"List the hardware options Replicate offers for running models, with name and SKU. Use for \"What GPU hardware can I pick ","description":"List the hardware options Replicate offers for running models, with name and SKU. Use for \"What GPU hardware can I pick on Replicate\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_hardwareArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}