Skip to main content

API Reference

Complete reference for the Promptomize API.

Base URL

https://api.promptomize.app/api/v1

Authentication

All endpoints require an API key in the X-API-Key header.

Learn more about authentication →

Endpoints

MethodEndpointDescriptionPermission
POST/public/enhanceEnhance a promptenhance
GET/public/usageGet usage and quota-
GET/public/modelsList modalities and options-
GET/public/historyGet enhancement historyread_history

Response Headers

All responses include these headers:

HeaderDescription
X-RateLimit-LimitMaximum requests per minute
X-RateLimit-RemainingRemaining requests in current window
X-RateLimit-ResetUnix timestamp when limit resets
X-Quota-LimitMonthly request quota
X-Quota-RemainingRemaining monthly requests
X-Quota-ResetISO date when quota resets

Content Types

  • All requests must use application/json
  • All responses are application/json
  • Streaming responses use text/event-stream

OpenAPI Specification

Download the complete OpenAPI 3.1 specification for use with code generators and API clients.