Add Replicate inference provider examples

README.md

@@ -1,10 +1,95 @@
 ---
-title: Inference Provider Examples
-emoji: 🏃
-colorFrom: purple
-colorTo: blue
+title: Replicate Inference Provider Examples
+emoji: 🚀
+colorFrom: blue
+colorTo: green
 sdk: static
-pinned: false
+pinned: true
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Replicate Inference Provider Examples
+
+Use Replicate through Hugging Face's standard `InferenceClient` by setting `provider="replicate"`. These examples use your `HF_TOKEN` and models available through Hugging Face Inference Providers.
+
+## Image generation
+
+```python
+import os
+from huggingface_hub import InferenceClient
+
+client = InferenceClient(
+    provider="replicate",
+    api_key=os.environ["HF_TOKEN"],
+)
+
+image = client.text_to_image(
+    "A cinematic photo of an astronaut riding a horse",
+    model="Tongyi-MAI/Z-Image-Turbo",
+)
+
+image.save("replicate-astronaut.png")
+```
+
+## Image editing
+
+```python
+import os
+from huggingface_hub import InferenceClient
+
+client = InferenceClient(
+    provider="replicate",
+    api_key=os.environ["HF_TOKEN"],
+)
+
+with open("cat.png", "rb") as image_file:
+    input_image = image_file.read()
+
+image = client.image_to_image(
+    input_image,
+    prompt="Turn the cat into a tiger.",
+    model="black-forest-labs/FLUX.2-dev",
+)
+
+image.save("replicate-tiger.png")
+```
+
+## Video generation
+
+```python
+import os
+from huggingface_hub import InferenceClient
+
+client = InferenceClient(
+    provider="replicate",
+    api_key=os.environ["HF_TOKEN"],
+)
+
+video = client.text_to_video(
+    "A young man walking on the street",
+    model="Wan-AI/Wan2.2-T2V-A14B",
+)
+```
+
+## Speech recognition
+
+```python
+import os
+from huggingface_hub import InferenceClient
+
+client = InferenceClient(
+    provider="replicate",
+    api_key=os.environ["HF_TOKEN"],
+)
+
+output = client.automatic_speech_recognition(
+    "sample1.flac",
+    model="openai/whisper-large-v3",
+)
+```
+
+## More resources
+
+- [Replicate org on Hugging Face](https://huggingface.co/replicate)
+- [Run with Replicate collection](https://huggingface.co/collections/replicate/run-with-replicate-6a04d0792d027edbf66c7155)
+- [Replicate provider docs](https://huggingface.co/docs/inference-providers/providers/replicate)
+- [Supported Replicate models](https://huggingface.co/models?inference_provider=replicate&sort=trending)