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

> ## Agent Instructions
> Phaseo Gateway base URL: https://api.phaseo.app/v1. Send `Authorization: Bearer $PHASEO_API_KEY` with every request.
> Model IDs look like `provider/model`, for example `openai/gpt-6-astra`. Do not guess IDs: list them with `GET /v1/models` or check https://phaseo.app/models. `phaseo/free` routes to an available free model and needs no wallet balance.
> For new text integrations prefer `POST /v1/responses`. `POST /v1/chat/completions` (OpenAI format) and `POST /v1/messages` (Anthropic format) suit existing code.
> The full API contract is https://phaseo.app/docs/openapi/v1/openapi.yaml. Official SDKs: `@phaseo/sdk` (TypeScript) and `phaseo` (Python), plus Go, C#, PHP, Ruby and Rust.
> Search these docs over MCP at https://phaseo.app/docs/mcp, and install Phaseo skills with `npx skills add https://phaseo.app/docs`. If a page is wrong or out of date, report it with the MCP `submit_feedback` tool.
> Manage Phaseo accounts with the `phaseo` CLI (`npm install -g @phaseo/cli`, then `phaseo login` or `phaseo login --device-code`), the `/v1` Management API or the MCP server at `https://mcp.phaseo.app/mcp?access=manage`. Do not send users to the dashboard for account tasks. A person is still needed for sign-up, approving a sign-in, paying the first top-up on the checkout link that `phaseo credits add` returns when no card is saved, confirming each saved-card top-up from the emailed link, and account security (password, MFA, passkeys). Create API keys with `phaseo keys create --name <name> --json`; never guess one. Credit top-ups need `phaseo login --scopes billing:write` first. Task map: https://phaseo.app/docs/v1/developers/manage-from-an-agent.md.

# Integrations

> Connect Phaseo to popular SDKs, frameworks, agents, and observability tools.

Most integrations work by pointing an OpenAI-compatible or Anthropic-compatible client at Phaseo and using a Phaseo API key. Start with the guide for the tool you already use.

## Base URLs

| Client style | Base URL |
| - | - |
| OpenAI-compatible clients | `https://api.phaseo.app/v1` |
| Anthropic-compatible clients | `https://api.phaseo.app` |

