Migrar desde otros servicios a 1折AI

Documentación mantenida por 1ZheAI. Fuentes y correcciones.

¿Encontraste un error? Contacta con soporte indicando la dirección de la página y una descripción. No envíes claves de API ni credenciales de cuenta.

Guarda la configuración original antes de migrar. Primero verifica en un terminal o entorno de desarrollo separado; confirma que funciona correctamente antes de cambiar tus herramientas habituales o servicios en producción.

Verifica estas cuatro configuraciones juntas

Configuración	Forma en 1折AI	Omisiones comunes
OpenAI Base URL	https://1zheai.com/v1	Escribir de más /chat/completions, u omitir /v1
Anthropic Base URL	https://1zheai.com	El SDK agrega una vez más /v1
Clave API	Clave creada en la consola de este sitio	Reutilizar la clave del proveedor anterior
ID del modelo	ID completo devuelto por /v1/models de este sitio	Reutilizar nombres con prefijo vendor/ o sufijo personalizado

Las solicitudes HTTP originales requieren la ruta completa del endpoint; los SDK y las herramientas de escritorio normalmente solo requieren la Base URL. Consulta el tutorial correspondiente a la herramienta.

Verifica en orden

1. Comprobar la lista de modelos

   Realiza una llamada según la interfaz de consulta de modelos. Si falla, primero corrige la dirección, las credenciales o las condiciones de acceso; no ajustes varios parámetros de negocio a la vez.

2. Ejecutar una solicitud de texto mínima

   Elige Chat Completions, Responses o Messages. Mantén el protocolo que requiere tu cliente original y elimina primero los parámetros opcionales.

3. Restaurar las funciones de negocio paso a paso

   Verifica secuencialmente el streaming, el historial de múltiples turnos, las llamadas a herramientas y las demás capacidades necesarias. Agrega una sola función cada vez y conserva las respuestas de error para comparar. Que el texto normal funcione no significa que los archivos, la búsqueda y los modelos auxiliares de un Agent sean todos compatibles.

4. Verificar el origen real de la solicitud

   Confirma la hora de la solicitud y el modelo en el registro de llamadas. Reinicia los terminales, IDE o servicios en segundo plano que necesiten recargar la configuración para evitar que sigan usando las variables de entorno antiguas.

Alcance de las variables de entorno

export en el terminal solo afecta al shell actual y a los procesos hijos iniciados después. Las aplicaciones de escritorio, los contenedores, las tareas programadas y los servicios del sistema pueden usar otro conjunto de entorno; configura las credenciales donde realmente se ejecute el programa.

Los campos con el mismo nombre en los archivos de configuración también pueden sobrescribir las variables de entorno. Herramientas como Claude Code y Codex tienen sus propios tutoriales; no acumules todas las variables de proveedores en la configuración global del shell.

Vuelve atrás si el cambio falla

Restaura la configuración de proveedor, dirección y modelo guardada anteriormente y reinicia el cliente. Si estás migrando un negocio en producción, verifica primero con una pequeña cantidad de solicitudes y luego amplía el alcance; conserva el método de conmutación de configuración a nivel de aplicación para facilitar la recuperación del servicio.

Si no estás seguro de si una función está habilitada, consulta el catálogo de modelos o contacta con soporte. No asumas que este sitio ofrece los mismos servicios que otras plataformas solo porque esas ofrezcan Embeddings, Batch o algún modelo de imagen propietario.