sdklisted
Install: claude install-skill runapi-ai/sdk-skill
# RunAPI SDK selection
Use this skill to help an **application developer** pick and wire up RunAPI SDK
packages for JavaScript, Ruby, or Go.
## When NOT to use this skill
Do not use for one-off generation or agent-executed media tasks. If the user
just wants an agent to create, edit, transform, or transcribe media once, use
the RunAPI CLI (the `runapi-cli` skill) or the relevant model skill instead —
not an SDK.
Reach for an SDK only when building a web app, backend, worker, library, or
production codebase that calls RunAPI from its own code.
## Core SDK vs model SDKs
- **Core SDK** — shared client primitives (auth, HTTP, polling, errors). Install
it transitively via a model SDK; depend on it directly only for custom
clients.
- JavaScript / TypeScript: `@runapi.ai/core`
- Ruby: `runapi-core`
- Go: `github.com/runapi-ai/core-sdk/go`
- **Model SDKs** — one typed package per model line, built on the core SDK.
- JavaScript / TypeScript: `@runapi.ai/<model>` (e.g. `@runapi.ai/suno`)
- Ruby: `runapi-<model>` (e.g. `runapi-suno`)
- Go: `github.com/runapi-ai/<model>-sdk/go`
Install only the model SDKs an application actually uses; each pulls the core
SDK as a dependency.
## Authentication
Keep the RunAPI API key in `RUNAPI_API_KEY` (or pass it to the client
constructor); never commit secrets.
## References
- Browse every RunAPI model and SDK package: https://runapi.ai/models.md