openclaw/extensions/fal/provider-contract-api.ts

// Fal API module exposes the plugin public contract.
import type { ProviderPlugin } from "openclaw/plugin-sdk/provider-model-shared";

const PROVIDER_ID = "fal";

export function createFalProvider(): ProviderPlugin {
  return {
    id: PROVIDER_ID,
    label: "fal",
    docsPath: "/providers/models",
    envVars: ["FAL_KEY"],
    auth: [
      {
        id: "api-key",
        kind: "api_key",
        label: "fal API key",
        hint: "Image, video, and music generation API key",
        run: async () => ({ profiles: [] }),
        wizard: {
          choiceId: "fal-api-key",
          choiceLabel: "fal API key",
          choiceHint: "Image, video, and music generation API key",
          groupId: "fal",
          groupLabel: "fal",
          groupHint: "Image, video, and music generation",
          onboardingScopes: ["image-generation", "music-generation"],
        },
      },
    ],
  };
}