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

# List Providers

> Retrieve a list of all available AI providers. Results are cached for 5 minutes.

## Authentication

Requires an API key with `list_models` scope.

<ParamField header="x-api-key" type="string" required>
  Your API key with `list_models` scope.
</ParamField>

## Response

<ResponseField name="providers" type="array">
  List of available providers.

  <Expandable title="Provider Object">
    <ResponseField name="id" type="string">Unique provider identifier.</ResponseField>
    <ResponseField name="name" type="string">Display name of the provider.</ResponseField>
    <ResponseField name="description" type="string">Brief description of the provider.</ResponseField>
    <ResponseField name="logoUrl" type="string">URL to the provider's logo image.</ResponseField>
    <ResponseField name="website" type="string">Provider's official website URL.</ResponseField>
    <ResponseField name="color" type="string">Brand color hex code for UI display.</ResponseField>
    <ResponseField name="categories" type="array">List of model categories offered by this provider (e.g., `video`, `image`).</ResponseField>
    <ResponseField name="isActive" type="boolean">Whether the provider is currently active and accepting requests.</ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET https://api.muvi.video/v1/providers \
    -H "x-api-key: YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.muvi.video/v1/providers",
      headers={"x-api-key": "YOUR_API_KEY"}
  )

  data = response.json()
  for provider in data["providers"]:
      print(f"{provider['name']} - {', '.join(provider['categories'])}")
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch("https://api.muvi.video/v1/providers", {
    headers: { "x-api-key": "YOUR_API_KEY" }
  });

  const data = await response.json();
  data.providers.forEach(provider => {
    console.log(`${provider.name} - ${provider.categories.join(", ")}`);
  });
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "providers": [
      {
        "id": "google",
        "name": "Google",
        "description": "Google's AI video and image generation models",
        "logoUrl": "https://cdn.muvi.video/providers/google.png",
        "website": "https://ai.google",
        "color": "#4285F4",
        "categories": ["video", "image"],
        "isActive": true
      },
      {
        "id": "alibaba",
        "name": "Alibaba",
        "description": "Alibaba's Wan series video generation models",
        "logoUrl": "https://cdn.muvi.video/providers/alibaba.png",
        "website": "https://www.alibabacloud.com",
        "color": "#FF6A00",
        "categories": ["video"],
        "isActive": true
      }
    ]
  }
  ```
</ResponseExample>