Reference

Models

GET /v1/models lists available public chat identities. It is an optional discovery call, not a required step before each message.

Request

request

GET https://api.wicarax.app/v1/models
Authorization: Bearer wcx_sk_...   (or wcx_pk_... from an allowed browser origin)

Response

200 OK

{
  "object": "list",
  "data": [
    {
      "id": "wicarax-zenith",
      "object": "model",
      "created": 0,
      "owned_by": "wicarax"
    }
  ]
}

Field	Notes
`id`	The public model id. This is the value echoed back in a completion
`object`	Always `model`, for OpenAI client compatibility
`created`	Present for shape compatibility. Not a meaningful timestamp
`owned_by`	`wicarax`

The list reflects eligible public chat models. It may contain more than the model currently assigned to your agent.

Choosing a model for a request

Your key identifies an agent. The model saved on that agent determines the effective public model.
A model field in a completion request is required and must match that agent's saved model. Unknown ids return model_not_found; known unavailable ids return model_unavailable; an available but unassigned id returns model_not_assigned.
Model behaviour is not part of the API contract you write against. What you rely on is the answer being grounded in your own material.

Note

The official SDK sends wicarax-zenith by default for existing callers and accepts an explicit public model id. It does not fetch this catalog during chat.

Reading the id you should display

If you show the model that answered, use the completion response. This catalog is useful when you want to display available models.

sdk

// Before the first message.
const { data } = await wicarax.models.list();
console.log(data[0].id);

// Or after any answer, echoed by the API.
const result = await wicarax.chat.send({ message });
console.log(result.model);

curl

curl https://api.wicarax.app/v1/models \
  -H "Authorization: Bearer $WICARAX_SECRET_KEY"

See Chat Completions for the completion response, or Official SDK for the typed client.

Tip

The API echoes the effective public model id on each completion, so clients do not need to fetch the list before every request.

Disclaimer

The public contract exposes Wicarax Zenith and its id. Integrations should use that public identity without depending on internal implementation details.