RunningHub-API
    • 开始
    • 更新日志
    • 指引
      • 模型 API 错误码说明
      • 关于nodeInfoList
      • 原生ComfyUI接口支持
      • 接口错误码说明
    • 接入示例
      • AI应用完整接入示例
      • AI应用完整接入示例高阶版
      • 任务进度显示示例
      • 工作流完整接入示例
    • AI 应用
      • 发起AI应用任务
        POST
      • 获取AI应用API调用示例
        GET
      • 获取公共模型列表
        POST
    • ComfyUI 工作流
      • 发起ComfyUI任务1-简易
        POST
      • 发起ComfyUI任务2-高级
        POST
      • 获取工作流Json
        POST
      • 取消ComfyUI任务
        POST
    • 模型API
      • 视频生成与处理
        • image-to-video
          • Vidu
            • Vidu-首尾帧生视频-q2-pro
            • Vidu-首尾帧生视频-q2-turbo
            • Vidu-图生视频-q2-pro
            • Vidu-首尾帧生视频-q3-pro
            • Vidu-图生视频-q2-turbo
            • Vidu-图生视频-q2-pro-fast
            • Vidu-首尾帧生视频-q3-turbo
            • Vidu-图生视频-q3-turbo
            • Vidu-首尾帧生视频-q2-pro-fast
            • Vidu-图生视频-q3-pro
          • 可灵图生视频o1
            • 可灵图生视频o1
          • 可灵首尾帧生视频o1
            • 可灵首尾帧生视频o1
          • seedance
            • seedance-v1.5-pro-image-to-video-fast
            • seedance-v1.5-pro-image-to-video
          • 海螺
            • 海螺-02-标准
            • 海螺-02-图生视频-标准
            • 海螺-2.3-图生视频-标准
            • 海螺-2.3-fast-图生视频
            • 海螺-2.3-fast-pro-图生视频
            • 海螺-2.3-图生视频-pro
            • 海螺-02-图生视频-pro
            • 海螺-02-fast
          • 悠船图生视频
            • 悠船图生视频
          • 全能视频V3.1
            • 全能视频V3.1-pro-首尾帧生视频-低价渠道版
            • 全能视频V3.1-fast-首尾帧生视频-低价渠道版
            • 全能视频V3.1-Lite图生视频-官方稳定版
            • 全能视频V3.1-pro-图生视频-官方稳定版
            • 全能视频V3.1-fast-图生视频-低价渠道版
            • 全能视频V3.1-pro-参考生视频-官方稳定版
            • 全能视频V3.1-fast-图生视频-官方稳定版
            • 全能视频V3.1-pro-图生视频-低价渠道版
          • 全能视频S
            • 全能视频S-图生视频-支持真人-官方稳定版
            • 全能视频S-文生视频-pro-官方稳定版
            • 全能视频S-图生视频-pro-官方稳定版
            • 全能视频S-图生视频-pro-低价渠道版-已下架
            • 全能视频S-图生视频-官方稳定版
            • 全能视频S-图生视频-低价渠道版
          • 万相2.2
            • 万相2.2-首尾帧生视频
            • 万相2.2-图生视频
          • kling
            • kling-elements
          • 可灵图生视频2.5
            • 可灵图生视频2.5-turbo-std
            • 可灵图生视频2.5-turbo-pro
          • ltx
            • ltx-2.3/image-to-video-lora
            • ltx-2.3/image-to-video
          • 全能视频X
            • 全能视频X-图生视频-低价渠道版-v1.5
            • 全能视频X-图生视频-官方稳定版
          • 万相2.6
            • 万相2.6-参考生视频
            • 万相2.6-参考生视频Flash
            • 万相2.6-图生视频Flash
            • 万相2.6-图生视频
          • 万相2.7
            • 万相2.7-图生视频
          • 万相2.5 Preview 图生视频
            • 万相2.5 Preview 图生视频
          • 可灵图生视频o3
            • 可灵图生视频o3-pro
            • 可灵图生视频o3-4k
            • 可灵图生视频o3-std
          • 可灵图生视频3.0
            • 可灵图生视频3.0-pro
            • 可灵图生视频3.0-std
          • PixVerse V6 图生视频
            • PixVerse V6 图生视频
          • seedance2.0
            • 图生视频
              • seedance2.0/图生视频
            • seedance2.0-Fast/图生视频
          • 可灵图生视频2.6
            • 可灵图生视频2.6-pro
          • 可灵图生视频v3
            • 可灵图生视频v3-4k
          • happyhorse
            • happyhorse-1.0/image-to-video
          • SkyReels V4 图生视频
            • SkyReels V4 图生视频-fast
            • SkyReels V4 图生视频-std
        • reference-to-video
          • 可灵参考生视频o1
          • Vidu-参考生视频-q3-mix
          • 万相2.7-参考生视频
          • kling-video-o3-pro/reference-to-video
          • kling-video-o3-std/reference-to-video
          • seedance2.0/多模态视频
          • 可灵参考生视频o3-4k
          • Vidu-参考生视频-q3
          • seedance2.0-Fast/多模态视频
          • happyhorse-1.0/reference-to-video
          • Vidu-参考生视频-q2
          • seedance-v1-lite-reference-to-video
          • SkyReels V4 Omni 参考视频-fast
          • SkyReels V4 Omni 参考视频-std
          • 全能视频X-多图参考生视频-官方稳定版
          • 全能视频V3.1-fast-参考生视频-官方稳定版
        • text-to-video
          • Vidu
            • Vidu-文生视频-q2
            • Vidu-文生视频-q3-turbo
            • Vidu-文生视频-q3-pro
          • 可灵文生视频o1
            • 可灵文生视频o1
          • seedance
            • seedance-v1.5-pro-text-to-video-fast
            • seedance-v1.5-pro-text-to-video
          • 海螺
            • 海螺-02-pro
            • 海螺-02-文生视频-标准
            • 海螺-2.3-文生视频-标准
            • 海螺-2.3-文生视频-pro
            • 海螺-02-文生视频-pro
          • 全能视频V3.1
            • 全能视频V3.1-pro-文生视频-低价渠道版
            • 全能视频V3.1-Lite首尾帧生视频-官方稳定版
            • 全能视频V3.1-Lite文生视频-官方稳定版
            • 全能视频V3.1-fast-文生视频-低价渠道版
            • 全能视频V3.1-pro-文生视频-官方稳定版
            • 全能视频V3.1-fast-视频扩展-官方稳定版
            • 全能视频V3.1-pro-视频扩展-官方稳定版
            • 全能视频V3.1-fast-文生视频-官方稳定版
          • 全能视频X
            • 全能视频X-文生视频-官方稳定版
            • 全能视频X-文生视频-低价渠道版-v1.5
          • 万相2.2
            • 万相2.2-文生视频
          • 可灵文生视频2.5
            • 可灵文生视频2.5-turbo-pro
            • 可灵文生视频2.5-turbo-std
          • 可灵文生视频2.6
            • 可灵文生视频2.6-pro
          • ltx
            • ltx-2.3/text-to-video-lora
            • ltx-2.3/text-to-video
          • 万相2.6
            • 万相2.6-文生视频
          • 全能视频S
            • 全能视频S-文生视频-pro-低价渠道版-已下架
            • 全能视频S-文生视频-官方稳定版
            • 全能视频S-文生视频-低价渠道版
          • 万相2.7
            • 万相2.7-文生视频
          • 万相2.5 Preview 文生视频
            • 万相2.5 Preview 文生视频
          • 可灵文生视频o3
            • 可灵文生视频o3-pro
            • 可灵文生视频o3-4k
            • 可灵文生视频o3-std
          • 可灵文生视频3.0
            • 可灵文生视频3.0-pro
            • 可灵文生视频3.0-std
          • PixVerse V6 文生视频
            • PixVerse V6 文生视频
          • seedance2.0
            • 文生视频
              • seedance2.0/文生视频
            • seedance2.0-Fast/文生视频
          • 可灵文生视频v3
            • 可灵文生视频v3-4k
          • happyhorse
            • happyhorse-1.0/text-to-video
          • SkyReels V4 文生视频
            • SkyReels V4 文生视频-fast
            • SkyReels V4 文生视频-std
        • video-edit
          • happyhorse-1.0/video-edit
          • 全能视频X-编辑视频-官方稳定版
          • 万相2.7-视频编辑
          • kling-video-o3-pro/video-edit
          • 可灵视频编辑o1
          • kling-video-o3-std/video-edit
        • video-tools
          • 可灵 o3 创建主体
          • 火山字幕擦除-视频字幕擦除(精细化版)
          • PixVerse V6 视频续写
          • RH视频超分
          • 全能视频S-角色上传-低价渠道版
          • PixVerse V6 转场
          • RH视频帧率增强
          • 火山字幕擦除-视频字幕擦除(标准版)
        • motion-control
          • 即梦/动作模仿2.0
          • 可灵动作控制V3.0-pro
          • kling-v2.6-pro-动作控制
          • 可灵动作控制V3.0-std
          • kling-v2.6-std-动作控制
        • audio-to-video
          • 可灵对口型-视频生成
          • 可灵对口型-人脸识别
        • video-extend
          • 万相2.7-视频续写
          • 全能视频X-视频续写-官方稳定版
        • video-to-video
          • 万相 2.2 角色动作迁移
      • 3D 生成与处理
        • text-to-3D
          • 混元文生3D模型v3.1
        • image-to-3D
          • 混元图生3D模型v3.1
          • hitem3d-v2/image-to-3d
          • hitem3d-v15/multi-image-to-3d
          • hitem3d-v2/multi-image-to-3d
          • hitem3d-portrait-v21/image-to-3d
          • hitem3d-portrait-v21/multi-image-to-3d
          • hitem3d-portrait-v20/image-to-3d
          • hitem3d-portrait-v20/multi-image-to-3d
          • hitem3d-portrait-v15/image-to-3d
          • hitem3d-portrait-v15/multi-image-to-3d
          • hitem3d-v15/image-to-3d
      • 图像生成与处理
        • image-to-image
          • seedream
            • seedream-v5-lite-图生图
            • seedream-v4-图生图
            • seedream-v4.5-图生图
          • 全能图片X
            • 全能图片X-图片编辑-官方稳定版
            • 全能图片X-图生图-低价渠道版
            • 全能图片X-高质量图片编辑-官方稳定版
          • f
            • f-2-dev/edit-lora
            • f-2-dev/edit
            • f-2-klein-9b/edit
            • f-2-klein-4b/edit
            • f-2-klein-4b/edit-lora
            • f-kontext-dev-lora
          • qwen
            • qwen-image/edit-2511-lora
            • qwen-image/edit-2511
          • z
            • z-image-turbo/image-to-image-lora
            • z-image-turbo/image-to-image
          • wan
            • wan-2.2/image-to-image
          • 万相2.5 Preview 图生图
            • 万相2.5 Preview 图生图
          • 悠船文生图
            • 悠船文生图-v8.1
            • 悠船文生图-v6
          • 全能图片V1
            • 全能图片V1-图生图-官方稳定版
            • 全能图片V1-图生图-低价渠道版
          • 全能图片PRO
            • 全能图片PRO-图生图-官方稳定版
            • 全能图片PRO-图生图-低价渠道版
            • 全能图片PRO-图生图Ultra-官方稳定版
          • 千问2.0
            • 千问2.0-图像编辑
          • 千问2.0Pro
            • 千问2.0Pro-图像编辑
          • 全能图片V2
            • 全能图片V2-图生图-低价渠道版
            • 全能图片V2-图生图-官方稳定版
          • 全能图片G
            • 全能图片G-2.0-图生图-低价渠道版
            • 全能图片G-2-图生图-官方稳定版
            • 全能图片G-1.5-图生图-低价渠道版-(已下架) 可用全能图片G-2 模型代替
            • 全能图片G-1.5-图生图-官方稳定版
          • 即梦图片 4.6 图生图
            • 即梦图片 4.6 图生图
        • text-to-image
          • seedream
            • seedream-v5-lite-文生图
            • seedream-v4-文生图
            • seedream-v4.5-文生图
          • 全能图片X
            • 全能图片X-文生图-低价渠道版
            • 全能图片X-文生图片-官方稳定版
            • 全能图片X-高质量文生图-官方稳定版
          • qwen
            • qwen-image/text-to-image-2512-lora
            • qwen-image/text-to-image-2512
          • z
            • z-image/turbo-lora
            • z-image/turbo
          • f
            • f-2-dev/text-to-image-lora
            • f-2-dev/text-to-image
            • f-2-klein-9b/text-to-image-lora
            • f-2-klein-9b/text-to-image
            • f-2-klein-4b/text-to-image
            • f-2-klein-4b/text-to-image-lora
            • f-krea-dev-lora
            • f-dev-lora
            • f-dev
          • wan
            • wan-2.2/text-to-image-lora
          • 万相2.7
            • 万相2.7-文生图Pro
            • 万相2.7-文生图
          • 万相2.5 Preview 文生图
            • 万相2.5 Preview 文生图
          • 悠船文生图
            • 悠船文生图-niji6
            • 悠船文生图-v61
            • 悠船文生图-v7
            • 悠船文生图-niji7
          • 全能图片V1
            • 全能图片V1-文生图-官方稳定版
            • 全能图片V1-文生图-低价渠道版
          • 全能图片PRO
            • 全能图片PRO-文生图-官方稳定版
            • 全能图片PRO-文生图-低价渠道版
            • 全能图片PRO-文生图Ultra-官方稳定版
          • 千问2.0
            • 千问2.0-文生图
          • 千问2.0Pro
            • 千问2.0Pro-文生图
          • 全能图片V2
            • 全能图片V2-文生图-官方稳定版
            • 全能图片V2-文生图-低价渠道版
          • 全能图片G
            • 全能图片G-2-文生图-官方稳定版
            • 全能图片G-2.0-文生图-低价渠道版
            • 全能图片G-1.5-文生图-官方稳定版
            • 全能图片G-1.5-文生图-低价渠道版-(已下架) 可用全能图片G-2 模型代替
          • 即梦图片 4.6 文生图
            • 即梦图片 4.6 文生图
        • image-tools
          • 万相2.7-图像编辑Pro
          • 万相2.7-图像编辑
        • reference-to-image
          • Vidu-参考生视频-q2-pro
      • 音频生成与处理
        • text-to-audio
          • minimax/speech-2.8-turbo
          • minimax/music-2.5
          • 可灵对口型-语音合成
          • minimax/speech-2.6-turbo
          • minimax/speech-2.6-hd
          • minimax/speech-02-turbo
          • minimax/speech-02-hd
          • minimax/speech-2.8-hd
          • minimax/voice-clone
          • MiniMax Music 2.6 纯音乐生成
          • MiniMax Music 2.6 文生音乐
        • text-to-music
          • suno-single-v5.5
          • suno-custom-v5.5
          • suno-single-v5
          • suno-custom-v5
          • suno-single-v4.5
          • suno-custom-v4.5
        • text-to-lyrics
          • suno-歌词生成
        • video-to-audio
          • 分离音频-Other
          • 分离音频-Vocals
          • 分离音频
    • 任务和查询 & webhook
      • 查询任务状态
        POST
      • 查询任务生成结果
        POST
      • 获取webhook事件详情
        POST
      • 重新发送指定webhook事件
        POST
      • 查询任务生成结果 V2
        POST
      • 模型 API 价格预估
        POST
    • 资源上传
      • 文件上传
      • 上传资源(弃用)
      • 上传Lora-获取Lora上传地址
    • 账户相关
      • 获取账户信息
      • 查询 APIKEY 列表
      • 查询指定 APIKEY 下队列状态
    • 数据模型
      • RTaskCreateResponse
      • 获取工作流Json Request
      • 获取工作流Json Response
      • TaskRunWebappByKeyRequest
      • 发起ComfyUI任务 Request 1
      • NodeInfo
      • 发起ComfyUI任务 Request 2
      • 发起ComfyUI任务 Request-webhook
      • 发起ComfyUI任务 Response
      • TaskCreateResponse
      • 查询任务状态 Request
      • 节点输入信息
      • 获取账户信息 Request
      • 上传资源Request
      • 获取webhook事件详情Request
      • 重新发送指定webhook Request
      • R?
      • RWorkflowDuplicateResponse
      • RAccountStatusResponse
      • WorkflowDuplicateResponse
      • AccountStatusResponse
      • WorkflowDuplicateRequest
      • ApiUploadLoraRequest
      • RString
      • RTaskUploadResponse
      • TaskUploadResponse
      • 生成任务提交结果

    开始

    平台介绍#

    🎉
    RunningHub API 为开发者提供多模态 AI 能力与大语言模型能力,支持将图像、视频、音频、AI 应用、工作流和 LLM 模型集成到产品或自动化流程中。
    RunningHub API 主要包含以下类型:
    类型说明调用方式
    模型 API直接调用图像、视频、音频等模型能力提交任务后返回 taskId,再查询结果
    AI 应用 API调用已封装的 AI 应用,输入参数更贴近业务场景提交任务后返回 taskId,再查询结果
    工作流 API调用由多个节点编排而成的工作流,适合复杂创作流程提交任务后返回 taskId,再查询结果
    LLM API调用大语言模型能力,兼容 OpenAI / Anthropic / Gemini 协议直接请求接口,支持普通响应或流式响应
    其中,模型 API、AI 应用 API、工作流 API 通常采用任务型调用流程:
    提交任务 → 获取 taskId → 查询任务状态 → 获取结果
    LLM API 采用兼容协议调用方式:
    选择模型 → 发起请求 → 获取文本或流式响应
    注意:模型 API 和 LLM API 仅支持企业级-共享 API Key 调用。

    快速开始#

    1. 注册平台账号#

    1
    访问 RunningHub 国内站
    访问 RunningHub 官网,点击登录 / 注册。
    2
    完成账号注册
    使用手机号和短信验证码完成注册。
    3
    获得个人账户
    注册成功后,您将获得一个个人账户。
    个人账户是使用 RunningHub 的基础身份。无论后续是创建团队、加入团队、创建 API Key,还是查看任务与账单或 LLM 调用日志,都会基于这个个人账户进行。
    注册成功后,默认使用个人账户。个人账户内的资源、任务、余额和 API Key 均归属于个人主体。
    个人账户是使用 RunningHub API 的基础身份。平台的主要用户也以个人账户为主;团队账户是在个人账户基础上,为企业或组织提供统一管理能力。

    2. 个人账户和团队账户#

    RunningHub 中的团队账户不是另一套独立登录账号,而是建立在个人账户之上的企业级协作与结算主体。
    每个用户始终使用自己的个人账户登录。登录后,用户可以使用个人账户,也可以创建或加入团队账户。
    个人账户适合大多数创作者、开发者和个人商业使用场景,任务与账单、LLM 调用日志会记录到个人维度。团队账户主要面向企业或组织,用于成员协作、团队资源与额度分配、统一结算,并按团队维度记录任务与账单、LLM 调用日志,同时保留实际调用成员。
    项目个人账户团队账户
    登录方式使用个人账户登录成员仍使用自己的个人账户登录
    账户定位默认使用主体,适合大多数个人创作者、开发者和个人商业使用企业或组织主体,适合统一管理与协作
    资源归属资源、任务、余额和 API Key 归个人所有团队资源、团队钱包、成员席位和成员额度可统一管理;团队账户下创建或使用的 API Key 归属于团队主体
    API Key 归属归个人主体归团队主体
    钱包 / 余额使用个人钱包、个人 RH 币使用团队资源池、成员钱包、席位权益
    任务与账单 / LLM 调用日志记录到个人维度记录到团队维度,并保留实际调用成员
    适合场景个人创作、开发集成、个人商业使用企业级调用、成员协作、统一结算、成员与资源管理
    可以简单理解为:
    个人账户 = 登录身份 + 默认使用主体
    团队账户 = 建立在个人账户之上的企业级协作与结算主体
    加入团队不会改变你的个人账户,也不会自动迁移你的个人资源。它只是让你的个人账户获得访问某个团队账户的权限。

    3. 创建或加入团队账户#

    1
    创建团队账户
    注册并登录后,可以在控制台创建团队账户。
    2
    成为团队管理员
    创建团队账户的用户会自动成为团队管理员,同时也是团队成员。管理员可以管理团队信息、团队成员、团队钱包、成员席位和团队账单。
    3
    邀请团队成员
    团队成员通过邀请链接加入团队。成员加入后,仍然使用自己的个人账户登录,但可以在团队账户下使用团队分配的资源和权限。
    4
    切换团队账户
    当用户切换到团队账户后,API Key 的创建、调用消耗、任务与账单以及 LLM 调用日志会按团队主体处理。
    如果团队开启审核,成员加入需要管理员审批;如果未开启审核,成员可以通过邀请链接直接加入。

    4. 获取 API Key#

    登录后访问 API Key 页面,在 API Key 管理页面创建密钥。
    后续调用 API 时,需要在请求中携带 API Key。不同 API 的具体传参方式以对应接口文档和示例代码为准。
    创建或使用 API Key 前,请确认:
    当前使用的是个人账户还是团队账户
    API Key 类型是否符合目标 API 的调用要求
    钱包余额或团队余额是否充足
    是否需要调用模型 API 或 LLM API
    是否已具备企业级-共享 API Key
    企业级-独占 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 调用权益对比 查看:
    前往 API Key 页面

    第一次调用#

    1. 调用模型 API / AI 应用 API / 工作流 API#

    模型 API、AI 应用 API 和工作流 API 通常采用任务型调用流程。
    1
    提交任务
    调用目标 API,提交任务参数。
    2
    获取 taskId
    接口会返回 taskId。
    3
    查询任务结果
    使用 taskId 查询任务状态和结果。
    第一步,提交任务:
    第二步,查询任务结果:

    2. 调用 LLM API#

    LLM API 兼容 OpenAI / Anthropic / Gemini 协议。以下是 curl 调用示例:
    注意:LLM API 只支持企业级-共享 API Key。消费级-会员 Key 和企业级-独占 Key 无法调用 LLM API。

    推荐开始路径#

    如果你是第一次使用 RunningHub API,建议按以下路径开始:
    1
    注册并登录 RunningHub 账户
    访问 RunningHub 官网,完成平台注册并登录。
    2
    选择账户主体
    根据使用场景选择个人账户或创建 / 加入团队账户。
    3
    创建企业级-共享 API Key
    如果需要调用模型 API 或 LLM API,创建企业级-共享 API Key。
    4
    选择目标 API
    如果只需要调用 AI 应用 API 或工作流 API,可根据权益选择消费级-会员、企业级-共享或企业级-独占 Key。
    5
    完成第一次调用
    在文档中心选择目标 API,复制示例代码完成第一次调用。模型 API、AI 应用 API 和工作流 API 的任务和消耗明细可在 任务与账单 中查看;LLM API 的调用记录可在 LLM 调用日志 中查看。
    修改于 2026-07-05 12:58:06
    下一页
    更新日志
    Built with