> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mountsea.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

# Mountsea API

Mountsea API is a premium microservice gateway for official-quality AI model access across image, video, audio, transcription, and chat-style capabilities. It is designed for production workloads that need stable routing, broad model coverage, and one consistent async task pattern.

<CardGroup cols={3}>
  <Card title="Official-Quality Models" icon="award">
    Access flagship model families such as Veo 3.1, Kling v3, WAN 2.7, Seedance 2.0, Nano Banana, GPT Image, ElevenLabs Music, and Whisper-style transcription through one API surface.
  </Card>

  <Card title="Production Stable" icon="shield-check">
    Submit tasks through Mountsea's managed gateway, poll a standard Task object, and use optional webhooks for terminal status callbacks.
  </Card>

  <Card title="Full-Platform Coverage" icon="grid-2">
    Discover every available endpoint from the marketplace instead of hard-coding provider-specific SDKs, schemas, and task formats.
  </Card>
</CardGroup>

## Core Flow

Every generation endpoint follows the same async pattern:

<Steps>
  <Step title="Discover endpoints">
    Call `GET /ms/v1/endpoints` to list marketplace endpoints. Filter by `capability` (`image`, `video`, `audio`, `chat`, `transcribe`, `embeddings`) or by `tag`.
  </Step>

  <Step title="Inspect the schema">
    Call `GET /ms/v1/endpoints/{endpoint_slug}` to read the endpoint's `input_schema`, `output_schema`, and ready-to-copy `examples`.
  </Step>

  <Step title="Submit a task">
    Call `POST /ms/v1/run/{endpoint_slug}` with `{ "input": { ... } }`. The response is a standard Task object with `status: "queued"`.
  </Step>

  <Step title="Poll or receive a webhook">
    Poll `GET /ms/v1/tasks/{task_id}` until `status` is `succeeded`, `failed`, `timeout`, or `canceled`. You can also pass `webhook_url` when submitting a task.
  </Step>
</Steps>

## Base URL

```bash theme={null}
https://api.mountsea.ai
```

All public endpoints require Bearer token authentication:

```bash theme={null}
Authorization: Bearer your-api-key
```

## Standard Request Body

Use `input` for the endpoint parameters. Media URLs, prompts, model options, and generation controls all live inside this object.

```json theme={null}
{
  "input": {
    "prompt": "Cinematic drone shot flying through ancient stone ruins at golden hour",
    "duration": "8s",
    "resolution": "720p",
    "aspect_ratio": "16:9"
  },
  "webhook_url": "https://your.app/webhooks/mountsea"
}
```

## Standard Task Object

Task responses share the same top-level fields:

| Field        | Description                                                                   |
| ------------ | ----------------------------------------------------------------------------- |
| `task_id`    | Unique Mountsea task ID.                                                      |
| `endpoint`   | Endpoint slug that was executed.                                              |
| `model`      | Model selected by the endpoint.                                               |
| `capability` | Capability category such as `image`, `video`, or `audio`.                     |
| `mode`       | Endpoint mode such as `text-to-video`, `image-to-video`, or `music-generate`. |
| `status`     | `queued`, `processing`, `succeeded`, `failed`, `timeout`, or `canceled`.      |
| `output`     | Result payload when the task succeeds.                                        |
| `error`      | Error details when the task fails or times out.                               |

## Management Endpoints

* [Submit Async Task](run) - run any marketplace endpoint by slug.
* [Poll Task Result](task) - read task status and output.
* [Cancel Task](cancel) - cancel a non-terminal task.
* [List Endpoints](endpoints) - browse the marketplace.
* [Endpoint Detail](endpoint-detail) - inspect schemas and examples.

## Endpoint Catalog

Each route below has a dedicated reference page with its full request body (`input` parameters) and response structure (`output`). The endpoint slug is the path after `/ms/v1/run/`.

### Video

