# Yoofooz API Readiness Report

## API
**Name:** Replicate
**Docs URL:** https://replicate.com/docs
**Domain:** replicate.com
**Generated At:** 2026-10-25T18:59:04.404587+00:00

## Certification
**Agent Readiness Score:** 75/100
**Certification Level:** Yoofooz Ready

## Agent Commerce Readiness
**Agent Commerce Score:** 30/100
**Agent Commerce Level:** Agent Commerce Emerging

This score is separate from the core Agent Readiness Score and evaluates MCP support, scoped agent identity, machine-native payments, consumption pricing, budget controls, rate controls, deterministic errors, auditability, least-privilege security, and agent observability.

## Category Scores
- Documentation Clarity: 10
- Machine Readable Spec: 10
- Authentication Clarity: 5
- Error Handling: 10
- Rate Limit Clarity: 10
- Agent Safe Workflow Support: 0
- Sandbox Availability: 0
- Webhook Event Support: 10
- Commercial Trust: 10
- Developer Experience: 10

## Strengths
- Documentation clarity
- Machine-readable specification (OpenAPI/GraphQL/etc.)
- Error handling and status codes
- Rate-limit / quota behavior
- Webhook / event support
- Commercial trust (status, SLA, compliance)
- Developer experience (SDKs, quickstart, CLI)

## Risks
- Authentication model clarity signal is partial; clearer documentation recommended.
- Agent-safe workflow primitives (idempotency, retries) signal not detected in docs.
- Sandbox / test-mode availability signal not detected in docs.

## Recommended Next Steps
- Strengthen: Document authentication clearly (API keys, OAuth scopes, bearer tokens, secret/publishable key handling).
- Document idempotency keys, test mode, dry runs, and safe retry semantics for agents.
- Provide a sandbox / test mode with test API keys for safe agent testing.

## Evidence Signals

### Documentation clarity
- **Source:** https://replicate.com/docs/reference/openapi
- **Matched:** parameters, request, response, docs, reference
- **Evidence:** "...openapi (formerly known as swagger) is a specification for describing the structure of http apis, including all their endpoints, http methods, input parameters, request and response formats, and other metadata. openapi schemas are useful as raw reference material when learning about an api, but they’re also..."

- **Source:** https://replicate.com/docs/reference/error-codes
- **Matched:** parameters, request, reference
- **Evidence:** "...e9243 - error starting prediction the prediction encountered an error during the startup process. this typically happens due to invalid input parameters, model configuration issues, resource allocation failures, or environment setup problems. verify your input parameters are correct, check the..."

### Machine-readable specification (OpenAPI/GraphQL/etc.)
- **Source:** https://replicate.com/docs/reference/openapi
- **Matched:** openapi, swagger, json schema, endpoints, schema
- **Evidence:** "home / reference openapi schema the openapi schema reference for replicate's http api. copy page view as markdown open in chatgpt open in claude table of contents what is..."

- **Source:** https://replicate.com/docs/reference/mcp
- **Matched:** openapi, schema
- **Evidence:** "...large language models (llms). mcp extends the capabilities of apps like claude desktop , claude code , cursor , or github copilot by feeding them openapi schemas that describe tools or services, like replicate’s http api. mcp lets you give natural language instructions to a language model, and it can..."

### Authentication model clarity
- **Source:** https://replicate.com/docs/reference/mcp
- **Matched:** authentication, api key
- **Evidence:** "...most users. you just add the hosted server url to your apps like claude or cursor. after installing the server, you’ll be directed to a web-based authentication flow where you can provide a replicate api key for the server to use on your behalf. local server: you can run the server locally on your machine...."

- **Source:** https://replicate.com/docs/reference/openapi
- **Matched:** authorization, keys
- **Evidence:** "...api endpoint. here’s an example using curl and jq to print the input schema for the black-forest-labs/flux-schnell model: copy curl -s \ -h 'authorization: bearer $replicate_api_token ' \ https://api.replicate.com/v1/models/black-forest-labs/flux-schnell \ | jq..."

