# 快速开始

> 3 步完成第一次 SnapAny API 调用

来源: https://platform.snapany.com/zh/docs/quickstart

一分钟内从一条链接拿到结构化的媒体数据。

## 1. 获取 API key

登录 [platform.snapany.com](https://platform.snapany.com/zh/console/keys) 创建 API key。新开发者可在[控制台](https://platform.snapany.com/zh/console)领取 **50 个免费积分**。

## 2. 发起第一个请求

```bash
curl -X POST https://api.snapany.com/openapi/v1/extract/post \
  -H "Authorization: Bearer sk_snapany_xxx" \
  -H "Accept-Language: zh" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'
```

## 3. 读取响应

```json
{
  "title": "...",
  "medias": [{ "media_type": "video", "resource_url": "https://..." }]
}
```

响应只包含业务数据。剩余积分 随时可通过 [`GET /credits/balance`](https://platform.snapany.com/zh/docs/api#GET/credits/balance)（免费）或[控制台](https://platform.snapany.com/zh/console)查询。

## 下一步

- [鉴权](https://platform.snapany.com/zh/docs/authentication) — API key 的使用方式
- [积分与计费](https://platform.snapany.com/zh/docs/credits) — 计费模型
- [API 参考](https://platform.snapany.com/zh/docs/api) — 完整端点文档（可在线调试）
- [MCP](https://platform.snapany.com/zh/docs/mcp) — 在 Claude Code、Codex 等 AI Agent 中使用 SnapAny