API de Gemini 2.5 Flash: 1M, versión estable

google/gemini-2.5-flash/chat

Gemini 2.5 Flash es el modelo de razonamiento híbrido de Google como endpoint de chat compatible con OpenAI. Lee hasta 1.048.576 tokens y responde hasta 65.535, con tres niveles de razonamiento, 128 herramientas y entrada de texto, imagen, video y audio.

Entrada $0.285Salida $2.375por 1 millón de tokensEntrada en caché $0.0285Precio oficial de Google~~$0.30$2.50~~

Ejecutar modelo Ver API

Enviar una solicitud

Los ejemplos usan las definiciones públicas de parámetros del endpoint seleccionado. Sustituye la clave de API y los medios de ejemplo, y envía la solicitud desde tu servidor.

SDK e integraciones

POSThttps://api.spicyapi.ai/v1/chat/completions

Autenticación de API

Guarda la clave de API en la variable de entorno del servidor SPICY_API_KEY. Usa autenticación Bearer y Content-Type: application/json en las solicitudes JSON.

Authorization: Bearer $SPICY_API_KEY

curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "google/gemini-2.5-flash/chat",
  "messages": [
    {
      "role": "user",
      "content": "Summarise the following release notes into three bullet points."
    }
  ],
  "stream": true
}' \
  | jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'

Generado a partir del esquema de entrada de este modelo: el mismo con el que la API valida cada solicitud.

Conserva un Idempotency-Key por cada solicitud lógica. Tras una interrupción de red, no reenvíes automáticamente con una clave nueva; guarda el request_id para investigar la solicitud aceptada. La idempotencia no vuelve a reproducir un flujo de chat anterior.

Parámetros de entrada

Los parámetros del modelo se incluyen junto a model en el cuerpo JSON. Este endpoint no utiliza un contenedor input.

messagesarray<object>Obligatorio

Turnos ordenados, del más antiguo al más reciente. El contenido es una cadena o un array de partes text, image_url, video_url, audio_url e input_audio. El video y el audio subidos pueden sumar 14 MB por solicitud. Las instrucciones permanentes van en el mensaje de sistema y luego añades un turno cada vez.

Valor predeterminado: Sin especificar
Restricciones: minItems:1

messages[].rolestringObligatorio dentro del objeto

Role of the message author.

Valor predeterminado: Sin especificar
Valores permitidos: "system""developer""user""assistant""tool"

messages[].namestringOpcional

Optional name identifying the speaker within its role.

Valor predeterminado: Sin especificar

messages[].contentstring | array | nullOpcional

Message content, either plain text or a list of content parts.

Valor predeterminado: Sin especificar

{
  "type": [
    "string",
    "array",
    "null"
  ],
  "items": {
    "oneOf": [
      {
        "type": "object",
        "required": [
          "type",
          "text"
        ],
        "properties": {
          "text": {
            "type": "string"
          },
          "type": {
            "const": "text"
          }
        }
      },
      {
        "type": "object",
        "required": [
          "type",
          "image_url"
        ],
        "properties": {
          "type": {
            "const": "image_url"
          },
          "image_url": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "url": {
                "type": "string"
              }
            }
          }
        }
      },
      {
        "type": "object",
        "required": [
          "type",
          "video_url"
        ],
        "properties": {
          "type": {
            "const": "video_url"
          },
          "video_url": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "url": {
                "type": "string"
              }
            }
          }
        }
      },
      {
        "type": "object",
        "required": [
          "type",
          "audio_url"
        ],
        "properties": {
          "type": {
            "const": "audio_url"
          },
          "audio_url": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "url": {
                "type": "string"
              }
            }
          }
        }
      },
      {
        "type": "object",
        "required": [
          "type",
          "input_audio"
        ],
        "properties": {
          "type": {
            "const": "input_audio"
          },
          "input_audio": {
            "type": "object",
            "required": [
              "data",
              "format"
            ],
            "properties": {
              "data": {
                "type": "string"
              },
              "format": {
                "enum": [
                  "wav",
                  "mp3"
                ],
                "type": "string"
              }
            }
          }
        }
      }
    ]
  },
  "description": "Message content, either plain text or a list of content parts."
}

messages[].tool_callsarray<object>Opcional

Tool calls the assistant requested in this message.

Valor predeterminado: Sin especificar

messages[].tool_call_idstringOpcional

Identifier of the tool call this message answers. Required on tool messages.

Valor predeterminado: Sin especificar

messages[].reasoning_contentstringOpcional

Reasoning text from a previous assistant reply, preserved when continuing a tool conversation.

Valor predeterminado: Sin especificar

