La API de OpenAI es la interfaz base de muchas aplicaciones de IA, pero los desarrolladores de China continental se enfrentan a problemas de red, pago, cuota y cumplimiento al conectarse directamente. Un API relay de OpenAI enruta el acceso y la facturación a través de una capa de puerta de enlace.
Este artículo explica qué es un relay, cómo elegirlo, cómo migrar y los riesgos habituales.
Nota: OpenAI y ChatGPT son marcas registradas de sus respectivos propietarios. Este artículo es solo para discusión técnica; los precios y las interfaces están sujetos al proveedor oficial o al sitio.
1. Qué es un API relay de OpenAI
tu aplicación → puerta de enlace relay → OpenAI
Tu código sigue usando el SDK de OpenAI. Solo cambias la URL base, la clave y el nombre del modelo. La puerta de enlace se encarga de la autenticación, la facturación, los registros y el enrutamiento.
Como la interfaz sigue siendo compatible con OpenAI, la mayoría de las aplicaciones pueden cambiar sin reescribir código. Por eso también importa la elección del proveedor: la puerta de enlace pasa a formar parte de tu ruta de producción.
2. Qué problemas resuelve
- Acceso inestable desde China continental.
- Métodos de pago poco cómodos.
- Necesidad de facturación y cuotas unificadas para todo el equipo.
- Necesidad de usar Claude, Gemini y DeepSeek junto a OpenAI.
- Necesidad de registros de uso y diagnóstico de errores.
3. Criterios de selección
| Criterio | Qué confirmar |
|---|---|
| Cobertura de modelos | Si la serie GPT está completa y las versiones están al día |
| Compatibilidad | Chat Completions/Responses, streaming, llamada a herramientas |
| Fiabilidad | Tasa de error, P95, límites de peticiones, reintentos |
| Facturación | Cómo se facturan los tokens de entrada, salida y caché |
| Cuotas | Límites por clave, miembro y proyecto |
| Registros | Tokens, latencia y errores de cada llamada |
| Cumplimiento | Conservación de datos, contratos, facturas |
4. Pasos de migración
1. Cambia la URL base
https://ai.zhongshangqihang.com/v1
2. Cambia la clave
Crea una clave en ZSQH AI Gateway y define un límite de gasto.
3. Actualiza el nombre del modelo
Copia el nombre actual del modelo desde el precio de los modelos. Es posible que los nombres antiguos ya estén obsoletos.
4. Despliega de forma gradual
Mueve primero el 5 %–10 % del tráfico, observa durante 3–7 días y después aumenta la proporción.
5. Ejemplo en Python
from openai import OpenAI
client = OpenAI(
api_key="sk-tu-clave",
base_url="https://ai.zhongshangqihang.com/v1",
)
resp = client.chat.completions.create(
model="gpt-5",
messages=[{"role": "user", "content": "Responde solo OK"}],
)
print(resp.choices[0].message.content)
Mantén la clave en el lado del servidor. No la incrustes en una aplicación móvil ni en un paquete de navegador.
6. Lista de pruebas
- Peticiones estándar y en streaming.
- Llamada a herramientas y salida estructurada.
- Contexto largo.
- 5, 10 y 20 peticiones concurrentes.
- Códigos de error 401/404/429/5xx.
- Conciliación de la factura con un conjunto fijo de peticiones.
Ejecuta el mismo conjunto de pruebas contra la vía antigua y la nueva para poder comparar directamente calidad, latencia y coste.
7. Riesgos y errores frecuentes
- Una «relay barata» que solo admite algunos modelos puede dejar de estar disponible en cualquier momento.
- Los nombres de modelo caducados o los parámetros no admitidos pueden provocar fallos en producción.
- Una clave filtrada puede vaciar el saldo rápidamente, así que los límites de gasto son obligatorios.
- Antes del uso empresarial, confirma las condiciones de datos, la facturación y el cumplimiento.
- No pongas todo el tráfico en un único canal; mantén un respaldo.
8. Acceso directo oficial frente a relay
| Dimensión | Acceso directo oficial | Puerta de enlace relay |
|---|---|---|
| Acceso | Afectado por las condiciones de red | Accesible desde China continental |
| Pago | Métodos oficiales | Recarga en el sitio |
| Modelos | Solo OpenAI | Varios modelos |
| Facturación | Consola oficial | Consola unificada |
| Riesgo | Barreras de cuenta y pago | Elegir un proveedor inadecuado |
Preguntas frecuentes
¿Tengo que cambiar el código para usar un relay?
Si usas el SDK de OpenAI, normalmente solo cambian la URL base, la clave y el nombre del modelo.
¿Afecta un relay a la calidad del modelo?
Normalmente no cambia el modelo upstream, pero las versiones del canal, los parámetros y los límites de peticiones pueden variar. Compara con un conjunto de pruebas fijo antes de migrar.
¿Puedo montar uno yo mismo?
Sí. Puertas de enlace de código abierto como New API y One API se pueden autohospedar, pero necesitas servidores, canales upstream y operaciones. Consulta la guía de One API y New API.
Siguientes pasos
Si necesitas acceso estable desde China continental o un único punto de entrada para varios modelos, regístrate en ZSQH AI Gateway y prueba con una clave pequeña. Los modelos y los precios están sujetos al precio de los modelos.
Lecturas relacionadas:
