1export const falIntegrationSpec = defineIntegration({
2	meta: {
3		key: 'ai-voice.fal',
4		version: '1.0.0',
5		category: 'ai-voice-tts',
6		title: 'Fal Chatterbox Text-to-Speech',
7		description:
8			'Fal integration for voice synthesis using Chatterbox text-to-speech models.',
9		domain: 'ai',
10		owners: ['platform.ai'],
11		tags: ['voice', 'tts', 'chatterbox'],
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.voice.tts', version: '1.0.0' }],
25	},
26	configSchema: {
27		schema: {
28			type: 'object',
29			properties: {
30				modelId: {
31					type: 'string',
32					description:
33						'Fal model endpoint identifier (e.g. fal-ai/chatterbox/text-to-speech).',
34				},
35				defaultVoiceUrl: {
36					type: 'string',
37					description:
38						'Optional reference audio URL used as default voice conditioning input.',
39				},
40				defaultExaggeration: {
41					type: 'number',
42					minimum: 0,
43					maximum: 1,
44					description: 'Optional default exaggeration value for speech output.',
45				},
46				defaultTemperature: {
47					type: 'number',
48					minimum: 0.05,
49					maximum: 2,
50					description: 'Optional default temperature for synthesis requests.',
51				},
52				defaultCfg: {
53					type: 'number',
54					minimum: 0.1,
55					maximum: 1,
56					description: 'Optional default cfg value for synthesis requests.',
57				},
58				pollIntervalMs: {
59					type: 'number',
60					description: 'Optional queue polling interval in milliseconds.',
61				},
62			},
63		},
64		example: {
65			modelId: 'fal-ai/chatterbox/text-to-speech',
66			defaultVoiceUrl:
67				'https://storage.googleapis.com/chatterbox-demo-samples/prompts/male_rickmorty.mp3',
68			defaultExaggeration: 0.25,
69			defaultTemperature: 0.7,
70			defaultCfg: 0.5,
71			pollIntervalMs: 1000,
72		},
73	},
74	secretSchema: {
75		schema: {
76			type: 'object',
77			required: ['apiKey'],
78			properties: {
79				apiKey: {
80					type: 'string',
81					description: 'Fal API key (FAL_KEY).',
82				},
83			},
84		},
85		example: {
86			apiKey: 'key-id:key-secret',
87		},
88	},
89	healthCheck: {
90		method: 'custom',
91		timeoutMs: 7000,
92	},
93	docsUrl: 'https://fal.ai/models/fal-ai/chatterbox/text-to-speech/api',
94	byokSetup: {
95		setupInstructions:
96			'Create a Fal API key and configure the desired voice model endpoint before connecting tenants.',
97		keyRotationSupported: false,
98		quotaTrackingSupported: true,
99	},
100});