AGENT READY API

让 Agent 直接调用
拉马助手。

优先适配 Codex,也可用于任何支持 HTTP 请求的 Agent、脚本或自动化平台。

API 在线20

普通用户测试额度
按成功提交的链接数计费

01

快速开始

API 使用 JSON 和 HTTPS。所有业务请求通过 Bearer API Key 鉴权。

POSThttps://lama.fftu.cn/parser-api/v1/parse
02

Codex 优先接入

把 API Key 保存为环境变量 LAMA_API_KEY,并在项目的 AGENTS.md 中加入以下约定:

When parsing public video share links:
1. POST https://lama.fftu.cn/parser-api/v1/parse
2. Set Authorization: Bearer $LAMA_API_KEY
3. Send {"links":["video URL"]}
4. Only process content the user is authorized to use
03

获取 API Key

普通用户:20 次测试额度

curl -X POST https://lama.fftu.cn/parser-api/v1/access/trial \
  -H "Content-Type: application/json" \
  -d '{"client_id":"LOCAL-UUID"}'

会员用户:使用软件密钥开通

curl -X POST https://lama.fftu.cn/parser-api/v1/access/member \
  -H "Content-Type: application/json" \
  -d '{"serial":"YOUR-LICENSE"}'

每个普通用户仅能领取一次测试 Key。月度会员 20,000 条,年度会员 250,000 条,终身会员每月 100,000 条,企业会员按定制额度执行;重新生成会员 API Key 后,旧 Key 会立即失效。

04

解析链接

curl -X POST https://lama.fftu.cn/parser-api/v1/parse \
  -H "Authorization: Bearer $LAMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"links":["https://v.douyin.com/example/"]}'

普通用户单次最多 7 条、总计 20 条;会员单次最多 50 条。响应包含标题、平台、时长、封面、清晰度和下载地址。

05

状态码与重试

200请求完成,逐条检查 items 与 errors
401API Key 缺失或无效
409测试额度已领取或会员 Key 已变化
429测试额度不足
502上游平台暂时不可用,建议指数退避重试