MODELAXY API / V1

One contract for every intelligence workload.

Build with native Modelaxy controls or existing OpenAI clients. Every response stays on a stable public service profile while private execution remains private.

Base URLhttps://api.modelaxy.comAuthenticationAuthorization: Bearer $MODELAXY_API_KEY
01

API explorer

Send a workspace API key as a Bearer token. Full key secrets are displayed once and are never recoverable.

OpenAI compatible

Responses

A modern response contract for text generation, structured input, instructions, and streaming.

StreamingStructured inputPrivacy policyIdempotent retries
Request
curl -X POST "https://api.modelaxy.com/v1/responses" \
  -H "Authorization: Bearer $MODELAXY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "tokenlab-general",
  "instructions": "Be concise and practical.",
  "input": "Design a production incident checklist.",
  "max_output_tokens": 800
}'

Request

Bearer API key
FieldTypeRequirementDescription
modelstringRequired

A stable Modelaxy service profile.

inputstring | message[]Required

Plain text or role-based input messages.

instructionsstringOptional

High-level behavior for this response.

streambooleanOptional

Return typed server-sent events.

tokenlab.privacystringOptional

managed, zero_retention, or local_only.

Response

application/json
{
  "id": "resp_...",
  "object": "response",
  "status": "completed",
  "model": "tokenlab-general",
  "output_text": "The normalized Modelaxy answer.",
  "usage": {
    "input_tokens": 24,
    "output_tokens": 86,
    "total_tokens": 110
  }
}
02

Choose intent, not a vendor

Service profiles describe the behavior your application needs. Modelaxy can improve the private execution plan without changing your integration.

tokenlab-fast

Interactive, low-latency execution.

tokenlab-general

Balanced production default.

tokenlab-reasoning

Multi-pass evaluation and synthesis.

tokenlab-private

Hard local-only execution boundary.

03

Stable, traceable errors

Every error includes a public code and request ID. Internal provider, model, and deployment identifiers are never included.

{
  "error": {
    "code": "TL_CAPACITY_BUSY",
    "message": "Modelaxy capacity is temporarily busy.",
    "request_id": "req_..."
  }
}
04

Your requested boundary is enforced

Use local_only to exclude managed cloud execution. If compliant local capacity is unavailable, the request fails instead of silently falling back.

Open the API Center