> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Usa Gemini 3.1 Flash Lite con Comfy Router

> Llama a vertexai/gemini-3.1-flash-lite con Comfy Router: endpoint, forma de la solicitud y respuesta que devuelve Router.

Referencia de API de `vertexai/gemini-3.1-flash-lite`, servida por Comfy Router de Google.

**Entrada:** Texto, Imagen, Audio, Video · **Salida:** Texto

## Inicio rápido

Crea una clave en [tu espacio de trabajo de Comfy](https://platform.comfy.org/profile/api-keys?onboarding=router) y expórtala como `COMFY_API_KEY`. Los fragmentos de Python y TypeScript usan los SDK de Comfy (`pip install comfy-sdk` y `npm install @comfyorg/sdk`); el fragmento de cURL es la misma llamada mediante HTTP sin procesar.

**ID del modelo:** `vertexai/gemini-3.1-flash-lite`

**Endpoint:** `POST https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite`

**Esperar el resultado**

```python Python theme={null}
from comfy_sdk import Comfy

# Lee COMFY_API_KEY del entorno.
# El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos.
with Comfy() as client:
    result = client.models.run(
        "vertexai/gemini-3.1-flash-lite",
        {
            "contents": [
                {
                    "parts": [
                        {
                            "text": "Describe a robot learning to paint, in two sentences.",
                        },
                    ],
                    "role": "user",
                },
            ],
        },
    )

print(result)
```

```typescript TypeScript theme={null}
import { comfy } from "@comfyorg/sdk";

// Lee COMFY_API_KEY del entorno.
// El SDK crea automáticamente una clave de idempotencia y la reutiliza para los reintentos automáticos.
const { data } = await comfy.models.run("vertexai/gemini-3.1-flash-lite", {
  contents: [
    {
      parts: [
        {
          text: "Describe a robot learning to paint, in two sentences.",
        },
      ],
      role: "user",
    },
  ],
});

console.log(data);
```

```bash cURL theme={null}
curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite \
  -H "X-API-Key: $COMFY_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d "{\"contents\": [{\"parts\":[{\"text\":\"Describe a robot learning to paint, in two sentences.\"}],\"role\":\"user\"}]}"
```

**Encolar y recoger más tarde**

El mismo cuerpo, enviado a `POST https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite/requests`. Router responde `201` con un `request_id` en cuanto se admite la ejecución, y puedes recoger el resultado cuando esté listo, desde este proceso u otro. [Entrega en cola](https://docs.comfy.org/es/development/comfy-router/queue.md) explica el estado, la cancelación y la recogida.

```python Python theme={null}
import asyncio
from comfy_sdk import AsyncComfy

# Lee COMFY_API_KEY del entorno.
# Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos.
async def main():
    async with AsyncComfy() as client:
        handle = await client.models.submit(
            "vertexai/gemini-3.1-flash-lite",
            {
                "contents": [
                    {
                        "parts": [
                            {
                                "text": "Describe a robot learning to paint, in two sentences.",
                            },
                        ],
                        "role": "user",
                    },
                ],
            },
        )
        print("request_id:", handle.request_id)  # junto con el ID del modelo, es todo lo que otro proceso necesita

        # Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor.
        async for update in handle.iter_events():
            print(update.status, update.queue_position)

        # La carga propia del proveedor, el mismo valor que devuelve models.run().
        # Una solicitud que falló o se canceló lanza aquí el error tipado de Router.
        result = await handle.get()

    print(result)

asyncio.run(main())
```

```typescript TypeScript theme={null}
import { comfy } from "@comfyorg/sdk";

// Lee COMFY_API_KEY del entorno.
// Cada llamada a submit() genera su propia Idempotency-Key y la reutiliza para los reintentos automáticos.
const handle = await comfy.models.submit("vertexai/gemini-3.1-flash-lite", {
  contents: [
    {
      parts: [
        {
          text: "Describe a robot learning to paint, in two sentences.",
        },
      ],
      role: "user",
    },
  ],
});
console.log("requestId:", handle.requestId); // junto con el ID del modelo, es todo lo que otro proceso necesita

// Consulta hasta que la solicitud se complete, esperando el Retry-After que indica el servidor.
for await (const update of handle.events()) {
  console.log(update.status, update.queuePosition);
}

// El mismo resultado que devuelve models.run(). Una solicitud que falló o se canceló se rechaza aquí.
const result = await handle.get();

console.log(result.data);
```

```bash cURL theme={null}
# 1. Envía. Router responde 201 con request_id, status_url, response_url y cancel_url.
curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite/requests \
  -H "X-API-Key: $COMFY_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d "{\"contents\": [{\"parts\":[{\"text\":\"Describe a robot learning to paint, in two sentences.\"}],\"role\":\"user\"}]}"

# 2. Consulta hasta que el estado sea COMPLETED, esperando los segundos de Retry-After que indica cada respuesta.
REQUEST_ID="<request_id from the 201 body>"
curl -i https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite/requests/$REQUEST_ID/status \
  -H "X-API-Key: $COMFY_API_KEY"

# 3. Recoge. 200 con la salida nativa del modelo, 202 con el cuerpo de estado mientras sigue en ejecución.
curl https://api.comfy.org/v2/models/vertexai/gemini-3.1-flash-lite/requests/$REQUEST_ID \
  -H "X-API-Key: $COMFY_API_KEY"
```

## Esquema

### Entrada

**contents** `object[]` *required*

El contenido de la conversación actual con el modelo. Para consultas de un solo turno, es una única instancia. Para consultas de varios turnos, es un campo repetido que contiene el historial de la conversación y la solicitud más reciente.

**contents\[].parts** `object[]` *required*

**contents\[].parts\[].fileData** `object`

Datos basados en URI.

**contents\[].parts\[].fileData.fileUri** `string`

URI

**contents\[].parts\[].fileData.mimeType** `string`

El tipo de medio del archivo especificado en los campos data o fileUri. Los valores aceptables incluyen los siguientes. Para gemini-2.0-flash-lite y gemini-2.0-flash, la duración máxima de un archivo de audio es de 8.4 horas y la duración máxima de un archivo de video (sin audio) es de una hora. Para más información, consulta los requisitos de audio y video de Gemini. Los archivos de texto deben estar codificados en UTF-8. El contenido del archivo de texto cuenta para el límite de tokens. No hay límite en la resolución de las imágenes.

Valores posibles: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm`

**contents\[].parts\[].inlineData** `object`

Datos en línea en bytes sin procesar. Para gemini-2.0-flash-lite y gemini-2.0-flash, puedes especificar hasta 3000 imágenes usando inlineData.

**contents\[].parts\[].inlineData.data** `string (byte)`

La codificación base64 de la imagen, PDF o video que se incluirá en línea en el prompt. Cuando incluyes medios en línea, también debes especificar el tipo de medio (mimeType) de los datos. Límite de tamaño: 20MB

Formato: `byte`

**contents\[].parts\[].inlineData.mimeType** `string`

El tipo de medio del archivo especificado en los campos data o fileUri. Los valores aceptables incluyen los siguientes. Para gemini-2.0-flash-lite y gemini-2.0-flash, la duración máxima de un archivo de audio es de 8.4 horas y la duración máxima de un archivo de video (sin audio) es de una hora. Para más información, consulta los requisitos de audio y video de Gemini. Los archivos de texto deben estar codificados en UTF-8. El contenido del archivo de texto cuenta para el límite de tokens. No hay límite en la resolución de las imágenes.

Valores posibles: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm`

**contents\[].parts\[].mediaProcessing** `string`

Cómo lee el modelo el video de esta parte. Establece "AGENTIC" para que el modelo decida qué segmentos inspeccionar, en lugar del muestreo de fotogramas a tasa fija. Omítelo para usar el muestreo a tasa fija predeterminado. Compatible con gemini-3.7-flash y modelos Flash más recientes.

**contents\[].parts\[].text** `string`

Un prompt de texto o fragmento de código.

**contents\[].parts\[].thought** `boolean`

Indica que esta parte es un paso de pensamiento o razonamiento del modelo.

**contents\[].role** `string`

Valores posibles: `user`, `model`

**generationConfig** `object`

Configuraciones de muestreo, longitud y salida para la generación. Todos los campos son opcionales: los campos siguientes que declaran un `default` lo aplican cuando se omiten, y el resto recurre al comportamiento propio del modelo.

**generationConfig.imageConfig** `object`

Configuración para la generación de imágenes

**generationConfig.imageConfig.aspectRatio** `string`

Relación de aspecto de las imágenes generadas

**generationConfig.imageConfig.imageOutputOptions** `object`

Opcional. El formato de salida de las imágenes generadas.

**generationConfig.imageConfig.imageOutputOptions.compressionQuality** `integer`

Opcional. La calidad de compresión de la imagen de salida.

**generationConfig.imageConfig.imageOutputOptions.mimeType** `string`

Opcional. El formato de imagen con el que se debe guardar la salida, en las rutas de Vertex AI: solicitudes atendidas con las credenciales propias de Comfy y solicitudes BYOK autenticadas con una cuenta de servicio de GCP. Los valores aceptados allí son `image/png` e `image/jpeg`, comparados sin distinguir mayúsculas y minúsculas y normalizados a minúsculas antes de reenviar la solicitud; cualquier otro valor se rechaza con un 400 que nombra este campo. Si se omite, el valor predeterminado es `image/png`. Una solicitud BYOK autenticada con una clave API de Google AI Studio es la excepción: ese upstream no tiene esa propiedad y rechaza la llamada completa si está presente, así que el campo se elimina de la solicitud en lugar de respetarse o rechazarse, y el formato de salida es el que elija AI Studio. En todas las rutas, lee el tipo de medio desde la parte de la respuesta que recibes (`inlineData.mimeType`, o `fileData.mimeType` cuando `uploadImagesToStorage` está configurado) en lugar de suponer el valor que enviaste.

**generationConfig.imageConfig.imageSize** `string`

Opcional. Especifica el tamaño de las imágenes generadas. Los valores admitidos son 1K, 2K, 4K. Si no se especifica, el modelo usará el valor predeterminado 1K.

**generationConfig.maxOutputTokens** `integer`

Número máximo de tokens que se pueden generar en la respuesta. Un token equivale aproximadamente a 4 caracteres. 100 tokens corresponden a unas 60-80 palabras.

Rango: `16` a `65536`

**generationConfig.responseModalities** \`\`TEXT`, `IMAGE`[]`

**generationConfig.seed** `integer`

Cuando la semilla se fija en un valor específico, el modelo hace su mejor esfuerzo por entregar la misma respuesta ante solicitudes repetidas. No se garantiza una salida determinista. Además, cambiar el modelo o los ajustes de los parámetros, como la temperatura, puede provocar variaciones en la respuesta incluso cuando usas el mismo valor de semilla. De forma predeterminada se usa un valor de semilla aleatorio. Disponible para los siguientes modelos:, gemini-2.5-flash, gemini-2.5-pro, gemini-2.5-flash-preview-04-1, gemini-2.5-pro-preview-05-0, gemini-2.0-flash-lite-00, gemini-2.0-flash-001

**generationConfig.stopSequences** `string[]`

**generationConfig.temperature** `number` (default: 1)

La temperatura se usa para el muestreo durante la generación de la respuesta, que ocurre cuando se aplican topP y topK. La temperatura controla el grado de aleatoriedad en la selección de tokens. Las temperaturas bajas son buenas para prompts que requieren una respuesta menos abierta o creativa, mientras que las temperaturas altas pueden dar lugar a resultados más diversos o creativos. Una temperatura de 0 significa que siempre se seleccionan los tokens de mayor probabilidad. En este caso, las respuestas para un prompt dado son en su mayoría deterministas, pero todavía es posible una pequeña cantidad de variación. Si el modelo devuelve una respuesta demasiado genérica, demasiado corta, o si el modelo da una respuesta de reserva, prueba a aumentar la temperatura

Rango: `0` a `2`

Formato: `float`

**generationConfig.thinkingConfig** `object`

Opcional. Configuración para las funciones de pensamiento. El pensamiento es un proceso en el que el modelo descompone una tarea compleja en pasos más pequeños para generar una respuesta de mayor calidad.

**generationConfig.thinkingConfig.includeThoughts** `boolean`

Opcional. Si es verdadero, el modelo incluirá sus pensamientos en la respuesta.

**generationConfig.thinkingConfig.thinkingBudget** `integer`

Opcional. El presupuesto de tokens para el proceso de pensamiento del modelo. El modelo hará su mejor esfuerzo por mantenerse dentro de este presupuesto.

**generationConfig.thinkingConfig.thinkingLevel** `string`

Opcional. El nivel de pensamiento del modelo.

Valores posibles: `THINKING_LEVEL_UNSPECIFIED`, `LOW`, `MEDIUM`, `HIGH`, `MINIMAL`

**generationConfig.topK** `integer` (default: 40)

Top-K cambia la forma en que el modelo selecciona los tokens de salida. Un top-K de 1 significa que el siguiente token seleccionado es el más probable entre todos los tokens del vocabulario del modelo. Un top-K de 3 significa que el siguiente token se selecciona entre los 3 tokens más probables usando la temperatura.

Rango: `1` a `…`

**generationConfig.topP** `number` (default: 0.95)

Si se especifica, se usa el muestreo de núcleo.
Top-P cambia la forma en que el modelo selecciona los tokens de salida. Los tokens se seleccionan del más (consulta top-K) al menos probable hasta que la suma de sus probabilidades iguale el valor de top-P. Por ejemplo, si los tokens A, B y C tienen una probabilidad de 0.3, 0.2 y 0.1 y el valor de top-P es 0.5, el modelo seleccionará A o B como el siguiente token usando la temperatura y excluirá a C como candidato.
Especifica un valor más bajo para respuestas menos aleatorias y un valor más alto para respuestas más aleatorias.

Rango: `0` a `1`

Formato: `float`

**safetySettings** `object[]`

Configuraciones por solicitud para bloquear contenido no seguro. Se aplican en GenerateContentResponse.candidates.

**safetySettings\[].category** `string` *required*

Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT`

**safetySettings\[].threshold** `string` *required*

Valores posibles: `OFF`, `BLOCK_NONE`, `BLOCK_LOW_AND_ABOVE`, `BLOCK_MEDIUM_AND_ABOVE`, `BLOCK_ONLY_HIGH`

**systemInstruction** `object`

Instrucciones para el modelo que lo orientan hacia un mejor rendimiento. Por ejemplo, "Responde de la forma más concisa posible" o "No uses términos técnicos en tu respuesta". Las cadenas de texto cuentan para el límite de tokens. El campo role de systemInstruction se ignora y no afecta el rendimiento del modelo. Nota: En las partes solo se debe usar texto y el contenido de cada parte debe ir en un párrafo separado.

**systemInstruction.parts** `object[]` *required*

Una lista de partes ordenadas que componen un solo mensaje. Las distintas partes pueden tener distintos tipos MIME de IANA. Para conocer los límites de las entradas, como el número máximo de tokens o el número de imágenes, consulta las especificaciones del modelo en la página de modelos de Google.

**systemInstruction.parts\[].text** `string`

Un prompt de texto o un fragmento de código.

**systemInstruction.role** `string`

La identidad de la entidad que crea el mensaje. Se admiten los siguientes valores: user: indica que el mensaje lo envía una persona real, normalmente un mensaje generado por el usuario. model: indica que el mensaje lo genera el modelo. El valor model se usa para insertar mensajes del modelo en la conversación durante conversaciones de varios turnos. En conversaciones que no son de varios turnos, este campo puede dejarse en blanco o sin definir.

Valores posibles: `user`, `model`

**tools** `object[]`

Un fragmento de código que permite al sistema interactuar con sistemas externos para realizar una acción, o un conjunto de acciones, fuera del conocimiento y el alcance del modelo. Consulta Llamada a funciones.

**tools\[].functionDeclarations** `object[]`

**tools\[].functionDeclarations\[].description** `string`

**tools\[].functionDeclarations\[].name** `string` *required*

**tools\[].functionDeclarations\[].parameters** `object`

Esquema JSON para los parámetros de la función

**uploadImagesToStorage** `boolean`

Si es verdadero, las imágenes generadas se subirán al almacenamiento en la nube y se devolverán como URLs firmadas en lugar de datos base64 en línea. Las URLs expiran después de 24 horas.

**videoMetadata** `object`

Para entradas de video, el desplazamiento de inicio y fin del video en formato Duration. Por ejemplo, para especificar un clip de 10 segundos que comienza en 1:00, establece "startOffset": \{ "seconds": 60 } y "endOffset": \{ "seconds": 70 }. Los metadatos solo deben especificarse mientras los datos del video se presenten en inlineData o fileData.

**videoMetadata.endOffset** `object`

Representa un desplazamiento de duración para posiciones en la línea de tiempo del video.

**videoMetadata.endOffset.nanos** `integer`

Fracciones de segundo con signo a resolución de nanosegundos. Los valores de segundos negativos con fracciones aún deben tener valores de nanos no negativos.

Rango: `0` a `999999999`

**videoMetadata.endOffset.seconds** `integer`

Segundos con signo de la extensión de tiempo. Debe estar entre -315,576,000,000 y +315,576,000,000 inclusive.

Rango: `-315576000000` a `315576000000`

**videoMetadata.startOffset** `object`

Representa un desplazamiento de duración para posiciones en la línea de tiempo del video.

**videoMetadata.startOffset.nanos** `integer`

Fracciones de segundo con signo a resolución de nanosegundos. Los valores de segundos negativos con fracciones aún deben tener valores de nanos no negativos.

Rango: `0` a `999999999`

**videoMetadata.startOffset.seconds** `integer`

Segundos con signo de la extensión de tiempo. Debe estar entre -315,576,000,000 y +315,576,000,000 inclusive.

Rango: `-315576000000` a `315576000000`

Generado a partir del esquema que Router sirve en `GET /v2/models/vertexai/gemini-3.1-flash-lite/openapi.json`, el mismo documento con el que valida una llamada antes de que la solicitud llegue al proveedor.

### Salida

**candidates** `object[]`

**candidates\[].citationMetadata** `object`

**candidates\[].citationMetadata.citations** `object[]`

**candidates\[].citationMetadata.citations\[].authors** `string[]`

**candidates\[].citationMetadata.citations\[].endIndex** `integer`

**candidates\[].citationMetadata.citations\[].license** `string`

**candidates\[].citationMetadata.citations\[].publicationDate** `string (date)`

Formato: `date`

**candidates\[].citationMetadata.citations\[].startIndex** `integer`

**candidates\[].citationMetadata.citations\[].title** `string`

**candidates\[].citationMetadata.citations\[].uri** `string`

**candidates\[].content** `object`

El contenido de la conversación actual con el modelo. Para consultas de un solo turno, es una sola instancia. Para consultas de varios turnos, es un campo repetido que contiene el historial de la conversación y la solicitud más reciente.

**candidates\[].content.parts** `object[]` *required*

**candidates\[].content.parts\[].fileData** `object`

Datos basados en URI.

**candidates\[].content.parts\[].fileData.fileUri** `string`

URI

**candidates\[].content.parts\[].fileData.mimeType** `string`

El tipo de medio del archivo especificado en los campos data o fileUri. Los valores aceptables incluyen los siguientes. Para gemini-2.0-flash-lite y gemini-2.0-flash, la duración máxima de un archivo de audio es de 8.4 horas y la duración máxima de un archivo de video (sin audio) es de una hora. Para obtener más información, consulta los requisitos de audio y video de Gemini. Los archivos de texto deben estar codificados en UTF-8. El contenido del archivo de texto cuenta para el límite de tokens. No hay límite en la resolución de las imágenes.

Valores posibles: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm`

**candidates\[].content.parts\[].inlineData** `object`

Datos en línea en bytes sin procesar. Para gemini-2.0-flash-lite y gemini-2.0-flash, puedes especificar hasta 3000 imágenes usando inlineData.

**candidates\[].content.parts\[].inlineData.data** `string (byte)`

La codificación base64 de la imagen, el PDF o el video para incluir en línea en el prompt. Cuando incluyes medios en línea, también debes especificar el tipo de medio (mimeType) de los datos. Límite de tamaño: 20MB

Formato: `byte`

**candidates\[].content.parts\[].inlineData.mimeType** `string`

El tipo de medio del archivo especificado en los campos data o fileUri. Los valores aceptables incluyen los siguientes. Para gemini-2.0-flash-lite y gemini-2.0-flash, la duración máxima de un archivo de audio es de 8.4 horas y la duración máxima de un archivo de video (sin audio) es de una hora. Para obtener más información, consulta los requisitos de audio y video de Gemini. Los archivos de texto deben estar codificados en UTF-8. El contenido del archivo de texto cuenta para el límite de tokens. No hay límite en la resolución de las imágenes.

Valores posibles: `application/pdf`, `audio/mpeg`, `audio/mp3`, `audio/wav`, `image/png`, `image/jpeg`, `image/webp`, `text/plain`, `video/mov`, `video/mpeg`, `video/mp4`, `video/mpg`, `video/avi`, `video/wmv`, `video/mpegps`, `video/flv`, `image/heic`, `image/heif`, `audio/flac`, `video/webm`

**candidates\[].content.parts\[].mediaProcessing** `string`

Cómo lee el modelo el video de esta parte. Establece "AGENTIC" para que el modelo decida qué segmentos inspeccionar, en lugar del muestreo de fotogramas a tasa fija. Omite este campo para usar el muestreo de tasa fija predeterminado. Compatible con gemini-3.7-flash y modelos Flash más recientes.

**candidates\[].content.parts\[].text** `string`

Un prompt de texto o un fragmento de código.

**candidates\[].content.parts\[].thought** `boolean`

Indica que esta parte es un paso de pensamiento/razonamiento del modelo.

**candidates\[].content.role** `string`

Valores posibles: `user`, `model`

**candidates\[].finishReason** `string`

**candidates\[].safetyRatings** `object[]`

**candidates\[].safetyRatings\[].category** `string`

Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT`

**candidates\[].safetyRatings\[].probability** `string`

La probabilidad de que el contenido viole la categoría de seguridad especificada

Valores posibles: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN`

**createTime** `string`

Marca de tiempo en la que se creó la respuesta.

**modelVersion** `string`

La versión del modelo usada para generar la respuesta.

**promptFeedback** `object`

**promptFeedback.blockReason** `string`

**promptFeedback.blockReasonMessage** `string`

**promptFeedback.safetyRatings** `object[]`

**promptFeedback.safetyRatings\[].category** `string`

Valores posibles: `HARM_CATEGORY_SEXUALLY_EXPLICIT`, `HARM_CATEGORY_HATE_SPEECH`, `HARM_CATEGORY_HARASSMENT`, `HARM_CATEGORY_DANGEROUS_CONTENT`

**promptFeedback.safetyRatings\[].probability** `string`

La probabilidad de que el contenido infrinja la categoría de seguridad especificada

Valores posibles: `NEGLIGIBLE`, `LOW`, `MEDIUM`, `HIGH`, `UNKNOWN`

**responseId** `string`

Identificador único de la respuesta.

**usageMetadata** `object`

**usageMetadata.cachedContentTokenCount** `integer`

Solo salida. Número de tokens en la parte almacenada en caché de la entrada (el contenido en caché).

**usageMetadata.candidatesTokenCount** `integer`

Número de tokens en la respuesta o respuestas.

**usageMetadata.candidatesTokensDetails** `object[]`

Desglose de los tokens de candidatos por modalidad.

**usageMetadata.candidatesTokensDetails\[].modality** `string`

Tipo de modalidad del contenido de entrada o salida.

Valores posibles: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT`

**usageMetadata.candidatesTokensDetails\[].tokenCount** `integer`

Número de tokens para la modalidad indicada.

**usageMetadata.promptTokenCount** `integer`

Número de tokens en la solicitud. Cuando se establece cachedContent, sigue siendo el tamaño total efectivo del prompt, es decir, incluye el número de tokens del contenido en caché.

**usageMetadata.promptTokensDetails** `object[]`

Desglose de los tokens del prompt por modalidad.

**usageMetadata.promptTokensDetails\[].modality** `string`

Tipo de modalidad del contenido de entrada o salida.

Valores posibles: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT`

**usageMetadata.promptTokensDetails\[].tokenCount** `integer`

Número de tokens para la modalidad indicada.

**usageMetadata.thoughtsTokenCount** `integer`

Número de tokens presentes en la salida de razonamientos.

**usageMetadata.toolUsePromptTokenCount** `integer`

Número de tokens presentes en el prompt o prompts de uso de herramientas.

**usageMetadata.toolUsePromptTokensDetails** `object[]`

Desglose de los tokens del prompt de uso de herramientas por modalidad.

**usageMetadata.toolUsePromptTokensDetails\[].modality** `string`

Tipo de modalidad del contenido de entrada o salida.

Valores posibles: `MODALITY_UNSPECIFIED`, `TEXT`, `IMAGE`, `VIDEO`, `AUDIO`, `DOCUMENT`

**usageMetadata.toolUsePromptTokensDetails\[].tokenCount** `integer`

Número de tokens para la modalidad indicada.

**usageMetadata.totalTokenCount** `integer`

Número total de tokens (prompt + candidatos).

**usageMetadata.trafficType** `string`

Tipo de tráfico utilizado para la solicitud (p. ej., PROVISIONED\_THROUGHPUT).

## Ejemplos

### Entrada

```json theme={null}
{
  "contents": [
    {
      "parts": [
        {
          "text": "Describe a robot learning to paint, in two sentences."
        }
      ],
      "role": "user"
    }
  ]
}
```

### Salida

```json theme={null}
{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "A lighthouse stands at the edge of the harbour, its lamp still turning as the sun comes up."
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP"
    }
  ],
  "modelVersion": "gemini-3.1-flash-lite",
  "responseId": "0d1f2a3b-4c5d-6e7f-8a9b-0c1d2e3f4a5b",
  "usageMetadata": {
    "candidatesTokenCount": 21,
    "promptTokenCount": 12,
    "totalTokenCount": 33
  }
}
```

## Antes de lanzar

Los SDK crean una `Idempotency-Key` y la reutilizan para los reintentos automáticos. Para los reintentos manuales, reutiliza la clave original. Router puede mantener la conexión abierta hasta 10 minutos.

Cuando una solicitud falla, Router envía un encabezado de respuesta `X-Comfy-Error-Type` que explica el motivo. Un `422` significa que Router rechazó la entrada antes de llamar al proveedor, y un `413` significa que el cuerpo de la solicitud era más grande de lo que Router acepta. Descarga los recursos generados de inmediato, porque [las URL de resultados pueden caducar](https://docs.comfy.org/es/development/comfy-router/reference.md#recursos-del-resultado).

Cualquier límite de tamaño mencionado en la descripción de un campo más arriba es el límite propio del proveedor para ese campo, citado de la especificación del proveedor. Router aplica un tope aparte al cuerpo completo de la solicitud, con el que cuentan los medios codificados en base64: consulta [tamaño del cuerpo de la solicitud](https://docs.comfy.org/es/development/comfy-router/limitations.md#los-cuerpos-de-las-solicitudes-tienen-un-límite).

Esta página documenta un modelo socio al que se llama a través de Comfy Router. El mismo paquete `comfy-sdk` / `@comfyorg/sdk` también incluye un segundo cliente, para ejecutar todo un gráfico de flujo de trabajo de ComfyUI en Comfy Cloud: `Comfy(api_key=...)` / `new Comfy({ apiKey })`, con `client.workflows`, `client.assets` y `client.jobs`. Consulta [SDK de Comfy](https://docs.comfy.org/es/development/api-development/sdks.md).

> **[Encabezados](https://docs.comfy.org/es/development/comfy-router/headers.md)**
>
> Autenticación, idempotencia, IDs de solicitud, agrupaciones de errores, ritmo de reintentos y límites de gasto.

> **[Uso de la API de Router](https://docs.comfy.org/es/development/comfy-router/api.md)**
>
> Descubrimiento de modelos, errores de validación, reintentos y facturación.

> **[Limitaciones](https://docs.comfy.org/es/development/comfy-router/limitations.md)**
>
> Lo que Router no hace hoy y qué usar en su lugar.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.