Seedance 2 for DeepSeek Harness
dsh-seedance2 adds image and video generation to DeepSeek Harness through the
Seedance 2 AI public API. The same plugin can create images with Nano Banana Pro,
Nano Banana 2 Lite, or GPT Image 2 and create videos with Seedance 2 or
Seedance 2.5.
Tools:
seedance2_generate_imageseedance2_generate_videoseedance2_get_taskseedance2_account_help
中文说明
Account, credits, and API key
-
Sign up or sign in at https://seedance2ai.io/sign-up.
-
Buy credits at https://seedance2ai.io/pricing.
-
Create and manage an API key at https://seedance2ai.io/app/api.
-
Set the key only in the environment that launches Harness:
export SEEDANCE2_PUBLIC_API_KEY='sk-...'
-
Restart Harness.
Use the public key created on the API page. Internal provider credentials such
as SEEDANCE_API_KEY are not accepted by the public API.
Official API documentation and current model parameters:
https://seedance2ai.io/developers
Install
npx -y @deepseek-ai/dsh plugin --profile web add dsh-seedance2
npx -y @deepseek-ai/dsh --profile web --dump-config
npx -y @deepseek-ai/dsh web --profile web
The config dump should contain a seedance2 bundle layer.
To install a cloned checkout instead:
npx -y @deepseek-ai/dsh plugin --profile web add .
Try it
Use Seedance 2 AI Nano Banana Pro to generate a 1:1, 2K premium packaging
mockup on a clean studio floor. Wait for the final image.
Use Seedance 2 Pro to turn this public HTTPS opening image into a five-second
720p 16:9 video. Use a slow dolly shot, generate audio, and wait for the result.
Use Seedance 2.5 media-to-video with these public HTTPS reference images and
video. State the role of each reference inside the prompt and wait for output.
Reference assets must be public HTTPS URLs. For best Seedance results, describe
the subject, action, scene, camera movement, visual style, constraints, and the
role of every supplied asset in the prompt.
Safety and billing behavior
- Paid image and video tools ask for approval by default.
- The API key is resolved through Harness credentials and never exposed as a
model argument.
- Every paid request carries an
Idempotency-Key; automatic retries reuse it.
- Retryable
429 and 5xx responses use bounded backoff.
- Cancellation aborts requests and foreground polling.
- Failed tasks surface
credits_refunded from the API.
- If foreground waiting times out, continue the original task with
seedance2_get_task; do not pay for a duplicate submission.
- Authentication and insufficient-credit errors return the official key or
recharge page.
Configuration
Defaults are production-ready. Override only when necessary:
- id: seedance2
config:
apiBaseUrl: https://www.seedance2ai.io
apiKeyEnv: SEEDANCE2_PUBLIC_API_KEY
requestTimeoutMs: 30000
pollIntervalMs: 3000
imageWaitTimeoutMs: 300000
videoWaitTimeoutMs: 900000
maxRetries: 2
retryDelayMs: 500
requireApproval: true
allowLocalHttp: false
Put this row in $DSH_HOME/profiles/web/cordis.patch.yml. Harness replaces the
whole config row, so keep every setting. Disable approval only for a trusted,
deliberately budgeted automation.
Validate
npm run check
npm test
npm run pack:check
The package ships plain JavaScript and needs no install-time build script.
