SDK

RunAPI SDK。
210+ AI 模型的类型化客户端。

RunAPI SDK 为 Python、Node.js、PHP、Java、Ruby 和 Go 应用提供同一套类型化集成层，覆盖视频、图像、音乐、音频和 LLM 工作流。选择模型 SDK，设置 RUNAPI_API_KEY，创建任务，然后用 REST API 相同的任务生命周期轮询或接收 webhook。

免费获取 API Key 打开 SDK 文档
Python · Node.js · PHP · Java · Ruby · Go · REST 兼容
SDK 选择器

选择模型系列和运行时，然后打开生成的 SDK 文档。

runapi.ai
npm install @runapi.ai/kling

export RUNAPI_API_KEY="runapi_..."

node create-video.mjs
pip install runapi-kling

export RUNAPI_API_KEY="runapi_..."

python create_video.py
composer require runapi-ai/kling

export RUNAPI_API_KEY="runapi_..."

php create-video.php
implementation(platform("ai.runapi:runapi-bom:0.1.1"))
implementation("ai.runapi:runapi-kling")

export RUNAPI_API_KEY="runapi_..."

./gradlew run
gem install runapi-kling

export RUNAPI_API_KEY="runapi_..."

ruby create_video.rb
go get github.com/runapi-ai/kling-sdk/go

export RUNAPI_API_KEY="runapi_..."

go run ./cmd/create-video
不同运行时的包可用状态不同。PHP 包已在 Packagist 发布，可直接通过 Composer 安装。
模型专属 SDK 共享同一套任务对象、认证、错误处理和价格链接。
SDK 覆盖范围
133 个模型

导出的 SDK contract 列出媒体和 LLM 端点中的 133 个公开模型 ID。

85 个操作

SDK contract 映射 85 个请求操作，让客户端保持端点名称和模型 ID 对齐。

6 种语言

Python、Node.js、PHP、Java、Ruby 和 Go SDK 包已为模型专属集成准备好；其他运行时可直接使用 REST。

1 套任务生命周期

创建、轮询、webhook 回调和失败处理在不同模型系列间保持一致。

这是什么

RunAPI SDK 是什么？

RunAPI SDK 是一组面向 RunAPI 平台的模型专属客户端。每个包封装一个模型系列，提供类型化请求、共享认证、任务轮询和响应解析。开发者在视频、图像、音乐、音频和 LLM 模型之间切换时，可以保留同一把 API key、账户、任务 ID、callback 模式和错误接口。

最后更新：2026 年 7 月 6 日 RunAPI Editorial Team 审阅
安装

为你使用的模型选择 SDK。

RunAPI 维护模型 SDK，而不是要求每个应用安装所有模型。先从你的模型系列对应的包开始，产品需要更多工作流时再添加更多包。

npm install @runapi.ai/kling
npm install @runapi.ai/suno
npm install @runapi.ai/flux-kontext
pip install runapi-kling
pip install runapi-suno
pip install runapi-flux-kontext
composer require runapi-ai/kling
composer require runapi-ai/suno
composer require runapi-ai/seedream
implementation("ai.runapi:runapi-kling")
implementation("ai.runapi:runapi-suno")
implementation("ai.runapi:runapi-flux-kontext")
gem install runapi-kling
gem install runapi-suno
gem install runapi-flux-kontext
go get github.com/runapi-ai/kling-sdk/go
go get github.com/runapi-ai/suno-sdk/go
go get github.com/runapi-ai/flux-kontext-sdk/go
不同运行时的包可用状态不同。PHP 包已在 Packagist 发布，可直接通过 Composer 安装。
能力

SDK 为生产应用处理什么

类型化模型请求

每个模型 SDK 暴露与 RunAPI contract 匹配的请求字段，让应用代码使用模型 ID 和端点参数，而不用在每个服务里复制原始 API 示例。

异步任务轮询

长时间运行的媒体任务会返回任务 ID。SDK helper 保持这套生命周期：创建任务、轮询状态，并在生成完成或失败时读取终态输出对象。

统一认证

同一把 RUNAPI_API_KEY 可用于支持的模型 SDK，并复用相同的账户任务生命周期。

工作方式

4 步调用模型

01

选择模型 SDK

选择与你要集成的模型系列匹配的包，例如 Kling 用于视频，Suno 用于音乐，Flux Kontext 用于图像工作流。

Package: runapi-ai/kling
02

设置 API key

