Trellis Data Logo
Developers Doc

Agents & Harnesses

Configure OpenCode to use the Agentaus API as its model provider.

OpenCode Integration Example

1

Set up OpenCode following the official docs.

2

Add the following to your opencode.json:

json
{
  "model": "trellisdata/agentaus.v1",
  "provider": {
    "trellisdata": {
      "name": "Trellis Data",
      "options": {
        "baseURL": "https://<host>/api/v1",
        "apiKey": "<AGENTAUS_API_KEY>"
      },
      "models": {
        "agentaus.v1": {
          "name": "Agentaus V1"
        }
      }
    }
  }
}

The model value is "trellisdata/agentaus.v1" — trellisdata matches the key under provider, and agentaus.v1 must be listed in its models dictionary. agentaus.v1 is the model id returned by List models; name is the label OpenCode shows in its model picker.

The provider's name is how it appears in OpenCode.

Replace <AGENTAUS_API_KEY> with your API key. To keep the key out of the file, use '{env:AGENTAUS_API_KEY}' to read it from an environment variable, or a file reference (e.g. '{file:~/.secrets/agentaus-key}'). If you paste the key in directly, don't commit opencode.json.

3

Run opencode in your terminal to start.

List models

Agents and harnesses that follow the OpenAI convention call this endpoint to find out which models the provider offers. You can also call it yourself to check that your API key works.
GET
/api/v1/models
GET
/api/v1/chat/completions/models

List Models

Requires header Authorization: Bearer <token>. Both paths return the same response. Some clients look for the model list next to the chat endpoint, so use whichever your client expects.
Response fields
object
string
Always "list".
data
array
The models available to you. Currently always one model.
data.id
string
Model identifier, e.g. "agentaus.v1".
data.object
string
Always "model".
data.created
integer
Unix timestamp, in seconds.
data.owned_by
string
Always "trellisdata".
curl https://<host>/api/v1/models \
  -H "Authorization: Bearer $AGENTAUS_API_KEY"
Response
{
  "object": "list",
  "data": [
    {
      "id": "agentaus.v1",
      "object": "model",
      "created": 1781059264,
      "owned_by": "trellisdata"
    }
  ]
}

Errors

Errors from this endpoint are returned as plain text, not JSON:
401Unauthorized
MeaningMissing, invalid, or expired bearer token.
403Forbidden
MeaningYour account is not a member of the requested tenant, or belongs to no tenant.
500Internal Server Error
MeaningUnexpected server error.

Coming Soon

More coming soonWe're actively building out more agent and harness integrations.