Changelog

Keyword and Semantic Balance

Tune the keyword/semantic balance: semantic_ratio on v2 and v3 Query (0.0 to 1.0, default 0.5) weights the fused result set: 0.0 is keyword only, 1.0 is semantic only. See Advanced Search & Relations.

MCP has its own guide: the hosted server, all 48 tools, and client configs for Claude Code, Cursor, VS Code, and Windsurf now live at MCP Server. OpenClaw and Hermes keep their page under Integrations.

Rank by your own metadata, not just filter by it: v3 Query accepts an optional boost array. Each clause retrieves chunks matching one of your custom_metadata keys and multiplies their retrieval score by a weight between 0.2 and 5.0. Use it when a chunk is the right answer but does not share wording with the query: a reviewer marked it, a curated tag applies, or your application already cited it. Send no boost and retrieval is unchanged.
Soft by default, guaranteed when you ask: with reranking on, boosts decide which chunks the reranker considers and the reranker still decides the final order. Set reserve on a clause to guarantee its best matches a place on the page.
Every boost explains itself: each clause is echoed with matched, in_pool, and on_page counts; boosted results carry a boost record with the multiplier and the rank they held beforehand, and report metadata in match_sources. See Advanced Search & Relations.

Fetch figure crops on demand: Mint Asset URLs takes the figure_ids from a document’s regions and returns short-lived signed image URLs. Batch up to 100, set ttl_seconds (default 900), and each id degrades on its own.

Supported file types guide: documents, text, images, video, and audio formats with their extensions, at Supported File Types. File Size Limits keeps the size ceilings.

Index the video, not just the captions: Index YouTube now takes a mode parameter. transcript (the default, unchanged and staying that way) indexes the caption track as text. audio pulls the audio track through the multimodal audio pipeline, billed at 5 credits per minute. video pulls the video itself for frame descriptions plus transcription, billed at 20 credits per minute.
Captionless videos can fall back instead of failing: set on_missing_transcript to audio or video and a video with no captions is indexed through that media pipeline instead of failing the file. Because the fallback changes what you are billed, it is never silent: Get Job Status returns a per-video youtube array with mode_used, fell_back_from, transcript_available, and languages.
youtube.com/live/ URLs are now accepted alongside the existing watch, youtu.be, shorts, embed, and /v/ shapes. Duplicate videos in one request are deduplicated, live streams are refused, and media over 4 hours is rejected before any processing starts.