{
  "type": "array",
  "x-ui": {
    "order": 100,
    "widget": "chat-messages",
    "primary": true
  },
  "items": {
    "type": "object",
    "allOf": [
      {
        "if": {
          "required": [
            "reasoning_content"
          ]
        },
        "then": {
          "properties": {
            "role": {
              "const": "assistant"
            }
          }
        }
      }
    ],
    "required": [
      "role"
    ],
    "properties": {
      "name": {
        "type": "string",
        "description": "Optional name identifying the speaker within its role."
      },
      "role": {
        "enum": [
          "system",
          "developer",
          "user",
          "assistant",
          "tool"
        ],
        "type": "string",
        "description": "Role of the message author."
      },
      "content": {
        "type": [
          "string",
          "array",
          "null"
        ],
        "items": {
          "oneOf": [
            {
              "type": "object",
              "required": [
                "type",
                "text"
              ],
              "properties": {
                "text": {
                  "type": "string"
                },
                "type": {
                  "const": "text"
                }
              }
            },
            {
              "type": "object",
              "required": [
                "type",
                "image_url"
              ],
              "properties": {
                "type": {
                  "const": "image_url"
                },
                "image_url": {
                  "type": "object",
                  "required": [
                    "url"
                  ],
                  "properties": {
                    "url": {
                      "type": "string"
                    }
                  }
                }
              }
            },
            {
              "type": "object",
              "required": [
                "type",
                "video_url"
              ],
              "properties": {
                "type": {
                  "const": "video_url"
                },
                "video_url": {
                  "type": "object",
                  "required": [
                    "url"
                  ],
                  "properties": {
                    "url": {
                      "type": "string"
                    }
                  }
                }
              }
            },
            {
              "type": "object",
              "required": [
                "type",
                "audio_url"
              ],
              "properties": {
                "type": {
                  "const": "audio_url"
                },
                "audio_url": {
                  "type": "object",
                  "required": [
                    "url"
                  ],
                  "properties": {
                    "url": {
                      "type": "string"
                    }
                  }
                }
              }
            },
            {
              "type": "object",
              "required": [
                "type",
                "input_audio"
              ],
              "properties": {
                "type": {
                  "const": "input_audio"
                },
                "input_audio": {
                  "type": "object",
                  "required": [
                    "data",
                    "format"
                  ],
                  "properties": {
                    "data": {
                      "type": "string"
                    },
                    "format": {
                      "enum": [
                        "wav",
                        "mp3"
                      ],
                      "type": "string"
                    }
                  }
                }
              }
            }
          ]
        },
        "description": "Message content, either plain text or a list of content parts."
      },
      "tool_calls": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Tool calls the assistant requested in this message."
      },
      "tool_call_id": {
        "type": "string",
        "description": "Identifier of the tool call this message answers. Required on tool messages."
      },
      "reasoning_content": {
        "type": "string",
        "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
      }
    },
    "additionalProperties": false
  },
  "minItems": 1,
  "description": "Ordered conversation turns. Text content only on this endpoint."
}

response_formatobjectOpcional

Pide un objeto JSON y nombra cada clave en el mensaje de sistema: así vuelve la respuesta en forma analizable.

Valor predeterminado: Sin especificar

tool_choicestring | objectOpcional

auto, none, required, o un objeto que nombre una función.

Valor predeterminado: Sin especificar

toolsarray<object>Opcional

Hasta 128 definiciones de función por solicitud.

Valor predeterminado: Sin especificar
Restricciones: maxItems:128

top_pnumberOpcional

De 0,01 a 1. Ajusta este o temperature, nunca los dos en la misma comparación.

Valor predeterminado: 1
Restricciones: minimum:0.01
maximum:1

temperaturenumberOpcional

De 0 a 2, 1 por defecto. Bájalo hacia 0 cuando la respuesta la lea código y súbelo cuando el texto deba sonar más suelto.

Valor predeterminado: 1
Restricciones: minimum:0
maximum:2

seedintegerOpcional

Cualquier entero. La misma semilla con una solicitud por lo demás idéntica hace que las respuestas se repitan de cerca, así puedes cambiar una sola cosa a la vez y comparar con justicia; no garantiza una salida idéntica. Sin valor por defecto: cada solicitud sortea de nuevo. No afecta el costo.

Valor predeterminado: Sin especificar

stopstring | arrayOpcional

Hasta 4 secuencias, como cadena o como arreglo. La respuesta termina en cuanto el modelo escribe una de ellas, y el texto que coincide no se devuelve. Sin valor por defecto. No cambia la tarifa: una respuesta cortada antes se cobra solo por los tokens que produjo.

Valor predeterminado: Sin especificar
Restricciones: minLength:1
minItems:1
maxItems:4

reasoning_effortstringOpcional

low, medium o high; medium es el valor por defecto. El trabajo rutinario va bien en low, y la solicitud que tiene que acertar se sube a high por separado. No hay una cifra publicada de tokens de pensamiento por nivel, así que no damos ninguna.

