Migrar desde el SDK de OpenAI

Usa esta guía para migrar una integración existente del SDK de OpenAI a Phaseo sin reescribir el resto de la aplicación. Empieza por la URL base y la clave de API, conserva la solicitud tal como está y verifica cada modelo y endpoint antes de trasladar el tráfico de producción.

Qué cambia

Ajuste	Antes	Después
URL base	Predeterminada de OpenAI	`https://api.phaseo.app/v1`
Clave de API	Clave de OpenAI	`PHASEO_API_KEY`
Modelo	Nombre del modelo de OpenAI	Un ID de modelo devuelto por `GET /v1/models`
Código de la solicitud	Llamada existente al SDK	Normalmente no cambia

Crea una clave de API de Phaseo

Crea una clave en Claves de Gateway y añádela a cada entorno donde se ejecute tu aplicación.

PHASEO_API_KEY=phaseo_v1_sk_...

Conecta el cliente con Phaseo

Conserva el SDK de OpenAI y, al principio, cambia solo las credenciales y la URL base.

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.PHASEO_API_KEY,
  baseURL: "https://api.phaseo.app/v1",
});

const response = await client.chat.completions.create({
  model: "openai/gpt-4.1-mini",
  messages: [{ role: "user", content: "Reply with: migration ready" }],
});

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["PHASEO_API_KEY"],
    base_url="https://api.phaseo.app/v1",
)

response = client.chat.completions.create(
    model="openai/gpt-4.1-mini",
    messages=[{"role": "user", "content": "Reply with: migration ready"}],
)

curl https://api.phaseo.app/v1/chat/completions \
  -H "Authorization: Bearer $PHASEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4.1-mini",
    "messages": [{"role": "user", "content": "Reply with: migration ready"}]
  }'

Verifica los ID de modelo y la cobertura de endpoints

En lugar de dar por hecho que todos los alias anteriores siguen funcionando, consulta la lista de modelos disponibles en Phaseo.

curl https://api.phaseo.app/v1/models \
  -H "Authorization: Bearer $PHASEO_API_KEY"

Comprueba todos los flujos de producción que uses, incluidos streaming, herramientas, salidas estructuradas, imágenes, audio, archivos o lotes. Consulta la Referencia de la API para confirmar el endpoint correspondiente.

Prueba y despliega

Ejecuta prompts representativos con las configuraciones antigua y nueva. Compara el formato de salida, la latencia, el uso de tokens, los errores y el coste antes de trasladar el tráfico gradualmente.

Lista de comprobación de la migración

La clave de Phaseo está configurada en desarrollo, staging y producción.
La URL base del cliente es https://api.phaseo.app/v1.
Todos los ID de modelos de producción aparecen en GET /v1/models.
Las solicitudes con y sin streaming funcionan en staging.
Las llamadas a herramientas y las salidas estructuradas funcionan si la aplicación las usa.
La reversión sigue limitándose a cambiar la clave y el endpoint en la configuración.

Próximos pasos

Última modificación el 2 de octubre de 2026

Resumen

Modelos y enrutamiento

Funciones

Integraciones

Espacios de trabajo y acceso

Fiabilidad y operaciones

Plataforma e investigación

Guías de migración

Comunidad

Migrar desde el SDK de OpenAI

Qué cambia

Lista de comprobación de la migración

Próximos pasos

​Qué cambia

​Lista de comprobación de la migración

​Próximos pasos

Qué cambia

Lista de comprobación de la migración

Próximos pasos