transloadit 4.14.0 → 5.0.0

package/src/alphalib/types/robots/assembly-savejson.ts

@@ -2,12 +2,10 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 
 import { z } from 'zod'
 
-import { interpolateRobot, robotBase } from './_instructions-primitives.ts'
+import { interpolateRobot, robotBase, robotProcessingMeta } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  bytescount: 0,
-  discount_factor: 0,
-  discount_pct: 100,
+  ...robotProcessingMeta,
   example_code: {
     steps: {
       save_json: {
@@ -16,26 +14,19 @@ export const meta: RobotMetaInput = {
     },
   },
   example_code_description: 'Save Assembly result data as JSON:',
-  minimum_charge: 0,
-  output_factor: 1,
   override_lvl1: 'File Exporting',
   purpose_sentence: 'exports Assembly status data as JSON',
   purpose_verb: 'export',
   purpose_word: 'Assembly status',
   purpose_words: 'Export Assembly status JSON',
   service_slug: 'file-exporting',
-  slot_count: 5,
   title: 'Export Assembly status JSON',
   typical_file_size_mb: 0.1,
-  typical_file_type: 'file',
   name: 'AssemblySavejsonRobot',
   priceFactor: 0,
   queueSlotCount: 5,
-  isAllowedForUrlTransform: true,
   trackOutputFileSize: false,
   isInternal: true,
-  stage: 'ga',
-  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
 }
 
 export const robotAssemblySavejsonInstructionsSchema = robotBase

package/src/alphalib/types/robots/audio-artwork.ts

@@ -1,52 +1,37 @@
-import type { RobotMetaInput } from './_instructions-primitives.ts'
+import type {
+  RobotDefinition,
+  RobotMetaInput,
+  RobotSchemaVariantTypes,
+} from './_instructions-primitives.ts'
 
 import { z } from 'zod'
 
+import { describeApiParameter } from '../apiParameterDescription.ts'
 import { stackVersions } from '../stackVersions.ts'
 import {
-  interpolateRobot,
+  createProcessingExample,
+  defineRobot,
+  robotAudioEncodingMeta,
   robotBase,
   robotFFmpegAudio,
   robotUse,
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  bytescount: 1,
-  discount_factor: 1,
-  discount_pct: 0,
-  example_code: {
-    steps: {
-      artwork_extracted: {
-        robot: '/audio/artwork',
-        use: ':original',
-        ffmpeg_stack: stackVersions.ffmpeg.recommendedVersion,
-      },
-    },
-  },
+  ...robotAudioEncodingMeta,
+  example_code: createProcessingExample('artwork_extracted', '/audio/artwork', {
+    ffmpeg_stack: stackVersions.ffmpeg.recommendedVersion,
+  }),
   example_code_description: 'Extract embedded cover artwork from uploaded audio files:',
-  minimum_charge: 0,
-  output_factor: 0.8,
-  override_lvl1: 'Audio Encoding',
   purpose_sentence:
     'extracts embedded cover artwork from audio files or inserts a new cover image into them. Extracted artwork can be piped into other Steps such as /image/resize. Use `method: "insert"` to embed artwork into audio files like MP3, FLAC, or M4A',
   purpose_verb: 'extract',
   purpose_word: 'extract/insert artwork',
   purpose_words: 'Extract or insert audio artwork',
-  service_slug: 'audio-encoding',
-  slot_count: 20,
   title: 'Extract or insert audio artwork',
-  typical_file_size_mb: 3.8,
-  typical_file_type: 'audio file',
   uses_tools: ['ffmpeg'],
   name: 'AudioArtworkRobot',
   priceFactor: 1,
-  queueSlotCount: 20,
-  isAllowedForUrlTransform: true,
-  trackOutputFileSize: true,
-  applyCommunityPlanMediaTrim: true,
-  isInternal: false,
-  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
-  stage: 'ga',
 }
 
 export const robotAudioArtworkInstructionsSchema = robotBase
@@ -66,43 +51,32 @@ For insertion, provide both an audio file (as \`"audio"\`) and an image file (as
       .describe(`
 What should be done with the audio file. A value of \`"extract"\` means audio artwork will be extracted. A value of \`"insert"\` means the provided image will be inserted as audio artwork.
 `),
-    change_format_if_necessary: z
-      .boolean()
-      .default(false)
-      .describe(`
+    change_format_if_necessary: describeApiParameter(
+      'audioArtworkChangeFormatIfNecessary',
+      z.boolean().default(false),
+      `
 Whether the original file should be transcoded into a new format if there is an issue with the original file.
-`),
+`,
+    ),
   })
   .strict()
 
