> ## Documentation Index
> Fetch the complete documentation index at: https://docs.youka.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Tài khoản

> Đăng nhập, đăng xuất và kiểm tra ngữ cảnh tài khoản CLI đang hoạt động

CLI sử dụng API key cho các lệnh cần xác thực. Bạn có thể lưu một lần với `youka login`, hoặc cung cấp thông qua `YOUKA_API_KEY` trong CI và các môi trường không tương tác khác.

`youka login` xác minh key với API trước khi lưu, sau đó lưu đệm email tài khoản đã phân giải trong `~/.youka/config.json` để phục vụ chẩn đoán.

## `login`

Lưu một API key vào `~/.youka/config.json`.

```bash theme={null}
youka login [token]
```

<ParamField path="token" type="string">
  API key được sao chép từ bảng điều khiển Youka. Nếu bỏ qua, CLI sẽ nhắc nhập
  trên một terminal tương tác.
</ParamField>

### Ví dụ

<CodeGroup>
  ```bash token theme={null}
  youka login yk_live_abcd1234
  ```

  ```bash with-api theme={null}
  youka login yk_live_abcd1234 --api https://staging-api.youka.test --json
  ```
</CodeGroup>

<Tip>Trong CI, ưu tiên `YOUKA_API_KEY` thay vì ghi ra một tệp cấu hình.</Tip>

## `logout`

Xóa API key đã lưu khỏi `~/.youka/config.json`.

```bash theme={null}
youka logout
youka logout --json
```

## `whoami`

Kiểm tra nguồn key đã phân giải, URL API và danh tính tài khoản.

```bash theme={null}
youka whoami
youka whoami --json
```

Phản hồi ví dụ:

```json theme={null}
{
  "ok": true,
  "data": {
    "authenticated": true,
    "tokenPresent": true,
    "authStatus": "verified",
    "identitySource": "live",
    "keySource": "config",
    "apiUrl": "https://api.youka.io/vi/api/v1",
    "apiUrlSource": "default",
    "email": "user@example.com",
    "userId": "user_123",
    "apiKeyId": "key_123",
    "org": null,
    "configPath": "/Users/you/.youka/config.json",
    "apiKeyPreview": "yk_l...1234"
  }
}
```

### Thứ tự phân giải

| Trường  | Thứ tự                                                                            |
| ------- | --------------------------------------------------------------------------------- |
| API key | `YOUKA_API_KEY`, sau đó `~/.youka/config.json`                                    |
| API URL | `--api`, sau đó `YOUKA_API_BASE_URL`, sau đó `~/.youka/config.json`, rồi mặc định |

Khi một key cấu hình đã lưu đang hoạt động, `whoami` sẽ xác minh danh tính với API và chỉ quay về email tài khoản được lưu đệm nếu không thể tra cứu trực tiếp. Lệnh này không sử dụng danh tính cấu hình đã lưu đệm cho các token `YOUKA_API_KEY`.

## Tiếp theo

* [Tùy chọn toàn cục](/vi/cli/global-options) - các cờ dùng chung cho mọi lệnh
* [Dự án](/vi/cli/projects) - tạo và xử lý các dự án karaoke