Skip to content

HiAPIAI/hiapi-seedance-2-5-video-skill

hiapi-seedance-2-5-video

Verified

Plan, generate, recover, download, and quality-check Seedance 2.5 videos through HiAPI. Use for Seedance 2.5 text-to-video, first/last-frame image-to-video, multimodal reference-to-video, or a complete brief-to-delivery video workflow.

FileKindSize
SKILL.mdskill md9.8 KB
agents/openai.yamlconfig361 B
assets/social-preview-seedance-2-5.pngbinary1.6 MB
references/api.mdmarkdown4.8 KB
references/output.mdmarkdown2.0 KB
references/upgrade-policy.mdmarkdown1.7 KB
references/workflow.mdmarkdown5.1 KB
scripts/check-config.mjsexecutablescript812 B
scripts/hiapi-seedance-2-video.mjsexecutablescript1.4 KB
scripts/install.mjsexecutablescript5.7 KB
scripts/lib/seedance-2-video.mjsscript39.0 KB

references/output.md

View on GitHub
# Output, Recovery, And Retention

## Lifecycle

1. The CLI prints the idempotency key before submitting.
2. `POST /v1/tasks` returns a task ID.
3. The CLI prints that task ID immediately.
4. It polls `GET /v1/tasks/{taskId}` until success/failure or the local timeout.
5. On success, it prefers a video item when the response contains mixed outputs, downloads HTTP(S) output when possible, and otherwise returns the remote URL.

Example result:

```json
{
  "ok": true,
  "taskId": "tk-hiapi-123",
  "model": "seedance-2.5/text-to-video",
  "idempotencyKey": "stable-job-key",
  "status": "success",
  "output": {
    "kind": "file",
    "path": "/absolute/path/to/outputs/seedance-2-5-20260810-120000.mp4",
    "value": "/absolute/path/to/outputs/seedance-2-5-20260810-120000.mp4",
    "sourceUrl": "https://cdn.example.com/video.mp4"
  }
}
```

## Recovery Rules

- If a task ID exists, use `--resume-task-id`. This never submits a new task.
- If submission acceptance is ambiguous and only an idempotency key exists, retry the exact payload with `--idempotency-key`.
- Never reuse one idempotency key for a changed prompt or parameter set.
- A local timeout is not a remote cancellation.
- A required skill update may block new task creation, but the CLI still permits recovery of an existing task.

## Retention

Temporary output is the default and normally expires after about 7 days. Download accepted output promptly and retain the task ID plus source URL in the local delivery record.

Persistent output storage is billed at the current HiAPI Output Storage rate. Confirm the current price before using it. Deleting a persistent output stops future storage charges.

## Delivery Record

Keep these together:

- creative brief and final prompt;
- source-media provenance and usage rights;
- exact model ID and input settings;
- estimate shown before generation;
- idempotency key and task ID;
- raw downloaded output;
- technical and visual/audio QC notes;
- edited derivatives and publication state.
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall