Axis API
Axis is the external developer surface for StudioAxis — the production engine behind WorldAxis. WorldAxis documents and positions the platform; all requests execute on StudioAxis.
What you get
- Deterministic image generation with cinematic reasoning (not raw model calls)
- Organization-scoped auth, per-generation usage metering, and audit logs
- Idempotent writes for safe retries in production pipelines
- Enterprise controls: rate limits, SLAs, and dedicated capacity (see Enterprise)
Base URL
https://studioaxis.io/api/external
Versioned paths:
| Version | Path prefix | Use case |
|---|---|---|
| v1 | /v1/ | Standard image generation |
| v2 | /v2/ | Cinematic pipeline (anchor → interpretation → render) |
Quickstart
1. Obtain credentials
Contact info@studioaxis.io for an API key and organization id. Keys are issued and rotated in StudioAxis only.
Generation = one successful billed API output (v1 or v2). See Pricing for the commercial model.
2. Make a request
curl -X POST "https://studioaxis.io/api/external/v1/generate-image" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "X-External-Org-Id: your-org-id" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Product hero on marble surface, soft key light",
"aspectRatio": "16:9",
"resolution": "2K"
}'
3. Handle the response
A successful call returns 200 with generationId and imageUrl. See API reference and Examples.
What Axis is not
| Misconception | Reality |
|---|---|
| Gemini API proxy | Multi-stage orchestration with semantic + cinematic layers |
| Prompt wrapper | Orchestration, brand context, per-generation usage metering |
| Creative toy | Production infrastructure with audit trail and billing |
Read Why Axis for positioning. Read Architecture for how StudioAxis executes requests.
Navigation
| Page | Description |
|---|---|
| Why Axis | Positioning and differentiation |
| Architecture | System design (StudioAxis backend) |
| API reference | Endpoints, headers, errors |
| API Examples | v1/v2 workflows, visual intent, errors |
| Enterprise | SLA, security, scaling, pilot path |
| Pricing | Commercial framework (no rate card) |