Skip to main content
Start with an MKA1 API key and your deployment’s API gateway URL. If you need a key, see API keys. You do not need to create an organization or configure resource permissions to use a key your administrator has already provided.

Install a client

For the command line, follow CLI installation and authentication.

Choose your endpoint

The hosted API uses https://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 in input 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.
If you are not acting for an end user, omit X-On-Behalf-Of.

Read the result

A successful response contains an ID and generated output. Look for output_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