跳到正文
RunAPI 开发者文档
EN 中文
指南
快速开始指南 · 开始使用 开始前准备快速开始 创建 API Key快速开始 验证连接快速开始 选择 API 类别快速开始 准备生产环境快速开始 API 身份验证指南 · 开始使用 选择正确的密钥API 身份验证 创建 API KeyAPI 身份验证 验证请求API 身份验证 安全保管 API KeyAPI 身份验证 排查身份验证问题API 身份验证 Task API 快速开始指南 · Task API 创建 TaskTask API 快速开始 轮询 TaskTask API 快速开始 处理完成状态Task API 快速开始 处理失败状态Task API 快速开始 接收 callbackTask API 快速开始 LLM API 快速开始指南 · LLM API 选择协议LLM API 快速开始 发送请求LLM API 快速开始 流式接收输出LLM API 快速开始 处理错误与 usageLLM API 快速开始 Platform Management 快速开始指南 · 平台管理 创建 Management KeyPlatform Management 快速开始 列出标准 API KeyPlatform Management 快速开始 创建并轮换密钥Platform Management 快速开始 应用 GuardrailPlatform Management 快速开始 处理管理错误Platform Management 快速开始 SDK开发者资源 · SDK 和 CLI 安装模型 SDKSDK 验证客户端SDK 处理异步 TaskSDK 选择下一步工作流SDK CLI开发者资源 · SDK 和 CLI 安装 CLICLI 身份验证CLI 查看操作说明CLI 运行并等待 TaskCLI 稍后查看 TaskCLI 通过 CC Switch 接入 RunAPI开发者资源 · 工具集成 开始前准备通过 CC Switch 接入 RunAPI 安装 CC Switch通过 CC Switch 接入 RunAPI 添加 RunAPI Provider通过 CC Switch 接入 RunAPI 验证连接通过 CC Switch 接入 RunAPI 排查问题通过 CC Switch 接入 RunAPI Kling Text-to-VideoAPI 参考 概览Kling Text-to-Video 端点Kling Text-to-Video 支持的模型Kling Text-to-Video 请求 SchemaKling Text-to-Video 创建已接受Kling Text-to-Video 轮询处理中Kling Text-to-Video 轮询已完成Kling Text-to-Video 轮询失败Kling Text-to-Video 客户回调：已完成Kling Text-to-Video 客户回调：失败Kling Text-to-Video 错误Kling Text-to-Video 生成的代码示例Kling Text-to-Video 相关指南Kling Text-to-Video HappyHorse Edit-VideoAPI 参考 概览HappyHorse Edit-Video 端点HappyHorse Edit-Video 支持的模型HappyHorse Edit-Video 请求 SchemaHappyHorse Edit-Video 创建已接受HappyHorse Edit-Video 轮询处理中HappyHorse Edit-Video 轮询已完成HappyHorse Edit-Video 轮询失败HappyHorse Edit-Video 客户回调：已完成HappyHorse Edit-Video 客户回调：失败HappyHorse Edit-Video 错误HappyHorse Edit-Video 生成的代码示例HappyHorse Edit-Video 相关指南HappyHorse Edit-Video HappyHorse Image-to-VideoAPI 参考 概览HappyHorse Image-to-Video 端点HappyHorse Image-to-Video 支持的模型HappyHorse Image-to-Video 请求 SchemaHappyHorse Image-to-Video 创建已接受HappyHorse Image-to-Video 轮询处理中HappyHorse Image-to-Video 轮询已完成HappyHorse Image-to-Video 轮询失败HappyHorse Image-to-Video 客户回调：已完成HappyHorse Image-to-Video 客户回调：失败HappyHorse Image-to-Video 错误HappyHorse Image-to-Video 生成的代码示例HappyHorse Image-to-Video 相关指南HappyHorse Image-to-Video HappyHorse Text-to-VideoAPI 参考 概览HappyHorse Text-to-Video 端点HappyHorse Text-to-Video 支持的模型HappyHorse Text-to-Video 请求 SchemaHappyHorse Text-to-Video 创建已接受HappyHorse Text-to-Video 轮询处理中HappyHorse Text-to-Video 轮询已完成HappyHorse Text-to-Video 轮询失败HappyHorse Text-to-Video 客户回调：已完成HappyHorse Text-to-Video 客户回调：失败HappyHorse Text-to-Video 错误HappyHorse Text-to-Video 生成的代码示例HappyHorse Text-to-Video 相关指南HappyHorse Text-to-Video Wan AnimateAPI 参考 概览Wan Animate 端点Wan Animate 支持的模型Wan Animate 请求 SchemaWan Animate 创建已接受Wan Animate 轮询处理中Wan Animate 轮询已完成Wan Animate 轮询失败Wan Animate 客户回调：已完成Wan Animate 客户回调：失败Wan Animate 错误Wan Animate 生成的代码示例Wan Animate 相关指南Wan Animate Wan Edit-VideoAPI 参考 概览Wan Edit-Video 端点Wan Edit-Video 支持的模型Wan Edit-Video 请求 SchemaWan Edit-Video 创建已接受Wan Edit-Video 轮询处理中Wan Edit-Video 轮询已完成Wan Edit-Video 轮询失败Wan Edit-Video 客户回调：已完成Wan Edit-Video 客户回调：失败Wan Edit-Video 错误Wan Edit-Video 生成的代码示例Wan Edit-Video 相关指南Wan Edit-Video Wan Image-to-VideoAPI 参考 概览Wan Image-to-Video 端点Wan Image-to-Video 支持的模型Wan Image-to-Video 请求 SchemaWan Image-to-Video 创建已接受Wan Image-to-Video 轮询处理中Wan Image-to-Video 轮询已完成Wan Image-to-Video 轮询失败Wan Image-to-Video 客户回调：已完成Wan Image-to-Video 客户回调：失败Wan Image-to-Video 错误Wan Image-to-Video 生成的代码示例Wan Image-to-Video 相关指南Wan Image-to-Video Wan Speech-to-VideoAPI 参考 概览Wan Speech-to-Video 端点Wan Speech-to-Video 支持的模型Wan Speech-to-Video 请求 SchemaWan Speech-to-Video 创建已接受Wan Speech-to-Video 轮询处理中Wan Speech-to-Video 轮询已完成Wan Speech-to-Video 轮询失败Wan Speech-to-Video 客户回调：已完成Wan Speech-to-Video 客户回调：失败Wan Speech-to-Video 错误Wan Speech-to-Video 生成的代码示例Wan Speech-to-Video 相关指南Wan Speech-to-Video Wan Text-to-ImageAPI 参考 概览Wan Text-to-Image 端点Wan Text-to-Image 支持的模型Wan Text-to-Image 请求 SchemaWan Text-to-Image 创建已接受Wan Text-to-Image 轮询处理中Wan Text-to-Image 轮询已完成Wan Text-to-Image 轮询失败Wan Text-to-Image 客户回调：已完成Wan Text-to-Image 客户回调：失败Wan Text-to-Image 错误Wan Text-to-Image 生成的代码示例Wan Text-to-Image 相关指南Wan Text-to-Image Wan Text-to-VideoAPI 参考 概览Wan Text-to-Video 端点Wan Text-to-Video 支持的模型Wan Text-to-Video 请求 SchemaWan Text-to-Video 创建已接受Wan Text-to-Video 轮询处理中Wan Text-to-Video 轮询已完成Wan Text-to-Video 轮询失败Wan Text-to-Video 客户回调：已完成Wan Text-to-Video 客户回调：失败Wan Text-to-Video 错误Wan Text-to-Video 生成的代码示例Wan Text-to-Video 相关指南Wan Text-to-Video Seedance Text-to-VideoAPI 参考 概览Seedance Text-to-Video 端点Seedance Text-to-Video 支持的模型Seedance Text-to-Video 请求 SchemaSeedance Text-to-Video 创建已接受Seedance Text-to-Video 轮询处理中Seedance Text-to-Video 轮询已完成Seedance Text-to-Video 轮询失败Seedance Text-to-Video 客户回调：已完成Seedance Text-to-Video 客户回调：失败Seedance Text-to-Video 错误Seedance Text-to-Video 生成的代码示例Seedance Text-to-Video 相关指南Seedance Text-to-Video OmniHuman Audio-to-VideoAPI 参考 概览OmniHuman Audio-to-Video 端点OmniHuman Audio-to-Video 支持的模型OmniHuman Audio-to-Video 请求 SchemaOmniHuman Audio-to-Video 创建已接受OmniHuman Audio-to-Video 轮询处理中OmniHuman Audio-to-Video 轮询已完成OmniHuman Audio-to-Video 轮询失败OmniHuman Audio-to-Video 客户回调：已完成OmniHuman Audio-to-Video 客户回调：失败OmniHuman Audio-to-Video 错误OmniHuman Audio-to-Video 生成的代码示例OmniHuman Audio-to-Video 相关指南OmniHuman Audio-to-Video OmniHuman Human-IdentificationAPI 参考 概览OmniHuman Human-Identification 端点OmniHuman Human-Identification 支持的模型OmniHuman Human-Identification 请求 SchemaOmniHuman Human-Identification 创建已接受OmniHuman Human-Identification 轮询处理中OmniHuman Human-Identification 轮询已完成OmniHuman Human-Identification 轮询失败OmniHuman Human-Identification 客户回调：已完成OmniHuman Human-Identification 客户回调：失败OmniHuman Human-Identification 错误OmniHuman Human-Identification 生成的代码示例OmniHuman Human-Identification 相关指南OmniHuman Human-Identification OmniHuman Subject-DetectionAPI 参考 概览OmniHuman Subject-Detection 端点OmniHuman Subject-Detection 支持的模型OmniHuman Subject-Detection 请求 SchemaOmniHuman Subject-Detection 创建已接受OmniHuman Subject-Detection 轮询处理中OmniHuman Subject-Detection 轮询已完成OmniHuman Subject-Detection 轮询失败OmniHuman Subject-Detection 客户回调：已完成OmniHuman Subject-Detection 客户回调：失败OmniHuman Subject-Detection 错误OmniHuman Subject-Detection 生成的代码示例OmniHuman Subject-Detection 相关指南OmniHuman Subject-Detection Volcengine Lip Sync Lip-Sync-VideoAPI 参考 概览Volcengine Lip Sync Lip-Sync-Video 端点Volcengine Lip Sync Lip-Sync-Video 支持的模型Volcengine Lip Sync Lip-Sync-Video 请求 SchemaVolcengine Lip Sync Lip-Sync-Video 创建已接受Volcengine Lip Sync Lip-Sync-Video 轮询处理中Volcengine Lip Sync Lip-Sync-Video 轮询已完成Volcengine Lip Sync Lip-Sync-Video 轮询失败Volcengine Lip Sync Lip-Sync-Video 客户回调：已完成Volcengine Lip Sync Lip-Sync-Video 客户回调：失败Volcengine Lip Sync Lip-Sync-Video 错误Volcengine Lip Sync Lip-Sync-Video 生成的代码示例Volcengine Lip Sync Lip-Sync-Video 相关指南Volcengine Lip Sync Lip-Sync-Video Veo 3.1 Extend-VideoAPI 参考 概览Veo 3.1 Extend-Video 端点Veo 3.1 Extend-Video 支持的模型Veo 3.1 Extend-Video 请求 SchemaVeo 3.1 Extend-Video 创建已接受Veo 3.1 Extend-Video 轮询处理中Veo 3.1 Extend-Video 轮询已完成Veo 3.1 Extend-Video 轮询失败Veo 3.1 Extend-Video 客户回调：已完成Veo 3.1 Extend-Video 客户回调：失败Veo 3.1 Extend-Video 错误Veo 3.1 Extend-Video 生成的代码示例Veo 3.1 Extend-Video 相关指南Veo 3.1 Extend-Video Veo 3.1 Text-to-VideoAPI 参考 概览Veo 3.1 Text-to-Video 端点Veo 3.1 Text-to-Video 支持的模型Veo 3.1 Text-to-Video 请求 SchemaVeo 3.1 Text-to-Video 创建已接受Veo 3.1 Text-to-Video 轮询处理中Veo 3.1 Text-to-Video 轮询已完成Veo 3.1 Text-to-Video 轮询失败Veo 3.1 Text-to-Video 客户回调：已完成Veo 3.1 Text-to-Video 客户回调：失败Veo 3.1 Text-to-Video 错误Veo 3.1 Text-to-Video 生成的代码示例Veo 3.1 Text-to-Video 相关指南Veo 3.1 Text-to-Video Veo 3.1 Upscale-VideoAPI 参考 概览Veo 3.1 Upscale-Video 端点Veo 3.1 Upscale-Video 支持的模型Veo 3.1 Upscale-Video 请求 SchemaVeo 3.1 Upscale-Video 创建已接受Veo 3.1 Upscale-Video 轮询处理中Veo 3.1 Upscale-Video 轮询已完成Veo 3.1 Upscale-Video 轮询失败Veo 3.1 Upscale-Video 客户回调：已完成Veo 3.1 Upscale-Video 客户回调：失败Veo 3.1 Upscale-Video 错误Veo 3.1 Upscale-Video 生成的代码示例Veo 3.1 Upscale-Video 相关指南Veo 3.1 Upscale-Video Kling AvatarAPI 参考 概览Kling Avatar 端点Kling Avatar 支持的模型Kling Avatar 请求 SchemaKling Avatar 创建已接受Kling Avatar 轮询处理中Kling Avatar 轮询已完成Kling Avatar 轮询失败Kling Avatar 客户回调：已完成Kling Avatar 客户回调：失败Kling Avatar 错误Kling Avatar 生成的代码示例Kling Avatar 相关指南Kling Avatar Kling Extend-VideoAPI 参考 概览Kling Extend-Video 端点Kling Extend-Video 支持的模型Kling Extend-Video 请求 SchemaKling Extend-Video 创建已接受Kling Extend-Video 轮询处理中Kling Extend-Video 轮询已完成Kling Extend-Video 轮询失败Kling Extend-Video 客户回调：已完成Kling Extend-Video 客户回调：失败Kling Extend-Video 错误Kling Extend-Video 生成的代码示例Kling Extend-Video 相关指南Kling Extend-Video Kling Image-to-VideoAPI 参考 概览Kling Image-to-Video 端点Kling Image-to-Video 支持的模型Kling Image-to-Video 请求 SchemaKling Image-to-Video 创建已接受Kling Image-to-Video 轮询处理中Kling Image-to-Video 轮询已完成Kling Image-to-Video 轮询失败Kling Image-to-Video 客户回调：已完成Kling Image-to-Video 客户回调：失败Kling Image-to-Video 错误Kling Image-to-Video 生成的代码示例Kling Image-to-Video 相关指南Kling Image-to-Video Kling Motion-ControlAPI 参考 概览Kling Motion-Control 端点Kling Motion-Control 支持的模型Kling Motion-Control 请求 SchemaKling Motion-Control 创建已接受Kling Motion-Control 轮询处理中Kling Motion-Control 轮询已完成Kling Motion-Control 轮询失败Kling Motion-Control 客户回调：已完成Kling Motion-Control 客户回调：失败Kling Motion-Control 错误Kling Motion-Control 生成的代码示例Kling Motion-Control 相关指南Kling Motion-Control Luma Modify-VideoAPI 参考 概览Luma Modify-Video 端点Luma Modify-Video 支持的模型Luma Modify-Video 请求 SchemaLuma Modify-Video 创建已接受Luma Modify-Video 轮询处理中Luma Modify-Video 轮询已完成Luma Modify-Video 轮询失败Luma Modify-Video 客户回调：已完成Luma Modify-Video 客户回调：失败Luma Modify-Video 错误Luma Modify-Video 生成的代码示例Luma Modify-Video 相关指南Luma Modify-Video InfiniteTalk Audio-to-VideoAPI 参考 概览InfiniteTalk Audio-to-Video 端点InfiniteTalk Audio-to-Video 支持的模型InfiniteTalk Audio-to-Video 请求 SchemaInfiniteTalk Audio-to-Video 创建已接受InfiniteTalk Audio-to-Video 轮询处理中InfiniteTalk Audio-to-Video 轮询已完成InfiniteTalk Audio-to-Video 轮询失败InfiniteTalk Audio-to-Video 客户回调：已完成InfiniteTalk Audio-to-Video 客户回调：失败InfiniteTalk Audio-to-Video 错误InfiniteTalk Audio-to-Video 生成的代码示例InfiniteTalk Audio-to-Video 相关指南InfiniteTalk Audio-to-Video Hailuo Image-to-VideoAPI 参考 概览Hailuo Image-to-Video 端点Hailuo Image-to-Video 支持的模型Hailuo Image-to-Video 请求 SchemaHailuo Image-to-Video 创建已接受Hailuo Image-to-Video 轮询处理中Hailuo Image-to-Video 轮询已完成Hailuo Image-to-Video 轮询失败Hailuo Image-to-Video 客户回调：已完成Hailuo Image-to-Video 客户回调：失败Hailuo Image-to-Video 错误Hailuo Image-to-Video 生成的代码示例Hailuo Image-to-Video 相关指南Hailuo Image-to-Video Hailuo Text-to-VideoAPI 参考 概览Hailuo Text-to-Video 端点Hailuo Text-to-Video 支持的模型Hailuo Text-to-Video 请求 SchemaHailuo Text-to-Video 创建已接受Hailuo Text-to-Video 轮询处理中Hailuo Text-to-Video 轮询已完成Hailuo Text-to-Video 轮询失败Hailuo Text-to-Video 客户回调：已完成Hailuo Text-to-Video 客户回调：失败Hailuo Text-to-Video 错误Hailuo Text-to-Video 生成的代码示例Hailuo Text-to-Video 相关指南Hailuo Text-to-Video Runway Extend-VideoAPI 参考 概览Runway Extend-Video 端点Runway Extend-Video 支持的模型Runway Extend-Video 请求 SchemaRunway Extend-Video 创建已接受Runway Extend-Video 轮询处理中Runway Extend-Video 轮询已完成Runway Extend-Video 轮询失败Runway Extend-Video 客户回调：已完成Runway Extend-Video 客户回调：失败Runway Extend-Video 错误Runway Extend-Video 生成的代码示例Runway Extend-Video 相关指南Runway Extend-Video Runway Text-to-VideoAPI 参考 概览Runway Text-to-Video 端点Runway Text-to-Video 支持的模型Runway Text-to-Video 请求 SchemaRunway Text-to-Video 创建已接受Runway Text-to-Video 轮询处理中Runway Text-to-Video 轮询已完成Runway Text-to-Video 轮询失败Runway Text-to-Video 客户回调：已完成Runway Text-to-Video 客户回调：失败Runway Text-to-Video 错误Runway Text-to-Video 生成的代码示例Runway Text-to-Video 相关指南Runway Text-to-Video Runway Aleph Edit-VideoAPI 参考 概览Runway Aleph Edit-Video 端点Runway Aleph Edit-Video 支持的模型Runway Aleph Edit-Video 请求 SchemaRunway Aleph Edit-Video 创建已接受Runway Aleph Edit-Video 轮询处理中Runway Aleph Edit-Video 轮询已完成Runway Aleph Edit-Video 轮询失败Runway Aleph Edit-Video 客户回调：已完成Runway Aleph Edit-Video 客户回调：失败Runway Aleph Edit-Video 错误Runway Aleph Edit-Video 生成的代码示例Runway Aleph Edit-Video 相关指南Runway Aleph Edit-Video 当前账户API 参考 对象当前账户 操作当前账户 当前账户对象API 参考 对象字段当前账户对象 相关参考当前账户对象 获取当前账户API 参考 端点获取当前账户 成功响应获取当前账户 错误响应 (401)获取当前账户 错误响应 (403)获取当前账户 cURL 示例获取当前账户 相关参考获取当前账户 余额API 参考 对象余额 操作余额 余额对象API 参考 对象字段余额对象 相关参考余额对象 获取余额API 参考 端点获取余额 成功响应获取余额 错误响应 (401)获取余额 错误响应 (403)获取余额 cURL 示例获取余额 相关参考获取余额 API 密钥API 参考 对象API 密钥 操作API 密钥 API 密钥对象API 参考 对象字段API 密钥对象 相关参考API 密钥对象 列出 API 密钥API 参考 端点列出 API 密钥 请求列出 API 密钥 成功响应列出 API 密钥 错误响应 (401)列出 API 密钥 错误响应 (403)列出 API 密钥 错误响应 (403)列出 API 密钥 错误响应 (400)列出 API 密钥 cURL 示例列出 API 密钥 相关参考列出 API 密钥 获取 API 密钥API 参考 端点获取 API 密钥 请求获取 API 密钥 成功响应获取 API 密钥 错误响应 (401)获取 API 密钥 错误响应 (403)获取 API 密钥 错误响应 (403)获取 API 密钥 错误响应 (404)获取 API 密钥 cURL 示例获取 API 密钥 相关参考获取 API 密钥 创建 API 密钥API 参考 端点创建 API 密钥 请求创建 API 密钥 成功响应创建 API 密钥 错误响应 (401)创建 API 密钥 错误响应 (403)创建 API 密钥 错误响应 (403)创建 API 密钥 错误响应 (400)创建 API 密钥 错误响应 (422)创建 API 密钥 cURL 示例创建 API 密钥 相关参考创建 API 密钥 更新 API 密钥API 参考 端点更新 API 密钥 请求更新 API 密钥 成功响应更新 API 密钥 错误响应 (401)更新 API 密钥 错误响应 (403)更新 API 密钥 错误响应 (403)更新 API 密钥 错误响应 (400)更新 API 密钥 错误响应 (404)更新 API 密钥 错误响应 (422)更新 API 密钥 cURL 示例更新 API 密钥 相关参考更新 API 密钥 删除 API 密钥API 参考 端点删除 API 密钥 请求删除 API 密钥 成功响应删除 API 密钥 错误响应 (401)删除 API 密钥 错误响应 (403)删除 API 密钥 错误响应 (403)删除 API 密钥 错误响应 (404)删除 API 密钥 cURL 示例删除 API 密钥 相关参考删除 API 密钥 GuardrailsAPI 参考 对象Guardrails 操作Guardrails Guardrail 对象API 参考 对象字段Guardrail 对象 相关参考Guardrail 对象 列出 GuardrailsAPI 参考 端点列出 Guardrails 请求列出 Guardrails 成功响应列出 Guardrails 错误响应 (401)列出 Guardrails 错误响应 (403)列出 Guardrails 错误响应 (403)列出 Guardrails 错误响应 (400)列出 Guardrails cURL 示例列出 Guardrails 相关参考列出 Guardrails 获取 GuardrailAPI 参考 端点获取 Guardrail 请求获取 Guardrail 成功响应获取 Guardrail 错误响应 (401)获取 Guardrail 错误响应 (403)获取 Guardrail 错误响应 (403)获取 Guardrail 错误响应 (404)获取 Guardrail cURL 示例获取 Guardrail 相关参考获取 Guardrail 创建 GuardrailAPI 参考 端点创建 Guardrail 请求创建 Guardrail 成功响应创建 Guardrail 错误响应 (401)创建 Guardrail 错误响应 (403)创建 Guardrail 错误响应 (403)创建 Guardrail 错误响应 (400)创建 Guardrail 错误响应 (422)创建 Guardrail cURL 示例创建 Guardrail 相关参考创建 Guardrail 更新 GuardrailAPI 参考 端点更新 Guardrail 请求更新 Guardrail 成功响应更新 Guardrail 错误响应 (401)更新 Guardrail 错误响应 (403)更新 Guardrail 错误响应 (403)更新 Guardrail 错误响应 (400)更新 Guardrail 错误响应 (404)更新 Guardrail 错误响应 (422)更新 Guardrail cURL 示例更新 Guardrail 相关参考更新 Guardrail 删除 GuardrailAPI 参考 端点删除 Guardrail 请求删除 Guardrail 成功响应删除 Guardrail 错误响应 (401)删除 Guardrail 错误响应 (403)删除 Guardrail 错误响应 (403)删除 Guardrail 错误响应 (404)删除 Guardrail cURL 示例删除 Guardrail 相关参考删除 Guardrail Guardrail 分配API 参考 对象Guardrail 分配 操作Guardrail 分配 Guardrail 分配对象API 参考 对象字段Guardrail 分配对象 相关参考Guardrail 分配对象 列出 Guardrail 分配API 参考 端点列出 Guardrail 分配 请求列出 Guardrail 分配 成功响应列出 Guardrail 分配 错误响应 (401)列出 Guardrail 分配 错误响应 (403)列出 Guardrail 分配 错误响应 (400)列出 Guardrail 分配 cURL 示例列出 Guardrail 分配 相关参考列出 Guardrail 分配 创建 Guardrail 分配API 参考 端点创建 Guardrail 分配 请求创建 Guardrail 分配 成功响应创建 Guardrail 分配 错误响应 (401)创建 Guardrail 分配 错误响应 (403)创建 Guardrail 分配 错误响应 (400)创建 Guardrail 分配 错误响应 (403)创建 Guardrail 分配 错误响应 (404)创建 Guardrail 分配 错误响应 (422)创建 Guardrail 分配 cURL 示例创建 Guardrail 分配 相关参考创建 Guardrail 分配 删除 Guardrail 分配API 参考 端点删除 Guardrail 分配 请求删除 Guardrail 分配 成功响应删除 Guardrail 分配 错误响应 (401)删除 Guardrail 分配 错误响应 (403)删除 Guardrail 分配 错误响应 (403)删除 Guardrail 分配 错误响应 (404)删除 Guardrail 分配 cURL 示例删除 Guardrail 分配 相关参考删除 Guardrail 分配
指南

