---
title: "Preguntas frecuentes sobre el acceso a la API"
description: "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."
headingIds: {"Dirección, claves y modelos":"section-1","Solicitudes y clientes":"section-2","Estado del servicio y ayuda":"section-3"}
---

<aside className="docs-publication" data-pagefind-ignore>

Documentación mantenida por [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Fuentes y correcciones](https://1zheai.com/en/editorial/).

¿Encontraste un error? [Contacta con soporte](mailto:support@1zheai.com) indicando la dirección de la página y una descripción. No envíes claves de API ni credenciales de cuenta.

</aside>
## Dirección, claves y modelos

<AccordionGroup>
<Accordion title="¿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 ](/es/docs/base-url/).

</Accordion>
<Accordion title="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.

</Accordion>
<Accordion title="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 ](/es/docs/api-models/).

</Accordion>
<Accordion title="¿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 ](/es/docs/migration/).

</Accordion>
</AccordionGroup>

## Solicitudes y clientes

<AccordionGroup>
<Accordion title="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.

</Accordion>
<Accordion title="¿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.

</Accordion>
<Accordion title="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 ](/es/docs/streaming/) para más detalles.

</Accordion>
<Accordion title="¿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 ](/es/docs/retries/).

</Accordion>
<Accordion title="¿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.

</Accordion>
</AccordionGroup>

## Estado del servicio y ayuda

<AccordionGroup>
<Accordion title="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.

</Accordion>
<Accordion title="¿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 ](/es/docs/troubleshooting/).

</Accordion>
</AccordionGroup>