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