OSS-first docs

These docs teach the open system first: contracts, generated surfaces, runtimes, governance, and incremental adoption. Studio shows up as the operating layer on top, not as the source of truth.

ai-voice.gradium

Gradium integration for low-latency voice synthesis and voice catalog access.

  • Type: integration (integration)
  • Version: 1.0.0
  • Owners: platform.ai
  • Tags: voice, tts, realtime
  • File: packages/libs/contracts-spec/src/integrations/providers/gradium.ts
  • field.key.label
    ai-voice.gradium
    field.version.label
    1.0.0
    field.type.label
    integration (integration)
    field.title.label
    ai-voice.gradium
    field.description.label

    Gradium integration for low-latency voice synthesis and voice catalog access.

  • Type: integration (integration)
  • Version: 1.0.0
  • Owners: platform.ai
  • Tags: voice, tts, realtime
  • File: packages/libs/contracts-spec/src/integrations/providers/gradium.ts
  • field.tags.label
    voice,tts,realtime
    field.owners.label
    platform.ai
    field.stability.label

    Gradium integration for low-latency voice synthesis and voice catalog access.

    Source Definition

    export const gradiumIntegrationSpec = defineIntegration({
      meta: {
        key: 'ai-voice.gradium',
        version: '1.0.0',
        category: 'ai-voice',
        title: 'Gradium Text-to-Speech',
        description:
          'Gradium integration for low-latency voice synthesis and voice catalog access.',
        domain: 'ai',
        owners: ['platform.ai'],
        tags: ['voice', 'tts', 'realtime'],
        stability: StabilityEnum.Experimental,
      },
      supportedModes: ['byok'],
      capabilities: {
        provides: [{ key: 'ai.voice.synthesis', version: '1.0.0' }],
      },
      configSchema: {
        schema: {
          type: 'object',
          properties: {
            defaultVoiceId: {
              type: 'string',
              description: 'Optional default voice identifier used for synthesis.',
            },
            region: {
              type: 'string',
              enum: ['eu', 'us'],
              description: 'Gradium region used by the SDK (eu or us).',
            },
            baseUrl: {
              type: 'string',
              description:
                'Optional API base URL override for private routing or proxies.',
            },
            timeoutMs: {
              type: 'number',
              description: 'Optional request timeout in milliseconds.',
            },
            outputFormat: {
              type: 'string',
              enum: [
                'wav',
                'pcm',
                'opus',
                'ulaw_8000',
                'alaw_8000',
                'pcm_16000',
                'pcm_24000',
              ],
              description:
                'Optional default output format used when no format is specified.',
            },
          },
        },
        example: {
          defaultVoiceId: 'YTpq7expH9539ERJ',
          region: 'eu',
          timeoutMs: 15000,
          outputFormat: 'wav',
        },
      },
      secretSchema: {
        schema: {
          type: 'object',
          required: ['apiKey'],
          properties: {
            apiKey: {
              type: 'string',
              description: 'Gradium API key with TTS access.',
            },
          },
        },
        example: {
          apiKey: 'gd_***',
        },
      },
      healthCheck: {
        method: 'custom',
        timeoutMs: 5000,
      },
      docsUrl: 'https://gradium.ai/api_docs.html',
      byokSetup: {
        setupInstructions:
          'Create a Gradium API key, select the target region, and store credentials in your tenant secret provider.',
      },
    });