new·The score now tells you which way it movedA brain's exam only ever grows: its own material writes questions, and so does every question a real caller asked and did not get answered. The score is a percentage over that growing set, so a brain that learned more could post a smaller number — and this week three did. One of them answered two MORE questions than the week before and showed eighteen points less. Printed as a single percentage, that reads as decline to a reader and as punishment to anyone who contributes material.all news →
mozg.beta
Sign in

AI SDK · Providers · all subjects

black-forest-labs/options

10 notes, read out of this brain and free to use. Each one was extracted from a source and is re-checked against its exam.

Black Forest Labs video duration parameter

`duration` accepts a whole number of seconds from 5 to 20. A fractional value is rounded and an out-of-range value is clamped, each with a warning. Omit it to let FLUX 3 fit the duration to the content.

Black Forest Labs image provider options

Black Forest Labs image models support the following provider options via `providerOptions.blackForestLabs`: width (number, 256–1920 pixels), height (number, 256–1920 pixels), outputFormat (string, 'jpeg' or 'png'), steps (number, higher values improve quality but increase time), guidance (number, higher values follow prompt more closely), imagePrompt (string, base64-encoded image), imagePromptStrength (number, 0.0 to 1.0), promptUpsampling (boolean), raw (boolean, natural aesthetics), safetyTolerance (number, 0–6 where 0 is strictest), pollIntervalMillis (number, default 500ms), pollTimeoutMillis (number, default 60s), webhookUrl (string, valid HTTP/HTTPS URL), webhookSecret (string, for signature verification).

Black Forest Labs image provider metadata

The `generateImage` response includes `providerMetadata.blackForestLabs.images[]` with properties: seed (number, for reproducing results), start_time (number, Unix timestamp), end_time (number, Unix timestamp), duration (number, in seconds), cost (number), inputMegapixels (number), outputMegapixels (number).

Black Forest Labs video resolution tiers

Black Forest Labs video API takes a named resolution tier: 'hd' or 'fhd' (default is 'hd'), where 'fhd' is finished by the video upsampler. The exact frame size depends on the aspect ratio. The top-level `resolution` option (width x height) is mapped to a tier by its shorter side—1280x720 becomes 'hd' and 1920x1080 becomes 'fhd'. Use `providerOptions.blackForestLabs.resolution` to set the tier directly.

Black Forest Labs video aspect ratio support

Black Forest Labs FLUX 3 accepts aspect ratios: '21:9', '2:1', '16:9', '4:3', '1:1', '3:4', '9:16', and 'auto'. The API default is 'auto', which infers the ratio from the prompt and conditioning media. Use `providerOptions.blackForestLabs.aspectRatio` to set 'auto'.

Black Forest Labs video provider options

Black Forest Labs FLUX 3 video supports these provider options: resolution ('hd' | 'fhd', takes precedence over top-level), aspectRatio ('21:9' | '2:1' | '16:9' | '4:3' | '1:1' | '3:4' | '9:16' | 'auto', takes precedence), keyframes (Array<string | [number, string]> for images pinned to specific seconds), safetyTolerance (number, 0–4, default 2; sexual content capped at 3, hate at 2), draft (boolean, default false), draftCache (string, encrypted bundle), version (string, only 'latest' available).

Black Forest Labs video provider metadata

FLUX 3 video results include `providerMetadata.blackForestLabs.videos[]` with properties: id (string, generation request ID), videoUrl (string, signed MP4 URL, time-limited), draftCache (string, download URL for draft bundle, present only on draft generation), seed (number, when reported by API), start_time (number, Unix timestamp), end_time (number, Unix timestamp), duration (number, seconds), cost (number, credits), inputMegapixels (number), outputMegapixels (number).

Black Forest Labs video top-level poll option

Use the top-level `poll` option with Black Forest Labs video to have AI SDK Core orchestrate polling and set the interval and timeout. Set `intervalMs` (milliseconds between attempts) and `timeoutMs` (overall timeout before giving up).

Black Forest Labs image reference input method

To pass reference images for editing with Black Forest Labs, use `prompt.images` instead of provider options. This supports up to 10 images as URLs or base64-encoded strings.

Black Forest Labs image prompt provider option limitation

The `imagePrompt` option in Black Forest Labs image models is a base64-encoded image for additional visual context, but to pass multiple reference images for editing, use `prompt.images` instead.

Give your agent this brain