Primeros pasos con la API de GetAPI.ONE: clave API y primera solicitud
Una ruta completa desde la creación de la cuenta y la selección del modelo hasta una clave API con alcance, la configuración del cliente y una primera conexión funcional.
Empieza aquí
Para empezar con GetAPI.ONE, crea una cuenta, elige un modelo y un endpoint compatible y después crea una clave API. ¿Ya tienes una clave? Ve directamente al ejemplo de Python o Node.js de abajo. Consulta los precios actuales antes de enviar solicitudes.
Antes de empezar
- Use el dominio oficial https://www.getapi.one y un buzón accesible para la verificación.
- Decida si conectará Codex CLI, un destino Codex compatible a través de CCSwitch o su propio cliente API.
- Prepare un gestor privado de contraseñas o almacén de variables de entorno. Nunca pegue una clave real en incidencias públicas, capturas o repositorios.
1. Crear y abrir su cuenta
- Abra el registro, elija un usuario, establezca una contraseña de 8–20 caracteres e introduzca su correo.
- Solicite el código por correo, introdúzcalo, revise y acepte el Acuerdo de usuario y la Política de privacidad enlazados y cree la cuenta.
- Inicie sesión con usuario o correo y contraseña. Un inicio correcto abre la página de resumen.
2. Comprobar saldo, endpoint y modelo
- Confirme que la cuenta tiene saldo utilizable o un paquete aplicable antes de enviar una solicitud facturable.
- Abra el catálogo de modelos. Elija uno que incluya explícitamente el endpoint utilizado por su cliente; no deduzca el protocolo a partir del nombre.
- Abra los precios en vivo inmediatamente antes de su uso. Verifique el modelo, grupo, modo de precio y unidad de facturación actuales porque la disponibilidad y los precios pueden cambiar.
3. Crear una clave API limitada
- Abra Claves API y seleccione Crear clave API. Asígnele un nombre que identifique su cliente o proyecto.
- Elija el grupo necesario, una caducidad concreta y una cuota adecuada. Amplíe las restricciones avanzadas solo cuando comprenda el acceso requerido.
- Guarde la clave y cópiela de la lista a su almacén privado. GetAPI.ONE conserva una entrada administrable, por lo que podrá copiarla de nuevo más adelante.
4. Conectar un cliente
Use solo la ruta adecuada para su cliente. Los proveedores personalizados de Codex usan Responses como API de transporte y la URL base ONE https://www.getapi.one/v1. Un programa API directo debe usar el endpoint declarado concreto sin añadir rutas a ciegas.
5. Verificar y continuar
- El éxito requiere una respuesta válida en el cliente elegido y un registro de solicitud en la consola GetAPI.ONE. Una comprobación local de sintaxis no basta para acreditar una llamada real.
- Para 401, copie de nuevo la clave ONE y confirme que está habilitada y usa la dirección ONE. Para 404, verifique el endpoint exacto o la base /v1 esperada por el cliente.
- Si no se encuentra el modelo, elija uno accesible para el grupo de la clave y compatible con el endpoint. Ante errores de cuota, frecuencia, red o proveedor, conserve hora e identificador de solicitud antes de diagnosticar.