@transloadit/node 6.2.2 → 6.4.0

package/src/alphalib/types/robots/text-translate.ts

@@ -26,19 +26,6 @@ export const meta: RobotMetaInput = {
   extended_description: `
 > [!Warning]
 > This <dfn>Robot</dfn> uses third-party AI services. They may tweak their models over time, giving different responses for the same input media. Avoid relying on exact responses in your tests and application.
-
-## Supported languages
-
-{%- for provider in text_translate_languages %}
-
-### {{provider[0] | upcase }}
-
-<!-- prettier-ignore -->
-{%- for language in provider[1] %}
-  {{ language }}{% unless forloop.last %},{% endunless %}
-{%- endfor %}
-
-{%- endfor %}
 `,
   override_lvl1: 'Artificial Intelligence',
   purpose_sentence: 'translates text in documents',

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

@@ -45,6 +45,8 @@ Videos recorded with iPhone spatial audio can contain a stereo AAC track alongsi
 
 Files containing only unsupported audio still fail. Individual audio track selections and stream-copy requests keep the tracks you select; the output format must support copied tracks.
 
+When adding watermarks or drawing with simple FFmpeg video filters such as \`drawtext\` to HLG or PQ HDR video, the video is tone-mapped to SDR BT.709 before drawing, so overlay colors retain their intended RGB values. SDR inputs keep their existing processing. A custom \`ffmpeg.pre:filter:v\` that supplies tone mapping controls its own color conversion. Custom multi-input \`filter_complex\` graphs must handle each input’s color space explicitly.
+
 ## Adding text overlays with FFmpeg
 
 You can add text overlays to videos using FFmpeg's \`drawtext\` filter through this <dfn>Robot</dfn>'s \`ffmpeg\` parameter. Here are two examples — one with the default font and one with a custom font family name:

package/src/alphalib/types/robots/video-generate.ts

@@ -11,6 +11,7 @@ import {
   robotParameterDocs,
   robotUse,
 } from './_instructions-primitives.ts'
+import { videoGenerationParameterEnforcementDate } from './_video-generate-description.ts'
 
 export const meta: RobotMetaInput = {
   ...robotArtificialIntelligenceMeta,
@@ -19,8 +20,6 @@ export const meta: RobotMetaInput = {
       generated_video: {
         robot: '/video/generate',
         prompt: 'A slow cinematic drone shot of ocean cliffs at sunrise, realistic lighting.',
-        duration: 5,
-        aspect_ratio: '16:9',
         format: 'mp4',
       },
     },
@@ -46,15 +45,18 @@ export const robotVideoGenerateInstructionsSchema = robotBase
       .string()
       .optional()
       .describe(
-        `The AI model to use for video generation. Defaults to ${videoGenerateDefaultModelIdentifier}.`,
+        `Video model; defaults to ${videoGenerateDefaultModelIdentifier}. Unsupported settings warn until ${videoGenerationParameterEnforcementDate}. MiniMax outputs are about six seconds.`,
       ),
     prompt: z.string().describe('The prompt describing the desired video content.'),
     format: z.enum(['mp4']).optional().describe('Format of the generated video.'),
     seed: z.number().optional().describe(robotParameterDocs.seed.description),
-    aspect_ratio: z.string().optional().describe('Aspect ratio of the generated video.'),
-    height: z.number().optional().describe('Height of the generated video.'),
-    width: z.number().optional().describe('Width of the generated video.'),
-    style: z.string().optional().describe('Style of the generated video.'),
+    aspect_ratio: z
+      .string()
+      .optional()
+      .describe('Aspect ratio for lightricks/ltx-video without an input image.'),
+    height: z.number().optional().describe('Pixel height for tencent/hunyuan-video.'),
+    width: z.number().optional().describe('Pixel width for tencent/hunyuan-video.'),
+    style: z.string().optional().describe('Unsupported by current models; omit it.'),
     num_outputs: z
       .number()
       .int()
@@ -62,26 +64,12 @@ export const robotVideoGenerateInstructionsSchema = robotBase
       .max(10)
       .optional()
       .describe('Number of video variants to generate.'),
-    duration: z.number().optional().describe('Duration of the generated video in seconds.'),
-    fps: z.number().optional().describe('Frames per second of the output video.'),
-    motion_amount: z
-      .number()
-      .optional()
-      .describe('Controls the intensity of motion in the generated video.'),
-    camera_motion: z
-      .string()
-      .optional()
-      .describe(
-        'Camera movement type (e.g., pan-left, pan-right, zoom-in, zoom-out, orbit, static, dolly, crane).',
-      ),
-    negative_prompt: z
-      .string()
-      .optional()
-      .describe('Describes what should be avoided in the generated video.'),
-    reference_strength: z
-      .number()
-      .optional()
-      .describe('How closely the output should follow the reference input (0.0 - 1.0).'),
+    duration: z.number().optional().describe('Unsupported by current models; omit it.'),
+    fps: z.number().optional().describe('Frames per second for tencent/hunyuan-video.'),
+    motion_amount: z.number().optional().describe('Unsupported by current models; omit it.'),
+    camera_motion: z.string().optional().describe('Unsupported by current models; omit it.'),
+    negative_prompt: z.string().optional().describe('Content to avoid (lightricks/ltx-video).'),
+    reference_strength: z.number().optional().describe('Unsupported by current models; omit it.'),
   })
   .strict()
 

package/src/alphalib/types/robots/video-subtitle.ts

@@ -77,6 +77,8 @@ export const robotVideoSubtitleInstructionsSchema = robotBase
 This <dfn>Robot</dfn> supports SRT, VTT, ASS, and the timestamped JSON output of \`/speech/transcribe\` with \`"format": "json"\`. Pass the video as \`"video"\` and the transcript as \`"subtitles"\` in the \`use\` parameter. JSON words are grouped into captions and converted to ASS for burned word highlighting, or plain SRT cues for external subtitle streams. External JSON cues preserve casing and punctuation. Provider segments do not control caption breaks. SRT and VTT timing is preserved.
 
 Without a \`preset\` or custom \`ffmpeg\` options, the legacy \`"flash"\` preset produces FLV output. With this default, burned subtitles use MP3 audio; external subtitles copy the input audio. Set \`"preset": "empty"\` to keep the input container, such as MP4 for an MP4 input.
+
+When burning subtitles into HLG or PQ HDR video, the video is tone-mapped to SDR BT.709 before captions are drawn. Caption colors retain their intended RGB values, and the output is tagged as SDR. External subtitles preserve the source video’s HDR colors. SDR inputs keep their existing processing. If \`ffmpeg.pre:filter:v\` supplies its own tone mapping, that filter controls color conversion.
 `),
     subtitles_type: zodInputPreservingTransform(z.enum(['burned', 'external', 'burn']), (val) =>
       val === 'burn' ? 'burned' : val,

package/src/alphalib/types/robots/video-thumbs.ts

@@ -70,6 +70,8 @@ export const robotVideoThumbsInstructionsSchema = robotBase
     robot: z.literal('/video/thumbs').describe(`
 Set \`smart: true\` to select strong preview images with AI instead of taking frames only at regular intervals. The Robot scores candidate frames for clarity, brightness, composition, faces, expressions, action, and visual interest, then returns the best \`count\` frames in chronological order. Smart results include \`file.meta.smart_score\` and \`file.meta.smart_reasons\`. If AI scoring is unavailable, the Assembly continues with the candidate frames in fallback order and includes a warning. No AI credentials are required.
 
+HLG and PQ HDR video frames are tone-mapped to SDR sRGB before image encoding, including smart-thumbnail candidates. This preserves the intended appearance in browsers that display thumbnails as sRGB images. SDR inputs keep their existing processing.
+
 ## AI pricing
 
 Regular \`/video/thumbs\` processing charges still apply. AI frame analysis is billed separately at the underlying provider cost plus a ${smartThumbnailMarkupPercent}% Transloadit markup. Smart selection uses the dedicated \`${smartThumbnailModel}\` vision model with \`${smartThumbnailReasoningEffort}\` reasoning, independently of the \`/ai/chat\` default. The exact AI charge varies with the number of candidate frames and provider pricing.

package/src/alphalib/types/template.ts

@@ -172,14 +172,44 @@ const assemblyInstructionsSharedShape = {
   template_id: templateIdSchema,
 } as const
 
+/** Most URLs one Assembly may import through `input_url`. */
+export const assemblyInputUrlMaxCount = 10
+/** Longest URL `input_url` accepts, in Unicode code points. */
+export const assemblyInputUrlMaxLength = 4096
+
+/** One `input_url` entry; API2 additionally requires a literal absolute HTTP(S) URL. */
+export const assemblyInputUrlValueSchema = z
+  .string()
+  .min(1)
+  .refine(
+    (value) => [...value].length <= assemblyInputUrlMaxLength,
+    `Must be at most ${assemblyInputUrlMaxLength} characters`,
+  )
+
+// Request-only: Template content cannot declare it, so it stays out of the shared shape.
+const assemblyInputUrlSchema = z
+  .union([
+    assemblyInputUrlValueSchema,
+    z.array(assemblyInputUrlValueSchema).min(1).max(assemblyInputUrlMaxCount),
+  ])
+  .optional()
+  .describe(
+    `One HTTP(S) URL, or a list of up to ${assemblyInputUrlMaxCount}, that Transloadit downloads as the input files of the Builtin Template selected with \`template_id\`, instead of your client uploading them. Only Builtin Templates that accept an input file support it, and the request must be signed or Bearer-authenticated. It cannot be combined with \`steps\` or with uploads. URLs are used literally: they must be absolute, at most ${assemblyInputUrlMaxLength} characters, and must not contain whitespace, \`|\` or Assembly variables such as \`\${fields.url}\`. Private-network addresses are refused.`,
+  )
+
+/** URLs a request imports as a Builtin Template's input files. */
+export type AssemblyInputUrl = z.input<typeof assemblyInputUrlSchema>
+
 export const assemblyInstructionsSchema = z.object({
   auth: assemblyAuthInstructionsSchema.optional(),
   ...assemblyInstructionsSharedShape,
+  input_url: assemblyInputUrlSchema,
 })
 
 export const assemblyInstructionsSchemaWithRequiredAuth = z.object({
   auth: assemblyAuthInstructionsSchema,
   ...assemblyInstructionsSharedShape,
+  input_url: assemblyInputUrlSchema,
 })
 
 export type AssemblyInstructions = z.infer<typeof assemblyInstructionsSchema>