Use model ids from the [Models endpoint](https://phaseo.app/docs/v1/api-reference/endpoint/models.md). For new OpenAI-style apps, prefer [Responses](https://phaseo.app/docs/v1/api-reference/endpoint/responses.md). For older libraries, [Chat Completions](https://phaseo.app/docs/v1/api-reference/endpoint/chat-completions.md) is usually the safest path.

## SDKs and direct clients

> [card] [OpenAI SDK](https://phaseo.app/docs/v1/guides/integrations/openai-sdk.md)
>
> Use official OpenAI clients with the Phaseo base URL.

> [card] [Anthropic SDK](https://phaseo.app/docs/v1/guides/integrations/anthropic-sdk.md)
>
> Use Anthropic-compatible clients through `/v1/messages`.

> [card] [AI SDK](https://phaseo.app/docs/v1/guides/integrations/ai-sdk.md)
>
> Use the first-party Phaseo provider for the Vercel AI SDK.

> [card] [LiteLLM](https://phaseo.app/docs/v1/guides/integrations/litellm.md)
>
> Route LiteLLM traffic through Phaseo or expose Phaseo behind a LiteLLM proxy.

## App and agent frameworks

> [card] [LangChain](https://phaseo.app/docs/v1/guides/integrations/langchain.md)
>
> Use LangChain Python with `ChatOpenAI` and the Phaseo base URL.

> [card] [LlamaIndex](https://phaseo.app/docs/v1/guides/integrations/llamaindex.md)
>
> Use Phaseo for RAG and indexing workflows.

> [card] [PydanticAI](https://phaseo.app/docs/v1/guides/integrations/pydanticai.md)
>
> Build typed Python agents against Phaseo.

> [card] [Mastra](https://phaseo.app/docs/v1/guides/integrations/mastra.md)
>
> Use Phaseo inside Mastra agents and workflows.

> [card] [TanStack AI](https://phaseo.app/docs/v1/guides/integrations/tanstack-ai.md)
>
> Connect TanStack AI's OpenAI-compatible adapter.

> [card] [Effect AI SDK](https://phaseo.app/docs/v1/guides/integrations/effect-ai.md)
>
> Use Phaseo from Effect TypeScript applications.

## Platforms and operations

> [card] [LiveKit](https://phaseo.app/docs/v1/guides/integrations/livekit.md)
>
> Use Phaseo models in LiveKit Agents and voice applications.

> [card] [Replit](https://phaseo.app/docs/v1/guides/integrations/replit.md)
>
> Build and deploy Replit applications with Phaseo.

> [card] [Workflow Automation](https://phaseo.app/docs/v1/guides/integrations/automation.md)
>
> Call Phaseo from Zapier, n8n, Pipedream, and similar platforms.

> [card] [Infisical](https://phaseo.app/docs/v1/guides/integrations/infisical.md)
>
> Prepare scoped, zero-downtime Phaseo API key rotation.

## Coding agents and observability

> [card] [Coding Agents](https://phaseo.app/docs/v1/guides/integrations/coding-assistants.md)
>
> Use the Phaseo CLI or manual provider settings with Cursor, VS Code, Continue, Aider, Cline, Roo Code, Kilo Code, and related tools.

> [card] [Claude Code](https://phaseo.app/docs/v1/guides/integrations/claude-code.md)
>
> Route Claude-compatible coding workflows through Phaseo.

> [card] [Codex](https://phaseo.app/docs/v1/guides/integrations/codex.md)
>
> Use Phaseo as a Codex provider.

> [card] [DeepSeek Harness](https://phaseo.app/docs/v1/guides/integrations/deepseek-harness.md)
>
> Add Phaseo as a custom OpenAI-compatible provider in DeepSeek Harness.

> [card] [OpenCode](https://phaseo.app/docs/v1/guides/integrations/opencode.md)
>
> Configure OpenCode with a custom Phaseo provider.

> [card] [Pi](https://phaseo.app/docs/v1/guides/integrations/pi.md)
>
> Install Pi with the complete Phaseo model catalog.

> [card] [oh-my-pi](https://phaseo.app/docs/v1/guides/integrations/oh-my-pi.md)
>
> Run oh-my-pi through Phaseo with an isolated provider catalog.

> [card] [MiniMax Code](https://phaseo.app/docs/v1/guides/integrations/minimax-code.md)
>
> Run MiniMax Code through Phaseo with temporary provider configuration.

> [card] [Muse Code](https://phaseo.app/docs/v1/guides/integrations/muse-code.md)
>
> Run Muse Code through Phaseo with temporary provider configuration.

> [card] [Prime Agent](https://phaseo.app/docs/v1/guides/integrations/prime-agent.md)
>
> Configure Prime Agent for long-running work through Phaseo.

> [card] [Observability](https://phaseo.app/docs/v1/guides/integrations/observability.md)
>
> Send Phaseo traffic through Langfuse, LangSmith, OpenTelemetry, or similar tooling.

> [card] [Docs MCP](https://phaseo.app/docs/v1/guides/integrations/docs-mcp.md)
>
> Add live Phaseo documentation to coding agents.

## Useful defaults

* Set `PHASEO_API_KEY` once and map it to the environment variable expected by the client.
* Keep the model id unchanged, for example `openai/gpt-5-nano`.
* Use `https://api.phaseo.app/v1` for OpenAI-compatible libraries unless the tool explicitly asks for the root host.
* Use `https://api.phaseo.app` for Anthropic-compatible SDKs and tools that append `/v1/messages`.
* Test streaming and tool calling in staging before moving agent traffic over.


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