# Runapi Sdk

> Choose RunAPI SDK packages for application developers building web apps, backends, workers, or libraries. Use when the user asks to integrate RunAPI into code, pick JavaScript/Python/Ruby/Go/Java/PHP packages, or understand core SDK vs Provider Client packages. Do not use for one-off generation or agent-executed media tasks; use the RunAPI CLI or the relevant model skill instead.

- Skill: `runapi-ai/runapi-sdk` (Agent Skill)
- Install (CLI): `npx skillmds@latest add runapi-ai/runapi-sdk`
- Raw SKILL.md: https://api.skillmd.com/api/skills/runapi-ai/runapi-sdk/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: runapi-ai (https://skillmd.com/u/runapi-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/runapi-ai/runapi-sdk

---


# RunAPI SDK selection

Use this skill to help an **application developer** pick and wire up RunAPI SDK
packages for JavaScript, Python, Ruby, Go, Java, or PHP.

Choose from the requested deliverable: a one-off artifact or result uses the
RunAPI CLI; an app, backend, worker, library, or production code integration
uses an SDK.

## Critical: SDK Integration Runtime

When the user is integrating RunAPI into an app, backend, worker, library,
Rails service, Node service, Ruby codebase, Go service, webhook pipeline, or
production workflow, start here before CLI/API docs. First confirm the target
language and current Provider Client package, then inspect the package README or
source for install commands, client methods (`create`, `get`, `run`), response
shape, and error classes.

Never shell out to the `runapi` CLI as the production runtime integration
layer.

## 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 skill instead: https://github.com/runapi-ai/cli-skill.

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 Provider Client packages

- **Core SDK** — shared client primitives (auth, HTTP, polling, errors). Install
  it transitively via a Provider Client package; depend on it directly only for custom
  clients.
  - JavaScript / TypeScript: `@runapi.ai/core`
  - Python: `runapi-core`
  - Ruby: `runapi-core`
  - Go: `github.com/runapi-ai/core-sdk/go`
  - Java: `ai.runapi:runapi-core`
  - PHP: `runapi-ai/core`
- **Provider Client packages** — one typed package per model line, built on the core SDK.
  - JavaScript / TypeScript: `@runapi.ai/<model>` (e.g. `@runapi.ai/suno`)
  - Python: `runapi-<model>` (e.g. `runapi-suno`)
  - Ruby: `runapi-<model>` (e.g. `runapi-suno`)
  - Go: `github.com/runapi-ai/<model>-sdk/go`
  - Java: `ai.runapi:runapi-<model>` (e.g. `ai.runapi:runapi-suno`)
  - PHP: `runapi-ai/<model>` (e.g. `runapi-ai/suno`)

Install only the Provider Client packages an application actually uses; each pulls the core
SDK as a dependency.

## Generated file storage

RunAPI-generated file URLs are temporary. Download and store any images,
videos, audio, or other generated files in your own durable storage within 7
days; do not treat returned file URLs as long-term assets.

## 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