概览

您可以使用 Threads API 让他人在 Threads 上以个人名义创建和发布内容，并在您的应用程序内仅向创建者显示这些帖子。

Threads API 可通过 graph.threads.com 或 graph.threads.net 访问。

流量限制

对 Threads API 的调用次数会计入调用应用的调用次数中。每个应用和应用用户对都拥有各自的应用调用次数，该次数是指应用在连续 24 小时内已发出的调用数量。其计算方式如下：

Calls within 24 hours = 4800 * Number of Impressions

“Number of Impressions”是指过去 24 小时内来自应用用户 Threads 账户中的任何内容在某个用户的屏幕上显示的次数。流量限制也可能受到每天总 CPU 时间的限制：

720000 * number_of_impressions for total_cputime 

      2880000 * Number of Impressions for total_time

注意：展示次数的最小值是 10（因此，如果展示次数小于 10，此值将默认为 10）。

帖子

Threads 主页在 24 小时内仅能通过 API 发布 250 个帖子。轮播算作单个帖子。在尝试发布媒体容器时，POST /{threads-user-id}/threads_publish 端点会强制执行此限制。我们建议您对自己的应用同样执行发布流量限制。如果您的应用允许应用用户设置在未来发布定时帖，则更应如此。

如要检查主页当前的 Threads API 流量限制使用情况，请查询 GET /{threads-user-id}/threads_publishing_limit 端点。

注意：此端点需要 threads_basic 和 threads_content_publish 权限。

字段

名称	描述
`quota_usage`	过去 24 小时内的 Threads 发布次数。
`config`	Threads 发布流量限制配置对象，其中包含 `quota_total` 和 `quota_duration` 字段。

请求示例

curl -s -X GET \
  "https:graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publishing_limit?fields=quota_usage,config&access_token=<ACCESS_TOKEN>"

响应示例

{
  "data": [
    {
      "quota_usage": 4,
      "config": {
        "quota_total": 250,
        "quota_duration": 86400
      }
    }
  ]
}

回复次数

Threads 主页在连续 24 小时内仅限发布 1,000 次回复。

要检查主页当前的 Threads 回复流量限制使用情况，请查询 GET /{threads-user-id}/threads_publishing_limit 端点。详情请参阅回复管理文档。

注意： 此端点要求提供 threads_basic、threads_content_publish 和 threads_manage_replies 权限。

字段

名称	描述
`reply_quota_usage`	过去 24 小时内的 Threads 回复发布次数。
`reply_config`	Threads 回复发布流量限制配置对象，其中包含 `quota_total` 和 `quota_duration` 字段。

请求示例

curl -s -X GET \
  "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publishing_limit?fields=reply_quota_usage,reply_config&access_token=<ACCESS_TOKEN>"

响应示例

{
  "data": [
    {
      "reply_quota_usage": 1,
      "reply_config": {
        "quota_total": 1000,
        "quota_duration": 86400
      }
    }
  ]
}

删除

Threads 主页在连续 24 小时内仅限执行 100 次删除。

如要检查主页当前的 Threads 删除流量限制使用情况，请查询 GET /{threads-user-id}/threads_publishing_limit 端点。详情请参阅删除帖子文档。

注意：该端点需要 threads_basic 和 threads_delete 权限。

字段

名称	描述
`delete_quota_usage`	过去 24 小时内的 Threads 删除次数。
`delete_config`	Threads 删除流量限制配置对象，其中包含 `quota_total` 和 `quota_duration` 字段。

请求示例

curl -s -X GET \
  "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publishing_limit?fields=delete_quota_usage,delete_config&access_token=<ACCESS_TOKEN>"

响应示例

{
  "data": [
    {
      "delete_quota_usage": 1,
      "delete_config": {
        "quota_total": 100,
        "quota_duration": 86400
      }
    }
  ]
}

地点搜索

Threads 主页在连续 24 小时内仅限搜索 500 个地点。

如要检查主页当前的 Threads 地点搜索流量限制使用情况，请查询 GET /{threads-user-id}/threads_publishing_limit 端点。详情请参阅地点搜索文档。

注意：该端点需要 threads_basic 和 threads_location_tagging 权限。

字段

名称	描述
`location_search_quota_usage`	过去 24 小时内的 Threads 地点搜索次数。
`location_search_config`	Threads 地点搜索流量限制配置对象，其中包含 `quota_total` 和 `quota_duration` 字段。

请求示例

curl -s -X GET \
  "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publishing_limit?fields=location_search_quota_usage,location_search_config&access_token=<ACCESS_TOKEN>"

响应示例

{
  "data": [
    {
      "location_search_quota_usage": 1,
      "location_search_config": {
        "quota_total": 500,
        "quota_duration": 86400
      }
    }
  ]
}

限制和规范

图片参数

格式：JPEG 和 PNG 图片类型是官方支持的图片帖子的格式。
文件大小：最大 8 MB。
宽高比限制：10:1
最小宽度：320（必要时将扩大至最小值）
最大宽度：1440（必要时将缩小至最大值）
高度：发生变化（取决于宽度和宽高比）
色彩空间：sRGB。若图片使用其他色彩空间，系统会将其色彩空间转换为 sRGB。

视频规格

容器：MOV 或 MP4 (MPEG-4 Part 14)，没有编辑列表，文件以 moov atom 开头。
音频编解码器：AAC，采样率不超过 48khz，1 或 2 个通道（单声道或立体声）。
视频编解码器：HEVC 或 H264，逐行扫描，封闭式图片组，4:2:0 色度抽样。
帧率：23-60 FPS
图片尺寸：
- 最大列数（水平像素）：1920
- 宽高比要求为 0.01:1 至 10:1，但我们建议使用 9:16 的宽高比，以避免图片被裁剪或出现空白位置。
视频比特率：VBR，最高 100 Mbps。
音频比特率：128 kbps。
时长：最多 300 秒（5 分钟），最少超过 0 秒。
文件大小：最大 1 GB。

其他限制

文字帖内容限制为 500 个字符。
轮播帖的子帖数量最高不得超多 20 个，最低不得少于 2 个。
如需了解其他限制，请参阅各端点参考文档。

后续步骤

Threads API 入门指南