> ## 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.

# REST API 调用方式

> 面向传统开发者与脚本的透明网关规范

## 核心请求规范

所有社媒端点通过单一代理网关调用：

* **HTTP Method**: `POST`
* **URL**: `https://socialvision.tisyk.xyz/api/v1/run`
* **Headers**:
  * `Authorization`: `Bearer sv_live_你的API_KEY`
  * `Content-Type`: `application/json`

### 请求 Body 结构

```json theme={null}
{
  "provider": "tikhub",
  "endpoint": "/api/v1/xiaohongshu/app_v2/search_notes",
  "input": {
    "keyword": "露营穿搭",
    "page": 1,
    "sort_type": "general"
  }
}
```

### 响应结构

```json theme={null}
{
  "runId": "run_01j7abc...",
  "status": "COMPLETED",
  "output": { ... },
  "billing": {
    "charged": 0.100000,
    "balanceAfter": 49.900000
  }
}
```