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

# 快速开始

> 三分钟获取 API Key 并完成第一次数据抓取

## 1. 注册账号与获取 API Key

1. 访问 [SocialVision 控制台](https://socialvision.tisyk.xyz)。
2. 注册并登录进入控制台。
3. 导航至 **API Keys** 页面，点击 **创建新 Key**。
4. 复制生成的密钥（形如 `sv_live_...`），**密钥明文仅展示一次，请妥善保存**。

## 2. 额度充值 (Credits)

SocialVision 采用预充值积分制：

* **基准汇率**：`1.00 Credit = ¥1.00 人民币`。
* **大部分端点售价**：`0.10 Credits / 次`（即 ¥0.10 元一次）。
* 前往官方发卡网 [shop.tosykan.xyz](https://shop.tosykan.xyz) 购买额度卡密。
* 在控制台 **Credits** 页面输入卡密完成核销。

## 3. 发起第一次数据调用

网关统一调用地址为：`POST https://socialvision.tisyk.xyz/api/v1/run`

```bash cURL theme={null}
curl -X POST https://socialvision.tisyk.xyz/api/v1/run \
  -H "Authorization: Bearer sv_live_你的API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "tikhub",
    "endpoint": "/api/v1/xiaohongshu/app_v2/search_notes",
    "input": {
      "keyword": "咖啡探店",
      "page": 1,
      "sort_type": "general"
    }
  }'
```

```python Python theme={null}
import requests

API_KEY = "sv_live_你的API_KEY"
url = "https://socialvision.tisyk.xyz/api/v1/run"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

payload = {
    "provider": "tikhub",
    "endpoint": "/api/v1/xiaohongshu/app_v2/search_notes",
    "input": {
        "keyword": "咖啡探店",
        "page": 1,
        "sort_type": "general"
    }
}

response = requests.post(url, headers=headers, json=payload)
data = response.json()
print("扣费结果:", data.get("billing"))
print("笔记列表:", data.get("output", {}).get("data", {}).get("items", []))
```