API 레퍼런스 · Storage

Storage · upload

Upload a file to the eroq Store and get a CDN URL back.

POST/v1/storage/objects2 per started 10MB, one-time

Object storage over a global CDN — the missing half of every generation stack. The Store is governed by the same acceptable-use policy as the models, so what the API generates, the Store can host.

Send multipart/form-data with a file part (up to 100MB) and an optional name. The response carries the public CDN URL immediately — pair it with image or video generation to unlock a permanent public URL for the render in one call (store: true).

Pricing is a one-time 2 credits per started 10MB: storage stays as long as your account lives, serving included within fair use (sustained multi-TB egress on a single object moves to metered, with notice). Generation outputs are stored free up to a 5 GB workspace quota; beyond it the same rate applies once.

요청 본문

filefile필수

The file to store (any type, up to 100MB).

namestring

Filename hint kept in the URL (sanitized).

curl https://eroq.ai/v1/storage/objects \
  -H "Authorization: Bearer $EROQ_API_KEY" \
  -F name=poster.webp \
  -F [email protected]
/v1/storage/objects
→ POST /v1/storage/objects
실행을 눌러 보세요 — 문서에 담긴 데이터로 실제 요청과 응답을 그대로 재현해요. 키도, 요청도, 요금도 없어요.

응답

200 · application/json
{
  "id": "0b52…",
  "object": "storage.object",
  "url": "https://store.eroq.ai/acc_…/8c1f2-poster.webp",
  "bytes": 482133,
  "content_type": "image/webp",
  "usage": { "credits_spent": 2, "credits_remaining": 880 }
}