### Error handling and status codes
- **Source:** https://replicate.com/docs/reference/error-codes
- **Matched:** error codes, retry
- **Evidence:** "home / reference error codes a list of common error codes returned by replicate's api copy page view as markdown open in chatgpt open in claude table of contents understanding..."

- **Source:** https://replicate.com/docs/topics/predictions/rate-limits
- **Matched:** 429
- **Evidence:** "...limited to 1 request per second with a maximum of 6 requests per minute. api response if you hit a limit, you will receive a response with status 429 with a body like: copy higher limits if you want higher limits, contact us . next: safety checking home about changelog join us terms privacy status..."

### Rate-limit / quota behavior
- **Source:** https://replicate.com/docs/topics/predictions/rate-limits
- **Matched:** rate limit, rate limits, 429, throttling, limits
- **Evidence:** "home / topics / predictions rate limits copy page view as markdown open in chatgpt open in claude table of contents throttling api response higher limits we limit the number of api..."

- **Source:** https://replicate.com/docs/reference/error-codes
- **Matched:** quota, limits
- **Evidence:** "...this can occur when the file is too large, there are network connectivity issues, the file format is invalid, the upload times out, or your storage quota has been exceeded. check your file size (most models have upload limits), ensure the file format is supported, try uploading the file again,..."

### Webhook / event support
- **Source:** https://replicate.com/docs/reference/error-codes
- **Matched:** webhook
- **Evidence:** "...table of contents understanding error codes common error codes e1000 - unknown error e1001 - model out of memory (oom killed) e4875 - internal webhook url empty e6716 - timeout starting prediction e8367 - prediction stopped in non-terminal state e8765 - model health check failed e9243 - error..."

### Commercial trust (status, SLA, compliance)
- **Source:** https://replicate.com/docs/reference/error-codes
- **Matched:** status page, support, changelog
- **Evidence:** "...connection. getting help if you’re encountering an error code not listed here, or if the suggested solutions don’t resolve your issue: check our status page for any ongoing system issues review the model documentation for specific requirements and limitations contact our support team next: open source at..."

- **Source:** https://replicate.com/docs/reference/openapi
- **Matched:** support, changelog, security
- **Evidence:** "...more about how replicate model interfaces are defined, see the cog documentation . next: llms.txt home about changelog join us terms privacy status support"

### Developer experience (SDKs, quickstart, CLI)
- **Source:** https://replicate.com/docs/reference/mcp
- **Matched:** client libraries, sdk, cli
- **Evidence:** ".... show me the code you generated and the result. for more information, see the replicate-mcp-code-mode repository . next: client libraries home about changelog join us terms privacy status support"

- **Source:** https://replicate.com/docs/reference/openapi
- **Matched:** client libraries, cli
- **Evidence:** "...other metadata. openapi schemas are useful as raw reference material when learning about an api, but they’re also great for dynamically generating client libraries, reference documentation , tests, and tools for interacting with http apis. openapi is also the industry-standard format for ai function calling..."

## AI Analyst Summary
_Provider: nvidia | Model: nvidia/nemotron-3.5-super-vl-120b-a12b_

Replicate scores 75 with Yoofooz Ready certification, showing strong documentation, specs, error handling, rate limits, webhooks, trust, and developer experience, but lacking agent-safe workflow support and sandbox availability.

**Credibility Notes:**
- Certified Yoofooz Ready with strong scores across documentation, specs, error handling, rate limits, webhooks, trust, and DX.
- Authentication clarity is partial and flagged as a risk needing clearer documentation.
- Agent-safe workflow primitives and sandbox/test mode signals are not detected in docs.

**Next Actions:**
- Document authentication clearly including API keys, OAuth scopes, bearer tokens, and secret/publishable key handling.
- Document idempotency keys, test mode, dry runs, and safe retry semantics for agents.
- Provide a sandbox or test mode with test API keys for safe agent testing.

## Yoofooz Summary
This API has been evaluated for autonomous AI-agent usability. The score reflects documentation quality, machine-readable specification signals, authentication clarity, error handling, workflow safety, commercial trust, and developer experience.