Repository navigation
v0.2.0
0.2.0 (2026-10-20)
⚠ BREAKING CHANGES
- 0.2.0 replaces old per-model, per-variation, and per-operation tool names without compatibility aliases. See the migration guide and restart MCP sessions.
- rename modelark-mcp server and skill to ark-mcp
Features
- add audio file delivery, cached pricing, and self-hosting (91a7566)
- add BytePlus VOD AI MediaKit video transcoding (58b5c6a)
- add BytePlus VOD AI MediaKit video transcoding (cf45135)
- add BytePlus VOD MediaKit enhancement (0605131)
- add BytePlus VOD OpenAPI voice and background audio separation (e77ac87)
- add BytePlus VOD OpenAPI voice and background audio separation (a1d1acc)
- add Draft mode to Seedance 2.5 and 2.5 Premium (4eb616c)
- add Draft mode to Seedance 2.5 and 2.5 Premium (b523fe6)
- add field descriptions to all MCP tool output models for client usability (00c87d0)
- add Hyper3D and Hitem3d 3D generation tools (c0a1385)
- add Hyper3D and Hitem3d 3D generation tools (2271d84)
- add media_presign tool and S3 object storage docs (#12) (946d437)
- add media_upload tool backed by BytePlus TOS (88515c5)
- add MediaKit enhancement task retrieval (ebd4987)
- add MediaKit enhancement task retrieval (d0ea169)
- add MediaKit subtitle tools (a88763d)
- add MediaKit subtitle tools (05d6b6c)
- add ModelArk private asset library tools and asset:// references (24931f4)
- add OmniHuman 2.0 image+audio avatar video tools (6731ba6)
- add OmniHuman 2.0 image+audio avatar video tools (b1945a5)
- add parallel multiple generation for Seedream, Seed Audio, and Seedance (3b1d1d0)
- add portable background job tools (b38812d)
- add pre-commit, pydantic-settings enhancements, pip-audit, and structlog (b43e7cd)
- add S3 object storage backend alongside TOS (adc4158)
- add Seed 2.1 multimodal understanding support (#18) (a5a4c70)
- add seed_audio_understand tool for audio understanding (4da41f4)
- add seed_audio_understand tool for audio understanding (b3cc225)
- add seed_media_export_artifact tool (4711f53)
- add seed_media_export_artifact tool (12137f2)
- add Seedance 2.5 video generation support (327cfdc)
- add Seedance 2.5 video generation support (864c1f3)
- add seedream_edit_image tool for interactive image editing (40c5004)
- add static tool catalog and ark_list_models discovery (307f1d1)
- add whitelist-only Seedance 2.5 Premium (4K) behind a feature flag (22e7f8f)
- add whitelist-only Seedance 2.5 Premium (4K) behind a feature flag (bec5718)
- agent workflow ergonomics — timeout retryability, understanding output control, output paths, batch tools (34e7175)
- allow per-upload presign TTL override for VOD inputs (07d04ff)
- audit MCP tool descriptions and add output model field descriptions (3b91ba9)
- cloud-readiness and security hardening (70aec7d)
- cloud-readiness and security hardening (d00a112)
- complete ModelArk MCP gap remediation (bcdd8ed)
- consolidate the MCP tool surface to 38 tools (0.2.0) (044b19e)
- default Seedream 5.0 Pro to fast prompt optimization (94a094b)
- default Seedream 5.0 Pro to fast prompt optimization (08262c7)
- default watermark to false for Seedance video generation (ab68d10)
- enable 1080p output for Seedance 2.5 (4901272)
- enable 1080p output for Seedance 2.5 (08fe81d)
- expose omni_reference_task_type and document auto-locked parameters (fb71690)
- expose omni_reference_task_type and document auto-locked parameters (62c0699)
- implement ModelArk Seed MCP server with tools, tests, and docs (d618d10)
- increase structured logging coverage across server (0615690)
- increase structured logging coverage across server (e9beca7)
- integrate audio file delivery, cached pricing, and self-hosting (7cb14b7)
- make the Seedream prompt optimization default configurable (5d01f60)
- make the Seedream prompt optimization default configurable (068de54)
- merge Seed Audio variations into seed_audio_generate (0953cdd)
- merge Seedream generate, edit and variations into one tool (ac3f1ff)
- merge six Seedance create tools into seedance_create_task (dfcd2d3)
- merge task polling into gen_task_* and vod_get_task (8167dba)
- migrate STT from LAS to Seed Speech ASR (#6) (9d513eb)
- ModelArk private asset library tools and asset:// references (74f1584)
- output_path on generation tools, batch upload/status tools, queue timing (a264124)
- polish pass — bug fixes, conformance tests, rate limiting, cost logging (1e4a2dc)
- run long media operations as MCP tasks (acd9d72)
- security hardening round 2 (7733dec)
- security hardening round 2 (a1124e1)
- seed_understand always thinks, returns only the answer, enforces JSON schemas (de7eb03)
- seedance: raise prompt max length to 32,000 characters (2d25035)
- skill: add github-pr-create skill — create PR with gh CLI and converge via parallel review + CI watch loop (c40a23f)
- skill: add github-pr-qa skill — independent read-only QA subagent for GitHub PRs (453b2bb)
- skill: add github-pr-review skill — end-to-end GitHub PR review with structured report (8c61bf2)
- skill: add subagent-workflows skill — orchestrate Codex subagent workflows (ed83739)
- skill: add writing-plans skill — implementation plans from specs and requests (4b0403b)
- SQLite-backed persistence cache, provider health checks, and HTTP rate limiting (#17) (258b5e9)
- stt: add speech-to-text via BytePlus LAS ASR (d994554)
- support fast/standard/professional tiers and more resolutions in vod_enhance_video (a802fd3)
- support fast/standard/professional tiers and more resolutions in vod_enhance_video (bbeed88)
- switch default understanding model to dola-seed-evolving (bdb4b55)
- switch default understanding model to dola-seed-evolving (f54634f)
- take lists in media tools and merge the asset library to eight tools (b985dc7)
Bug Fixes
- accurate local background-job errors and shared loopback server support (b21eae0)
- add missing description to VariationSummary.variations field (73ac808)
- address PR #38 review findings (3c3cb8e)
- address PR #43 round 1 review findings (8a0b08e)
- address PR #44 round 1 review findings (7dc9bd7)
- address review findings for WAV duration preflight (4661c37)
- address review findings for WAV duration preflight (056ba58)
- address review findings from PR #64 and #65 (d2d108d)
- address review round 1 findings (bc0ea06)
- address round-1 review findings on PR #72 (551e05b)
- address round-1 review findings on PR #73 (6a2d7e1)
- address round-2 review findings on PR #72 (2971a4a)
- address sub-agent review findings for transcode PR (f04944a)
- allow audio-only input for Seedance 2.5 (088d2d7)
- allow audio-only input for Seedance 2.5 (b751e3d)
- audit locked third-party dependencies (21168b4)
- bootstrap the agreed release and update the root lockfile version (181a02d)
- complete background task admission telemetry (e7a9d15)
- correct release bootstrap and lockfile version updates (c721d77)
- correct Seed3D model IDs and Hyper3D artifact persistence (e6fb0eb)
- default Seedream 5.0 prompt optimization to standard (7691489)
- default Seedream 5.0 prompt optimization to standard (ea5d6fa)
- document background sweeper and guard registry login (25317cd)
- enforce MediaKit response invariants (dea18bb)
- enforce Seedream 4,000-char prompt limit consistently (00f97ba)
- enforce Seedream 4,000-char prompt limit consistently (46baa3b)
- error path output schema, Seed Audio request flattening, and artifact UX (2170d2f)
- gate persisted task retrieval behind MCP tasks (26ba57f)
- harden enhancement task retrieval (0a11bfd)
- harden VOD audio separation URL/error handling from review (a4b5a50)
- infer separated-track MIME from URL; align spec/docs (894b136)
- issues found by live API testing of the consolidated tools (82cde37)
- make asset mutations and group resolution safe (3621aac)
- mention S3_PRESIGN_TTL_SECONDS in use-cases TTL reference per round 3 review (0bf2cb2)
- normalize MediaKit rejection envelopes (a76155c)
- point Seedance 2.0 variations hints at 2.5 and Premium variations tools (eb3dce3)
- point Seedance 2.5 variations wrong-family hints at variations tools (60391de)
- preserve consolidated tool prompts and durable outputs (0a53f3f)
- preserve enhancement results on cache errors (2cad719)
- protect upload recovery and deployment lifecycle (16e7dd2)
- QA review findings — cost model, tests, docs (63d971e)
- reconcile background tasks with FastMCP 4 (653ce76)
- recover from a missing env file and finish the default-path sweep (c212898)
- reject draft=false with draft_task_id and parse ISO created_at (dfd231e)
- remove hostname/IP leakage from SSRF validation logs (5c88027)
- remove nonexistent seedance_2_5_get_task from skill docs (ec926d5)
- replace assert with guard clauses + document media_upload tool (ea76ae0)
- replace asserts in shipped code paths with real control flow (0c8d5f4)
- report process-local background jobs and document shared loopback server (3dec75f)
- resolve round 2 review findings — grammar artifact and stale docs (ea4b26c)
- restore turbo as default understanding model, keep evolving as recognized Pro option (7651648)
- restore turbo as default understanding model, keep evolving as recognized Pro option (4002187)
- review findings from #64/#65, plus env-file recovery (cefe3e3)
- sanitize invalid task response metadata (8969693)
- sanitize UrlValidationError in AsrAudioInput validator (050acf3)
- scope tiktokcdn trust to OmniHuman and close review gaps (f31330b)
- secure and validate background task execution (62a7078)
- seed-audio: use nested audio_config and watermark in provider request (#7) (9968c2d)
- Seedance schema and content format, add live smoke test (68a3ea5)
- seedance: use documented omni_reference_task_type values (ae985ba)
- standardize Seedance prompt limit to 1-32,000 characters (19efd72)
- standardize Seedance prompt limit to 1-32,000 characters (8a7fe5c)
- strip ratio for video extension tasks to prevent InvalidParameter.TaskTypeConstraint (#28) (e5c2db2)
- stt: catch TOS upload ProviderError in create_task + add missing tests (d6e575b)
- stt: remove stale doc notice and clean up LAS gateway boilerplate (3c8060c)
- surface the real reason when OmniHuman tasks fail after submission (9ed9e04)
- surface the real reason when OmniHuman tasks fail after submission (9640ef7)
- timeout retryability, variation deadlines, download retries, persistence fallbacks (5bd0821)
- unblock parallel generation and reconcile upload limits (675d20b)
- unblock parallel generation and reconcile upload limits (dae1cb1)
- update docs, skills, and add S3 billed_provider_slot test per PR review (583bc8e)
- use exception type name instead of str(result) in variation error log (c6ec23c)
- validate WAV audio duration in base64 preflight (#25) (ec1a4c7)
Dependencies
- complete FastMCP 4 migration (054da44)
- deps-dev: update uv-build requirement (23ff35f)
- deps: update fastmcp requirement from <4.0,>=3.4.4 to >=3.4.4,<5.0 (aa00d5e)
Documentation
- add API keys guide for ModelArk, Seed Audio, LAS, and TOS (#4) (3d7bd75)
- add multi-generation mechanisms documentation (bbe0493)
- add operational docs, sync agent config, and expand client guides (5850479)
- add supported input modalities table to README (0af2a19)
- add tool contract rules for MCP client usability (472839a)
- add tool contract rules to AGENTS.md and tools.md (00fedc6)
- add use cases, integration guide, API reference, and update README (73511ae)
- align Ark MCP skill with background jobs (fdb72fa)
- align FastMCP composition guidance with v4 (af6a16f)
- align MediaKit async contract (c476a3f)
- align persist_output expiry wording with source_url description (e4c4ed7)
- align plan open question with the shipped paging behavior (5a50cf2)
- align skill and plan with local concurrency semantics (8df4aea)
- align task retrieval with FastMCP 4 (c10c287)
- clarify background task workflows (46bdf38)
- clarify provider task IDs in skill guide (88c2386)
- clarify task identifiers and STT execution (cb9a216)
- clarify understanding default model and thinking opt-in (d2e433f)
- correct Seedance 2.5 task type guidance (e8c9a74)
- correct Seedance 2.5 task type guidance (0d80de1)
- default long-running work to the ordinary ark_job_* path (d8b8f3a)
- default long-running work to the ordinary ark_job_* path (c96f41c)
- document ergonomics changes across docs, README, skill, and plan (1055b0b)
- document Seed Speech ASR 20000003 silent-audio error in modelark-mcp skill (42ef79d)
- document unified Seedream and Seed Audio tools (1fe54d1)
- list Seedance 2.5 Premium in seedance_get_task and list_tasks field descriptions (fbe7ed9)
- merge ark-director skill prose into server skill copy (dbdd7bf)
- merge ark-director skill prose into server skill copy (143ae33)
- merge modelark-mcp skill with full parameter tables, examples, and new features (0260f7f)
- move shipped plan decisions into specs and docs (71e54d6)
- note video-reference hosting limit + plan TOS upload feature (8cd0189)
- order the empty-targets diagnosis by actual likelihood (be4f495)
- order the empty-targets diagnosis by actual likelihood (2f9979d)
- release 0.2.0 with migration guide and restructured skill (521e0cb)
- remove final FastMCP 3 compatibility guidance (e72dba8)
- slim the ark-mcp skill and move detail into references (ff7eb82)
- sync ark-mcp skill copy with workspace guidance (1ac9f72)
- sync modelark-mcp skill with transcode and presign patterns (02ed56b)
- tools: add actual model IDs to parameter descriptions and SKILL.md (6794e5c)
- tools: add parameter descriptions to all tool input models (a80065a)
- update AGENTS.md and modelark-mcp skill for 3D and latest MCP (#46) (0e3e578)
- update modelark-mcp skill with Seedance 2.5 and seed_understand tools (3417dff)
Code Refactoring
- rename modelark-mcp server and skill to ark-mcp (da75d1a)
Container
ghcr.io/byteplus-sa/ark-mcp@sha256:301b85770608ebbe6bc4155c3782afb15c80c1ee3df555fa04da68c0396b55a8