API Reference

Proxy endpoints

Orqen supports stateless upstream proxy endpoint families in addition to chat completions. These routes use the same Orqen API key and provider-key injection, but they do not run chat-only payload optimization, tool routing, prompt compression, or session chat logging.

Object lifecycle APIs such as files, batches, vector stores, assistants, containers, and evals need storage ownership and provider-specific lifecycle semantics. They are intentionally not exposed as blind pass-through routes.

Supported stateless endpoints

POST	/v1/completions	Text completions via upstream proxy
POST	/v1/embeddings	Embeddings via upstream proxy
POST	/v1/responses	OpenAI Responses API via upstream proxy
POST	/v1/images/generations	Image generation
POST	/v1/images/edits	Image editing, multipart form
POST	/v1/images/variations	Image variations, multipart form
POST	/v1/audio/transcriptions	Audio transcription, multipart form
POST	/v1/audio/speech	Text to speech, binary audio response
POST	/v1/moderations	Moderation
POST	/v1/rerank	Rerank
POST	/v1/ocr	OCR
POST	/v1/videos/generations	Video generation

Embeddings

curl https://api.orqen.app/v1/embeddings \
  -H "Authorization: Bearer sk-orq-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": "Memory snippet to embed"
  }'

Images

curl https://api.orqen.app/v1/images/generations \
  -H "Authorization: Bearer sk-orq-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "A clean product UI mockup"
  }'

Audio

curl https://api.orqen.app/v1/audio/speech \
  -H "Authorization: Bearer sk-orq-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tts-1",
    "voice": "alloy",
    "input": "Hello from Orqen"
  }' \
  --output speech.mp3

Provider credentials

The model field is used to detect the provider and inject the provider key saved in the dashboard. Per-request provider credentials also work on these endpoints when the upstream provider supports them.