# Manus
[Manus](https://manus.im/docs/introduction/welcome) is a workflow and AI-agent orchestration platform that lets users integrate custom APIs, define automation logic, and run LLM-powered tools inside a unified interface. Manus supports custom model backends (such as AI/ML API), prompt templates, request routing, secure secret storage, and visual debugging.
## Installation / Setup
### 1. Prerequisites
* **AI/ML API account** – sign up and create an API key at:
* [Dashboard](https://aimlapi.com/app/)
* [API Keys](https://aimlapi.com/app/keys/)
* **Manus account** – with access to **Settings → Integrations → Add custom API**.
***
### 2. Open the *Add custom API* Form
In Manus, go to:
> **Settings → Integrations → Add custom API**
This opens the configuration form.
***
### 3. Fill Out the Configuration
#### A) Name
Enter:
```c
AI/ML API
```
***
#### B) Icon (optional)
Paste this URL into the icon field:
{% code overflow="wrap" %}
```css
https://raw.githubusercontent.com/OctavianTheI/aimlapi-assets-devrel/main/aimlapi%20square%20Logo%20Icon.svg
```
{% endcode %}
***
#### C) Base URL & Auth Header
* **Base URL:**
```html
https://api.aimlapi.com
```
* **Authorization header (Manus will use the secret defined below):**
```python
Authorization: Bearer ${AIMLAPI_KEY}
```
***
#### D) Secrets
Create a secret to store your AI/ML API key:
* **Secret name:** `AIMLAPI_KEY`
* **Value:** your personal AI/ML API key from the AI/ML API dashboard.
***
#### E) Note (Request Templates)
Paste the following template into the **Note** field — Manus will use it as a reference for how to call AI/ML API endpoints:
{% code overflow="wrap" %}
```json
This custom API connects to https://api.aimlapi.com to access a variety of AI models.
The API key is stored in the AIMLAPI_KEY secret and must be sent as:
Authorization: Bearer ${AIMLAPI_KEY}
Base URL: https://api.aimlapi.com
## 1. Chat / Text & Code
POST /chat/completions
{ "model": "MODEL_NAME_HERE", "messages": [{"role":"user","content":"..."}] }
## 2. Text → Image
POST /images/generations
{ "model": "MODEL_NAME_HERE", "prompt": "Describe the image" }
## 3. Audio → Text (STT)
POST /audio/transcriptions
[file upload: "file"]
{ "model": "openai/whisper-1" }
## 4. Text → Speech (TTS)
POST /audio/speech
{ "model": "MODEL_NAME_HERE", "input": "Text to speak", "voice": "alloy" }
## 5. Image → Text (Vision)
POST /chat/completions
{ "model": "MODEL_NAME_HERE", "messages":[{"role":"user","content":[
{"type":"text","text":"Question"}, {"type":"image_url","image_url":{"url":"https://..."}}]}] }
## 6. Embeddings
POST /embeddings
{ "model": "MODEL_NAME_HERE", "input": "The text to embed" }
```
{% endcode %}
***
### 4. Finalise the Integration
Click **Add**. Manus will save the integration and show a confirmation message.
***
## Usage Examples
Once the custom API is added, you can select **AI/ML API** as a backend in Manus and use prompts such as:
* **Chat / Text & Code**
> “Write a poem about spring.”
* **Text → Image**
> “Draw a lonely lighthouse on a stormy coast using `openai/dall-e-3`.”
* **Embeddings**
> “Generate embeddings for this paragraph with `BAAI/bge-large-en-v1.5`.”
***
## Tips
* You can use either `https://api.aimlapi.com` or `https://api.aimlapi.com/v1` as the base URL.
* All requests must include:
```python
Authorization: Bearer ${AIMLAPI_KEY}
```
* AI/ML API supports a wide range of providers and models (chat, code, images, audio, vision, embeddings) with enterprise-grade rate limits and uptime.
***
## Helpful Links
* [Dashboard](https://aimlapi.com/app/)
* [API Keys](https://aimlapi.com/app/keys/)
* [Model browser](https://aimlapi.com/models/)
* [Docs](https://docs.aimlapi.com/)
Enjoy building with Manus + AI/ML API 🚀
