> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stigg.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Together AI

> Wrap Together AI's OpenAI-compatible API to meter and gate calls with Stigg.

Together AI hosts a large catalog of open-source models. Its API follows OpenAI's format, so you wrap it with the `OpenAI` client and the SDK meters it with the OpenAI recipe.

## Set up

Point the `OpenAI` client's `baseURL` at Together AI and wrap it:

```typescript theme={null}
import OpenAI from 'openai';

const together = stigg.wrap(
  new OpenAI({ baseURL: 'https://api.together.ai/v1', apiKey: process.env.TOGETHER_API_KEY }),
);

const response = await together.chat.completions.create({
  model,
  messages,
  stiggContext: { customerId: 'customer-acme', entitlement: { currencyId: 'credits' } },
});
```

## What is reported

Together AI returns a `usage` object in OpenAI's format with the number of tokens each call consumed. The calls go through the `OpenAI` client, so they are reported under OpenAI event names. The wrapper reads the counts and reports them to Stigg as the metrics below.

| Method | Event name |
| - | - |
| `chat.completions.create` | `openai.chat.completions.create` |

**Chat Completions**

| Metric | What it counts |
| - | - |
| `prompt_tokens` | Input tokens, **including** cached tokens |
| `completion_tokens` | Output tokens |
| `cached_tokens` | Input tokens served from the cache, when the vendor reports them |
| `total_tokens` | All input and output tokens, as reported by the vendor |

`total_tokens` includes the other token counts, so price the total or the parts, never both. To tell Together AI apart from other vendors on the same event name, add a dimension such as `provider` to the `stiggContext`.

Every usage field the provider returns is also included, with a `raw.` prefix. See [How usage is reported](/documentation/ai-agents/usage-metering#how-usage-is-reported).

For details on Together AI's API, see Together AI's [OpenAI compatibility docs](https://docs.together.ai/docs/inference/openai-compatibility).


## Related topics

- [Usage metering](/documentation/ai-agents/usage-metering.md)
- [Bring your own vendor](/documentation/ai-agents/providers/custom.md)
- [AI Terminal](/api-and-sdks/ai-terminal.md)
- [TypeSafe](/documentation/ai-agents/providers/typesafe.md)
- [Agent Skills](/api-and-sdks/agent-skills.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.