> ## 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.

# أدلة الترحيل

> أدلة للانتقال بين المنصات أو اعتماد إصدار محدد من نموذج.

اختر الدليل المناسب لما تغيّره: المنصة التي يستدعيها تطبيقك (أدناه)، أو النموذج الذي يستخدمه ([ترحيل النماذج](https://phaseo.app/docs/ar/v1/model-migrations.md)). إذا كنت تغيّر الاثنين، فانقل المنصة أولًا وأبقِ النموذج كما هو حتى يتم التحقق من المسار الجديد.

للحصول على قائمة تحقق مخصصة، استخدم [مساعد الترحيل](https://phaseo.app/migrate).

## ترحيل المنصات

يتبع كل دليل منصة الترتيب نفسه: بدّل عنوان URL الأساسي والمفتاح، وطابق معرّفات النماذج، وطابق ميزات المنصة، ثم اختبر وانشر مع إبقاء التراجع مجرد تغيير لعنوان URL الأساسي والمفتاح.

| ما تستدعيه | مؤشرات في الشيفرة | الدليل |
| - | - | - |
| OpenAI مباشرة | `api.openai.com` و`OPENAI_API_KEY` و`AzureOpenAI` | [OpenAI SDK](https://phaseo.app/docs/ar/v1/migration-guides/from-openai.md) |
| Anthropic مباشرة | `api.anthropic.com` و`ANTHROPIC_API_KEY` و`@anthropic-ai/sdk` | [Anthropic SDK](https://phaseo.app/docs/ar/v1/migration-guides/from-anthropic.md) |
| OpenRouter | `openrouter.ai` و`OPENROUTER_API_KEY` ومفاتيح `sk-or-v1` | [OpenRouter](https://phaseo.app/docs/ar/v1/migration-guides/from-openrouter.md) |
| Vercel AI Gateway | `ai-gateway.vercel.sh` و`@ai-sdk/gateway` ونماذج بسلاسل نصية مجردة في استدعاءات AI SDK | [Vercel AI Gateway](https://phaseo.app/docs/ar/v1/migration-guides/from-vercel.md) |
| LLM Gateway | `api.llmgateway.io` و`LLM_GATEWAY_API_KEY` | [LLM Gateway](https://phaseo.app/docs/ar/v1/migration-guides/from-llmgateway.md) |
| وكيل LiteLLM | `config.yaml` يحتوي على `model_list`، ومتغيرات `LITELLM_*`، والمنفذ 4000 | [LiteLLM](https://phaseo.app/docs/ar/v1/migration-guides/from-litellm.md) |
| Cloudflare AI Gateway | `gateway.ai.cloudflare.com` وترويسات `cf-aig-*` | [Cloudflare AI Gateway](https://phaseo.app/docs/ar/v1/migration-guides/from-cloudflare.md) |
| Helicone | `*.helicone.ai` و`Helicone-Auth` | [Helicone](https://phaseo.app/docs/ar/v1/migration-guides/from-helicone.md) |

لتخطيط النشر والتحقق منه، استخدم [قائمة التحقق من ميزات الترحيل](https://phaseo.app/docs/ar/v1/migration-guides/feature-parity-matrix.md).

## الترحيل باستخدام وكيل برمجة

اطلب من وكيل برمجة تخطيط الترحيل وتنفيذه معك.

Migrate this project's AI requests to Phaseo Gateway.

&#x20; 1\. Install the Phaseo skills: npx skills add [https://phaseo.app/docs](https://phaseo.app/docs)
&#x20;  Use phaseo-migration, which has a guide for each source platform (and openrouter-to-phaseo-migration for a detailed OpenRouter move).
&#x20; 2\. Find every place the project calls its current provider or gateway (OpenAI, Anthropic, OpenRouter, Vercel AI Gateway, LiteLLM or another), including environment variables, SDK clients, base URLs and model IDs.
&#x20; 3\. Read the matching guide at [https://phaseo.app/docs/ar/v1/migration-guides](https://phaseo.app/docs/ar/v1/migration-guides.md) and map each call to its Phaseo equivalent at [https://api.phaseo.app/v1](https://api.phaseo.app/v1) with a server-side PHASEO\_API\_KEY.
&#x20; 4\. Check every model ID against data\[].id from GET /v1/models?format=openai. Do not assume IDs carry over unchanged.
&#x20; 5\. List the changes and a rollback plan before editing. After editing, verify one normal request and one streaming request if the project streams.
&#x20; 6\. Never print or commit API keys, and do not switch production traffic without my approval.

## ترحيل النماذج

استخدم [دليل ترحيل النموذج](https://phaseo.app/docs/ar/v1/model-migrations.md) عندما يبقى التكامل كما هو ويتغير النموذج. يغطي كل دليل تغييرات معاملات الطلب، والتحولات في سلوك المطالبات والاستدلال، واختلافات المخرجات المنظّمة واستدعاء الأدوات، وكيفية النشر مع نموذج احتياطي.

في أي من نوعي الترحيل، تحقّق من معاملات الطلب وسلوك نقطة النهاية قبل مقارنة جودة المخرجات، وشغّل تقييمات شبيهة بالإنتاج قبل نقل الحركة الفعلية.


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