指南
快速开始
创建 API Key、验证连接,并选择适合的 RunAPI 集成路径。
先完成一次经过身份验证的请求,再根据应用需要进入对应 API 类别的 Guide。
开始前准备
创建 RunAPI 账户,并选择一个有可用额度的账户。服务端应用应从密钥管理系统或环境变量读取凭据。
创建 API Key
在 API Keys 页面创建标准 API Key。密钥显示后立即复制并安全保存。调用 Task API、LLM API 和账户接口时,每个请求都要以 bearer token 形式发送它。
HTTP
Authorization: Bearer YOUR_API_TOKEN
验证连接
查询 API Key 所属账户的余额:
SHELL
curl "https://runapi.ai/api/v1/me/balance" \
-H "Authorization: Bearer YOUR_API_TOKEN"
收到 200 OK 表示 Base URL 与 API Key 有效。401 Unauthorized 表示密钥缺失、格式错误、已撤销或无效。
选择 API 类别
- Task API 适用于异步图像、视频、音频和音乐生成。应用创建 Task,并观察它直到进入
completed或failed。 - LLM API 适用于通过受支持公开协议发起同步或流式语言模型调用。
- Platform Management 使用独立的 Management Key 创建和治理 API Key 与 Guardrail。
准备生产环境
开发与生产环境使用不同密钥,设置应用超时,只重试瞬时故障,并在日志中记录 RunAPI request 或 Task identifier。切勿在浏览器代码或公开仓库中暴露密钥。