Referencia de la 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.

Cuerpo de la solicitud

filefileobligatorio

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
Ejecuta el ejemplo: reproduce un intercambio real a partir de los datos de la propia documentación. Sin clave, sin solicitud, sin cargo.

Respuesta

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 }
}