API 身份验证

创建 API Key，并使用它验证发送到 RunAPI 的请求。

查看 Markdown

RunAPI 使用 API Key 验证 API 请求。访问账户资源或创建任务时，每个请求都必须携带 API Key。

选择正确的密钥

  • 标准 API Key 用于调用 Task API、LLM API 与账户接口。在 API Keys 页面创建它。
  • Management Key 用于创建和治理标准 API Key 与 Guardrail。在 Management Keys 页面创建它，并且只用于 Platform Management 接口。

创建 API Key

为每个应用分配独立的 API Key，以便单独轮换或撤销访问权限，而不中断其他集成。每个密钥只属于一个账户，请求只能访问该账户可见的资源。

验证请求

在 Authorization 请求头中以 bearer token 形式发送 API Key：

HTTP 
Authorization: Bearer YOUR_API_TOKEN

例如，使用 cURL 查询当前余额：

SHELL 
curl "https://runapi.ai/api/v1/me/balance" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

安全保管 API Key

  • 将 API Key 存储在密钥管理系统或加密凭据中。
  • 切勿将 API Key 提交到源码仓库或暴露在浏览器代码中。
  • 如果 API Key 可能已经泄露，请立即轮换。
  • 开发环境和生产环境使用不同的 API Key。

排查身份验证问题

  • 401 Unauthorized 表示 API Key 缺失、格式错误、已撤销或无效。
  • 403 Forbidden 表示密钥有效，但其凭据类别或账户角色不能执行该操作。
  • 确认请求头以 Bearer 开头，随后是一个空格和完整的 API Key。
  • 确认 API Key 属于当前请求资源所在的账户。