Make one OpenAI-compatible /v1 chat request against Token Factory's live endpoint.
Already onboarded and signed in? You're one API key away from your first call.
https://api.tokenfactory.omniva.com/v1
OMNIVA_API_KEY
Omniva/Kimi-K2.6
- Get an API key
First, make sure you have workspace access and you're signed in — see Workspace access (new customers request access).
Once signed in, open API keys and click Generate. The full value is shown once at creation time — copy it now and keep it out of source control.
For rotation and leak-response, see Authentication.
- Set your environment
Export the key under its canonical name. Every snippet below reads from it.
- Install a client
Token Factory's wire shape matches OpenAI's at
https://api.tokenfactory.omniva.com/v1. Use the official OpenAI SDK or any HTTP client. - Make your first call
Send a chat completion against
https://api.tokenfactory.omniva.com/v1.
#Verification
You should see a short answer explaining retrieval-augmented generation, for example:
Retrieval-augmented generation combines a retrieval step over an external knowledge source with a generative model so the output is grounded in cited evidence.
Exact wording varies between runs. If you got something back, the rest of Token Factory is one call away.
#What just happened?
Your OpenAI-compatible client sent a request to Token Factory's /v1/chat/completions endpoint. Read more →
OMNIVA_API_KEY authenticated the request without putting the secret in source code. Read more →
model selected the hosted chat model. Replace it with any available chat model from Models overview.
#Stream tokens (optional)
Pass stream: true when you want tokens to arrive incrementally — typical for chat UIs that render a typing effect. Deeper concerns (reconnects, partial-tool calls, cancellation, plus TypeScript and cURL variants) live in the Streaming guide.
#What next
What's in the catalog and how it's sorted.
Server-sent events, chunks, and cancellation.
Full parameter and response schemas.
#Troubleshooting
401 Unauthorized: confirmOMNIVA_API_KEYis set in the same shell where you run the command.403 Forbidden: your key is valid but doesn't have access to the requested resource. Check workspace membership.400or404for the model: choose a model from Models overview and paste its exact ID.429 Too Many Requests: check your quota and retry after the rate-limit window.- No output from streaming cURL: include
-Nso cURL does not buffer the stream.
Hitting an SSL trust-chain error? See Errors → SSL. Model returning 503 instead of generating? See the fallback pattern.