feat(replicate): add complete Replicate provider with all features

Add comprehensive Replicate provider implementation supporting all core features:
text generation, streaming (SSE), structured output, embeddings, image generation,
audio (TTS/STT), and tool calling with multi-step execution.

Features:
- Text generation with system prompts and conversation history
- Real-time SSE streaming with automatic fallback to simulated streaming
- Tool calling via prompt engineering with JSON parsing
- Structured output with JSON schema validation
- Image generation (FLUX, Stable Diffusion XL, etc.)
- Text-to-Speech with multiple voices (Kokoro-82m)
- Speech-to-Text with Whisper (WAV, MP3, FLAC, OGG, M4A)
- Embeddings (single and batch, 768-dimensional vectors)

Implementation:
- Async prediction management with configurable polling
- Sync mode (Prefer: wait header) for lower latency
- Comprehensive error handling with typed exceptions
- Full PHPStan level 8 compliance
- 44 tests with 132 assertions (100% feature coverage)
- 455 lines of comprehensive documentation

Files changed: 73 files, 5,360+ lines added

Author: cemarta7

.gitignore

@@ -11,3 +11,4 @@ phpunit.xml
 ray.php
 CLAUDE.md
 .phpunit.result.cache
+AGENTS.md

config/prism.php

@@ -59,5 +59,13 @@
                 'x_title' => env('OPENROUTER_SITE_X_TITLE', null),
             ],
         ],
+        'replicate' => [
+            'api_key' => env('REPLICATE_API_KEY', ''),
+            'url' => env('REPLICATE_URL', 'https://api.replicate.com/v1'),
+            'webhook_url' => env('REPLICATE_WEBHOOK_URL', null),
+            'use_sync_mode' => env('REPLICATE_USE_SYNC_MODE', true), // Use Prefer: wait header
+            'polling_interval' => env('REPLICATE_POLLING_INTERVAL', 1000),
+            'max_wait_time' => env('REPLICATE_MAX_WAIT_TIME', 60),
+        ],
     ],
 ];

docs/.vitepress/config.mts

@@ -203,6 +203,14 @@ export default defineConfig({
                 text: "OpenAI",
                 link: "/providers/openai",
               },
+              {
+                text: "OpenRouter",
+                link: "/providers/openrouter",
+              },
+              {
+                text: "Replicate",
+                link: "/providers/replicate",
+              },
               {
                 text: "Voyage AI",
                 link: "/providers/voyageai",

docs/components/ProviderSupport.vue

@@ -327,6 +327,18 @@ export default {
           tools: Supported,
           documents: Supported,
         },
+        {
+          name: "Replicate",
+          text: Supported,
+          streaming: Supported,
+          structured: Supported,
+          embeddings: Supported,
+          image: Supported,
+          "speech-to-text": Supported,
+          "text-to-speech": Supported,
+          tools: Unsupported,
+          documents: Unsupported,
+        },
         {
           name: "VoyageAI",
           text: Unsupported,

docs/getting-started/introduction.md

@@ -60,6 +60,19 @@ $response = Prism::text()
     ->withPrompt('Explain quantum computing to a 5-year-old.')
     ->asText();
 
+echo $response->text;
+```
+
+```php [Replicate]
+use Prism\Prism\Facades\Prism;
+use Prism\Prism\Enums\Provider;
+
+$response = Prism::text()
+    ->using(Provider::Replicate, 'meta/meta-llama-3.1-405b-instruct')
+    ->withSystemPrompt(view('prompts.system'))
+    ->withPrompt('Explain quantum computing to a 5-year-old.')
+    ->asText();
+
 echo $response->text;
 ```
 :::
@@ -92,6 +105,7 @@ We currently offer first-party support for these leading AI providers:
 - [Mistral](/providers/mistral.md)
 - [Ollama](/providers/ollama.md)
 - [OpenAI](/providers/openai.md)
+- [Replicate](/providers/replicate.md)
 - [xAI](/providers/xai.md)
 
 Each provider brings its own strengths to the table, and Prism makes it easy to use them all through a consistent, elegant interface.