For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navegación principal
Theme

OpenAI en Google Cloud

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.

Solicitud a la API de Respuestas en Google Cloud
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ónAPI de OpenAIGoogle Cloud

Solicitudes a la API

Generación de textoDisponibleDisponible
Transmisión de respuestas por HTTP (SSE)DisponibleDisponible
Punto de acceso de la API de RespuestasDisponibleDisponible
Uso de tokens por respuestaDisponibleDisponible
Punto de acceso para contar los tokens de entradaDisponibleNo disponible
Conexiones WebSocket de RealtimeDisponibleNo disponible
Solicitudes en segundo planoDisponibleNo disponible
Reanudación de la transmisión en segundo planoDisponibleNo disponible
API para completar chatsDisponibleNo disponible
Procesamiento por lotesDisponibleNo disponible

Salida y razonamiento

Resultados estructurados con JSON SchemaDisponibleDisponible
Modo JSONDisponibleDisponible
Esfuerzo de razonamientoDisponibleDisponible
Razonamiento cifradoDisponibleDisponible
Resúmenes de razonamientoDisponibleNo disponible

Herramientas e integraciones

Llamada a funciones del lado del clienteDisponibleDisponible
Llamadas a herramientas en paraleloDisponibleDisponible
Argumentos estructurados para funcionesDisponibleDisponible
Herramientas personalizadasDisponibleDisponible con entradas de formato libre o con restricciones definidas mediante expresiones regulares
Búsqueda de herramientas del lado del clienteDisponibleDisponible
Herramientas MCP y herramientas con espacios de nombres que ejecuta el clienteDisponibleDisponible
Herramienta de shell del lado del clienteDisponibleDisponible
Búsqueda web alojadaDisponibleNo disponible
Búsqueda de archivos y almacenes de vectores alojadosDisponibleNo disponible
Ejecución de código en un entorno alojadoDisponibleNo disponible
MCP remoto del lado del servidorDisponibleNo disponible

Documentos y contenido multimedia

Extracción de texto de archivos PDFDisponibleDisponible
Imágenes incluidas directamente en la entradaDisponibleDisponible
Generación de imágenesDisponibleNo disponible

Estado de la conversación

Continuación de conversaciones guardadasDisponibleDisponible
Continuación de conversaciones sin estadoDisponibleDisponible
Compactación de conversacionesDisponibleDisponible
Controles explícitos de la caché de promptsDisponibleDisponible

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.