nexu-io/openmotion / skills/openmotion-media
openmotion-media
UnverifiedGenerate, 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.4 KB |
| agents/openai.yaml | config | 359 B |
| references/inspection.md | markdown | 5.5 KB |
| references/jobs.md | markdown | 8.5 KB |
| references/planning.md | markdown | 3.6 KB |
| references/providers/account.md | markdown | 8.0 KB |
| references/providers/atlascloud.md | markdown | 7.4 KB |
| references/providers/codex.md | markdown | 1.6 KB |
| references/providers/compatible.md | markdown | 6.4 KB |
| references/providers/fal.md | markdown | 8.3 KB |
| references/providers/opendesign.md | markdown | 14.3 KB |
| references/providers/wavespeed.md | markdown | 6.4 KB |
| references/setup.md | markdown | 3.1 KB |
references/providers/atlascloud.md
View on GitHub# Atlas Cloud 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**. `ATLASCLOUD_API_KEY` is the environment alternative; the 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 arguments.
```json
{"action":"models","provider":"atlascloud","refresh":true,"modality":"image","query":"nano-banana","limit":20}
```
Discovery reads the public catalogue `GET https://api.atlascloud.ai/api/v1/models`. Read the response `data` array. Change or omit modality/query for video/audio. The tool returns normalized metadata, not every model's input schema. Confirm the selected model in the current [model library](https://www.atlascloud.ai/models) and read its API schema. Public discovery and cached/built-in examples do not establish key validity, balance or model entitlement.
## Request templates
These JSON objects are `openmotion_assets_use` arguments. Assign a unique requestId per intended generation. Verify current availability and schema first; generation can incur charges.
Image — [Nano Banana 2 text-to-image](https://www.atlascloud.ai/models/google/nano-banana-2/text-to-image):
```json
{"action":"generate","requestId":"atlas-image-01","model":"atlascloud:google/nano-banana-2/text-to-image","modality":"image","mode":"text-to-image","prompt":"A ceramic cup on a wooden table, soft morning light","parameters":{"aspect_ratio":"1:1","resolution":"1k","output_format":"png"}}
```
Video — [Seedance 2.0 text-to-video](https://www.atlascloud.ai/models/bytedance/seedance-2.0/text-to-video):
```json
{"action":"generate","requestId":"atlas-video-01","model":"atlascloud:bytedance/seedance-2.0/text-to-video","modality":"video","mode":"text-to-video","prompt":"Steam rises from a ceramic cup as the camera slowly moves closer","parameters":{"duration":5,"resolution":"720p","aspect_ratio":"16:9","generate_audio":false}}
```
Speech — [audio input guide](https://www.atlascloud.ai/docs/models/audio):
```json
{"action":"generate","requestId":"atlas-speech-01","model":"atlascloud:bytedance/seed-audio-1.0","modality":"audio","mode":"text-to-speech","prompt":"Welcome to a quiet morning.","parameters":{"format":"mp3","sample_rate":24000}}
```
Instrumental music — the same audio guide documents Suno's non-custom prompt input:
```json
{"action":"generate","requestId":"atlas-music-01","model":"atlascloud:suno/chirp-v5","modality":"audio","mode":"text-to-audio","prompt":"A gentle instrumental piano piece for a quiet morning","parameters":{"instrumental":true}}
```
Suno can return multiple tracks. Custom lyrics/style modes have different required fields; consult the schema rather than reusing this minimal prompt template.
Wire mapping (paths relative to `https://api.atlascloud.ai`):
| Modality | POST path | JSON body |
| --- | --- | --- |
| Image | `/api/v1/model/generateImage` | `{model,prompt,...parameters}` |
| Video | `/api/v1/model/generateVideo` | `{model,prompt,...parameters}` |
| Speech (`text-to-speech`) | `/api/v1/model/generateAudio` | `{model,text,...parameters}` |
| Music (`text-to-audio`) | `/api/v1/model/generateAudio` | `{model,prompt,...parameters}` |
Reference-media URLs, if the selected model supports them, belong in provider-native parameters. This tool does not upload local paths. Speech transcription, lyrics-only, LLM and 3D outputs are outside the media-file adapter.
## Polling and result
Read the envelope `code` and `data.id`; the adapter polls that same prediction at `GET /api/v1/model/prediction/{data.id}`. It waits through nonterminal states; `completed` / `succeeded` imports media from `data.outputs`. `failed`, `timeout`, `cancelled` or `canceled` ends local processing. Image Base64 output is also recognized. Agent polling uses the local ID, not the remote prediction ID:
```json
{"action":"status","jobId":"LOCAL_JOB_ID_FROM_GENERATE"}
```
Submission is never automatically retried. Polling failure/local timeout does not prove a remote stop; cancellation is local and does not guarantee refunds. Query the original prediction before creating another billable task.
## Error interpretation
The [official error guide](https://www.atlascloud.ai/docs/errors) separates HTTP status, media response `{code,msg,request_id,data}` and asynchronous task failure (`data.error_code`, `data.error`). `X-Request-ID` can identify a call for support when available. Interpret the code in its actual layer.
| Signal | Actual possible meaning / next action |
| --- | --- |
| HTTP 400 | Malformed JSON, missing model, wrong content type or invalid request option. Inspect the submitted body and provider message. |
| HTTP 401 | Missing, unknown or expired key; **a wrong URL path can also return 401 because authentication precedes routing**. Verify `api.atlascloud.ai`, exact `/api/v1/model/...` path, Bearer scheme and saved-vs-environment key source. A 401 alone does not prove an incorrect key. |
| HTTP 402 | Balance/plan allowance exhausted. Check available funds or allowance; retrying unchanged cannot fix it. |
| HTTP 403 / 404 | Permission/scope or unavailable resource/model. A Coding Plan key may not permit the selected model. Verify account access and model ID. |
| HTTP 413 / 451 | Body too large (50 MB limit) / regional restriction. Use supported media URLs or resolve account/region access. |
| HTTP 429 | Account/model rate limit. Reduce concurrency and back off. Media APIs do not promise Retry-After or rate-limit headers. |
| HTTP 500 / 503 / 504 | Internal/unavailable service or synchronous wait timeout. Inspect an existing prediction before any new POST; an unknown outcome can still incur a charge. |
| Task `error_code: 1039` | Content moderation failure. Review the prompt/reference and provider detail; changing the key does not address it. Other task codes require the actual provider explanation. |
Current OpenMotion non-2xx handling omits the raw provider error body/headers. Its `credentials or permissions rejected` suffix is synthesized locally, not an Atlas diagnostic. When `msg`, `request_id` or `error_code` is unavailable, state that the exact cause is unknown and inspect provider history/support. Do not claim a missing detail was returned or expose authenticated headers.
## Sources
- [Key creation](https://www.atlascloud.ai/console/api-keys), [authentication](https://www.atlascloud.ai/docs/api-keys)
- [Prediction lifecycle](https://www.atlascloud.ai/docs/predictions), [audio models](https://www.atlascloud.ai/docs/models/audio), [errors and rate limits](https://www.atlascloud.ai/docs/errors)
## Shared parameter discovery
Checked on 2026-11-15: model discovery exposes `generationOptions` for [Nano Banana 2](https://www.atlascloud.ai/docs/more-models/google/nano-banana-2-text-to-image/generateImage), [Seedance 2.0](https://www.atlascloud.ai/docs/more-models/bytedance/seedance-2.0-text-to-video/generateVideo) and [Suno Chirp v4](https://www.atlascloud.ai/docs/more-models/suno/chirp-v4/generateAudio). Studio and MCP consume the same profile. Seedance uses `ratio` and integer `duration` (4–15, or -1 for automatic), while Nano Banana uses `aspect_ratio` and lowercase `resolution` values. Do not copy fields between endpoints. Unknown models keep their provider-specific parameters without an inferred control profile.
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 |