El acceso a los modelos de OpenAI a través de Google Cloud está actualmente en vista previa privada. Para usarlos en tu proyecto, solicita acceso.
Los modelos de OpenAI están disponibles en la plataforma Gemini a través de Google Cloud. El uso se factura a tu cuenta de Google Cloud. Los modelos se ejecutan dentro del perímetro de seguridad de Google Cloud y tu organización administra el acceso mediante Google Cloud IAM.
En esta guía aprenderás a enviar una solicitud a la API de Respuestas a través de Google Cloud y verás qué funciones están disponibles en Google Cloud y cuáles ofrece OpenAI directamente en su API.
Estos son los modelos disponibles:
| Modelo | ID del modelo |
|---|---|
| GPT-6 Luna | gpt-6-luna |
| GPT-6.1 Sol | gpt-6.1-sol |
| GPT-6.1 Terra | gpt-6.1-terra |
| GPT-6 Astra | gpt-6-astra |
Antes de empezar
Para que puedas enviar solicitudes, tu administrador de Google Cloud debe:
- Habilitar la facturación del proyecto, gestionar la aprobación del proyecto y coordinar con tu administrador de facturación la aceptación de la oferta privada de Marketplace.
- Habilitar la API de Vertex AI (
aiplatform.googleapis.com) y habilitar el modelo en Model Garden, lo que incluye aceptar los términos del modelo. - Si la política de tu organización restringe el acceso a los modelos, permitir el acceso al modelo en esa política.
- Otorgar al usuario o a la cuenta de servicio que envía las solicitudes el permiso para llamar al modelo, por ejemplo, mediante la asignación del rol
roles/aiplatform.user.
Cuando el proyecto esté listo, pídele a tu administrador el ID del proyecto.
Hacer tu primera llamada a la API
Para el desarrollo local, instala la CLI de Google Cloud e inicia sesión con la cuenta de Google que tiene acceso a tu proyecto:
gcloud auth application-default login
Obtén un token de acceso en la terminal desde la que enviarás la solicitud:
export GOOGLE_CLOUD_ACCESS_TOKEN="$(gcloud auth application-default print-access-token)"
Cuando venza el token de acceso, vuelve a ejecutar este comando para obtener uno nuevo con las credenciales de inicio de sesión guardadas.
Envía la solicitud con cURL o con el SDK de OpenAI. Reemplaza your-project-id por el ID de tu proyecto.
PROJECT_ID="your-project-id"
PROJECT_URL="https://aiplatform.googleapis.com/v1/projects/$PROJECT_ID"
curl --fail-with-body "$PROJECT_URL/locations/global/publishers/openai/v1/responses" \
-H "Authorization: Bearer $GOOGLE_CLOUD_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6-luna",
"input": "Write a one-sentence bedtime story about a unicorn.",
"store": false
}'Si prefieres obtener los tokens de acceso mediante la biblioteca de autenticación de Google en lugar de exportarlos en tu terminal, sigue la guía de inicio de Google. Allí se explica cómo usar las credenciales predeterminadas de la aplicación (ADC) y solucionar errores de la API.
Disponibilidad de funciones
La tabla compara las funciones disponibles en Google Cloud con las que ofrece OpenAI directamente en su API.
| Función | API de OpenAI | Google Cloud |
|---|---|---|
Solicitudes a la API | ||
| Generación de texto | Disponible | Disponible |
| Transmisión de respuestas por HTTP (SSE) | Disponible | Disponible |
| Punto de acceso de la API de Respuestas | Disponible | Disponible |
| Uso de tokens por respuesta | Disponible | Disponible |
| Punto de acceso para contar los tokens de entrada | Disponible | No disponible |
| Conexiones WebSocket de Realtime | Disponible | No disponible |
| Solicitudes en segundo plano | Disponible | No disponible |
| Reanudación de la transmisión en segundo plano | Disponible | No disponible |
| API para completar chats | Disponible | No disponible |
| Procesamiento por lotes | Disponible | No disponible |
Salida y razonamiento | ||
| Resultados estructurados con JSON Schema | Disponible | Disponible |
| Modo JSON | Disponible | Disponible |
| Esfuerzo de razonamiento | Disponible | Disponible |
| Razonamiento cifrado | Disponible | Disponible |
| Resúmenes de razonamiento | Disponible | No disponible |
Herramientas e integraciones | ||
| Llamada a funciones del lado del cliente | Disponible | Disponible |
| Llamadas a herramientas en paralelo | Disponible | Disponible |
| Argumentos estructurados para funciones | Disponible | Disponible |
| Herramientas personalizadas | Disponible | Disponible con entradas de formato libre o con restricciones definidas mediante expresiones regulares |
| Búsqueda de herramientas del lado del cliente | Disponible | Disponible |
| Herramientas MCP y herramientas con espacios de nombres que ejecuta el cliente | Disponible | Disponible |
| Herramienta de shell del lado del cliente | Disponible | Disponible |
| Búsqueda web alojada | Disponible | No disponible |
| Búsqueda de archivos y almacenes de vectores alojados | Disponible | No disponible |
| Ejecución de código en un entorno alojado | Disponible | No disponible |
| MCP remoto del lado del servidor | Disponible | No disponible |
Documentos y contenido multimedia | ||
| Extracción de texto de archivos PDF | Disponible | Disponible |
| Imágenes incluidas directamente en la entrada | Disponible | Disponible |
| Generación de imágenes | Disponible | No disponible |
Estado de la conversación | ||
| Continuación de conversaciones guardadas | Disponible | Disponible |
| Continuación de conversaciones sin estado | Disponible | Disponible |
| Compactación de conversaciones | Disponible | Disponible |
| Controles explícitos de la caché de prompts | Disponible | Disponible |
Retención de datos
Tus prompts y respuestas no se usan para entrenar los modelos de OpenAI. El plazo de retención predeterminado es de hasta 30 días.
Si necesitas retención cero de datos (ZDR), comunícate con tu representante de OpenAI o de Google Cloud durante el proceso de incorporación y espera a que te confirme que esta opción está disponible para ti. Configurar store: false en una solicitud no activa la ZDR.