SuperAPI AI 工具集

runapi-sdk

编程与开发

查看项目

更新于 10-16 08:11

技能介绍

用途:帮助应用开发者挑选并接入 RunAPI SDK,适用于构建 Web 应用、后端、Worker、库或生产代码的项目。

选择依据:如果是一次性产物或结果,使用 RunAPI CLI;如果是应用、后端、Worker、库或生产代码集成,则使用 SDK。

接入要点:当用户把 RunAPI 集成进应用、后端、Worker、库、Rails/Node/Ruby/Go 服务、Webhook 流水线或生产工作流时,先确认目标语言与当前 Provider Client 包,再查看包的 README 或源码,了解安装命令、客户端方法(create、get、run)、响应结构与错误类。不要用 runapi CLI 作为生产运行时的集成层。

包的分类:Core SDK 提供共享客户端基础能力(认证、HTTP、轮询、错误),通常经由 Provider Client 包间接安装,仅在编写自定义客户端时直接依赖。各语言对应: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 包按模型线划分,构建于 Core SDK 之上:JavaScript/TypeScript 为 @runapi.ai/<model>(如 @runapi.ai/suno),Python 为 runapi-<model>(如 runapi-suno),Ruby 为 runapi-<model>(如 runapi-suno),Go 为 github.com/runapi-ai/<model>-sdk/go,Java 为 ai.runapi:runapi-<model>(如 ai.runapi:runapi-suno),PHP 为 runapi-ai/<model>(如 runapi-ai/suno)。只安装应用实际用到的 Provider Client 包,它们会把 Core SDK 作为依赖引入。

文件存储:RunAPI 生成的文件 URL 是临时的,应在 7 天内把图片、视频、音频等生成文件下载并存入自己的持久化存储,不要把返回的文件 URL 当作长期资产。

认证:将 RunAPI API key 保存在 RUNAPI_API_KEY(或传给客户端构造函数),不要提交密钥。

适用场景:构建需要从自身代码调用 RunAPI 的 Web 应用、后端、Worker、库或生产代码库。不适用:一次性生成或由智能体执行的媒体任务,若只是让智能体创建、编辑、转换或转录一次媒体,应改用 RunAPI CLI 技能。

限制:资料未提供具体安装命令示例、各 SDK 方法的完整参数、错误码列表、价格与配额信息;可浏览 https://runapi.ai/models.md 查看所有模型与 SDK 包。