Skip to content

nexu-io/openmotion / skills/openmotion-media

openmotion-media

Unverified

Generate, poll and inspect individual image, video, speech or music assets through openmotion_assets_use after openmotion_media_use discovery (configured Atlas Cloud, fal.ai, WaveSpeedAI or OpenDesign Cloud BYOK providers, or a signed-in OpenDesign account), either when delegated by an OpenMotion film workflow or for a standalone asset-generation request. Native-only tasks with no new speech or music stay outside generation unless explicitly requested. Not a whole-film entry point: creating, recreating, templating, editing or exporting a whole video belongs to the OpenMotion video entries.

references/providers/wavespeed.md

View on GitHub
# WaveSpeedAI BYOK

Checked against official documentation on 2026-11-13. Sections: discovery, request templates, polling, errors, sources.

## Setup and discovery

Save the key in editor **Model providers**. `WAVESPEED_API_KEY` is the environment alternative; a saved key wins. The service injects `Authorization: Bearer ...`. Agents discover with `openmotion_media_use` and generate with `openmotion_assets_use`; never read credential files or put keys in tool arguments.

```json
{"action":"models","provider":"wavespeed","refresh":true,"modality":"video","query":"hunyuan","limit":20}
```

Discovery calls the authenticated `GET https://api.wavespeed.ai/api/v3/models`. The envelope uses `code: 200`; read `data[].model_id`, `name`, `type`. Raw entries can include `api_schema.api_schemas[].request_schema`; the tool returns normalized metadata rather than the full schema. Use the selected model's official API page for required inputs and output format. Change or omit modality/query for image/audio. Cached/built-in entries are not live account or balance checks.

## Request templates

These are `openmotion_assets_use` arguments. Assign a new requestId per intended generation. Check current model availability/schema before submitting; generation can incur charges.

Image — [REST API example](https://wavespeed.ai/docs/rest-api):

```json
{"action":"generate","requestId":"wave-image-01","model":"wavespeed:wavespeed-ai/z-image/turbo","modality":"image","mode":"text-to-image","prompt":"A ceramic cup on a wooden table, soft morning light","parameters":{"size":"1024*1024"}}
```

Video — [Hunyuan text-to-video](https://wavespeed.ai/models/wavespeed-ai/hunyuan-video/t2v):

```json
{"action":"generate","requestId":"wave-video-01","model":"wavespeed:wavespeed-ai/hunyuan-video/t2v","modality":"video","mode":"text-to-video","prompt":"Steam rises from a ceramic cup as the camera slowly moves closer","parameters":{"size":"1280*720"}}
```

Speech — [speech API example](https://wavespeed.ai/docs/generate-speech):

```json
{"action":"generate","requestId":"wave-speech-01","model":"wavespeed:minimax/speech-2.6-hd","modality":"audio","mode":"text-to-speech","prompt":"Welcome to a quiet morning.","parameters":{"voice_id":"Friendly_Person","speed":1}}
```

Voice IDs belong to the selected model. Music/SFX models can also appear in audio discovery, but their schemas differ from speech; do not send `voice_id` or assume a `text` field without checking that model.

Wire mapping: POST `https://api.wavespeed.ai/api/v3/{full model ID}`, body `{...parameters,prompt}` or `{...parameters,text}` for `text-to-speech`. The model ID belongs in the path, not the body.

Reference-media URLs, if supported, go in the selected model's exact parameter fields. Local paths are not uploaded. Only image/video/audio files are imported; LLM, training and 3D outputs are outside this adapter.

## Polling and result

Save the response `data.id`; the adapter polls `GET https://api.wavespeed.ai/api/v3/predictions/{data.id}/result`. It constructs this fixed-origin polling path; it does not forward the key to arbitrary returned URLs. `data.status: completed` imports `data.outputs`; `failed`, `cancelled`, `canceled`, `timeout` or `deleted` stops local processing. Other statuses keep polling. In the Agent workflow use the local ID:

```json
{"action":"status","jobId":"LOCAL_JOB_ID_FROM_GENERATE"}
```

Submission is never automatically retried. The provider recommends backoff for transient **GET** failures, honoring Retry-After where supplied. The current adapter does not implement that read retry: a poll error stops local work while preserving the remote ID. Its worker deadline is fifteen minutes. The remote task may continue; inspect provider history/the original task before any new paid POST. Cancellation is local and does not guarantee a remote stop or refund.

## Error interpretation

Read [authentication](https://wavespeed.ai/docs/api-authentication), [error codes](https://wavespeed.ai/docs/error-codes) and [retry semantics](https://wavespeed.ai/docs/errors-retries-timeouts). HTTP status, top-level envelope `code: 200` and task error codes are different layers; a task success code `0` is not an HTTP status.

| Signal | Actual possible meaning / next action |
| --- | --- |
| HTTP 401 | Missing/invalid authentication. Check API origin/path, Bearer scheme and credential source. Do not infer insufficient balance from 401. |
| HTTP 403 | Key creator's role, endpoint permission or IP allowlist can deny access. For an allowlist, check the service's public outbound IP. `API_KEY_PERMISSION_FORBIDDEN` adds permission evidence if actually returned. |
| HTTP 400 / task 1400 or 1401 | Invalid request, missing required input or invalid parameter. Check model schema, `size` syntax, and `text` versus `prompt`. |
| Task 1200 | Content moderation. Review the prompt/reference against provider policy; unchanged retries are not a fix. |
| Task 1402 | Provider could not fetch reference media. Check public reachability, expiry and format; a local path is not a URL. |
| Task 1407 | Insufficient credits. Check balance; this differs from an authentication failure. |
| HTTP 429 | Rate limit. Reduce concurrency/back off and honor Retry-After if available. Distinguish safe read retries from creating another paid job. |
| Task 1403 / 1405 / 1406 | Execution failure / unknown failure / provider retries exhausted. Inspect task detail/history before deciding whether to regenerate. |
| HTTP 5xx / task 5000, 5003 or 5004 | Internal, unavailable or timed-out processing. A timeout can leave work running; query the original ID before resubmitting. |
| HTTP 400 with code 4005 / 4006 / 4007 | Pricing calculation / media duration / image dimension could not be determined. Inspect the model/input media rather than replacing a key. |

Current OpenMotion non-2xx handling omits raw provider bodies and response headers; failed-task messages can also omit detailed task codes. Its `credentials or permissions rejected` suffix is local wording, not the provider's diagnosis. Report only actually observed codes; if detail is absent, use provider history/support and mark the cause unknown. Never expose keys or authenticated headers.

## Sources

- [Key setup](https://wavespeed.ai/accesskey), [model list/schema](https://wavespeed.ai/docs/list-models)
- [REST API](https://wavespeed.ai/docs/rest-api), [speech](https://wavespeed.ai/docs/generate-speech), [troubleshooting](https://wavespeed.ai/docs/troubleshooting-guide)
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