--- title: 新增上傳分段 | RunAPI description: 將一個多部分 Part 串流上傳至未完成的 Upload。 url: https://runapi.ai/zh-HK/docs/api/protocol/uploads/add-part.md canonical: https://runapi.ai/zh-HK/docs/api/protocol/uploads/add-part locale: zh-HK --- > HTML 版本: https://runapi.ai/zh-HK/docs/api/protocol/uploads/add-part > 智能代理網站索引: https://runapi.ai/llms.txt # 新增上傳分段 將一個多部分 Part 串流上傳至未完成的 Upload。 ## 端點 POST /v1/uploads/:upload_id/parts 基礎 URL: https://runapi.ai API 版本: v1 身份驗證: Authorization: Bearer YOUR_API_KEY ## 請求 僅在列出的請求位置傳送值。 ### multipart/form-data ```json { "data": { "description": "上傳 Part 位元組。", "format": "binary", "required": true, "type": "string" } } ``` ### 路徑參數 ```json { "upload_id": { "description": "RunAPI 上傳 ID。", "required": true, "type": "string" } } ``` ## 成功回應 HTTP 200 - POST /v1/uploads/:upload_id/parts ```json { "created_at": 1785196860, "id": "part_abc123", "object": "upload.part", "upload_id": "upload_abc123" } ``` ## 錯誤回應（401） HTTP 401 ### 回應結構 ```json { "additionalProperties": true, "properties": { "error": { "additionalProperties": true, "properties": { "code": { "type": [ "string", "null" ] }, "message": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "type": { "type": "string" } }, "required": [ "message", "type" ], "type": "object" } }, "required": [ "error" ], "type": "object" } ``` ### 回應範例 ```json { "error": { "code": "authentication_error", "message": "Missing API key", "param": null, "type": "authentication_error" } } ``` ## 錯誤回應（400） HTTP 400 ### 回應結構 ```json { "additionalProperties": true, "properties": { "error": { "additionalProperties": true, "properties": { "code": { "type": [ "string", "null" ] }, "message": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "type": { "type": "string" } }, "required": [ "message", "type" ], "type": "object" } }, "required": [ "error" ], "type": "object" } ``` ### 回應範例 ```json { "error": { "code": "invalid_request_error", "message": "Malformed request", "param": null, "type": "invalid_request_error" } } ``` ## 錯誤回應（404） HTTP 404 ### 回應結構 ```json { "additionalProperties": true, "properties": { "error": { "additionalProperties": true, "properties": { "code": { "type": [ "string", "null" ] }, "message": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "type": { "type": "string" } }, "required": [ "message", "type" ], "type": "object" } }, "required": [ "error" ], "type": "object" } ``` ### 回應範例 ```json { "error": { "code": "not_found", "message": "File not found", "param": null, "type": "invalid_request_error" } } ``` ## 錯誤回應（409） HTTP 409 ### 回應結構 ```json { "additionalProperties": true, "properties": { "error": { "additionalProperties": true, "properties": { "code": { "type": [ "string", "null" ] }, "message": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "type": { "type": "string" } }, "required": [ "message", "type" ], "type": "object" } }, "required": [ "error" ], "type": "object" } ``` ### 回應範例 ```json { "error": { "code": "upload_state_conflict", "message": "Upload state conflict", "param": null, "type": "invalid_request_error" } } ``` ## 錯誤回應（413） HTTP 413 ### 回應結構 ```json { "additionalProperties": true, "properties": { "error": { "additionalProperties": true, "properties": { "code": { "type": [ "string", "null" ] }, "message": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "type": { "type": "string" } }, "required": [ "message", "type" ], "type": "object" } }, "required": [ "error" ], "type": "object" } ``` ### 回應範例 ```json { "error": { "code": "file_too_large", "message": "File size exceeds the maximum allowed size", "param": "file", "type": "invalid_request_error" } } ``` ## 錯誤回應（422） HTTP 422 ### 回應結構 ```json { "additionalProperties": true, "properties": { "error": { "additionalProperties": true, "properties": { "code": { "type": [ "string", "null" ] }, "message": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "type": { "type": "string" } }, "required": [ "message", "type" ], "type": "object" } }, "required": [ "error" ], "type": "object" } ``` ### 回應範例 ```json { "error": { "code": "invalid_upload", "message": "Upload request rejected", "param": null, "type": "invalid_request_error" } } ``` ## 錯誤回應（502） HTTP 502 ### 回應結構 ```json { "additionalProperties": true, "properties": { "error": { "additionalProperties": true, "properties": { "code": { "type": [ "string", "null" ] }, "message": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "type": { "type": "string" } }, "required": [ "message", "type" ], "type": "object" } }, "required": [ "error" ], "type": "object" } ``` ### 回應範例 ```json { "error": { "code": "storage_write_failed", "message": "File storage failed", "param": null, "type": "server_error" } } ``` ## cURL 範例 ### curl ```curl curl -X POST https://runapi.ai/v1/uploads/upload_abc123/parts \ -H 'Authorization: Bearer YOUR_API_KEY' \ -F 'data=@./archive.part-01' ``` ## 相關參考資料 - [上傳](https://runapi.ai/zh-HK/docs/api/protocol/uploads.md) - [Upload 物件](https://runapi.ai/zh-HK/docs/api/protocol/uploads/object.md) --- ## RunAPI 的更多內容 - [首頁](https://runapi.ai/zh-HK/.md) - [模型目錄](https://runapi.ai/zh-HK/models.md) - [收費](https://runapi.ai/zh-HK/pricing.md) - [服務商](https://runapi.ai/zh-HK/models) - [文件](https://runapi.ai/zh-HK/docs/guides) - [SDK](https://runapi.ai/zh-HK/sdk.md) - [CLI](https://runapi.ai/zh-HK/cli.md) - [MCP Server](https://runapi.ai/zh-HK/mcp.md) - [Claude Code 與 Cursor](https://runapi.ai/zh-HK/claude-code-vs-cursor.md) - [Cursor API 設定](https://runapi.ai/zh-HK/cursor-api-setup.md) - [RunAPI 與 OpenRouter](https://runapi.ai/zh-HK/openrouter-alternative.md) - [企業版](https://runapi.ai/zh-HK/contact.md) - [聯絡](https://runapi.ai/zh-HK/contact.md) - [條款](https://runapi.ai/zh-HK/terms.md) - [私隱](https://runapi.ai/zh-HK/privacy.md) - [智能代理網站索引](https://runapi.ai/llms.txt) 聯絡我們: contact@runapi.ai ## 結構化資料 ```json [ { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/zh-HK", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/zh-HK/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/zh-HK", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/zh-HKicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "TechArticle", "headline": "新增上傳分段", "description": "將一個多部分 Part 串流上傳至未完成的 Upload。", "url": "https://runapi.ai/zh-HK/docs/api/protocol/uploads/add-part", "mainEntityOfPage": "https://runapi.ai/zh-HK/docs/api/protocol/uploads/add-part" } ] ```