{"id":48963838,"url":"https://github.com/paperfoot/seedance-cli","last_synced_at":"2026-04-18T03:04:34.731Z","repository":{"id":351794272,"uuid":"1212527767","full_name":"paperfoot/seedance-cli","owner":"paperfoot","description":"Generate video with ByteDance Seedance 2.0 from the terminal. Agent-friendly Rust CLI -- JSON envelope, semantic exit codes, reference images/videos/audio, one binary.","archived":false,"fork":false,"pushed_at":"2026-04-17T20:43:15.000Z","size":112,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-17T22:29:22.405Z","etag":null,"topics":["agent-cli","ai","bytedance","byteplus","cli","generative-ai","image-to-video","rust","seedance","seedance-2","text-to-video","video","video-generation"],"latest_commit_sha":null,"homepage":"https://github.com/199-biotechnologies/seedance","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/paperfoot.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-16T13:19:38.000Z","updated_at":"2026-04-17T20:43:19.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/paperfoot/seedance-cli","commit_stats":null,"previous_names":["199-biotechnologies/seedance","paperfoot/seedance-cli"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/paperfoot/seedance-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paperfoot%2Fseedance-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paperfoot%2Fseedance-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paperfoot%2Fseedance-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paperfoot%2Fseedance-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/paperfoot","download_url":"https://codeload.github.com/paperfoot/seedance-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paperfoot%2Fseedance-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31954738,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T00:39:45.007Z","status":"online","status_checked_at":"2026-04-18T02:00:07.018Z","response_time":103,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-cli","ai","bytedance","byteplus","cli","generative-ai","image-to-video","rust","seedance","seedance-2","text-to-video","video","video-generation"],"created_at":"2026-04-18T03:04:30.659Z","updated_at":"2026-04-18T03:04:34.723Z","avatar_url":"https://github.com/paperfoot.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# seedance\n\n**Generate video with ByteDance Seedance 2.0 from the terminal.** Agent-friendly CLI -- JSON envelope on pipe, human-readable on TTY, semantic exit codes, one binary, no MCP.\n\nBuilt with the [agent-cli-framework](https://github.com/paperfoot/agent-cli-framework).\n\n## Install\n\n```bash\ncargo install --path .\n# or (once published)\ncargo install seedance\n```\n\n## Auth\n\nGet an API key at [console.byteplus.com/ark](https://console.byteplus.com/ark) and export it:\n\n```bash\nexport SEEDANCE_API_KEY=sk-...\n# ARK_API_KEY is also accepted\n```\n\n## Fast path\n\n```bash\nseedance doctor\nseedance generate --prompt \"A cat yawns at the camera\" --wait\n# -\u003e ~/Documents/seedance/\u003ctask-id\u003e.mp4\n```\n\nDefault output directory is `~/Documents/seedance/`. Override with `-o /path/to/file.mp4` or `-o /some/dir/`.\n\n## Reference inputs\n\nSeedance 2.0 accepts a free mix of references in one `content` array:\n\n| Flag            | Kind  | Limit | Notes |\n|-----------------|-------|-------|-------|\n| `--image / -i`  | Image | 0-9   | Path (base64'd inline) or URL. Role: `reference_image` |\n| `--first-frame` | Image | 1     | Role: `first_frame` |\n| `--last-frame`  | Image | 1     | Role: `last_frame` (requires `--first-frame`) |\n| `--video / -v`  | Video | 0-3   | **URL only** (API restriction). Total \u003c=15s |\n| `--audio / -a`  | Audio | 0-3   | wav/mp3. Path (base64'd) or URL. Total \u003c=15s. Requires an image or video alongside. |\n\nAddress references inside the prompt: `[Image 1] the boy waves`, `[Video 1] camera style`, `[Audio 1] background music`. Use time codes for multi-shot: `[0-4s]: wide establishing shot; [4-8s]: push in`.\n\n## Examples\n\n```bash\n# Text-to-video, wait and download\nseedance generate \\\n  --prompt \"A kitten yawns and blinks at the camera, cozy warm light\" \\\n  --duration 6 --resolution 720p --ratio 16:9 \\\n  --wait --output kitten.mp4\n\n# Multimodal reference-to-video with the fast tier\nseedance generate \\\n  --prompt \"[Image 1] the boy smiles; [Image 2] the corgi jumps in; [Video 1] camera motion\" \\\n  --image boy.png --image corgi.png \\\n  --video https://my-cdn.example/style.mp4 \\\n  --fast --wait -o out.mp4\n\n# Fire and forget, poll later\nTASK=$(seedance gen --prompt \"...\" | jq -r '.data.id')\nseedance status \"$TASK\"\nseedance download \"$TASK\" -o final.mp4\n```\n\n## Known quirks\n\n* **Audio upload mutates lyrics.** Reported by @MrDavids1 + @simeonnz: uploading audio directly\n  alters the song. Workaround: render a silent MP4 with the audio baked in, then pass it as\n  `--video`. The API trusts reference videos for audio content but post-processes raw audio.\n* **No real human faces in references.** ModelArk blocks direct upload of real human portraits.\n  Use a face first generated by Seedance itself (those get a 30-day trust window per your key).\n* **Videos must be URLs, not local files.** Host to S3/Cloudinary/etc. and pass the URL.\n\n## Commands\n\n| Command | Purpose |\n|---------|---------|\n| `seedance generate` / `gen` | Create a video generation task |\n| `seedance status \u003cid\u003e` / `get` | Poll a task |\n| `seedance download \u003cid\u003e` | Download the mp4 for a completed task |\n| `seedance cancel \u003cid\u003e` / `rm` | Cancel a queued task |\n| `seedance models` / `ls` | List available model ids |\n| `seedance doctor` | Check API key, base URL, auth |\n| `seedance agent-info` / `info` | Machine-readable capability manifest |\n| `seedance skill install` | Deploy SKILL.md to Claude/Codex/Gemini |\n| `seedance config show` / `path` | Show / locate config |\n| `seedance update [--check]` | Self-update from GitHub Releases |\n\nGlobal flags: `--json` (force JSON), `--quiet` (suppress info), `--help`, `--version`.\n\n## Exit codes\n\n| Code | Meaning |\n|------|---------|\n| `0`  | Success |\n| `1`  | Transient (network, API, IO) -- retry |\n| `2`  | Config (missing API key, bad base URL) -- fix setup |\n| `3`  | Bad input -- fix arguments |\n| `4`  | Rate limited -- wait and retry |\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaperfoot%2Fseedance-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpaperfoot%2Fseedance-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaperfoot%2Fseedance-cli/lists"}