| Endpoint Slug                                    | Route                                                            | Page                                                                                               |
| ------------------------------------------------ | ---------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| `google/veo-3.1/text-to-video`                   | `POST /ms/v1/run/google/veo-3.1/text-to-video`                   | [Veo 3.1 - Text to Video](endpoints/google-veo-3.1-text-to-video)                                  |
| `google/veo-3.1/image-to-video`                  | `POST /ms/v1/run/google/veo-3.1/image-to-video`                  | [Veo 3.1 - Image to Video](endpoints/google-veo-3.1-image-to-video)                                |
| `google/veo-3.1/reference-to-video`              | `POST /ms/v1/run/google/veo-3.1/reference-to-video`              | [Veo 3.1 - Reference to Video](endpoints/google-veo-3.1-reference-to-video)                        |
| `google/veo-3.1/first-last-frame-to-video`       | `POST /ms/v1/run/google/veo-3.1/first-last-frame-to-video`       | [Veo 3.1 - First-Last Frame](endpoints/google-veo-3.1-first-last-frame-to-video)                   |
| `google/veo-3.1/fast/text-to-video`              | `POST /ms/v1/run/google/veo-3.1/fast/text-to-video`              | [Veo 3.1 Fast - Text to Video](endpoints/google-veo-3.1-fast-text-to-video)                        |
| `google/veo-3.1/fast/image-to-video`             | `POST /ms/v1/run/google/veo-3.1/fast/image-to-video`             | [Veo 3.1 Fast - Image to Video](endpoints/google-veo-3.1-fast-image-to-video)                      |
| `google/veo-3.1/fast/reference-to-video`         | `POST /ms/v1/run/google/veo-3.1/fast/reference-to-video`         | [Veo 3.1 Fast - Reference to Video](endpoints/google-veo-3.1-fast-reference-to-video)              |
| `google/veo-3.1/lite/text-to-video`              | `POST /ms/v1/run/google/veo-3.1/lite/text-to-video`              | [Veo 3.1 Lite - Text to Video](endpoints/google-veo-3.1-lite-text-to-video)                        |
| `google/veo-3.1/lite/image-to-video`             | `POST /ms/v1/run/google/veo-3.1/lite/image-to-video`             | [Veo 3.1 Lite - Image to Video](endpoints/google-veo-3.1-lite-image-to-video)                      |
| `google/veo-3/text-to-video`                     | `POST /ms/v1/run/google/veo-3/text-to-video`                     | [Veo 3 - Text to Video](endpoints/google-veo-3-text-to-video)                                      |
| `google/veo-3/image-to-video`                    | `POST /ms/v1/run/google/veo-3/image-to-video`                    | [Veo 3 - Image to Video](endpoints/google-veo-3-image-to-video)                                    |
| `kuaishou/kling-v3/standard/text-to-video`       | `POST /ms/v1/run/kuaishou/kling-v3/standard/text-to-video`       | [Kling v3 Standard - Text to Video](endpoints/kuaishou-kling-v3-standard-text-to-video)            |
| `kuaishou/kling-v3/standard/image-to-video`      | `POST /ms/v1/run/kuaishou/kling-v3/standard/image-to-video`      | [Kling v3 Standard - Image to Video](endpoints/kuaishou-kling-v3-standard-image-to-video)          |
| `kuaishou/kling-v3/pro/text-to-video`            | `POST /ms/v1/run/kuaishou/kling-v3/pro/text-to-video`            | [Kling v3 Pro - Text to Video](endpoints/kuaishou-kling-v3-pro-text-to-video)                      |
| `kuaishou/kling-v3/pro/image-to-video`           | `POST /ms/v1/run/kuaishou/kling-v3/pro/image-to-video`           | [Kling v3 Pro - Image to Video](endpoints/kuaishou-kling-v3-pro-image-to-video)                    |
| `alibaba/wan-2.7/text-to-video`                  | `POST /ms/v1/run/alibaba/wan-2.7/text-to-video`                  | [WAN 2.7 - Text to Video](endpoints/alibaba-wan-2.7-text-to-video)                                 |
| `alibaba/wan-2.7/image-to-video`                 | `POST /ms/v1/run/alibaba/wan-2.7/image-to-video`                 | [WAN 2.7 - Image to Video](endpoints/alibaba-wan-2.7-image-to-video)                               |
| `alibaba/wan-2.7/reference-to-video`             | `POST /ms/v1/run/alibaba/wan-2.7/reference-to-video`             | [WAN 2.7 - Reference to Video](endpoints/alibaba-wan-2.7-reference-to-video)                       |
| `alibaba/wan-2.7/edit-video`                     | `POST /ms/v1/run/alibaba/wan-2.7/edit-video`                     | [WAN 2.7 - Edit Video](endpoints/alibaba-wan-2.7-edit-video)                                       |
| `bytedance/seedance-2.0/text-to-video`           | `POST /ms/v1/run/bytedance/seedance-2.0/text-to-video`           | [Seedance 2.0 - Text to Video](endpoints/bytedance-seedance-2.0-text-to-video)                     |
| `bytedance/seedance-2.0/image-to-video`          | `POST /ms/v1/run/bytedance/seedance-2.0/image-to-video`          | [Seedance 2.0 - Image to Video](endpoints/bytedance-seedance-2.0-image-to-video)                   |
| `bytedance/seedance-2.0/reference-to-video`      | `POST /ms/v1/run/bytedance/seedance-2.0/reference-to-video`      | [Seedance 2.0 - Reference to Video](endpoints/bytedance-seedance-2.0-reference-to-video)           |
| `bytedance/seedance-2.0/fast/text-to-video`      | `POST /ms/v1/run/bytedance/seedance-2.0/fast/text-to-video`      | [Seedance 2.0 Fast - Text to Video](endpoints/bytedance-seedance-2.0-fast-text-to-video)           |
| `bytedance/seedance-2.0/fast/image-to-video`     | `POST /ms/v1/run/bytedance/seedance-2.0/fast/image-to-video`     | [Seedance 2.0 Fast - Image to Video](endpoints/bytedance-seedance-2.0-fast-image-to-video)         |
| `bytedance/seedance-2.0/fast/reference-to-video` | `POST /ms/v1/run/bytedance/seedance-2.0/fast/reference-to-video` | [Seedance 2.0 Fast - Reference to Video](endpoints/bytedance-seedance-2.0-fast-reference-to-video) |