Valor predeterminado: "medium"
Valores permitidos: "low""medium""high"

max_tokensintegerOpcional

Limita la respuesta a 65.535; el valor por defecto es 16 384. Bájalo cuando de una lectura larga quieras una respuesta breve: el techo es un límite, no una meta. Los tokens de razonamiento también se cobran como salida, así que deja margen por encima de la respuesta visible que esperas.

Valor predeterminado: 16384
Restricciones: minimum:1
maximum:65535

{
  "type": "object",
  "required": [
    "messages"
  ],
  "x-pricing": {
    "billingMode": "formula",
    "variantFields": []
  },
  "properties": {
    "seed": {
      "type": "integer",
      "x-ui": {
        "order": 55,
        "widget": "number",
        "affects_price": false
      },
      "description": "Seed for the sampler, so a repeated request comes back close to the same."
    },
    "stop": {
      "type": [
        "string",
        "array"
      ],
      "x-ui": {
        "order": 65,
        "widget": "text",
        "affects_price": false
      },
      "items": {
        "type": "string",
        "minLength": 1
      },
      "maxItems": 4,
      "minItems": 1,
      "minLength": 1,
      "description": "Sequences that end the reply as soon as the model writes one; the matched text is not returned."
    },
    "tools": {
      "type": "array",
      "x-ui": {
        "order": 35,
        "widget": "json"
      },
      "items": {
        "type": "object"
      },
      "maxItems": 128,
      "description": "Tool definitions the model may call."
    },
    "top_p": {
      "type": "number",
      "x-ui": {
        "step": 0.01,
        "order": 40,
        "widget": "slider"
      },
      "default": 1,
      "maximum": 1,
      "minimum": 0.01,
      "description": "Nucleus sampling threshold. Lower values keep only the most likely tokens."
    },
    "messages": {
      "type": "array",
      "x-ui": {
        "order": 100,
        "widget": "chat-messages",
        "primary": true
      },
      "items": {
        "type": "object",
        "allOf": [
          {
            "if": {
              "required": [
                "reasoning_content"
              ]
            },
            "then": {
              "properties": {
                "role": {
                  "const": "assistant"
                }
              }
            }
          }
        ],
        "required": [
          "role"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Optional name identifying the speaker within its role."
          },
          "role": {
            "enum": [
              "system",
              "developer",
              "user",
              "assistant",
              "tool"
            ],
            "type": "string",
            "description": "Role of the message author."
          },
          "content": {
            "type": [
              "string",
              "array",
              "null"
            ],
            "items": {
              "oneOf": [
                {
                  "type": "object",
                  "required": [
                    "type",
                    "text"
                  ],
                  "properties": {
                    "text": {
                      "type": "string"
                    },
                    "type": {
                      "const": "text"
                    }
                  }
                },
                {
                  "type": "object",
                  "required": [
                    "type",
                    "image_url"
                  ],
                  "properties": {
                    "type": {
                      "const": "image_url"
                    },
                    "image_url": {
                      "type": "object",
                      "required": [
                        "url"
                      ],
                      "properties": {
                        "url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                {
                  "type": "object",
                  "required": [
                    "type",
                    "video_url"
                  ],
                  "properties": {
                    "type": {
                      "const": "video_url"
                    },
                    "video_url": {
                      "type": "object",
                      "required": [
                        "url"
                      ],
                      "properties": {
                        "url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                {
                  "type": "object",
                  "required": [
                    "type",
                    "audio_url"
                  ],
                  "properties": {
                    "type": {
                      "const": "audio_url"
                    },
                    "audio_url": {
                      "type": "object",
                      "required": [
                        "url"
                      ],
                      "properties": {
                        "url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                {
                  "type": "object",
                  "required": [
                    "type",
                    "input_audio"
                  ],
                  "properties": {
                    "type": {
                      "const": "input_audio"
                    },
                    "input_audio": {
                      "type": "object",
                      "required": [
                        "data",
                        "format"
                      ],
                      "properties": {
                        "data": {
                          "type": "string"
                        },
                        "format": {
                          "enum": [
                            "wav",
                            "mp3"
                          ],
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              ]
            },
            "description": "Message content, either plain text or a list of content parts."
          },
          "tool_calls": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "Tool calls the assistant requested in this message."
          },
          "tool_call_id": {
            "type": "string",
            "description": "Identifier of the tool call this message answers. Required on tool messages."
          },
          "reasoning_content": {
            "type": "string",
            "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
          }
        },
        "additionalProperties": false
      },
      "minItems": 1,
      "description": "Ordered conversation turns. Text content only on this endpoint."
    },
    "max_tokens": {
      "type": "integer",
      "x-ui": {
        "unit": "tokens",
        "order": 80,
        "widget": "number",
        "advanced": false,
        "affects_price": false
      },
      "default": 16384,
      "maximum": 65535,
      "minimum": 1,
      "description": "Maximum number of tokens to generate in the reply."
    },
    "temperature": {
      "type": "number",
      "x-ui": {
        "order": 50,
        "widget": "slider"
      },
      "default": 1,
      "maximum": 2,
      "minimum": 0,
      "description": "Sampling temperature. Higher values make the output more varied."
    },
    "tool_choice": {
      "type": [
        "string",
        "object"
      ],
      "x-ui": {
        "order": 30,
        "widget": "json"
      },
      "description": "Controls whether and which tool the model may call."
    },
    "response_format": {
      "type": "object",
      "x-ui": {
        "order": 25,
        "widget": "json"
      },
      "description": "Requested reply format, such as plain text or a JSON object."
    },
    "reasoning_effort": {
      "enum": [
        "low",
        "medium",
        "high"
      ],
      "type": "string",
      "x-ui": {
        "order": 70,
        "widget": "radio"
      },
      "default": "medium",
      "description": "How much the model works through the task before answering."
    }
  },
  "x-image-token-limit": 4500,
  "x-input-token-limit": 1048576,
  "additionalProperties": false,
  "x-max-tokens-includes-reasoning": true
}

Leer el resultado

Con stream en false, la solicitud devuelve directamente la respuesta completa: lee choices[].message, sin consultar ninguna tarea. Pon stream en true si tu cliente admite Server-Sent Events.

Ejemplo de respuesta completada

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1788652800,
  "model": "google/gemini-2.5-flash/chat",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Here is a concise summary of the release notes."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 14,
    "total_tokens": 46
  }
}

Esta respuesta solo ilustra la estructura. usage trae el número de tokens; el consumo y el costo reales dependen de tu solicitud.

SDK e integraciones

Usa SpicyAPI en tu app, terminal, asistente de IA o flujo visual. Elige una guía de configuración.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Comandos de terminal y scripts de automatización.

MCP

Claude Code · Cursor · Codex

Agent Skill

Instrucciones reutilizables para tu asistente de IA.

n8n

Nodos comunitarios para instalaciones propias y plantillas HTTP Request importables para n8n Cloud.

ComfyUI

Flujos de imagen, video y audio en un lienzo de nodos.

Más integraciones

SillyTavern Telegram / Discord App proxy OpenAI SDK LangChain Vercel AI SDK

Explorar flujos listos para usar

Es un modelo de chat, así que funciona donde se use la API de chat de OpenAI: mantén tu cliente, cambia la URL base y elige este modelo por su ID.

Conecta aquí cualquier cliente compatible con OpenAI

export OPENAI_BASE_URL="https://api.spicyapi.ai/v1"
export OPENAI_API_KEY="$SPICY_API_KEY"

aider --model openai/google/gemini-2.5-flash/chat

Todo lo que use la API de chat de OpenAI funciona de la misma manera: SDKs, Vercel AI SDK, LangChain, aider, Cline. El servidor MCP y la CLI spicyapi cubren tareas de medios asíncronas. Encontrarás la configuración de cada herramienta en el centro de desarrolladores.

Úsalo en SillyTavern y apps de roleplay

En SillyTavern, RisuAI, Agnai o cualquier app con una opción compatible con OpenAI, pega la URL base de abajo y tu clave de API, y elige google/gemini-2.5-flash/chat como modelo. Se aceptan llamadas desde el navegador, y los controles que este modelo no admite se ignoran en lugar de rechazarse.

Base URL: https://api.spicyapi.ai/v1
Model: google/gemini-2.5-flash/chat

Guía de SillyTavern RisuAI, Agnai y más Extensión de SillyTavern

Úsalo en ComfyUI

Instala los nodos de SpicyAPI desde ComfyUI Manager o con el comando de abajo y elige google/gemini-2.5-flash/chat en el nodo SpicyAPI Chat para usar este modelo dentro de un grafo de ComfyUI.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi

Ejemplos de workflows Guía de configuración Código en GitHub

El panel incrustado lee el mismo esquema que esta página, así que no puede desincronizarse de la API. Si tu documentación necesita contenido indexable, toma el JSON de /api/embed/models/ y renderízalo tú mismo.

<iframe src="https://spicyapi.ai/embed/es/models/gemini-2-5-flash/api?model=google%2Fgemini-2.5-flash%2Fchat" width="100%" height="560" loading="lazy" title="Ejemplo de solicitud" style="border:1px solid rgba(0,0,0,.12)"></iframe>

Abrir el panel

Playground

Enviar una solicitud

Autenticación de API

Parámetros de entrada

Leer el resultado

SDK e integraciones

Úsalo en SillyTavern y apps de roleplay

Úsalo en ComfyUI