Skip to content

Rapidfile Upload API 與 Media

為您的應用程式提供檔案上傳。 為您的媒體提供代管。

Rapidfile Upload API 會儲存使用者上傳的檔案,Rapidfile Media 則代管您的圖片、影片與音訊。兩者都從 cdn.rapidfile.cc 發送,使用您的 Enzonic 登入,並自動套用您付費 Enzonic 方案的限制。

包含在每個付費 Enzonic 方案中。免費帳戶則使用 Rapidfile 自己的免費方案。

Rapidfile Upload API: api.rapidfile.cc 上的 Upload API 首頁,含 Next.js 上傳路由

Rapidfile Upload API

位於 api.rapidfile.cc 的 REST API,供您建置的應用程式使用。您的伺服器保管機密的 rk_live_ 金鑰;瀏覽器只會看到已簽章的上傳 URL。

已簽章的上傳 URL
POST /v1/uploads 會回傳一個有效期一小時、可安全交給瀏覽器的已簽章 URL,瀏覽器會直接上傳至儲存空間。
大型檔案分段上傳
最大 95 MB 的檔案可在一次請求中上傳;較大的檔案會使用分段上傳,上限為您方案的檔案大小限制。
伺服器上傳與檔案管理
使用 PUT /v1/files 從您的伺服器上傳,並以同一組金鑰列出、取得與刪除檔案。
公開或私人檔案
公開檔案會在 cdn.rapidfile.cc 上取得一個連結。私人檔案則取得在七天內到期的已簽章連結。
已簽章的 Webhook
file.uploaded 與 file.deleted 事件會附上可驗證的 HMAC-SHA256 簽章,傳送至您的端點。
傳送前掃描
上傳的檔案會掃描惡意軟體,掃描完成前,檔案不會從 CDN 傳送。
app/api/upload/route.ts
// Your server: create an upload with the secret key
const res = await fetch("https://api.rapidfile.cc/v1/uploads", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.RAPIDFILE_KEY}`, // rk_live_...
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ name: "avatar.png", size: 48213, type: "image/png" }),
});
return Response.json(await res.json()); // { file, upload }
在瀏覽器中(sdk.js)
// The browser: upload straight to storage with sdk.js
import { uploadFile } from "https://api.rapidfile.cc/sdk.js";

const file = await uploadFile(input.files[0], {
  getUpload: "/api/upload", // your endpoint above
  onProgress: (p) => console.log(p.percent),
});
console.log(file.url); // https://cdn.rapidfile.cc/<id>/avatar.png

位於 api.rapidfile.cc/sdk.js 的瀏覽器 SDK 沒有任何相依套件:它會向您的端點申請上傳、以分段方式傳送大型檔案,並回報進度。

Rapidfile Media

位於 media.rapidfile.cc 的圖片、影片與音訊代管,適用於您想自行分享的檔案。

每個檔案都有連結、播放器與分享頁面

拖放一個檔案,即可取得分享頁面、可嵌入的播放器與直接的 CDN 連結。您可以將檔案設為公開或不公開列出,並查看瀏覽次數。

圖片
PNG, JPEG, GIF, WebP, AVIF
影片
MP4, WebM, QuickTime
音訊
MP3, M4A, OGG, WAV, WebM
  • 分享頁面與可嵌入的播放器
  • 每個檔案都有直接的 CDN 連結
  • 公開或不公開列出的檔案,並顯示瀏覽次數
  • 可從您自己的工具上傳與管理媒體的 JSON API
開啟 Rapidfile Media
Rapidfile Media: media.rapidfile.cc 上的 Rapidfile Media 上傳頁面

各方案的 Rapidfile 限制

「免費」欄是 Rapidfile 自己的免費方案。每個付費 Enzonic 方案都會自動套用其欄位中的限制,Rapidfile 則採用這些限制與您自己 Rapidfile 方案中較高的一個。

方案免費免費StarterUS$5 每月ProUS$10 每月GrowthUS$19 每月BusinessUS$29 每月
Rapidfile Upload API
儲存空間2 GB100 GB200 GB500 GB1 TB
檔案大小最多 512 MB最多 4 GB最多 8 GB最多 16 GB最多 32 GB
應用程式3102550100
CDN 傳送不按日計量不按日計量不按日計量不按日計量不按日計量
Rapidfile Media
儲存空間1 GB100 GB200 GB500 GB1 TB
檔案大小最多 100 MB最多 5 GB最多 10 GB最多 20 GB最多 20 GB
CDN 請求每天 200,000每天 1,000,000每天 2,000,000每天 4,000,000每天 8,000,000

來自 CDN 的 Upload API 傳送不按日計量。贈與也會套用所授予方案的 Rapidfile 限制。

enzonic.dev 上的 Rapidfile

在 enzonic.dev 比較所有限制

Cloud 補助金

為替他人建置的人提供免費 Pro 或 Business 時間,以及最多 US$500 的 Cloud 額度。

  • 3、6 或 12 個月的 Pro 或 Business
  • Enzonic 餘額中最多 US$500 的 Cloud 額度
  • 一項補助涵蓋 Deploy、Databases、CI 與該方案的 Rapidfile 限制
  • 由真人審閱,通常會在幾天內回覆

請使用 enzonic.dev 上的表單申請。只需要一個免費的 Enzonic 帳戶,不需信用卡。

  • 開源專案
  • 學生
  • 非營利組織
  • 新創公司
  • 教育工作者
  • 黑客松

常見問題

不需要。Rapidfile 使用同一個 Enzonic 登入。當您的 Enzonic 方案為付費方案時,Rapidfile 會自動為您的帳戶套用 Upload API 與 Media 的限制;如果您自己的 Rapidfile 方案更高,則套用該方案的限制。

建立 API 金鑰,送出您的第一次上傳。

也要代管應用程式、資料庫或其管線嗎?