把 key 存入 RUNAPI_API_KEY。SDK 读取 REST API、CLI、MCP Server 和 agent skills 使用的同一把 key。

export RUNAPI_API_KEY=...
03

创建任务

通过 SDK 发送类型化请求。媒体端点会快速返回 RunAPI 任务 ID，让应用不用阻塞 Web 请求。

client.textToVideo.run(...)
04

轮询或使用 webhook

从 worker 轮询任务，或配置 callback URL，让 RunAPI 在生成进入终态时通知你的后端。

task.status == "completed"
常用 SDK 包

从模型专属 SDK 开始

浏览 SDK 模型
包 语言 适合场景 文档
@runapi.ai/kling JavaScript Kling 视频生成 查看 →
runapi-kling Python Kling 视频生成 查看 →
runapi-ai/kling PHP Kling 视频生成 查看 →
runapi-kling Ruby Kling 视频生成 查看 →
github.com/runapi-ai/kling-sdk/go Go Kling 视频生成 查看 →
ai.runapi:runapi-kling Java Kling 视频生成 查看 →
@runapi.ai/suno JavaScript Suno 音乐生成 查看 →
runapi-ai/suno PHP Suno 音乐生成 查看 →
@runapi.ai/flux-kontext JavaScript Flux Kontext 图像工作流 查看 →
@runapi.ai/core JavaScript 共享 SDK runtime helpers 查看 →
SDK VS REST

什么时候用 SDK、REST、CLI 或 skills

SDK

应用后端代码

类型化 helper、包管理升级、共享任务轮询，以及模型专属请求字段。

REST API

任意语言或轻量集成

直接 HTTP 调用，使用同一把 API key、端点路径、任务 ID 和 callback 行为。

CLI

本地脚本和 CI job

JSON 优先的终端命令，适合自动化、smoke test 和一次性生成任务。

Agent skills

Claude Code、Codex、Cursor 和 agent runtime

可安装的模型上下文，让 coding agent 找到文档、schema 和接入说明。

相关开发资源

在每个开发接口使用同一个模型目录

SDK 文档

在生成的 API reference 中阅读模型专属 SDK 文档和包链接。

查看 →

模型目录

选择 SDK 前比较支持的模型 ID、端点名称、价格链接和能力。

查看 →

CLI

用 CLI 做自动化和快速 smoke test，并复用相同任务生命周期。

查看 →

Agent skills

当你希望 AI assistant 帮你把 SDK 接入应用时，把模型上下文安装进 coding agents。

查看 →
FAQ

RunAPI SDK 常见问题

RunAPI SDK 支持哪些语言？

RunAPI 维护 Python、Node.js、PHP、Java、Ruby 和 Go 的模型专属 SDK。PHP 包已在 Packagist 发布，可通过 Composer 安装。每个包面向一个模型系列；Elixir、.NET 和任何能发送 HTTPS 请求的运行时都可以继续使用 REST API。

为什么 RunAPI SDK 是模型专属的？

模型专属包让应用依赖更小，也让请求字段更容易理解。视频应用可以安装 Kling 或 Seedance，音乐应用可以安装 Suno，多模态后端可以随着新工作流上线继续添加包。

SDK contract 覆盖多少模型？

当前导出的 contract 覆盖 133 个公开模型 ID 和 85 个请求操作。该 contract 从 RunAPI 目录生成，用于保持 SDK 示例、CLI metadata 和 API 文档一致。

SDK 调用会用不同的 API key 吗？

不会。SDK 调用使用与 REST、CLI、MCP 和 agent skills 相同的 RunAPI API key。请把它存入 RUNAPI_API_KEY 或部署 secret manager，不要硬编码进源码。

SDK 可以使用 webhook 吗？

可以。SDK 创建的任务使用与 REST 请求相同的任务生命周期。你可以从 worker 轮询任务状态，也可以配置 callback handling，让 RunAPI 发送终态任务 payload 到你的后端。

使用 SDK 前应该在哪里查看价格？

集成模型前请查看模型目录和价格页。SDK 文档会链接回模型页，让开发者查看当前计费单位、端点形态和支持的模型 ID，而不用把价格数值复制进代码。

用类型化 SDK 和一把 RunAPI key 开始构建。

选择模型 SDK，创建免费 API key，并在视频、图像、音乐、音频和 LLM 功能中复用同一套任务生命周期。

免费获取 API Key 打开 SDK 文档