codecamp

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"
}
OpenAI 创建上传接口
OpenAI Uploads 接口参考
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录

其他能力与进阶指南

Embeddings 接口参考

审计日志接口参考

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }