{"id":"4f5c2d54-b1ce-4895-a56d-cf03ebc8f140","entityType":"agent","slug":"clawhub-runapi-ai-runapi-sdk","name":"runapi-sdk","canonicalUrl":"https://www.xpersona.co/agent/clawhub-runapi-ai-runapi-sdk","canonicalPath":"/agent/clawhub-runapi-ai-runapi-sdk","generatedAt":"2026-10-14T05:37:09.324Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-12T02:38:08.091Z","emptyReason":null},"description":"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.","descriptionLabel":"Source description","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 953 downloads reported by the source. Last updated 10/12/2026.","installCommand":"clawhub skill install s1771k6pjxksnjws51x2htfjvd876syh:runapi-sdk","sourceUrl":"https://clawhub.ai/runapi-ai/runapi-sdk","homepage":"https://clawhub.ai/runapi-ai/skills/runapi-sdk","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/runapi-ai/runapi-sdk","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/runapi-ai/skills/runapi-sdk","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":60,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"runapi-sdk technical dossier on Xpersona with agent coverage, OPENCLEW support, and live trust metadata."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-12T02:38:08.091Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-12T02:38:08.091Z","emptyReason":null},"stars":null,"forks":null,"downloads":953,"likes":null,"task":null,"library":null,"packageName":null,"latestVersion":"0.2.8","tractionLabel":"953 downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-12T02:38:08.085Z","emptyReason":null},"lastUpdatedAt":"2026-10-12T02:38:08.091Z","lastCrawledAt":"2026-10-12T02:38:08.085Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-13T02:38:08.085Z","lastVerifiedAt":null,"highlights":[{"version":"0.2.8","createdAt":"2026-08-12T06:25:05.041Z","changelog":"## Changed - Route application and production integrations through SDKs while directing one-off results to the RunAPI CLI.","fileCount":3,"zipByteSize":2985},{"version":"0.2.7","createdAt":"2026-08-10T14:12:58.439Z","changelog":"## Changed - Complete marketplace distribution for the RunAPI SDK skill.","fileCount":3,"zipByteSize":2917},{"version":"0.2.4","createdAt":"2026-05-23T18:38:32.340Z","changelog":"Agent-facing CLI-first redesign","fileCount":3,"zipByteSize":2454}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s1771k6pjxksnjws51x2htfjvd876syh:runapi-sdk","setupComplexity":"low","setupSteps":["Install using `clawhub skill install s1771k6pjxksnjws51x2htfjvd876syh:runapi-sdk` in an isolated environment before connecting it to live workloads.","No published capability contract is available yet, so validate auth and request/response behavior manually.","Review the upstream CLAWHUB listing at https://clawhub.ai/runapi-ai/runapi-sdk before using production credentials."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-sdk/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-sdk/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-sdk/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-sdk/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-sdk/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-sdk/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-14T05:37:09.324Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-sdk/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-sdk/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-sdk/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-runapi-ai-runapi-sdk/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-12T02:38:08.091Z","emptyReason":null},"readme":"Skill: runapi-sdk\n\nOwner: runapi-ai\n\nSummary: 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.\n\nTags: latest:0.2.8\n\nVersion history:\n\nv0.2.8 | 2026-08-12T06:25:05.041Z | user\n\n## Changed\n- Route application and production integrations through SDKs while directing one-off results to the RunAPI CLI.\n\nv0.2.7 | 2026-08-10T14:12:58.439Z | user\n\n## Changed\n- Complete marketplace distribution for the RunAPI SDK skill.\n\nv0.2.4 | 2026-05-23T18:38:32.340Z | user\n\nAgent-facing CLI-first redesign\n\nArchive index:\n\nArchive v0.2.8: 3 files, 2985 bytes\n\nFiles: skill-card.md (2476b), SKILL.md (3258b), _meta.json (129b)\n\nFile v0.2.8:SKILL.md\n\n---\nname: runapi-sdk\ndescription: 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.\ndocumentation: https://runapi.ai/models.md\ncatalog: https://runapi.ai/models.md\nmetadata:\n  openclaw:\n    always: true\n    homepage: https://runapi.ai/models\n---\n\n# RunAPI SDK selection\n\nUse this skill to help an **application developer** pick and wire up RunAPI SDK\npackages for JavaScript, Python, Ruby, Go, Java, or PHP.\n\nChoose from the requested deliverable: a one-off artifact or result uses the\nRunAPI CLI; an app, backend, worker, library, or production code integration\nuses an SDK.\n\n## Critical: SDK Integration Runtime\n\nWhen the user is integrating RunAPI into an app, backend, worker, library,\nRails service, Node service, Ruby codebase, Go service, webhook pipeline, or\nproduction workflow, start here before CLI/API docs. First confirm the target\nlanguage and current Provider Client package, then inspect the package README or\nsource for install commands, client methods (`create`, `get`, `run`), response\nshape, and error classes.\n\nNever shell out to the `runapi` CLI as the production runtime integration\nlayer.\n\n## When NOT to use this skill\n\nDo not use for one-off generation or agent-executed media tasks. If the user\njust wants an agent to create, edit, transform, or transcribe media once, use\nthe RunAPI CLI skill instead: https://github.com/runapi-ai/cli-skill.\n\nReach for an SDK only when building a web app, backend, worker, library, or\nproduction codebase that calls RunAPI from its own code.\n\n## Core SDK vs Provider Client packages\n\n- **Core SDK** — shared client primitives (auth, HTTP, polling, errors). Install\n  it transitively via a Provider Client package; depend on it directly only for custom\n  clients.\n  - JavaScript / TypeScript: `@runapi.ai/core`\n  - Python: `runapi-core`\n  - Ruby: `runapi-core`\n  - Go: `github.com/runapi-ai/core-sdk/go`\n  - Java: `ai.runapi:runapi-core`\n  - PHP: `runapi-ai/core`\n- **Provider Client packages** — one typed package per model line, built on the core SDK.\n  - JavaScript / TypeScript: `@runapi.ai/<model>` (e.g. `@runapi.ai/suno`)\n  - Python: `runapi-<model>` (e.g. `runapi-suno`)\n  - Ruby: `runapi-<model>` (e.g. `runapi-suno`)\n  - Go: `github.com/runapi-ai/<model>-sdk/go`\n  - Java: `ai.runapi:runapi-<model>` (e.g. `ai.runapi:runapi-suno`)\n  - PHP: `runapi-ai/<model>` (e.g. `runapi-ai/suno`)\n\nInstall only the Provider Client packages an application actually uses; each pulls the core\nSDK as a dependency.\n\n## Generated file storage\n\nRunAPI-generated file URLs are temporary. Download and store any images,\nvideos, audio, or other generated files in your own durable storage within 7\ndays; do not treat returned file URLs as long-term assets.\n\n## Authentication\n\nKeep the RunAPI API key in `RUNAPI_API_KEY` (or pass it to the client\nconstructor); never commit secrets.\n\n## References\n\n- Browse every RunAPI model and SDK package: https://runapi.ai/models.md\n\nFile v0.2.8:_meta.json\n\n{\n  \"ownerId\": \"kn70me4rk7jqjt92evshjeb5z18768g7\",\n  \"slug\": \"runapi-sdk\",\n  \"version\": \"0.2.8\",\n  \"publishedAt\": 1786515905041\n}\n\nFile v0.2.8:skill-card.md\n\n## Description:\n\nChoose RunAPI SDK packages for application developers building web apps, backends, workers, or libraries.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[runapi-ai](https://clawhub.ai/user/runapi-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and engineers use this skill to choose the appropriate RunAPI SDK or provider client package for application, backend, worker, library, or production integrations.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: A developer may install the wrong or stale RunAPI package for a target model or language.\n\nMitigation: Verify package names and client methods against RunAPI's current documentation before adding dependencies.\n\nRisk: A RunAPI API key may be exposed if copied into source code or committed configuration.\n\nMitigation: Keep RUNAPI_API_KEY in environment variables or a secret manager and do not commit secrets.\n\nRisk: RunAPI-generated file URLs may expire before downstream systems retain the generated asset.\n\nMitigation: Download generated files and store them in durable application-owned storage within 7 days.\n\nRisk: Using the RunAPI CLI as a production runtime layer can create a brittle application integration.\n\nMitigation: Use the relevant RunAPI SDK or provider client package for application, backend, worker, library, and production code paths.\n\n## Reference(s):\n\n- [RunAPI models and SDK packages](https://runapi.ai/models.md)\n- [RunAPI models homepage](https://runapi.ai/models)\n- [ClawHub publisher profile: runapi-ai](https://clawhub.ai/user/runapi-ai)\n- [ClawHub skill page: runapi-sdk](https://clawhub.ai/runapi-ai/skills/runapi-sdk)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown guidance with package names, install commands, configuration notes, and code-oriented integration advice]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May reference language-specific RunAPI provider clients, RUNAPI_API_KEY handling, and durable storage guidance for generated file URLs.]\n\n## Skill Version(s):\n\n0.2.8 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v0.2.7: 3 files, 2917 bytes\n\nFiles: skill-card.md (2261b), SKILL.md (3090b), _meta.json (129b)\n\nFile v0.2.7:SKILL.md\n\n---\nname: runapi-sdk\ndescription: 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.\ndocumentation: https://runapi.ai/models.md\ncatalog: https://runapi.ai/models.md\nmetadata:\n  openclaw:\n    always: true\n    homepage: https://runapi.ai/models\n---\n\n# RunAPI SDK selection\n\nUse this skill to help an **application developer** pick and wire up RunAPI SDK\npackages for JavaScript, Python, Ruby, Go, Java, or PHP.\n\n## Critical: SDK Integration Runtime\n\nWhen the user is integrating RunAPI into an app, backend, worker, library,\nRails service, Node service, Ruby codebase, Go service, webhook pipeline, or\nproduction workflow, start here before CLI/API docs. First confirm the target\nlanguage and current Provider Client package, then inspect the package README or\nsource for install commands, client methods (`create`, `get`, `run`), response\nshape, and error classes.\n\nNever shell out to the `runapi` CLI as the production runtime integration\nlayer.\n\n## When NOT to use this skill\n\nDo not use for one-off generation or agent-executed media tasks. If the user\njust wants an agent to create, edit, transform, or transcribe media once, use\nthe RunAPI CLI skill instead: https://github.com/runapi-ai/cli-skill.\n\nReach for an SDK only when building a web app, backend, worker, library, or\nproduction codebase that calls RunAPI from its own code.\n\n## Core SDK vs Provider Client packages\n\n- **Core SDK** — shared client primitives (auth, HTTP, polling, errors). Install\n  it transitively via a Provider Client package; depend on it directly only for custom\n  clients.\n  - JavaScript / TypeScript: `@runapi.ai/core`\n  - Python: `runapi-core`\n  - Ruby: `runapi-core`\n  - Go: `github.com/runapi-ai/core-sdk/go`\n  - Java: `ai.runapi:runapi-core`\n  - PHP: `runapi-ai/core`\n- **Provider Client packages** — one typed package per model line, built on the core SDK.\n  - JavaScript / TypeScript: `@runapi.ai/<model>` (e.g. `@runapi.ai/suno`)\n  - Python: `runapi-<model>` (e.g. `runapi-suno`)\n  - Ruby: `runapi-<model>` (e.g. `runapi-suno`)\n  - Go: `github.com/runapi-ai/<model>-sdk/go`\n  - Java: `ai.runapi:runapi-<model>` (e.g. `ai.runapi:runapi-suno`)\n  - PHP: `runapi-ai/<model>` (e.g. `runapi-ai/suno`)\n\nInstall only the Provider Client packages an application actually uses; each pulls the core\nSDK as a dependency.\n\n## Generated file storage\n\nRunAPI-generated file URLs are temporary. Download and store any images,\nvideos, audio, or other generated files in your own durable storage within 7\ndays; do not treat returned file URLs as long-term assets.\n\n## Authentication\n\nKeep the RunAPI API key in `RUNAPI_API_KEY` (or pass it to the client\nconstructor); never commit secrets.\n\n## References\n\n- Browse every RunAPI model and SDK package: https://runapi.ai/models.md\n\nFile v0.2.7:_meta.json\n\n{\n  \"ownerId\": \"kn70me4rk7jqjt92evshjeb5z18768g7\",\n  \"slug\": \"runapi-sdk\",\n  \"version\": \"0.2.7\",\n  \"publishedAt\": 1786371178439\n}\n\nFile v0.2.7:skill-card.md\n\n## Description:\n\nChoose RunAPI SDK packages for application developers building web apps, backends, workers, or libraries.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[runapi-ai](https://clawhub.ai/user/runapi-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and engineers use this skill to choose and wire up RunAPI SDK packages for JavaScript, Python, Ruby, Go, Java, or PHP application integrations. It helps agents distinguish production SDK integration from one-off CLI-driven media generation.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Generated integration guidance may reference SDK documentation and package READMEs that change over time.\n\nMitigation: Review the current RunAPI SDK documentation and package README for the selected language and provider before shipping an integration.\n\nRisk: RunAPI API keys could be exposed if copied into source code or logs.\n\nMitigation: Keep RUNAPI_API_KEY in environment variables or secret storage and avoid committing or logging secrets.\n\nRisk: Returned generated-file URLs are temporary and may expire before an application stores them.\n\nMitigation: Download generated images, videos, audio, or other files into durable application storage within the documented retention window.\n\n## Reference(s):\n\n- [RunAPI model and SDK catalog](https://runapi.ai/models.md)\n- [RunAPI models homepage](https://runapi.ai/models)\n- [ClawHub skill page](https://clawhub.ai/runapi-ai/skills/runapi-sdk)\n\n## Skill Output:\n\n**Output Type(s):** [guidance, markdown, code, shell commands, configuration]\n\n**Output Format:** [Markdown guidance with package names, install commands, code snippets, and configuration notes]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May refer to RunAPI SDK package READMEs and documentation for language-specific client methods, response shapes, and errors.]\n\n## Skill Version(s):\n\n0.2.7 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v0.2.4: 3 files, 2454 bytes\n\nFiles: skill-card.md (2291b), SKILL.md (1969b), _meta.json (129b)\n\nFile v0.2.4:SKILL.md\n\n---\nname: sdk\ndescription: 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/Ruby/Go packages, or understand core-sdk vs model SDKs. Do not use for one-off generation or agent-executed media tasks; use the RunAPI CLI or the relevant model skill instead.\ndocumentation: https://runapi.ai/models.md\ncatalog: https://runapi.ai/models.md\nmetadata:\n  openclaw:\n    always: true\n    homepage: https://runapi.ai/models\n---\n\n# RunAPI SDK selection\n\nUse this skill to help an **application developer** pick and wire up RunAPI SDK\npackages for JavaScript, Ruby, or Go.\n\n## When NOT to use this skill\n\nDo not use for one-off generation or agent-executed media tasks. If the user\njust wants an agent to create, edit, transform, or transcribe media once, use\nthe RunAPI CLI (the `runapi-cli` skill) or the relevant model skill instead —\nnot an SDK.\n\nReach for an SDK only when building a web app, backend, worker, library, or\nproduction codebase that calls RunAPI from its own code.\n\n## Core SDK vs model SDKs\n\n- **Core SDK** — shared client primitives (auth, HTTP, polling, errors). Install\n  it transitively via a model SDK; depend on it directly only for custom\n  clients.\n  - JavaScript / TypeScript: `@runapi.ai/core`\n  - Ruby: `runapi-core`\n  - Go: `github.com/runapi-ai/core-sdk/go`\n- **Model SDKs** — one typed package per model line, built on the core SDK.\n  - JavaScript / TypeScript: `@runapi.ai/<model>` (e.g. `@runapi.ai/suno`)\n  - Ruby: `runapi-<model>` (e.g. `runapi-suno`)\n  - Go: `github.com/runapi-ai/<model>-sdk/go`\n\nInstall only the model SDKs an application actually uses; each pulls the core\nSDK as a dependency.\n\n## Authentication\n\nKeep the RunAPI API key in `RUNAPI_API_KEY` (or pass it to the client\nconstructor); never commit secrets.\n\n## References\n\n- Browse every RunAPI model and SDK package: https://runapi.ai/models.md\n\nFile v0.2.4:_meta.json\n\n{\n  \"ownerId\": \"kn70me4rk7jqjt92evshjeb5z18768g7\",\n  \"slug\": \"runapi-sdk\",\n  \"version\": \"0.2.4\",\n  \"publishedAt\": 1779561512340\n}\n\nFile v0.2.4:skill-card.md\n\n## Description: <br>\nHelps application developers choose and wire up RunAPI SDK packages for JavaScript, Ruby, or Go. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[runapi-ai](https://clawhub.ai/user/runapi-ai) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nDevelopers and engineers use this skill when integrating RunAPI into applications, backends, workers, or libraries. It helps them select core or model-specific SDK packages, understand language package names, and handle API-key configuration. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: RunAPI credentials can be exposed if copied into source code or committed to version control. <br>\nMitigation: Keep the API key in RUNAPI_API_KEY or pass it through a secure client configuration path, and never commit secrets. <br>\nRisk: Adding SDK packages without review can introduce unsuitable dependencies into production applications. <br>\nMitigation: Review model-specific SDK packages before production use and install only the packages the application actually needs. <br>\nRisk: Using an SDK workflow for one-off media generation can add unnecessary application integration overhead. <br>\nMitigation: Use the RunAPI CLI or a model-specific skill for one-off media tasks. <br>\n\n\n## Reference(s): <br>\n- [RunAPI models and SDK package catalog](https://runapi.ai/models) <br>\n- [RunAPI models markdown catalog](https://runapi.ai/models.md) <br>\n- [ClawHub skill listing](https://clawhub.ai/runapi-ai/runapi-sdk) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [guidance, markdown, code, shell commands, configuration] <br>\n**Output Format:** [Markdown with package names, environment-variable guidance, and code or command snippets when useful] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [No files are produced by the skill itself.] <br>\n\n## Skill Version(s): <br>\n0.2.4 (source: server release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>","readmeExcerpt":"Skill: runapi-sdk Owner: runapi-ai Summary: 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 in","codeSnippets":[],"executableExamples":[],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: runapi-sdk\ndescription: 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.\ndocumentation: https://runapi.ai/models.md\ncatalog: https://runapi.ai/models.md\nmetadata:\n  openclaw:\n    always: true\n    homepage: https://runapi.ai/models\n---\n\n# RunAPI SDK selection\n\nUse this skill to help an **application developer** pick and wire up RunAPI SDK\npackages for JavaScript, Python, Ruby, Go, Java, or PHP.\n\nChoose from the requested deliverable: a one-off artifact or result uses the\nRunAPI CLI; an app, backend, worker, library, or production code integration\nuses an SDK.\n\n## Critical: SDK Integration Runtime\n\nWhen the user is integrating RunAPI into an app, backend, worker, library,\nRails service, Node service, Ruby codebase, Go service, webhook pipeline, or\nproduction workflow, start here before CLI/API docs. First confirm the target\nlanguage and current Provider Client package, then inspect the package README or\nsource for install commands, client methods (`create`, `get`, `run`), response\nshape, and error classes.\n\nNever shell out to the `runapi` CLI as the production runtime integration\nlayer.\n\n## When NOT to use this skill\n\nDo not use for one-off generation or agent-executed media tasks. If the user\njust wants an agent to create, edit, transform, or transcribe media once, use\nthe RunAPI CLI skill instead: https://github.com/runapi-ai/cli-skill.\n\nReach for an SDK only when building a web app, backend, worker, library, or\nproduction codebase that calls RunAPI from its own code.\n\n## Core SDK vs Provider Client packages\n\n- **Core SDK** — shared client primitives (auth, HTTP, polling, errors). Install\n  it transitively via a Provider Client package; depend on it directly only for custom\n  clients.\n  - JavaScript / TypeScript: `@runapi.ai/core`\n  - Python: `runapi-core`\n  - Ruby: `runapi-core`\n  - Go: `github.com/runapi-ai/core-sdk/go`\n  - Java: `ai.runapi:runapi-core`\n  - PHP: `runapi-ai/core`\n- **Provider Client packages** — one typed package per model line, built on the core SDK.\n  - JavaScript / TypeScript: `@runapi.ai/<model>` (e.g. `@runapi.ai/suno`)\n  - Python: `runapi-<model>` (e.g. `runapi-suno`)\n  - Ruby: `runapi-<model>` (e.g. `runapi-suno`)\n  - Go: `github.com/runapi-ai/<model>-sdk/go`\n  - Java: `ai.runapi:runapi-<model>` (e.g. `ai.runapi:runapi-suno`)\n  - PHP: `runapi-ai/<model>` (e.g. `runapi-ai/suno`)\n\nInstall only the Provider Client packages an application actually uses; each pulls the core\nSDK as a dependency.\n\n## Generated file storage\n\nRunAPI-generated file URLs are temporary. Download and store any images,\nvideos, audio, or other generated files in your own durable storage within 7\ndays; do not treat r"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn70me4rk7jqjt92evshjeb5z18768g7\",\n  \"slug\": \"runapi-sdk\",\n  \"version\": \"0.2.8\",\n  \"publishedAt\": 1786515905041\n}"},{"path":"skill-card.md","content":"## Description:\n\nChoose RunAPI SDK packages for application developers building web apps, backends, workers, or libraries.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[runapi-ai](https://clawhub.ai/user/runapi-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and engineers use this skill to choose the appropriate RunAPI SDK or provider client package for application, backend, worker, library, or production integrations.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: A developer may install the wrong or stale RunAPI package for a target model or language.\n\nMitigation: Verify package names and client methods against RunAPI's current documentation before adding dependencies.\n\nRisk: A RunAPI API key may be exposed if copied into source code or committed configuration.\n\nMitigation: Keep RUNAPI_API_KEY in environment variables or a secret manager and do not commit secrets.\n\nRisk: RunAPI-generated file URLs may expire before downstream systems retain the generated asset.\n\nMitigation: Download generated files and store them in durable application-owned storage within 7 days.\n\nRisk: Using the RunAPI CLI as a production runtime layer can create a brittle application integration.\n\nMitigation: Use the relevant RunAPI SDK or provider client package for application, backend, worker, library, and production code paths.\n\n## Reference(s):\n\n- [RunAPI models and SDK packages](https://runapi.ai/models.md)\n- [RunAPI models homepage](https://runapi.ai/models)\n- [ClawHub publisher profile: runapi-ai](https://clawhub.ai/user/runapi-ai)\n- [ClawHub skill page: runapi-sdk](https://clawhub.ai/runapi-ai/skills/runapi-sdk)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown guidance with package names, install commands, configuration notes, and code-oriented integration advice]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May reference language-specific RunAPI provider clients, RUNAPI_API_KEY handling, and durable storage guidance for generated file URLs.]\n\n## Skill Version(s):\n\n0.2.8 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":null,"editorialQuality":{"score":100,"threshold":65,"status":"thin","wordCount":1221,"uniquenessScore":41,"reasons":["uniqueness-below-45"]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-12T02:38:08.091Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-12T02:38:08.091Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-14T05:37:09.324Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}