---
title: 快速开始
url: https://runapi.ai/zh-CN/docs/guides/quickstart.md
canonical: https://runapi.ai/zh-CN/docs/guides/quickstart
locale: zh-CN
---

# 快速开始

先完成一次经过身份验证的请求，再根据应用需要进入对应 API 类别的 Guide。

## 开始前准备

创建 RunAPI 账户，并选择一个有可用额度的账户。服务端应用应从密钥管理系统或环境变量读取凭据。

## 创建 API Key

在 [API Keys 页面](/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。切勿在浏览器代码或公开仓库中暴露密钥。