上传文件 · Moss API

使用方式

场景	后续用法
音频转写	上传音频后，在 POST /v1/audio/transcriptions 中传 file_id
多模态理解	上传图片或视频后，在 POST /v1/responses 的内容项中传 file_id
直接上传	如果业务接口支持 multipart file，也可以不提前上传文件，直接在业务请求中上传

请求参数

字段类型必填说明

file: multipart file必填

multipart 文件字段，单文件最大 512 MB；文件流式上传到资产，不整文件读入内存。

purpose: string必填

文件用途。

返回值

字段类型说明

id: string

文件 id，即后续接口使用的 file_id。

object: string

固定为 file。

bytes: integer

文件字节数。

created_at: integer

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

filename: string

原始文件名。

purpose: string

上传时传入的用途标记。

status: string

文件状态，例如 processed / active；失败时可能返回 failed，具体以服务端实际返回为准。

下一步

查询文件列表

查询当前账号上传的文件列表。

音频转写

音频转写接口。

请求示例

curl -X POST "https://api.mosi.cn/v1/files" \
  -H "Authorization: Bearer $MOSS_API_KEY" \
  -F "purpose=audio" \
  -F "file=@./audio.wav"

import os
import requests

with open("./audio.wav", "rb") as file:
    response = requests.post(
        "https://api.mosi.cn/v1/files",
        headers={
        "Authorization": f"Bearer {os.environ['MOSS_API_KEY']}",
        },
        data={
            "purpose": "audio",
        },
        files={"file": file},
    )

response.raise_for_status()
print(response.json())

import { readFile } from "node:fs/promises"

const bytes = await readFile("./audio.wav")
const form = new FormData()
form.append("purpose", "audio")
form.append("file", new Blob([bytes]), "audio.wav")

const response = await fetch("https://api.mosi.cn/v1/files", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.MOSS_API_KEY,
  },
  body: form,
})

if (!response.ok) throw new Error(`HTTP ${response.status}`)
console.log(await response.json())

响应示例

{
  "id": "<file_id>",
  "object": "file",
  "filename": "audio.wav",
  "purpose": "audio",
  "bytes": 5242880,
  "created_at": 1710000000,
  "status": "processed"
}