ファイル詳細の取得

リクエストパラメータ

パスパラメータ型必須説明

file_id: string必須

POST /v1/filesが返すid。

戻り値

フィールド型説明

id: string

ファイルID。すなわちfile_idです。

object: string

固定値file。

bytes: integer

ファイルのバイト数。

created_at: integer

作成時刻。Unixタイムスタンプ（秒）。

filename: string

元のファイル名。

purpose: string

ファイルの用途を示す値。空文字列の場合があります。

status: string

ファイルの状態。サーバーの実際の返却値に準じます。

境界

外部向けのエンドポイントではasset_idは公開されません。モデル呼び出しでfile_idを渡すと、プラットフォームがそれをダウンロードURLに解決して下流で使用します。呼び出し側とモデル側が扱うのはfile_idまたはURLのみです。

次のステップ

ファイルの削除

アップロード済みのファイルを削除します。

ファイルのアップロード

音声ファイルをアップロードしてfile_idを取得します。

リクエスト例

curl -X GET "https://api.mosi.cn/v1/files/<file_id>" \
  -H "Authorization: Bearer $MOSS_API_KEY"

import os
import requests

response = requests.get(
        "https://api.mosi.cn/v1/files/<file_id>",
        headers={
        "Authorization": f"Bearer {os.environ['MOSS_API_KEY']}",
        },
)

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

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

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

レスポンス例

{
  "id": "<file_id>",
  "object": "file",
  "bytes": 1048576,
  "created_at": 1710000000,
  "filename": "speech.wav",
  "status": "active"
}