---
title: "Morpheus Inference API (hosted)"
description: "Use Morpheus inference via a hosted OpenAI-compatible HTTPS gateway — no node, no wallet, just an API key."
audience: ["api-user", "developer"]
product: ["inference-api"]
last_verified: "v7.11.0"
source_url: "https://apidocs.mor.org"
---
The **Morpheus Inference API** (also called the API Gateway) is a separate hosted product built on top of the Morpheus Inference Marketplace. It gives you OpenAI-compatible inference behind a simple base URL and API key — **no proxy-router, no wallet, no on-chain session management**. It powers integrations, lite clients, and the **Morpheus Chat App** at [app.mor.org](https://app.mor.org). Canonical docs at [apidocs.mor.org](https://apidocs.mor.org).
This page summarizes the product. The canonical, full documentation lives at [apidocs.mor.org](https://apidocs.mor.org). For deeper integration guides (Cursor, OpenCode, LangChain, Eliza, n8n, Open Web-UI, Brave Leo, OpenAI Python SDK, Vercel AI SDK), follow the links there.
## When to use the Inference API vs running a node
| You want to... | Use |
|----------------|-----|
| Plug Morpheus into an OpenAI-compatible client without managing infra | **Inference API** ([apidocs.mor.org](https://apidocs.mor.org)) |
| Self-custody your wallet and pay providers directly on-chain | [Run a C-Node](/prosumers/c-node-setup) or [MorpheusUI](/consumers/quickstart) |
| Host models for the marketplace and earn MOR | [Run a P-Node](/providers/full/quickstart) |
| Get cryptographic TEE attestation guarantees on the inference path | [TEE provider chain](/concepts/tee-overview) (requires running your own consumer-side proxy-router) |
The Inference API abstracts away node operation, sessions, and MOR escrow into a simple API-key model. Behind the scenes it talks to the same Morpheus marketplace this repo's proxy-router does.
## Quickstart
Per [apidocs.mor.org](https://apidocs.mor.org):
Create an account at [app.mor.org](https://app.mor.org) and log in.
Generate an API key and confirm automation is enabled.
Either chat through the hosted **test** page, or start integrating immediately.
```
Inference API base URL: https://api.mor.org/api/v1
```
## Using it with the OpenAI Python SDK
The Inference API speaks the OpenAI HTTP shape, so any OpenAI-compatible client works:
```python
from openai import OpenAI
client = OpenAI(
base_url="https://api.mor.org/api/v1",
api_key="",
)
response = client.chat.completions.create(
model="",
messages=[{"role": "user", "content": "Hello"}],
)
```
Same pattern for the Vercel AI SDK, LangChain, Eliza, n8n, Cursor, OpenCode, Open Web-UI, Brave Leo, etc. Specific integration guides for each: [apidocs.mor.org](https://apidocs.mor.org).
## What this product is *not*
- **Not the proxy-router HTTP API.** That's a different surface — a local API exposed by the [proxy-router](/concepts/architecture) on `:8082` when you self-host. If you're running a node, you talk to it directly; you do not use `api.mor.org` for that.
- **Not the only way to use Morpheus.** It's the easiest, but you give up self-custody of the wallet and direct on-chain control of sessions in exchange. Casual chat users with the same trade-off can use [app.mor.org](/ecosystem/app-mor-org) directly (no API integration needed).
- **Not the whole marketplace.** The list of models exposed through `apidocs.mor.org` / `app.mor.org` is the hosted gateway's **allowlisted** set, not every bid on chain. The gateway's catalog **input** is the **GATEWAY** slice on [active.mor.org](https://active.mor.org) (`gateway_models.json` — healthy + degraded + aliases). Independent providers can register additional models that appear on **ALL** or **ACTIVE** and still never show up on the hosted API. To see the live marketplace, pick a layer: [Marketplace catalog](/ecosystem/active-status). Illustrated explainer: [tech.mor.org/active.html](https://tech.mor.org/active.html). A self-hosted C-Node uses [`GET /blockchain/models`](/reference/api-endpoints#get-models) plus `SESSION_HEALTH_POLICY`, not the GATEWAY file.
## Pricing
The hosted API runs on a credits/billing model — see [apidocs.mor.org](https://apidocs.mor.org) for current terms. The underlying **marketplace** itself is priced per **session-time** (`pricePerSecond`), not per token — see [Tokens and fees](/concepts/tokens-and-fees).
## Relationship to this repository
```mermaid
flowchart LR
Client[Your OpenAI-shaped client] -->|"api key"| Gateway[Hosted API Gateway]
Gateway -.uses.-> Marketplace[Compute Node contracts on BASE]
Gateway -.uses.-> ProviderProxy[Provider proxy-routers]
SelfHost[Your own C-Node from this repo] -->|"direct"| Marketplace
SelfHost -->|"direct"| ProviderProxy
```
The Inference API is built on the same Morpheus marketplace this repo's proxy-router talks to. If you want to **self-host** that gateway behavior (your own wallet, your own MOR, no third-party billing, full control), follow [C-Node setup](/prosumers/c-node-setup) and call your local proxy-router instead.
## Related
- [What is Morpheus?](/concepts/what-is-morpheus)
- [Architecture](/concepts/architecture)
- [Marketplace catalog (active.mor.org)](/ecosystem/active-status)
- [Hosted consumer surface — app.mor.org / Morpheus Chat App](/ecosystem/app-mor-org)
- [Self-hosted consumer alternative — C-Node setup](/prosumers/c-node-setup)