diff --git a/api-reference/endpoint/create.mdx b/api-reference/endpoint/create.mdx
deleted file mode 100644
index 5689f1b..0000000
--- a/api-reference/endpoint/create.mdx
+++ /dev/null
@@ -1,4 +0,0 @@
----
-title: 'Create Plant'
-openapi: 'POST /plants'
----
diff --git a/api-reference/endpoint/delete.mdx b/api-reference/endpoint/delete.mdx
deleted file mode 100644
index 657dfc8..0000000
--- a/api-reference/endpoint/delete.mdx
+++ /dev/null
@@ -1,4 +0,0 @@
----
-title: 'Delete Plant'
-openapi: 'DELETE /plants/{id}'
----
diff --git a/api-reference/endpoint/get.mdx b/api-reference/endpoint/get.mdx
deleted file mode 100644
index 56aa09e..0000000
--- a/api-reference/endpoint/get.mdx
+++ /dev/null
@@ -1,4 +0,0 @@
----
-title: 'Get Plants'
-openapi: 'GET /plants'
----
diff --git a/api-reference/endpoint/webhook.mdx b/api-reference/endpoint/webhook.mdx
deleted file mode 100644
index 3291340..0000000
--- a/api-reference/endpoint/webhook.mdx
+++ /dev/null
@@ -1,4 +0,0 @@
----
-title: 'New Plant'
-openapi: 'WEBHOOK /plant/webhook'
----
diff --git a/api-reference/introduction.mdx b/api-reference/introduction.mdx
index c835b78..65594ff 100644
--- a/api-reference/introduction.mdx
+++ b/api-reference/introduction.mdx
@@ -1,33 +1,24 @@
---
-title: 'Introduction'
-description: 'Example section for showcasing API endpoints'
+title: 'API Reference'
+description: 'Complete reference for the DeepInfra REST API'
---
-
- If you're not looking to build API reference documentation, you can delete
- this section by removing the api-reference folder.
-
+The DeepInfra API is available at `https://api.deepinfra.com`. It offers two sets of endpoints:
-## Welcome
+1. **OpenAI-compatible endpoints** at `/v1/openai` — drop-in replacement for OpenAI chat completions, embeddings, and image generation. Use these with any OpenAI SDK.
-There are two ways to build API documentation: [OpenAPI](https://mintlify.com/docs/api-playground/openapi/setup) and [MDX components](https://mintlify.com/docs/api-playground/mdx/configuration). For the starter kit, we are using the following OpenAPI specification.
-
-
- View the OpenAPI specification file
-
+2. **DeepInfra native endpoints** at `/v1/inference/{model_name}` — direct access to all model types including speech recognition, object detection, image classification, and more.
## Authentication
-All API endpoints are authenticated using Bearer tokens and picked up from the specification file.
+All endpoints require a Bearer token in the `Authorization` header:
-```json
-"security": [
- {
- "bearerAuth": []
- }
-]
```
+Authorization: Bearer $DEEPINFRA_TOKEN
+```
+
+Get your API key from the [Dashboard](https://deepinfra.com/dash/api_keys).
+
+## Interactive reference
+
+Use the tabs above to browse and try all available endpoints, generated from our live OpenAPI specification.