JovethraDocumentation
JOVETHRA / API DOCUMENTATION

Build with a familiar OpenAI-compatible endpoint.

Keep the SDK you already know. Change the base URL, provide a Jovethra key, and ship your first request in minutes.

Choose a plan
Base URLhttps://api.jovethra.xyz/v1HTTPS
01 / QUICKSTART

One base URL. Provider-scoped keys.

Set the base URL and the matching Jovethra key in your OpenAI client. Always keep the key on the server.

cURL
curl https://api.jovethra.xyz/v1/responses \
  -H "Authorization: Bearer $JOVETHRA_GPT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "store": false,
    "input": "Summarize this release note in one sentence."
  }'
1Choose a familyGPT and Claude keys are separate.
2Set the variableJOVETHRA_GPT_KEY ou JOVETHRA_CLAUDE_KEY
3Send the requestQuotas are enforced automatically.
02 / RESPONSES API

Responses API

Use POST /v1/responses for new GPT integrations. Text, structured output, tools, and usage accounting follow the OpenAI-compatible contract.

JavaScript · OpenAI SDK
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.JOVETHRA_GPT_KEY,
  baseURL: "https://api.jovethra.xyz/v1",
});

const response = await client.responses.create({
  model: "gpt-5.6-sol",
  store: false,
  input: "List three concise naming ideas.",
});

console.log(response.output_text);
modelPublic model identifier.required
inputText or structured input.required
storeEnforced as false by the gateway.false
streamEnables server-sent events.optional
03 / CHAT COMPLETIONS

Chat Completions

Existing clients can keep using POST /v1/chat/completions. This path is available for all six public models.

JavaScript · OpenAI SDK
const completion = await client.chat.completions.create({
  model: "gpt-5.6-sol",
  messages: [
    { role: "system", content: "Be concise and precise." },
    { role: "user", content: "Explain idempotency." },
  ],
});

console.log(completion.choices[0].message.content);
04 / TOOLS

Controlled function calling.

Declare tools with the standard tools field. The model proposes arguments; your application remains responsible for validating them and every side effect.

JavaScript · Function tool
const response = await client.responses.create({
  model: "gpt-5.6-sol",
  input: "What is the weather in Paris?",
  tools: [{
    type: "function",
    name: "get_weather",
    description: "Get current weather for a city",
    parameters: {
      type: "object",
      properties: { city: { type: "string" } },
      required: ["city"],
    },
  }],
});
05 / STREAMING

Render output as it arrives.

Set stream: true. Consume the stream until completion; Chat Completions automatically requests usage in the stream.

JavaScript · SSE stream
const stream = await client.responses.create({
  model: "gpt-5.6-sol",
  input: "Write a two-line product description.",
  stream: true,
});

for await (const event of stream) {
  if (event.type === "response.output_text.delta") {
    process.stdout.write(event.delta);
  }
}
requestSSE eventscomplete + usage
06 / COMPATIBILITY

A precise public contract.

Jovethra exposes only the models authorized by the presented key. Responses is available for GPT; Chat Completions covers GPT and Claude. Unpublished paths return unsupported_endpoint.

API reference
GET /v1/modelsLists only models authorized by the key.all keys
POST /v1/responsesText, streaming, structured output, and tools for Sol, Terra, and Luna.GPT
POST /v1/chat/completionsMessages, streaming, and usage for all six models.all models
SSE streamingAvailable on Chat Completions and Responses for GPT.documented
Tools / function callingAvailable on GPT; validate the exact Claude compatibility first.validate first
gpt-5.6-solgpt-5.6-terragpt-5.6-lunaclaude-fable-5claude-opus-5-thinkingclaude-sonnet-5-thinking
  • JSON request bodies only, limited to 4 MiB.
  • store=false is enforced by the gateway.
  • Default output ceiling: 4,096 tokens.
  • Images, audio, files, batch, fine-tuning, and Assistants are not part of the contract.
07 / QUOTAS

Visible limits, no automatic overage.

Input, output, and cached tokens are tracked separately. Plans also enforce request-rate and concurrency limits.

Starter€9.99/mo

20M input · 1.25M output · 30M cache

Power€49.99/mo

110M input · 6.25M output · 150M cache

Request rate30 / 60 / 120 requests per minute by plan.per key
Concurrency2 / 4 / 8 in-flight requests by plan.per key
Model unitsEach model consumes a different share of the quota.weighted
Sol 1.0xTerra 0.6xLuna 0.1xFable 2.0xOpus 1.0xSonnet 0.4x

When a hard quota is reached, the request is rejected instead of triggering an automatic overage charge. Review usage in the portal.

08 / PRODUCTION

Keep the integration predictable.

Production requires isolated secrets, explicit timeouts, and a retry policy that understands streaming.

Store JOVETHRA_GPT_KEY or JOVETHRA_CLAUDE_KEY in a server-side secret manager.
Set timeouts and bounded exponential backoff with jitter.
Log the Jovethra request reference, never complete prompts or responses.
Validate tool arguments before every side effect.
Size input, output, and cache allowances separately.
09 / ERRORS & RETRIES

Retry only when delivery is unambiguous.

HTTP errors use a stable Jovethra envelope with a public code and request reference. Internal provider details are never exposed.

StatusCodeAction
400invalid_requestFix the JSON. Do not retry unchanged.
401invalid_api_keyReplace the invalid, expired, or revoked key.
403model_not_allowedUse a model authorized for this key.
413invalid_requestReduce the request below 4 MiB.
415unsupported_media_typeSend application/json.
429rate_limit_exceededWait, then use bounded backoff.
429quota_exceededWait for renewal or change plan.
503service_busyHonor Retry-After, currently 1 second.
503service_unavailableRetry only if no response bytes were delivered.
Error envelope · JSON
{
  "error": {
    "message": "The API request could not be completed.",
    "type": "gateway_error",
    "code": "service_unavailable",
    "request_id": "jov_..."
  }
}
10 / SUPPORT

Support with the right context.

Report an issue from the customer portal. Include a request reference, never an API key, payment data, or a complete prompt.

SUPPORT CHANNELcontact@jovethra.xyz

For general questions and persistent incidents.

Contact support