Chat Completion

Runs an OpenAI-compatible message list against a selected chat model.

POST /domains/models/capabilities/chat-complete/execute

Call List All Models first. The exact returned models[].id becomes this endpoint’s model value.

Request

import { AgentRouterClient } from "@agentrouter/agentrouter";
const client = new AgentRouterClient({
  apiKey: process.env.AGENTIC_API_KEY,
});
const result = await client.models.chat.complete.execute(
  {
    model: "openai/gpt-4.1-nano",
    messages: [
      {
        role: "system",
        content: "You write concise landing-page copy.",
      },
      {
        role: "user",
        content: "Write a one-line hero for an AI course builder.",
      },
    ],
    max_tokens: 120,
    temperature: 0.2,
  },
  { allowFallback: true },
);
console.log(result.completionText);
console.log(result.creditsCharged);

Capability input

Check the selected catalog entry’s supported_parameters before sending optional model fields.

Routing controls

Routing controls are the SDK method’s second argument. With raw HTTP they are fields in the same JSON body.

Response

{
  "success": true,
  "completionText": "Build your course in minutes, not months.",
  "model": "openai/gpt-4.1-nano",
  "provider": "openrouter",
  "routeKey": "models.chat.complete.openrouter.mpp",
  "fallbackUsed": false,
  "finishReason": "stop",
  "usage": {
    "promptTokens": 31,
    "completionTokens": 10,
    "totalTokens": 41
  },
  "creditsCharged": 1
}

The token counts and charge above are illustrative. Always use the values returned by the live response.

Response fields

Common scenarios

The endpoint always performs model inference. Your prompt and messages define the job.

Pricing

Catalog rates are estimates per one million input and output tokens. The paid MPP route obtains a request-specific quote. creditsCharged is the final amount; do not calculate the debit from the catalog alone.

Inspect the exact route contract

const context = await client.catalog.routes.context(
  "models.chat.complete.openrouter.mpp",
);
console.log(context.execute?.requiredFields);
console.log(context.execute?.optionalFields);
console.log(context.execute?.fields);

Errors