> This page is for 平台, version 旧版.
> 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 V3 → V4 迁移指南





以下指南将帮助您从 Frame.io API V3（在文档中有时称为“旧版”或“v2”端点）迁移到 Adobe Frame.io API V4。这参照了 Dropbox API 迁移示例的风格和结构，为您全面展示端点映射、负载更改、身份验证更新等内容。



---

---


## 端点：V3 → V4 映射





以下是 Frame.io V3 关键端点（左侧）与其 V4 对应端点（右侧）的并排对比。本部分灵感来自 Dropbox“v1 → v2 映射”表格。



<blockquote>**提示：**此表格侧重于典型的文件、文件夹和项目操作。专用端点（例如，Camera to Cloud）已被省略。</blockquote>



### OAuth 与身份验证




| **V3** | **V4** |
| --- | --- |
| 开发者令牌（Bearer `<token></token>`）或使用 `Authorization: Bearer 的 Frame.io OAuth 2.0<token></token>` | Adobe IMS OAuth 2.0（必须在 Adobe Developer Console 中创建一个项目）并使用：`Authorization: Bearer<adobe_access_token></adobe_access_token>` |
**注意：**旧版开发者令牌无法自动转换。您必须实施新的 IMS OAuth 流程。**文档：**[如何获取 Adobe Frame.io 访问令牌](https://developer.adobe.com/frameio/api/current/)

### 文件夹和文件操作





#### 创建文件夹




* **V3（创建文件夹）：**

```http

POST /v2/assets/{parent_asset_id}/children


  

Content-Type: application/json



  

{


    

&quot;name&quot;: &quot;My New Folder&quot;,


    

&quot;type&quot;: &quot;folder&quot;


  

}