ZETRAX REST API
The ZETRAX API provides programmatic access to our prompt generation engine. Build integrations, automate workflows, and scale AI-powered creativity in any stack.
Authentication
All API requests must be authenticated using a Bearer token in the Authorization header. You can create and manage API keys in your Dashboard → API Keys.
API keys are scoped to your account. Never share or commit them to version control. Use environment variables.
Base URL
All API requests must be made over HTTPS to the following base URL:
Generate a Prompt
Generate a high-quality AI prompt from the provided subject, style, and lighting parameters. Returns a structured prompt object with variants.
Request Body Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| subject | string | Required | The primary subject of the prompt (e.g., "Portrait Photography") |
| style | string | Required | The artistic style modifier (e.g., "Cinematic Film", "Watercolor") |
| lighting | string | Required | Lighting descriptor (e.g., "Golden Hour", "Studio Soft Box") |
| quality | string | Optional | Output quality tier: "standard" | "premium" | "ultra". Default: "standard" |
| model_target | string | Optional | Target AI model: "midjourney" | "dalle3" | "stablediffusion" | "universal" |
| variants | integer | Optional | Number of prompt variations to return (1–5). Default: 1 |
| temperature | float | Optional | Creativity variance 0.0–1.0. Higher = more creative. Default: 0.7 |
Response
Returns a PromptObject with the generated text, metadata, and usage statistics.
List Prompts
Returns a paginated list of all prompts generated by the authenticated user. Supports cursor-based pagination and filtering.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Number of results per page (1–100). Default: 20 |
| cursor | string | Pagination cursor from previous response's next_cursor field |
| search | string | Full-text search query across prompt content |
| style | string | Filter by style modifier slug |
Rate Limits
API rate limits are applied per API key. Exceeding the limit returns a 429 Too Many Requests response with a Retry-After header.
| Plan | Requests / minute | Requests / month |
|---|---|---|
| Hobby (Free) | 10 | 50 |
| Pro | 120 | Unlimited |
| Enterprise | Custom | Custom |
Error Codes
| Code | HTTP Status | Description |
|---|---|---|
| invalid_api_key | 401 | The provided API key is invalid or expired |
| rate_limit_exceeded | 429 | You've exceeded your plan's rate limit |
| invalid_params | 400 | One or more required parameters are missing or malformed |
| model_unavailable | 503 | The specified model_target is temporarily unavailable |
| internal_error | 500 | An unexpected server error occurred. Our team is notified. |