minimax/options

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

MiniMax provider baseURL option

The baseURL option is an optional string setting for the MiniMax provider instance. It specifies a different URL prefix for API calls. The provider speaks MiniMax's Anthropic-compatible protocol, so the default prefix is https://api.minimax.io/anthropic/v1 (not the OpenAI-compatible https://api.minimax.io/v1).

MiniMax provider videoBaseURL option

The videoBaseURL option is an optional string setting for the MiniMax provider instance. It specifies a different URL prefix for video generation API calls. The video API uses the MiniMax V2 native endpoint (not the Anthropic-compatible endpoint). The default prefix is https://api.minimax.io.

MiniMax provider apiKey option

The apiKey option is an optional string setting for the MiniMax provider instance. It provides the API key for the MiniMax API. It defaults to the MINIMAX_API_KEY environment variable. Language models send it in the x-api-key header (the Anthropic-compatible protocol); video models send it as Authorization: Bearer.

MiniMax provider headers option

The headers option is an optional Record<string,string> setting for the MiniMax provider instance. It allows custom headers to be included in the requests.

MiniMax provider fetch option

The fetch option is an optional setting for the MiniMax provider instance. It accepts a custom fetch implementation with signature (input: RequestInfo, init?: RequestInit) => Promise<Response>.

MiniMax thinking provider option

The thinking option is an object that controls the model's reasoning ('thinking') behavior. It has a type field that accepts 'adaptive' or 'disabled'. 'adaptive' means the model decides when to reason (deep reasoning enabled). 'disabled' means the model responds directly without reasoning, for higher throughput and lower latency. When omitted, the model uses its provider-side default. Thinking control is only supported on minimax-m3. The M2.x models always think, so 'disabled' has no effect on them.

MiniMax video duration parameter

The duration parameter for MiniMax video generation accepts a whole number of seconds from 5 to 15, and defaults to 5. A fractional value is rounded and an out-of-range value is clamped, each with a warning.

MiniMax video aspect ratio defaults

For MiniMax video generation: for text-to-video, aspectRatio defaults to 16:9 when omitted. For reference-to-video, the API default is adaptive when aspectRatio is omitted. For image-to-video with frame images, the aspect ratio follows the input image.

MiniMax video provider option: resolution

The resolution option is an optional string for MiniMax video models. It specifies the output resolution. MiniMax-H3 currently only supports '2K' (the default).

MiniMax video provider option: ratio

The ratio option is an optional string for MiniMax video models. It accepts values 'adaptive', '21:9', '16:9', '4:3', '1:1', '3:4', or '9:16'. It specifies the aspect ratio of the generated video and overrides the top-level aspectRatio.

MiniMax video provider option: referenceAudioUrls

The referenceAudioUrls option is an optional string array for MiniMax video models. It provides reference audio URLs (or mm_file:// handles) for reference-to-video generation. Must be paired with at least one reference image or video. Accepts up to 3 URLs.

MiniMax video provider option: aigcWatermark

The aigcWatermark option is an optional boolean for MiniMax video models. It specifies whether to embed an AIGC watermark in the output. Defaults to false.

MiniMax video provider option: pollIntervalMs

The pollIntervalMs option is an optional number for MiniMax video models. It specifies the interval in milliseconds between task status polls. Default is 10000.

MiniMax video provider option: pollTimeoutMs

The pollTimeoutMs option is an optional number for MiniMax video models. It specifies the maximum time in milliseconds to poll before timing out. Default is 600000.

MiniMax mm_file:// handle limitations

MiniMax mm_file:// handles are only forwarded as-is for referenceAudioUrls. They cannot be used for image, frameImages, or inputReferences: those inputs go through the AI SDK's file handling, which base64-decodes any string that is not an http(s):// or data: URL. Pass those inputs as public URLs, data URIs, or binary data instead.

MiniMax configuration options

MiniMax provider configuration accepts these options: baseURL (string, defaults to https://api.minimax.io/anthropic/v1 for Anthropic-compatible and https://api.minimax.io/v1 for OpenAI-compatible), apiKey (string, defaults to MINIMAX_API_KEY environment variable), headers (Record<string,string> for custom headers), and fetch (custom fetch implementation).

Give your agent this brain