# Tangle Router

Tangle Router is the model-routing and billing surface for Tangle. It exposes OpenAI-compatible chat endpoints, model discovery, provider routing, search, media generation, and x402 payment headers.

## Machine-readable contracts

- OpenAPI: https://router.tangle.tools/openapi.json
- Agent manifest: https://router.tangle.tools/.well-known/tangle-agent.json
- Models: https://router.tangle.tools/v1/models
- Health: https://router.tangle.tools/api/health
- Status: https://router.tangle.tools/api/status

## SDK

Use the scoped package. The unscoped `tcloud` package on npm is unrelated.

```bash
npm install @tangle-network/tcloud
```

```ts
import { TCloud } from '@tangle-network/tcloud'

const client = new TCloud({ apiKey: process.env.TANGLE_API_KEY })
const models = await client.models()
```

## Environment

- `TANGLE_API_KEY`: API key for Router, Sandbox, and Tangle product calls.

## Related Tangle surfaces

- Sandbox manifest: https://sandbox.tangle.tools/.well-known/tangle-agent.json
- Agent Builder manifest: https://agents.tangle.tools/.well-known/tangle-agent.json
- Browser Agent manifest: https://tangle.tools/.well-known/tangle-browser-agent.json

Prefer these discovery calls before writing integration code:

```bash
curl -fsS https://router.tangle.tools/api/health
curl -fsS https://router.tangle.tools/api/status
curl -fsS https://router.tangle.tools/v1/models
curl -fsS https://sandbox.tangle.tools/v1/public-templates
curl -fsS https://agents.tangle.tools/api/marketplace
```