-export const robotAudioArtworkInstructionsWithHiddenFieldsSchema =
-  robotAudioArtworkInstructionsSchema.extend({
-    result: z
-      .union([z.literal('debug'), robotAudioArtworkInstructionsSchema.shape.result])
-      .optional(),
-  })
-
-export type RobotAudioArtworkInstructions = z.infer<typeof robotAudioArtworkInstructionsSchema>
-export type RobotAudioArtworkInstructionsWithHiddenFields = z.infer<
-  typeof robotAudioArtworkInstructionsWithHiddenFieldsSchema
->
+export const robotDefinition: RobotDefinition<typeof robotAudioArtworkInstructionsSchema.shape> =
+  defineRobot(meta, robotAudioArtworkInstructionsSchema)
 
-export const interpolatableRobotAudioArtworkInstructionsSchema = interpolateRobot(
-  robotAudioArtworkInstructionsSchema,
-)
-export type InterpolatableRobotAudioArtworkInstructions =
-  InterpolatableRobotAudioArtworkInstructionsInput
+export const {
+  withHiddenFields: robotAudioArtworkInstructionsWithHiddenFieldsSchema,
+  interpolatable: interpolatableRobotAudioArtworkInstructionsSchema,
+  interpolatableWithHiddenFields: interpolatableRobotAudioArtworkInstructionsWithHiddenFieldsSchema,
+} = robotDefinition
 
-export type InterpolatableRobotAudioArtworkInstructionsInput = z.input<
-  typeof interpolatableRobotAudioArtworkInstructionsSchema
->
+type Instructions = RobotSchemaVariantTypes<typeof robotDefinition>
 
-export const interpolatableRobotAudioArtworkInstructionsWithHiddenFieldsSchema = interpolateRobot(
-  robotAudioArtworkInstructionsWithHiddenFieldsSchema,
-)
-export type InterpolatableRobotAudioArtworkInstructionsWithHiddenFields = z.infer<
-  typeof interpolatableRobotAudioArtworkInstructionsWithHiddenFieldsSchema
->
-export type InterpolatableRobotAudioArtworkInstructionsWithHiddenFieldsInput = z.input<
-  typeof interpolatableRobotAudioArtworkInstructionsWithHiddenFieldsSchema
->
+export type RobotAudioArtworkInstructions = Instructions['output']
+export type RobotAudioArtworkInstructionsWithHiddenFields = Instructions['hiddenOutput']
+export type InterpolatableRobotAudioArtworkInstructions = Instructions['interpolatableInput']
+export type InterpolatableRobotAudioArtworkInstructionsInput = Instructions['interpolatableInput']
+export type InterpolatableRobotAudioArtworkInstructionsWithHiddenFields =
+  Instructions['interpolatableHiddenOutput']
+export type InterpolatableRobotAudioArtworkInstructionsWithHiddenFieldsInput =
+  Instructions['interpolatableHiddenInput']

package/src/alphalib/types/robots/audio-concat.ts

@@ -1,4 +1,4 @@
-import type { RobotMetaInput } from './_instructions-primitives.ts'
+import type { RobotMetaInput, RobotSchemaPair } from './_instructions-primitives.ts'
 
 import { z } from 'zod'
 
