---
title: "RunAPI SDK — 面向 210+ AI 模型的 Python、Node.js、PHP、Java、Ruby 和 Go SDK"
url: "https://runapi.ai/zh-CN/sdk.md"
canonical: "https://runapi.ai/zh-CN/sdk"
locale: "zh-CN"
---

# RunAPI SDK

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

## What is the RunAPI SDK?

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

## Install

```bash
npm install @runapi.ai/kling
pip install runapi-kling
composer require runapi-ai/kling
gem install runapi-kling
go get github.com/runapi-ai/kling-sdk/go
```

## How it works

1. **选择模型 SDK** — 选择与你要集成的模型系列匹配的包，例如 Kling 用于视频，Suno 用于音乐，Flux Kontext 用于图像工作流。
2. **设置 API key** — 把 key 存入 RUNAPI_API_KEY。SDK 读取 REST API、CLI、MCP Server 和 agent skills 使用的同一把 key。
3. **创建任务** — 通过 SDK 发送类型化请求。媒体端点会快速返回 RunAPI 任务 ID，让应用不用阻塞 Web 请求。
4. **轮询或使用 webhook** — 从 worker 轮询任务，或配置 callback URL，让 RunAPI 在生成进入终态时通知你的后端。

## Popular SDK packages

- [@runapi.ai/kling](https://www.npmjs.com/package/@runapi.ai/kling) — JavaScript, Kling 视频生成
- [runapi-kling](https://pypi.org/project/runapi-kling/) — Python, Kling 视频生成
- [runapi-ai/kling](https://packagist.org/packages/runapi-ai/kling) — PHP, Kling 视频生成
- [runapi-kling](https://rubygems.org/gems/runapi-kling) — Ruby, Kling 视频生成
- [github.com/runapi-ai/kling-sdk/go](https://pkg.go.dev/github.com/runapi-ai/kling-sdk/go) — Go, Kling 视频生成
- [ai.runapi:runapi-kling](https://central.sonatype.com/artifact/ai.runapi/runapi-kling) — Java, Kling 视频生成
- [@runapi.ai/suno](https://www.npmjs.com/package/@runapi.ai/suno) — JavaScript, Suno 音乐生成
- [runapi-ai/suno](https://packagist.org/packages/runapi-ai/suno) — PHP, Suno 音乐生成
- [@runapi.ai/flux-kontext](https://www.npmjs.com/package/@runapi.ai/flux-kontext) — JavaScript, Flux Kontext 图像工作流
- [@runapi.ai/core](https://www.npmjs.com/package/@runapi.ai/core) — JavaScript, 共享 SDK runtime helpers

## FAQ

### 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，而不用把价格数值复制进代码。


## Links

- [SDK docs](https://runapi.ai/zh-CN/docs#runapi-sdks)
- [Model catalog](https://runapi.ai/zh-CN/models)
- [Pricing](https://runapi.ai/zh-CN/pricing)
- [CLI](https://runapi.ai/zh-CN/cli)
- [Agent skills](https://runapi.ai/zh-CN/skills)