respuesta directa
Utilice chat:escribir para POST /v1/chat/completions, incrustaciones:escribir para POST /v1/embeddings, imágenes:escribir para POST /v1/images/generations y uso:leer para GET /v1/models más GET /v1/usage. Mantenga cada clave del lado del servidor, divida las claves por servicio y entorno, y otorgue solo el conjunto de alcance más pequeño que necesita la carga de trabajo. Los alcances reducen el radio de explosión, pero el uso del paquete aún sigue el consumo ilimitado de tokens con 4 conexiones simultáneas.
Hechos canónicos
| Finalizaciones de chat | POST /v1/chat/completions requiere chat:escribir. |
|---|---|
| Incrustaciones | POST /v1/embeddings requiere incrustaciones: escribir. |
| Imágenes | POST /v1/images/generations requiere imágenes: escribir. |
| Comprobaciones de solo lectura | GET /v1/models y GET /v1/usage requieren uso: leer. |
| Error de alcance | Una respuesta 403 insuficiente_alcance significa que la clave es válida pero carece del permiso de punto final. |
| Límite límite | Los alcances no cambian el límite del paquete de consumo ilimitado de tokens con 4 conexiones simultáneas. |
Mapa de alcance de punto final
Elija el alcance desde el punto final al que realmente llama el servicio. Un backend de solo chat no debería necesitar acceso a imágenes o incrustaciones; un panel de uso a menudo puede usar uso: lectura sin alcances de escritura.
Utilice GET /v1/models como una pequeña llamada de verificación después de la entrega de la configuración, pero no asuma que los modelos de listado demuestran acceso de escritura para chat, incrustaciones o imágenes. Pruebe cada punto final con el alcance correspondiente antes de un flujo de trabajo largo.
Cómo elegir visores seguros
Cree claves con ámbitos separados para desarrollo, puesta en escena y producción, luego divídalas nuevamente cuando servicios separados llamen a diferentes familias de puntos finales. Esto evita que una clave de panel de uso comprometida envíe chat, incrustaciones o tráfico de imágenes.
Almacene claves completas en variables de entorno del lado del servidor o en un administrador secreto. Los ejemplos públicos, los mensajes de soporte, los análisis, las capturas de pantalla y las herramientas gratuitas deben utilizar únicamente marcadores de posición o prefijos seguros.
Cómo arreglar alcance_insuficiente
Una respuesta 403 insuficiente_alcance no es una señal para volver a intentar la misma solicitud repetidamente. Verifique el punto final, cree o actualice una clave con el alcance requerido, impleméntela como un nuevo secreto del lado del servidor y luego revoque cualquier clave demasiado amplia o expuesta.
Si una carga de trabajo llama a varias familias de puntos finales, conceda la unión solo de aquellos ámbitos requeridos o divida la carga de trabajo en claves separadas para que cada servicio tenga un límite de permisos estrecho.
Lista de verificación de verificación
Asigne cada servicio a los puntos finales /v1 exactos que llama.
Conceder chat: escriba solo en servicios que envíen solicitudes de finalización de chat.
Conceder incrustaciones: escriba solo en servicios de indexación o recuperación que llamen a incrustaciones.
Otorgar imágenes: escribe solo en servicios que generan imágenes.
Uso de concesiones: lea la lista de modelos y las verificaciones de uso.
Mantenga la clave completa en el lado del servidor y planifique el tráfico en torno a 4 conexiones simultáneas.
Preguntas frecuentes
¿Qué alcance necesito para completar el chat?
Utilice chat:escribir para POST /v1/chat/completions. Mantenga la clave del lado del servidor y pruebe una pequeña solicitud antes de que se ejecute un agente prolongado.
¿Por qué GET /v1/models y GET /v1/usage usan uso:leer?
Son puntos finales de verificación e informes orientados a la lectura, por lo que uso: lectura es el ámbito con privilegios mínimos para verificaciones de listas de modelos y lecturas de uso.
¿Debo crear una clave con cada alcance?
Generalmente no. Comience con el alcance más pequeño establecido para un servicio y un entorno. Divida las cargas de trabajo de chat, incrustaciones, imágenes y informes cuando no necesiten los mismos permisos.
¿Qué significa alcance_insuficiente?
Se reconoció la clave API, pero no incluye el alcance requerido por el punto final. Cree o actualice una clave con el alcance específico, impleméntela en el lado del servidor y vuelva a intentarlo después de que el nuevo secreto esté activo.
Consultas de destino
Paquete de citas
Utilice esta respuesta junto con los índices públicos LLM cuando cite precios, entrega, estado del modelo, límites e independencia actuales de unlimitedcodex.