1export const falImageIntegrationSpec = defineIntegration({
2	meta: {
3		key: 'ai-image.fal',
4		version: '1.0.0',
5		category: 'ai-image',
6		title: 'Fal Image Generation',
7		description:
8			'Fal integration for AI image generation using Flux and Stable Diffusion models.',
9		domain: 'ai',
10		owners: ['platform.ai'],
11		tags: ['image', 'generation', 'flux', 'stable-diffusion'],
12		stability: StabilityEnum.Experimental,
13	},
14	supportedModes: ['byok'],
15	transports: [
16		{ type: 'rest', baseUrl: 'https://fal.run' },
17		{ type: 'sdk', packageName: '@fal-ai/client' },
18	] satisfies IntegrationTransportConfig[],
19	preferredTransport: 'rest',
20	supportedAuthMethods: [
21		{ type: 'header', headerName: 'Authorization', valuePrefix: 'Key ' },
22	] satisfies IntegrationAuthConfig[],
23	capabilities: {
24		provides: [{ key: 'ai.image.generation', version: '1.0.0' }],
25	},
26	configSchema: {
27		schema: {
28			type: 'object',
29			properties: {
30				modelId: {
31					type: 'string',
32					description: 'Fal model endpoint (e.g. fal-ai/flux/dev).',
33				},
34				defaultFormat: {
35					type: 'string',
36					enum: ['png', 'jpg', 'webp'],
37				},
38				defaultGuidanceScale: {
39					type: 'number',
40					minimum: 1,
41					maximum: 20,
42				},
43			},
44		},
45		example: {
46			modelId: 'fal-ai/flux/dev',
47			defaultFormat: 'png',
48			defaultGuidanceScale: 7.5,
49		},
50	},
51	secretSchema: {
52		schema: {
53			type: 'object',
54			required: ['apiKey'],
55			properties: {
56				apiKey: {
57					type: 'string',
58					description: 'Fal API key (FAL_KEY).',
59				},
60			},
61		},
62		example: {
63			apiKey: 'key-id:key-secret',
64		},
65	},
66	healthCheck: {
67		method: 'custom',
68		timeoutMs: 7000,
69	},
70	docsUrl: 'https://fal.ai/models',
71	byokSetup: {
72		setupInstructions:
73			'Create a Fal API key and ensure image generation model access is enabled.',
74		keyRotationSupported: false,
75		quotaTrackingSupported: true,
76	},
77});