# 快速开始
> 发一句话、登录一次，就能在你的智能体里使用 Beatra。只要智能体能安装 Skill、能运行 Python 3.10 及以上版本，下面的流程都一样。

步骤最后验证：2026-11-09

按下面的步骤，在智能体里装好 Beatra Skill，在浏览器里登录一次，拿到第一个作品。WorkBuddy、千问办公、豆包工作、Codex、Claude Code、Cursor，以及其他能安装 Skill、能运行 Python 3.10 及以上版本的智能体，流程都一样。安装和登录免费，生成媒体消耗 Beatra 积分。想先比较 Skill、MCP 和 REST API，见[选择使用方式](https://docs.beatra.cn/zh/docs/choose-integration)。

### 把安装消息发给智能体

```text title="发给智能体"
请帮我安装 Beatra；需要登录授权时告诉我：https://beatra.ai/install.md
```

智能体会识别当前平台，完成能自动完成的设置；需要你在平台设置里操作的那一步，它会明确告诉你。它装了什么、以后怎么更新和重新连接，见[安装 Beatra Skill](https://docs.beatra.cn/zh/docs/install-skill)。

**检查点**

- [x] 智能体确认安装完成。

### 在浏览器里登录一次

浏览器打开 Beatra 后，登录并确认一次授权。这一次登录覆盖图片、视频、音乐和语音，切换创作类型不需要再授权。完成后开启一个新的智能体会话，让 Beatra 正常加载。

**检查点**

- [x] 浏览器页面显示「已批准」，智能体接上后变成「已连接」。
- [x] 智能体告诉你 Beatra 已就绪。

### 开始创作

用平常说话的方式描述结果：

```text title="发给智能体"
为这个落地页制作一张温暖的杂志风插画。
```

耗时的创作在后台继续，完成后智能体把结果交给你。生成媒体会消耗积分。

**检查点**

- [x] 智能体确认已创建 Beatra 任务。
- [x] 完成后收到成品和本次扣费。任务还在排队中，或还在生成中，都是正常状态。智能体会继续查看进度。

### 在控制台或手机上查看

作品会出现在[控制台的作品页](https://console.beatra.cn/assets)；也可以用微信扫码，在 [Beatra 小程序](https://www.beatra.cn/zh/mini-program?utm_source=docs&utm_medium=quickstart)里看。

**检查点**

- [x] 控制台的「作品」页里有这次的成品。

## 某一步没成功 [#if-a-step-fails]

把同一句安装消息再发一次。智能体会保留已经正确的设置，只继续没做完的部分。遇到具体提示时：

- 授权页面、登录验证码，或者登录已失效：见[排错指南：登录失败](https://docs.beatra.cn/zh/docs/troubleshooting#sign-in)；微信二维码和验证码的问题见[登录问题排查](https://docs.beatra.cn/zh/docs/sign-in-help)。
- 提示积分不足：见[排错指南：积分不足](https://docs.beatra.cn/zh/docs/troubleshooting#credits)。
- 任务一直在跑，或者以错误结束：见[排错指南：任务慢或超时](https://docs.beatra.cn/zh/docs/troubleshooting#timeouts)。

## 接入自己的服务

在自有应用里集成 Beatra，用 REST/OpenAPI：

- [REST · API 参考](https://docs.beatra.cn/zh/docs/api-reference) — 全部 v1 端点与机器可读契约。
- [开始之前 · 认证与请求约定](https://docs.beatra.cn/zh/docs/authentication) — API Key、公共 Header 与幂等。
- [机制 · 异步任务](https://docs.beatra.cn/zh/docs/mechanisms/async-tasks) — 任务从提交到终态的生命周期。