OpenAI 添加上传分片接口

添加上传分片

post /uploads/{upload_id}/parts

向Upload对象添加分片。分片表示待上传文件中的一块字节数据。

每个分片最大64 MB；可以持续添加分片，直到达到Upload的8 GB上限。

可以并行添加多个分片。在完成Upload时，可确定分片的预期顺序。

路径参数

• upload_id: string：上传对象的 ID。

请求体参数

媒体类型为 multipart/form-data。

• data: string：此分片的字节数据。

返回值

• UploadPart object { id, created_at, object, upload_id }

上传分片表示可添加到Upload对象的一块字节数据。

• id: string

上传分片的唯一标识符，可在API端点中引用。

• created_at: integer（Unix 时间戳）

分片创建时的Unix时间戳，单位为秒。

• object: "upload.part"

对象类型，固定为upload.part。

• "upload.part"

• upload_id: string

此分片所属Upload对象的ID。

示例

## [中文] 发送POST请求；将示例API凭证、文件或上传对象标识替换为应用使用的值。
curl https://api.openai.com/v1/uploads/$UPLOAD_ID/parts \
    -H 'Content-Type: multipart/form-data' \
    -H "Authorization: Bearer $OPENAI_API_KEY" \
    -F 'data=@/path/to/data'

响应

中文说明：以下为原文配置、命令或事件示例，字段名、枚举、标识符及数值保留。

{
  "id": "id",
  "created_at": 0,
  "object": "upload.part",
  "upload_id": "upload_id"
}

示例

原文示例待核：此片段的curl行与后续参数行之间缺少Shell续行符；保留原状，执行前须核对完整命令。

## [中文] 发送POST请求；将示例API凭证、文件或上传对象标识替换为应用使用的值。
curl https://api.openai.com/v1/uploads/upload_abc123/parts
  -F data="aHR0cHM6Ly9hcGkub3BlbmFpLmNvbS92MS91cGxvYWRz..."

响应

中文说明：以下为原文配置、命令或事件示例，字段名、枚举、标识符及数值保留。

{
  "id": "part_def456",
  "object": "upload.part",
  "created_at": 1719185911,
  "upload_id": "upload_abc123"
}