平台介绍#
RunningHub API 为开发者提供多模态 AI 能力与大语言模型能力,支持将图像、视频、音频、AI 应用、工作流和 LLM 模型集成到产品或自动化流程中。
| 类型 | 说明 | 调用方式 |
|---|
| 模型 API | 直接调用图像、视频、音频等模型能力 | 提交任务后返回 taskId,再查询结果 |
| AI 应用 API | 调用已封装的 AI 应用,输入参数更贴近业务场景 | 提交任务后返回 taskId,再查询结果 |
| 工作流 API | 调用由多个节点编排而成的工作流,适合复杂创作流程 | 提交任务后返回 taskId,再查询结果 |
| LLM API | 调用大语言模型能力,兼容 OpenAI / Anthropic / Gemini 协议 | 直接请求接口,支持普通响应或流式响应 |
其中,模型 API、AI 应用 API、工作流 API 通常采用任务型调用流程:提交任务 → 获取 taskId → 查询任务状态 → 获取结果
注意:模型 API 和 LLM API 仅支持企业级-共享 API Key 调用。
快速开始#
1. 注册平台账号#
个人账户是使用 RunningHub 的基础身份。无论后续是创建团队、加入团队、创建 API Key,还是查看任务与账单或 LLM 调用日志,都会基于这个个人账户进行。注册成功后,默认使用个人账户。个人账户内的资源、任务、余额和 API Key 均归属于个人主体。个人账户是使用 RunningHub API 的基础身份。平台的主要用户也以个人账户为主;团队账户是在个人账户基础上,为企业或组织提供统一管理能力。
2. 个人账户和团队账户#
RunningHub 中的团队账户不是另一套独立登录账号,而是建立在个人账户之上的企业级协作与结算主体。每个用户始终使用自己的个人账户登录。登录后,用户可以使用个人账户,也可以创建或加入团队账户。个人账户适合大多数创作者、开发者和个人商业使用场景,任务与账单、LLM 调用日志会记录到个人维度。团队账户主要面向企业或组织,用于成员协作、团队资源与额度分配、统一结算,并按团队维度记录任务与账单、LLM 调用日志,同时保留实际调用成员。| 项目 | 个人账户 | 团队账户 |
|---|
| 登录方式 | 使用个人账户登录 | 成员仍使用自己的个人账户登录 |
| 账户定位 | 默认使用主体,适合大多数个人创作者、开发者和个人商业使用 | 企业或组织主体,适合统一管理与协作 |
| 资源归属 | 资源、任务、余额和 API Key 归个人所有 | 团队资源、团队钱包、成员席位和成员额度可统一管理;团队账户下创建或使用的 API Key 归属于团队主体 |
| API Key 归属 | 归个人主体 | 归团队主体 |
| 钱包 / 余额 | 使用个人钱包、个人 RH 币 | 使用团队资源池、成员钱包、席位权益 |
| 任务与账单 / LLM 调用日志 | 记录到个人维度 | 记录到团队 维度,并保留实际调用成员 |
| 适合场景 | 个人创作、开发集成、个人商业使用 | 企业级调用、成员协作、统一结算、成员与资源管理 |
个人账户 = 登录身份 + 默认使用主体
团队账户 = 建立在个人账户之上的企业级协作与结算主体
加入团队不会改变你的个人账户,也不会自动迁移你的个人资源。它只是让你的个人账户获得访问某个团队账户的权限。
3. 创建或加入团队账户#
2
成为团队管理员
创建团队账户的用户会自动成为团队管理员,同时也是团队成员。管理员可以管理团队信息、团队成员、团队钱包、成员席位和团队账 单。
3
邀请团队成员
团队成员通过邀请链接加入团队。成员加入后,仍然使用自己的个人账户登录,但可以在团队账户下使用团队分配的资源和权限。
4
切换团队账户
当用户切换到团队账户后,API Key 的创建、调用消耗、任务与账单以及 LLM 调用日志会按团队主体处理。
如果团队开启审核,成员加入需要管理员审批;如果未开启审核,成员可以通过邀请链接直接加入。4. 获取 API Key#
后续调用 API 时,需要在请求中携带 API Key。不同 API 的具体传参方式以对应接口文档和示例代码为准。API Key 类型是否符合目标 API 的调用要求
企业级-独占 Key 需要购买独占机器后才可以创建
RunningHub API Key 主要分为三类:| API Key 类型 | 说明 |
|---|
| 消费级-会员 | 面向个人账户的会员调用权益,适合大多数个人使用场景 |
| 企业级-共享 | 面向企业级按量调用场景,支持模型 API、LLM API、AI 应用 API 和工作流 API |
| 企业级-独占 | 用户购买独占机器后可创建,适合独占资源场景 |
注意:模型 API 和 LLM API 都只支持企业级-共享 API Key 直接调用。
选择 API Key 类型#
不同 API 类型对 API Key 类型有不同要求。开始调用前,请先确认你要调用的 API 类型,并选择可用的 API Key。| API 类型 | 可使用的 API Key |
|---|
| 模型 API | 企业级-共享 |
| LLM API | 企业级-共享 |
| AI 应用 API | 消费级-会员、企业级-共享、企业级-独占 |
| 工作流 API | 消费级-会员、企业级-共享、企业级-独占 |
模型 API 和 LLM API 仅支持企业级-共享 API Key。企业级-独占 Key 需要购买独占机器后才可以创建。
完整的调用权益、并发额度和计费说明,请在密钥页面右上角点击 API Key 调用权益对比 查看:
第一次调用#
1. 调用模型 API / AI 应用 API / 工作流 API#
模型 API、AI 应用 API 和工作流 API 通常采用任务型调用流程。2. 调用 LLM API#
LLM API 兼容 OpenAI / Anthropic / Gemini 协议。以下是 curl 调用示例:注意:LLM API 只支持企业级-共享 API Key。消费级-会员 Key 和企业级-独占 Key 无法调用 LLM API。
推荐开始路径#
如果你是第一次使用 RunningHub API,建议按以下路径开始:2
选择账户主体
根据使用场景选择个人账户或创建 / 加入团队账户。
3
创建企业级-共享 API Key
如果需要调用模型 API 或 LLM API,创建企业级-共享 API Key。
4
选择目标 API
如果只需要调用 AI 应用 API 或工作流 API,可根据权益选择消费级-会员、企业级-共享或企业级-独占 Key。
5
完成第一次调用
在文档中心选择目标 API,复制示例代码完成第一次调用。模型 API、AI 应用 API 和工作流 API 的任务和消耗明细可在
任务与账单 中查看;LLM API 的调用记录可在
LLM 调用日志 中查看。