GPT-Image 2.6 Flare y Sunburst ya están disponiblesDesde $0.025 por imagen
OmniaKey
Iniciar sesión

Configuración de la clave de API

Clave de API de Nano Banana: obtener, configurar y probar

Antes de configurar su clave de API de Nano Banana, elija quién la emite. Haga coincidir la clave, la URL de la API y el ID del modelo. Los pasos siguientes configuran el acceso a través de OmniaKey.

Clave oficial del proveedor

Para una clave emitida y facturada directamente por Google, siga las instrucciones de cuenta y de clave de API del proveedor.

Abrir las instrucciones de la clave oficial

Clave de API de OmniaKey

Use un solo saldo y una sola clave OmniaKey para los modelos disponibles en su cuenta. La clave funciona con el endpoint de OmniaKey.

Obtener una clave de API

01Cree una clave de API de OmniaKey

Inicie sesión, abra API Keys y cree una clave para su aplicación. Revise su cuota, caducidad y restricciones de modelos. Añada saldo antes de lanzar solicitudes de generación.

Obtener una clave de API

02Defina la clave y la URL de la API

Ejecute los comandos en su terminal y sustituya el marcador de posición por su clave. Guarde la clave en su servidor o en un gestor de secretos. Nunca la incluya en código del navegador ni en un repositorio público.

bash / zsh
export OMNIAKEY_API_KEY="YOUR_OMNIAKEY_API_KEY"
export OMNIAKEY_BASE_URL="https://api.omniakey.com/v1"

03Compruebe la autenticación

Solicite la lista de modelos sin iniciar una tarea de generación. Una respuesta correcta es JSON con un array data. Esto comprueba el acceso de la clave; no demuestra que todos los modelos estén habilitados para su cuenta.

GET /v1/models
curl --fail-with-body "$OMNIAKEY_BASE_URL/models" \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"

04Use el formato de solicitud del modelo

Seleccione un modelo en la página de la familia, copie su ID de API y siga la documentación de API correspondiente. La autenticación por sí sola no comprueba sus parámetros de generación.

La generación de imágenes y vídeo usa POST /v1/media/tasks. Mantenga la misma Idempotency-Key al reenviar el mismo envío, guarde el ID de tarea devuelto y consulte GET /v1/media/tasks/{id} para obtener el resultado.

Solicitud de generación de ejemplo (con cargo)

Esta solicitud usa el saldo de su cuenta. Revise primero el precio del modelo elegido. El ejemplo sigue el formato de solicitud documentado; su cuenta aún necesita acceso al modelo.

POST /v1/media/tasks
curl --fail-with-body 'https://api.omniakey.com/v1/media/tasks' \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: nano-banana-first-request-001" \
  -d '{
  "model": "gemini-nano-banana-2.1",
  "type": "image",
  "operation": "generate",
  "input": {
    "prompt": "A paper boat on a quiet lake at sunset."
  },
  "parameters": {
    "image_size": "1K",
    "aspect_ratio": "1:1"
  }
}'

Consultar la tarea multimedia

Sustituya YOUR_TASK_ID por el ID devuelto por la solicitud de creación. Consulte hasta que la tarea alcance un estado final. Si la tarea se completa, descargue las URL de assets antes de que caduquen. Use una clave de idempotencia nueva solo para una tarea nueva.

GET /v1/media/tasks/{id}
curl --fail-with-body "https://api.omniakey.com/v1/media/tasks/YOUR_TASK_ID" \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"
Leer la documentación de la API

Si falla la conexión

  • 401: compruebe que la clave esté completa, activa y emitida para la URL de API a la que llama.
  • 403: compruebe las restricciones de modelos de la clave y los permisos disponibles en su cuenta.
  • 404 o HTML en lugar de JSON: compruebe el host de la API y el prefijo de versión. Use api.omniakey.com, no la dirección del sitio web.
  • 429: reduzca la concurrencia y siga las indicaciones de reintento de la respuesta. No reenvíe tareas de generación con claves de idempotencia nuevas.