eroq

Referencia de la API · Storage

Storage · upload

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

POST/v1/storage/objectsFree within your plan's storage, then 2 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).

Uploads are free within your plan's storage (5 GB without a plan, up to 1 TB on plans; your Store objects, uploads, reference photos and unpublished library media count together). Past it, a one-time 2 credits per started 10MB on the bytes beyond. 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).

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 file=@poster.webp
/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 }
}