@@ -7,17 +7,17 @@ import {
   bitrateSchema,
   inputSortBySchema,
   interpolateRobot,
+  robotAudioEncodingMeta,
   robotBase,
   robotFFmpegAudio,
+  robotParameterDocs,
   robotUse,
   robotUseWithHiddenFields,
   sampleRateSchema,
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  bytescount: 4,
-  discount_factor: 0.25,
-  discount_pct: 75,
+  ...robotAudioEncodingMeta,
   example_code: {
     steps: {
       concatenated: {
@@ -47,28 +47,13 @@ export const meta: RobotMetaInput = {
   },
   example_code_description:
     'If you have a form with 3 file input fields and want to concatenate the uploaded audios in a specific order, instruct Transloadit using the `name` attribute of each input field. Use this attribute as the value for the `fields` key in the JSON, and set `as` to `audio_[[index]]`. Transloadit will concatenate the files based on the ascending index order:',
-  minimum_charge: 0,
-  output_factor: 0.8,
-  override_lvl1: 'Audio Encoding',
   purpose_sentence: 'concatenates several audio files together',
   purpose_verb: 'concatenate',
   purpose_word: 'concatenate',
   purpose_words: 'Concatenate audio',
-  service_slug: 'audio-encoding',
-  slot_count: 20,
   title: 'Concatenate audio',
-  typical_file_size_mb: 3.8,
-  typical_file_type: 'audio file',
   uses_tools: ['ffmpeg'],
   name: 'AudioConcatRobot',
-  priceFactor: 4,
-  queueSlotCount: 20,
-  isAllowedForUrlTransform: true,
-  trackOutputFileSize: true,
-  applyCommunityPlanMediaTrim: true,
-  isInternal: false,
-  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
-  stage: 'ga',
 }
 
 export const robotAudioConcatInstructionsSchema = robotBase
@@ -82,12 +67,10 @@ export const robotAudioConcatInstructionsSchema = robotBase
     robot: z.literal('/audio/concat').describe(`
 This Robot can concatenate an almost infinite number of audio files.
 `),
-    bitrate: bitrateSchema.optional().describe(`
-Bit rate of the resulting audio file, in bits per second. If not specified will default to the bit rate of the input audio file.
-`),
-    sample_rate: sampleRateSchema.optional().describe(`
-Sample rate of the resulting audio file, in Hertz. If not specified will default to the sample rate of the input audio file.
-`),
+    bitrate: bitrateSchema.optional().describe(robotParameterDocs.audio_bitrate.description),
+    sample_rate: sampleRateSchema
+      .optional()
+      .describe(robotParameterDocs.audio_sample_rate.description),
     audio_fade_seconds: z
       .number()
       .default(1)
@@ -143,3 +126,12 @@ export type InterpolatableRobotAudioConcatInstructionsWithHiddenFields = z.infer
 export type InterpolatableRobotAudioConcatInstructionsWithHiddenFieldsInput = z.input<
   typeof interpolatableRobotAudioConcatInstructionsWithHiddenFieldsSchema
 >
+
+export const robotDefinition: RobotSchemaPair<
+  typeof interpolatableRobotAudioConcatInstructionsSchema,
+  typeof interpolatableRobotAudioConcatInstructionsWithHiddenFieldsSchema
+> = {
+  meta,
+  interpolatable: interpolatableRobotAudioConcatInstructionsSchema,
+  interpolatableWithHiddenFields: interpolatableRobotAudioConcatInstructionsWithHiddenFieldsSchema,
+}

package/src/alphalib/types/robots/audio-encode.ts

@@ -1,56 +1,40 @@
-import type { RobotMetaInput } from './_instructions-primitives.ts'
+import type {
+  RobotDefinition,
+  RobotMetaInput,
+  RobotSchemaVariantTypes,
+} from './_instructions-primitives.ts'
 
 import { z } from 'zod'
 
 import { stackVersions } from '../stackVersions.ts'
 import {
   bitrateSchema,
-  interpolateRobot,
+  createProcessingExample,
+  defineRobot,
+  robotAudioEncodingMeta,
   robotBase,
   robotFFmpegAudio,
+  robotParameterDocs,
   robotUse,
   sampleRateSchema,
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  bytescount: 4,
-  discount_factor: 0.25,
-  discount_pct: 75,
-  example_code: {
-    steps: {
-      mp3_encoded: {
-        robot: '/audio/encode',
-        use: ':original',
-        preset: 'mp3',
-        bitrate: 256000,
-        ffmpeg_stack: stackVersions.ffmpeg.recommendedVersion,
-      },
-    },
-  },
+  ...robotAudioEncodingMeta,
+  example_code: createProcessingExample('mp3_encoded', '/audio/encode', {
+    preset: 'mp3',
+    bitrate: 256000,
+    ffmpeg_stack: stackVersions.ffmpeg.recommendedVersion,
+  }),
   example_code_description: 'Encode uploaded audio to MP3 format at a 256 kbps bitrate:',
-  minimum_charge: 0,
-  output_factor: 0.8,
-  override_lvl1: 'Audio Encoding',
   purpose_sentence:
     'converts audio files into all kinds of formats for you. We provide encoding presets for the most common formats',
   purpose_verb: 'encode',
   purpose_word: 'encode',
   purpose_words: 'Encode audio',
-  service_slug: 'audio-encoding',
-  slot_count: 20,
   title: 'Encode audio',
-  typical_file_size_mb: 3.8,
-  typical_file_type: 'audio file',
   uses_tools: ['ffmpeg'],
   name: 'AudioEncodeRobot',
-  priceFactor: 4,
-  queueSlotCount: 20,
-  isAllowedForUrlTransform: true,
-  trackOutputFileSize: true,
-  applyCommunityPlanMediaTrim: true,
-  isInternal: false,
-  stage: 'ga',
-  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
 }
 
 export const robotAudioEncodeInstructionsSchema = robotBase
@@ -62,43 +46,29 @@ export const robotAudioEncodeInstructionsSchema = robotBase
       .optional()
       .describe('Whether the results of this Step should be present in the Assembly Status JSON'),
     robot: z.literal('/audio/encode'),
-    bitrate: bitrateSchema.optional().describe(`
-Bit rate of the resulting audio file, in bits per second. If not specified will default to the bit rate of the input audio file.
-`),
-    sample_rate: sampleRateSchema.optional().describe(`
-Sample rate of the resulting audio file, in Hertz. If not specified will default to the sample rate of the input audio file.
-`),
+    bitrate: bitrateSchema.optional().describe(robotParameterDocs.audio_bitrate.description),
+    sample_rate: sampleRateSchema
+      .optional()
+      .describe(robotParameterDocs.audio_sample_rate.description),
   })
   .strict()
 
-export const robotAudioEncodeInstructionsWithHiddenFieldsSchema =
-  robotAudioEncodeInstructionsSchema.extend({
-    result: z
-      .union([z.literal('debug'), robotAudioEncodeInstructionsSchema.shape.result])
-      .optional(),
-  })
-
-export type RobotAudioEncodeInstructions = z.infer<typeof robotAudioEncodeInstructionsSchema>
-export type RobotAudioEncodeInstructionsWithHiddenFields = z.infer<
-  typeof robotAudioEncodeInstructionsWithHiddenFieldsSchema
->
+export const robotDefinition: RobotDefinition<typeof robotAudioEncodeInstructionsSchema.shape> =
+  defineRobot(meta, robotAudioEncodeInstructionsSchema)
 
-export const interpolatableRobotAudioEncodeInstructionsSchema = interpolateRobot(
-  robotAudioEncodeInstructionsSchema,
-)
-export type InterpolatableRobotAudioEncodeInstructions =
-  InterpolatableRobotAudioEncodeInstructionsInput
+export const {
+  withHiddenFields: robotAudioEncodeInstructionsWithHiddenFieldsSchema,
+  interpolatable: interpolatableRobotAudioEncodeInstructionsSchema,
+  interpolatableWithHiddenFields: interpolatableRobotAudioEncodeInstructionsWithHiddenFieldsSchema,
+} = robotDefinition
 
-export type InterpolatableRobotAudioEncodeInstructionsInput = z.input<
-  typeof interpolatableRobotAudioEncodeInstructionsSchema
->
+type Instructions = RobotSchemaVariantTypes<typeof robotDefinition>
 
-export const interpolatableRobotAudioEncodeInstructionsWithHiddenFieldsSchema = interpolateRobot(
-  robotAudioEncodeInstructionsWithHiddenFieldsSchema,
-)
-export type InterpolatableRobotAudioEncodeInstructionsWithHiddenFields = z.infer<
-  typeof interpolatableRobotAudioEncodeInstructionsWithHiddenFieldsSchema
->
-export type InterpolatableRobotAudioEncodeInstructionsWithHiddenFieldsInput = z.input<
-  typeof interpolatableRobotAudioEncodeInstructionsWithHiddenFieldsSchema
->
+export type RobotAudioEncodeInstructions = Instructions['output']
+export type RobotAudioEncodeInstructionsWithHiddenFields = Instructions['hiddenOutput']
+export type InterpolatableRobotAudioEncodeInstructions = Instructions['interpolatableInput']
+export type InterpolatableRobotAudioEncodeInstructionsInput = Instructions['interpolatableInput']
+export type InterpolatableRobotAudioEncodeInstructionsWithHiddenFields =
+  Instructions['interpolatableHiddenOutput']
+export type InterpolatableRobotAudioEncodeInstructionsWithHiddenFieldsInput =
+  Instructions['interpolatableHiddenInput']

package/src/alphalib/types/robots/audio-loop.ts

@@ -1,56 +1,40 @@
-import type { RobotMetaInput } from './_instructions-primitives.ts'
+import type {
+  RobotDefinition,
+  RobotMetaInput,
+  RobotSchemaVariantTypes,
+} from './_instructions-primitives.ts'
 
 import { z } from 'zod'
 
 import { stackVersions } from '../stackVersions.ts'
 import {
   bitrateSchema,
-  interpolateRobot,
+  createProcessingExample,
+  defineRobot,
+  robotAudioEncodingMeta,
   robotBase,
   robotFFmpegAudio,
+  robotParameterDocs,
   robotUse,
   sampleRateSchema,
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  bytescount: 4,
-  discount_factor: 0.25,
-  discount_pct: 75,
-  example_code: {
-    steps: {
-      looped: {
-        robot: '/audio/loop',
-        use: ':original',
-        duration: 300,
-        ffmpeg_stack: stackVersions.ffmpeg.recommendedVersion,
-      },
-    },
-  },
+  ...robotAudioEncodingMeta,
+  example_code: createProcessingExample('looped', '/audio/loop', {
+    duration: 300,
+    ffmpeg_stack: stackVersions.ffmpeg.recommendedVersion,
+  }),
   example_code_description: 'Loop uploaded audio to achieve a target duration of 300 seconds:',
   marketing_intro:
     'Whether you’re producing beats, white-noise, or just empty segments as fillers between audio tracks that you’re to stringing together with [🤖/audio/concat](/docs/robots/audio-concat/), [🤖/audio/loop](/docs/robots/audio-loop/) has got your back.',
-  minimum_charge: 0,
-  output_factor: 0.8,
-  override_lvl1: 'Audio Encoding',
   purpose_sentence: 'loops one audio file as often as is required to match a given duration',
   purpose_verb: 'loop',
   purpose_word: 'loop',
   purpose_words: 'Loop audio',
-  service_slug: 'audio-encoding',
-  slot_count: 20,
   title: 'Loop audio',
-  typical_file_size_mb: 3.8,
-  typical_file_type: 'audio file',
   uses_tools: ['ffmpeg'],
   name: 'AudioLoopRobot',
-  priceFactor: 4,
-  queueSlotCount: 20,
-  isAllowedForUrlTransform: true,
-  trackOutputFileSize: true,
-  applyCommunityPlanMediaTrim: true,
-  isInternal: false,
-  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
-  stage: 'ga',
 }
 
 export const robotAudioLoopInstructionsSchema = robotBase
@@ -58,12 +42,10 @@ export const robotAudioLoopInstructionsSchema = robotBase
   .merge(robotFFmpegAudio)
   .extend({
     robot: z.literal('/audio/loop'),
-    bitrate: bitrateSchema.optional().describe(`
-Bit rate of the resulting audio file, in bits per second. If not specified will default to the bit rate of the input audio file.
-`),
-    sample_rate: sampleRateSchema.optional().describe(`
-Sample rate of the resulting audio file, in Hertz. If not specified will default to the sample rate of the input audio file.
-`),
+    bitrate: bitrateSchema.optional().describe(robotParameterDocs.audio_bitrate.description),
+    sample_rate: sampleRateSchema
+      .optional()
+      .describe(robotParameterDocs.audio_sample_rate.description),
     duration: z
       .number()
       .default(60)
@@ -73,31 +55,22 @@ Target duration for the whole process in seconds. The <dfn>Robot</dfn> will loop
   })
   .strict()
 
-export const robotAudioLoopInstructionsWithHiddenFieldsSchema =
-  robotAudioLoopInstructionsSchema.extend({
-    result: z.union([z.literal('debug'), robotAudioLoopInstructionsSchema.shape.result]).optional(),
-  })
-
-export type RobotAudioLoopInstructions = z.infer<typeof robotAudioLoopInstructionsSchema>
-export type RobotAudioLoopInstructionsWithHiddenFields = z.infer<
-  typeof robotAudioLoopInstructionsWithHiddenFieldsSchema
->
+export const robotDefinition: RobotDefinition<typeof robotAudioLoopInstructionsSchema.shape> =
+  defineRobot(meta, robotAudioLoopInstructionsSchema)
 
-export const interpolatableRobotAudioLoopInstructionsSchema = interpolateRobot(
-  robotAudioLoopInstructionsSchema,
-)
-export type InterpolatableRobotAudioLoopInstructions = InterpolatableRobotAudioLoopInstructionsInput
+export const {
+  withHiddenFields: robotAudioLoopInstructionsWithHiddenFieldsSchema,
+  interpolatable: interpolatableRobotAudioLoopInstructionsSchema,
+  interpolatableWithHiddenFields: interpolatableRobotAudioLoopInstructionsWithHiddenFieldsSchema,
+} = robotDefinition
 
-export type InterpolatableRobotAudioLoopInstructionsInput = z.input<
-  typeof interpolatableRobotAudioLoopInstructionsSchema
->
+type Instructions = RobotSchemaVariantTypes<typeof robotDefinition>
 
-export const interpolatableRobotAudioLoopInstructionsWithHiddenFieldsSchema = interpolateRobot(
-  robotAudioLoopInstructionsWithHiddenFieldsSchema,
-)
-export type InterpolatableRobotAudioLoopInstructionsWithHiddenFields = z.infer<
-  typeof interpolatableRobotAudioLoopInstructionsWithHiddenFieldsSchema
->
-export type InterpolatableRobotAudioLoopInstructionsWithHiddenFieldsInput = z.input<
-  typeof interpolatableRobotAudioLoopInstructionsWithHiddenFieldsSchema
->
+export type RobotAudioLoopInstructions = Instructions['output']
+export type RobotAudioLoopInstructionsWithHiddenFields = Instructions['hiddenOutput']
+export type InterpolatableRobotAudioLoopInstructions = Instructions['interpolatableInput']
+export type InterpolatableRobotAudioLoopInstructionsInput = Instructions['interpolatableInput']
+export type InterpolatableRobotAudioLoopInstructionsWithHiddenFields =
+  Instructions['interpolatableHiddenOutput']
+export type InterpolatableRobotAudioLoopInstructionsWithHiddenFieldsInput =
+  Instructions['interpolatableHiddenInput']

package/src/alphalib/types/robots/audio-merge.ts

@@ -1,4 +1,4 @@
-import type { RobotMetaInput } from './_instructions-primitives.ts'
+import type { RobotMetaInput, RobotSchemaPair } from './_instructions-primitives.ts'
 
 import { z } from 'zod'
 
@@ -6,17 +6,17 @@ import { stackVersions } from '../stackVersions.ts'
 import {
   bitrateSchema,
   interpolateRobot,
+  robotAudioEncodingMeta,
   robotBase,
   robotFFmpegAudio,
+  robotParameterDocs,
   robotUse,
   robotUseWithHiddenFields,
   sampleRateSchema,
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  bytescount: 4,
-  discount_factor: 0.25,
-  discount_pct: 75,
+  ...robotAudioEncodingMeta,
   example_code: {
     steps: {
       merged: {
@@ -47,28 +47,13 @@ export const meta: RobotMetaInput = {
   },
   example_code_description:
     'If you have a form with 3 file input fields and wish to overlay the uploaded audios, instruct Transloadit using the `name` attribute of each input field. Use this attribute as the value for the `fields` key in the JSON, and set `as` to `audio`:',
-  minimum_charge: 0,
-  output_factor: 0.8,
-  override_lvl1: 'Audio Encoding',
   purpose_sentence: 'overlays several audio files on top of each other',
   purpose_verb: 'merge',
   purpose_word: 'merge',
   purpose_words: 'Merge audio files into one',
-  service_slug: 'audio-encoding',
-  slot_count: 20,
   title: 'Merge audio files into one',
-  typical_file_size_mb: 3.8,
-  typical_file_type: 'audio file',
   uses_tools: ['ffmpeg'],
   name: 'AudioMergeRobot',
-  priceFactor: 4,
-  queueSlotCount: 20,
-  isAllowedForUrlTransform: true,
-  trackOutputFileSize: true,
-  applyCommunityPlanMediaTrim: true,
-  isInternal: false,
-  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
-  stage: 'ga',
 }
 
 export const robotAudioMergeInstructionsSchema = robotBase
@@ -76,12 +61,10 @@ export const robotAudioMergeInstructionsSchema = robotBase
   .merge(robotFFmpegAudio)
   .extend({
     robot: z.literal('/audio/merge'),
-    bitrate: bitrateSchema.optional().describe(`
-Bit rate of the resulting audio file, in bits per second. If not specified will default to the bit rate of the input audio file.
-`),
-    sample_rate: sampleRateSchema.optional().describe(`
-Sample rate of the resulting audio file, in Hertz. If not specified will default to the sample rate of the input audio file.
-`),
+    bitrate: bitrateSchema.optional().describe(robotParameterDocs.audio_bitrate.description),
+    sample_rate: sampleRateSchema
+      .optional()
+      .describe(robotParameterDocs.audio_sample_rate.description),
     duration: z
       .enum(['first', 'longest', 'shortest'])
       .default('longest')
@@ -136,3 +119,12 @@ export type InterpolatableRobotAudioMergeInstructionsWithHiddenFields = z.infer<
 export type InterpolatableRobotAudioMergeInstructionsWithHiddenFieldsInput = z.input<
   typeof interpolatableRobotAudioMergeInstructionsWithHiddenFieldsSchema
 >
+
+export const robotDefinition: RobotSchemaPair<
+  typeof interpolatableRobotAudioMergeInstructionsSchema,
+  typeof interpolatableRobotAudioMergeInstructionsWithHiddenFieldsSchema
+> = {
+  meta,
+  interpolatable: interpolatableRobotAudioMergeInstructionsSchema,
+  interpolatableWithHiddenFields: interpolatableRobotAudioMergeInstructionsWithHiddenFieldsSchema,
+}