Preguntas frecuentes sobre el acceso a la API
Encuentre rápidamente respuestas a preguntas frecuentes sobre la URL base, los modelos, el streaming, los clientes, los tiempos de espera y la monitorización de disponibilidad.
Dirección, claves y modelos
Sección titulada “Dirección, claves y modelos”¿La Base URL debe llevar /v1 o no?
Para el SDK de OpenAI, complete https://1zheai.com/v1; para el SDK de Anthropic y Claude Code, complete https://1zheai.com. Al usar curl directamente, complete la ruta completa de la solicitud. Algunas herramientas de escritorio completan automáticamente la ruta; consulte la tabla de correspondencia de direcciones .
Si tengo suscripción a ChatGPT o Claude, ¿aún necesito la clave de este sitio?
Sí. El acceso a este sitio utiliza una clave API creada en la consola de este sitio; la suscripción de los clientes de consumo y las credenciales de la API de este sitio son formas de acceso distintas. La herramienta también debe admitir proveedores o direcciones API personalizados.
El modelo aparece en la lista, ¿por qué la llamada sigue fallando?
La lista muestra los modelos visibles para la clave actual, no la tasa de éxito de inferencia en tiempo real. También debe verificar el protocolo de la interfaz, los parámetros opcionales y el estado del proveedor upstream; consulte la interfaz de consulta de modelos .
¿Se pueden copiar directamente los nombres de modelos de otras plataformas?
Copie el ID completo desde la lista de modelos de este sitio. Diferentes proveedores pueden usar prefijos, alias y versiones por fecha distintos; no cambie los nombres por conjetura. Los pasos de migración se encuentran en la guía de migración .
Solicitudes y clientes
Sección titulada “Solicitudes y clientes”La llamada tiene éxito, pero no obtengo texto
Primero confirme el protocolo de respuesta. Chat Completions lee choices[].message.content, Messages recorre los bloques de texto de content, Responses recorre output o usa el output_text del SDK. Las respuestas de llamadas a herramientas también pueden no contener texto normal.
¿Por qué no se recuerda el contenido de la ronda anterior?
Las conversaciones de múltiples turnos requieren que el cliente envíe el historial. Reutilizar la misma clave no crea automáticamente una sesión en el servidor. Las extensiones relacionadas con sesiones de Responses deben confirmarse por separado; no dependa de ellas por defecto.
Si ya se recibió texto en streaming, ¿se considera un éxito?
También es necesario confirmar el evento de finalización o el estado final. Pueden ocurrir errores a mitad de camino, interrupciones del flujo y truncamiento de la salida después de haber recibido ya parte del texto. Consulte salida en streaming para más detalles.
¿Se puede reintentar indefinidamente tras un tiempo de espera agotado?
No se recomienda. El tiempo de espera puede agotarse después de que la solicitud ya haya sido procesada. Primero consulte los registros de llamadas y luego ejecute reintentos con un número limitado de intentos, retroceso y tiempo total de espera, evitando que tanto el SDK como la aplicación realicen cada uno una ronda de reintentos. Consulte tiempos de espera y reintentos .
¿Se puede poner la clave API directamente en el frontend de la página web?
No compile la clave en scripts de navegador ni en repositorios públicos. Mantenga las credenciales en su servidor y llame a la interfaz desde allí; el navegador solo debe conectarse a su propio backend. Las variables de entorno en el código de demostración están destinadas al servidor o a la terminal local.
Estado del servicio y ayuda
Sección titulada “Estado del servicio y ayuda”El monitoreo de tiempo de ejecución es normal, ¿por qué el modelo sigue dando error?
La monitorización comprueba la accesibilidad HTTP del sitio oficial, la consola y la entrada de la API; no representa la tasa de éxito de inferencia de cada modelo. La monitorización y la aplicación se despliegan en el mismo servidor; en caso de fallo del equipo completo, la monitorización también se detendrá; los datos históricos se acumulan a partir de la activación.
¿Qué debo preparar al contactar con soporte?
Proporcione la hora y la zona horaria del incidente, la versión del cliente, el ID del modelo, la ruta completa de la solicitud, el código de estado HTTP, el ID de solicitud y la información de error despersonalizada. Elimine las claves, las cabeceras de autenticación y el contenido de conversaciones privadas; puede organizar la información según la plantilla de resolución de problemas .