### Image

| Endpoint Slug                          | Route                                                  | Page                                                                              |
| -------------------------------------- | ------------------------------------------------------ | --------------------------------------------------------------------------------- |
| `google/nano-banana/text-to-image`     | `POST /ms/v1/run/google/nano-banana/text-to-image`     | [Nano Banana - Text to Image](endpoints/google-nano-banana-text-to-image)         |
| `google/nano-banana/edit`              | `POST /ms/v1/run/google/nano-banana/edit`              | [Nano Banana - Edit](endpoints/google-nano-banana-edit)                           |
| `google/nano-banana-2/text-to-image`   | `POST /ms/v1/run/google/nano-banana-2/text-to-image`   | [Nano Banana 2 - Text to Image](endpoints/google-nano-banana-2-text-to-image)     |
| `google/nano-banana-2/edit`            | `POST /ms/v1/run/google/nano-banana-2/edit`            | [Nano Banana 2 - Edit](endpoints/google-nano-banana-2-edit)                       |
| `google/nano-banana-pro/text-to-image` | `POST /ms/v1/run/google/nano-banana-pro/text-to-image` | [Nano Banana Pro - Text to Image](endpoints/google-nano-banana-pro-text-to-image) |
| `google/nano-banana-pro/edit`          | `POST /ms/v1/run/google/nano-banana-pro/edit`          | [Nano Banana Pro - Edit](endpoints/google-nano-banana-pro-edit)                   |
| `openai/gpt-image-2/text-to-image`     | `POST /ms/v1/run/openai/gpt-image-2/text-to-image`     | [GPT Image 2 - Text to Image](endpoints/openai-gpt-image-2-text-to-image)         |
| `openai/gpt-image-2/edit`              | `POST /ms/v1/run/openai/gpt-image-2/edit`              | [GPT Image 2 - Edit](endpoints/openai-gpt-image-2-edit)                           |

### Audio

| Endpoint Slug                                | Route                                                        | Page                                                                                |
| -------------------------------------------- | ------------------------------------------------------------ | ----------------------------------------------------------------------------------- |
| `elevenlabs/elevenlabs-music/music-generate` | `POST /ms/v1/run/elevenlabs/elevenlabs-music/music-generate` | [ElevenLabs Music - Generate](endpoints/elevenlabs-elevenlabs-music-music-generate) |