Aetherion AI

Operating Workspace

Developer API v1
Reference9 min~162 words

Usage and generation endpoints

Credits, plan capacity, storage and AI generation history.

GET /usage

Returns a current-month workspace usage snapshot. The response measures account plan access, credit balance and charges, projects, publications, asset storage, generation counts and the API window after the current request.

ObjectImportant fields
periodstarts_at, measured_at
planSlug, name, subscription status and period end.
creditsBalance, monthly allowance and charged this month.
projectsTotal, active and plan limits.
publicationsActive count and limit.
storageUsed bytes, used MB and limit MB.
generationsTotal, completed and failed this month.
apiLimit, remaining calls and reset time.

GET /generations

ParameterBehaviour
statusExact generation status.
project_idExact project ID, maximum 80 characters.
media_typeExact media type, maximum 40 characters.
job_typeExact job type, maximum 60 characters.
sortcreated_at, started_at, completed_at, status, charged_credits

Records can include project and asset IDs, job and media type, provider, model, status, plan, estimated and charged credits, error message and lifecycle timestamps. Only jobs owned by the authenticated account are returned.

bash
curl "https://aetherionai.org/api/v1/generations?project_id=PROJECT_ID&status=completed&per_page=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

Need project-specific help?

Open the private Help Center or create a support ticket with the affected project, route and request ID.