Install a client
Choose your endpoint
The hosted API useshttps://apigw.mka1.com. For a private deployment, use the gateway URL supplied by your administrator. See SDKs for each client’s server URL option. The model auto must resolve to an active model in your organization; see Models.
Send your first request
Pass a string ininput for a single-turn request.
The response includes generated text in output_text.
If a guardrail blocks the request, output_text is absent and the output carries a refusal instead; see Guardrails.
X-On-Behalf-Of.
Read the result
A successful response contains an ID and generated output. Look foroutput_text in the wire response (outputText in the TypeScript SDK). A guardrail refusal is a different output item, so do not assume every successful HTTP request contains text.
Next steps
- Text generation: instructions, messages, and generation settings.
- Streaming: display text as it arrives.
- Create and run agents: save reusable model and tool configurations.