Reelflow · Open API

开放 API 接入文档

概览

用一枚 API Key,以 Bearer 令牌调用平台聚合的新媒体数据接口(抖音、小红书、TikTok、YouTube、公众号…)与生图能力。按次计费,从工作区积分实时扣减。左侧选择接口查看参数、在线测试与 curl。

鉴权与 Base URL

Base URL
/api/v1
鉴权方式
Authorization: Bearer <key>
curl "/api/v1/credits" \
  -H "Authorization: Bearer rf_your_api_key"

幂等:写请求可带 Idempotency-Key 头,重放同一 Key 直接返回首次结果、不重复扣费。

计费与限流

  • 按次计费:调用成功即扣对应单价(见每个接口的「积分/次」);失败不扣费。
  • 余额:余额 > 0 即可调用,单次可透支入债;余额 ≤ 0 返回 402,充值后自动补齐欠款并恢复。
  • 限流:按用户默认 10 次/秒,超限返回 429

错误码

{ "error": { "code": "insufficient_credits", "message": "..." } }
401unauthorizedKey 缺失、无效或被吊销
402insufficient_credits工作区积分不足
403forbidden越权访问该工作区资源
404not_found端点未上架或路径错误
429rate_limited触发调用频率限制
502upstream_error上游平台返回异常