Usa la CLI para trabajar en el terminal con archivos locales seleccionados y acciones locales explícitas. Usa la API cuando necesites el contrato publicado de solicitud y respuesta en tu aplicación. Los clientes comparten controles de cuenta, pero sus sintaxis no son intercambiables.
La documentación es la referencia de instalación, ámbitos de autenticación y campos actuales de los endpoints. Empieza por ella en lugar de adaptar un ejemplo de otro proveedor cambiando solo la URL.
Antes de empezar
- La documentación actual de la CLI o API y un alias de modelo publicado por el servidor.
- Una credencial con ámbitos adecuados guardada en el entorno o gestor de secretos, nunca en el repositorio.
- Un prompt corto sin datos sensibles y un presupuesto pequeño de salida para la primera solicitud real.
Sigue los pasos
- Consulta la instalación y autenticación actuales del cliente. Mantén la credencial en el servidor y fuera de bundles del navegador y registros del terminal.
- Para la API, copia el ejemplo documentado de chat completions y revisa modelo, mensajes y límite de salida. Usa el alias y las capacidades actuales del catálogo.
- Para la CLI, selecciona modo y archivos explícitamente. Las operaciones de archivo requieren la aceptación documentada; no implican subir el repositorio de forma recursiva.
- Examina respuesta, uso e identificador antes de añadir reintentos o concurrencia. Un timeout no demuestra que no se haya realizado trabajo.
- Automatiza tras probar fallos, cancelación cuando exista y límites de presupuesto. Sigue la idempotencia documentada en lugar de repetir una creación sin comprobar el resultado.
Usa un prompt preciso
Adáptalo a tus pruebas
Ayuda a revisar esta integración antes de su primera solicitud. Comprueba que las credenciales quedan fuera del código y del navegador, que el alias procede del catálogo actual y que el presupuesto de salida es explícito. Identifica cómo trata el cliente timeouts, límites y resultados desconocidos sin duplicar trabajo.
Verifica tu trabajo
- La solicitud real usa el endpoint documentado y campos compatibles; copiar un ejemplo no demuestra integración.
- Los secretos no aparecen en código, solicitudes del navegador, logs ni informes exportados.
- Uso y errores se tratan según respuestas reales, y la concurrencia respeta los límites efectivos de la cuenta.
Lleva tus evidencias a una conversación y trabaja en la siguiente pregunta.
Abrir chat