HiAPIAI/hiapi-seedance-2-5-video-skill
hiapi-seedance-2-5-video
VerifiedPlan, 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 9.8 KB |
| agents/openai.yaml | config | 361 B |
| assets/social-preview-seedance-2-5.png | binary | 1.6 MB |
| references/api.md | markdown | 4.8 KB |
| references/output.md | markdown | 2.0 KB |
| references/upgrade-policy.md | markdown | 1.7 KB |
| references/workflow.md | markdown | 5.1 KB |
| scripts/check-config.mjsexecutable | script | 812 B |
| scripts/hiapi-seedance-2-video.mjsexecutable | script | 1.4 KB |
| scripts/install.mjsexecutable | script | 5.7 KB |
| scripts/lib/seedance-2-video.mjs | script | 39.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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 119k | Updated | Claude CodeCodex | Verified | Install |
| 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: 118k | Updated | Claude CodeCodex | Verified | Install |
| 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: 108k | Updated | Claude CodeCodex | Verified | Install |
| 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: 108k | Updated | Claude CodeCodex | Verified | Install |