> This page is for 平台, version V4 实验版.
> For other versions, use one of these documentation indexes:
> - V4 (default): https://next.developer.frame.io/platform/v4/llms.txt
> - V4 实验版: https://next.developer.frame.io/platform/v4-experimental/llms.txt
> - 旧版: https://next.developer.frame.io/platform/v2/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://next.developer.frame.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://next.developer.frame.io/_mcp/server.

# 常见问题解答

Frame.io API 允许开发者集成 Frame.io 的界面，供创意人员及其团队管理他们的工作。

## 常见问题

#### API 参考在哪里？

前往[此处](https://developer.adobe.com/frameio/api/current/)查看 Frame V4 API 参考页面。

#### 如何获得帮助？

通过我们的[支持网站](https://help.frame.io/zh-CN/)与我们聊天，联系 Frame.io 支持团队寻求帮助。 请注意，企业客户可能会被转介给其客户成功经理。

#### Frame.io API 有哪些关键概念？

* V4 代表从主要服务后期制作视频专业人员扩展到面向创意人员和创意管理者的跨学科平台。 Frame.io 可以充当多学科团队的中心平台，解决从为创意工作提供更多专注时间到提高正在进行项目的可见性等各种关键需求。

#### 工作流管理

利用元数据、自定义字段和收藏集，大规模集中、组织和构建所有端到端创意工作流。

#### 文件传输和管理

这套功能为用户提供了充分的灵活性和强大动力，使其能够构建适合其创作过程的文件管理系统，从而更容易快速获取所需信息，并大规模管理所有正在进行的工作资产。

#### 审阅和审批

Frame.io 帮助创意团队通过适用于广泛媒体类型的先进审阅、评论和批注功能减少修订周期总数。

#### 共享和演示

从一个集中位置自定义和共享创意作品。

#### 安全性和治理

在统一的位置查看和管理所有用户、工作区和项目。 执行批量操作并导出信息来控制您如何利用使用情况数据。

#### 开放 API 标准

通过 OpenAPI 3.0 规范记录的 REST API 可以将 Frame.io 连接到您已使用的系统，从而解锁自定义工作流程。

## 兼容性问题

#### Frame.io V4 API 是否向后兼容？

> **Warning**
>
> 否。 在 Adobe MAX 上发布的 Frame.io 产品与旧版产品的运行方式截然不同，且强调的是不同的工作流程。 由于这些差异，新的 API 不向后兼容。

#### 今后要如何处理向后兼容性？

考虑到向后兼容性对于管理生产-质量集成且有高正常运行时间要求的客户来说是一个主要问题，我们正在设计 V4 API，以通过自定义 HTTP 标头支持额外的版本控制级别，以便允许客户端选择使用实验性端点，避免破坏性更改，并在 `/v4` API 命名空间内提供向后兼容性保证。

#### V4 API 全面推出后，我使用旧版产品设置的自动化功能是否会继续运行？ 也就是说，这些功能是否会自动迁移到 V4？

> **Warning**
>
> 所有使用旧版开发者令牌的自动化功能将不再适用于 V4 帐户。 我们**无法**将其迁移到 V4。

## 可用性问题

#### V4 API 是否仅适用于企业？

V4 API 目前适用于新的企业客户以及通过测试帐户选择的客户和合作伙伴。

#### 我们能否在 V4 上以编程方式创建和管理收藏集？

> **Info**
>
> 我们尚未提供任何公开可用的收藏集端点。 但是，收藏集管理功能正在开发中。

## 媒体和文件

#### 媒体关联 URL 的有效期是多长时间？

在 `media_links` 中返回的 URL（例如 `download_url`、`inline_url` 和 `url`）是**临时签名的 URL**，它们会过期且无法无限期重用。

| URL 类型                                                            | 过期时间     |
| ----------------------------------------------------------------- | -------- |
| 下载和内联 URL（`original`、`high_quality`、`efficient`、`video_h264_180`） | 最长 24 小时 |
| 缩略图和预览 URL (`thumbnail`)                                          | 最长 24 小时 |

实际上，过期时间与 UTC 中午或午夜一致，因此当您收到 URL 时，实际剩余时间可能在几分钟到 24 小时之间，具体取决于发出请求的时间。

**请勿存储或缓存这些 URL。** 每次需要提供或访问文件时，请始终请求一组全新的 `media_links`。 尝试使用过期 URL 将导致 CDN 出现 `403` 错误。

## 集成问题

#### V4 是否会支持 Zapier 连接？

> **Info**
>
> 但是，现有的 Zapier 集成**尚不支持** V4，目前正在开发中。

#### 对于 Frame.io V4 与 Airtable、Zapier 和 Make 集成，是否有支持或推荐的工作流程？

> **Info**
>
> 还没有，但正在开发中。