Coding

runapi-sdk

Try it

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.

What it does

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

The skill document

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/ (e.g. @runapi.ai/suno)
    • Python: runapi- (e.g. runapi-suno)
    • Ruby: runapi- (e.g. runapi-suno)
    • Go: github.com/runapi-ai/-sdk/go
    • Java: ai.runapi:runapi- (e.g. ai.runapi:runapi-suno)
    • PHP: runapi-ai/ (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

Related skills

Join meeting

Join a video meeting as an AI bot with voice, avatar, and screenshare across four operating modes.

by johnpatternai22 installs8 stars

Memory

Stores durable facts in a categorized, plain-markdown vault on disk, alongside your agent's built-in memory.

by Iván559 installs18 stars

diagram-generator

Generate and edit Draw.io, Mermaid, and Excalidraw diagrams from natural language using a structured JSON spec.

by nssa.io1.0k installs47 stars

Productivity

Find why your productivity system keeps failing, then apply the smallest fix — capacity math, bottleneck routing, durable local notes.

by Iván855 installs69 stars

AdMapix

Fetch raw ad creative, app, ranking, and revenue data from AdMapix as structured JSON.

by fly0pants4.3k installs296 stars

More from runapi-ai

Browse all skills

suno

Generate, extend, and transform music or compose lyrics with Suno models via RunAPI's CLI or SDK.

by runapi-ai11 installs

runapi-cli

Run one-off RunAPI service commands from the terminal with JSON requests and inspect results synchronously or via polling.

by runapi-ai11 installs

gpt-image

Generate and edit images with GPT Image through RunAPI. Use when the user asks an agent to create, edit, or transform images with GPT Image. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend.

by runapi-ai13 installs

elevenlabs

Generate speech, dialogue, and sound with ElevenLabs through RunAPI. Use when the user asks an agent to create speech, dialogue, or sound effects, or transcribe audio with ElevenLabs. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend.

by runapi-ai12 installs

flux-kontext

Generate and edit images with Flux Kontext through RunAPI. Use when the user asks an agent to create, edit, or transform images with Flux Kontext. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend.

by runapi-ai12 installs

gpt-image-2

Generate and edit images with GPT Image 2 through RunAPI. Use when the user asks an agent to create, edit, or transform images with GPT Image 2. Default to the RunAPI CLI for one-off generation; use SDKs only when the user is integrating RunAPI into an app or backend.

by runapi-ai12 installs