Guías de desarrollo

Una vez que la API responde correctamente, busque la guía correspondiente a lo que necesita hacer. Cada guía incluye ejemplos ejecutables; los protocolos que cubre cada una se indican en la propia página.

Funciones básicas

Controle «cómo responde» el modelo: salida progresiva, llamadas a sus funciones, respuestas con un formato fijo y comprensión de imágenes.

Quiero…	Guía	Puntos clave
Mostrar la respuesta a medida que se genera, sin esperar al texto completo	Respuestas en streaming	Envío por SSE; incluye reconexión y llamada a funciones en streaming
Que el modelo llame a mis funciones o a APIs externas	Llamada a funciones	Definición de `tools`; admite llamadas en paralelo y `tool_choice`
Que la salida sea siempre JSON	Salida estructurada	Restricciones con JSON Mode y JSON Schema
Que el modelo analice imágenes	Comprensión visual	URL de imagen o Base64; permite comparar varias imágenes

Costos y estabilidad

Reduzca el costo de las mismas solicitudes y evite interrupciones cuando surjan problemas.

Quiero…	Guía	Puntos clave
Reducir costos al enviar repetidamente prompts largos	Caché de prompts	Almacena en caché los prefijos repetidos y reduce el costo en tokens y la latencia
Reutilizar un contexto extenso de Gemini entre solicitudes	Caché explícito de Gemini	Crea y referencia cachedContents de forma explícita, con aciertos más predecibles
Elegir qué proveedor procesa la solicitud	Enrutamiento de proveedores	Enrutamiento automático por defecto; `provider.type` para especificarlo cuando sea necesario
Cambiar automáticamente a un modelo de respaldo si el principal falla	Respaldo automático	`provider.fallback`, hasta 3 modelos alternativos

Cuando algo falla

Si una solicitud falla, se limita su tasa o se bloquea, empiece por aquí.

Si encuentra…	Guía	Puntos clave
Un error y quiere saber cómo tratarlo y si conviene reintentar	Manejo de errores	Códigos de estado, formato de errores, retroceso exponencial y configuración de timeouts
429 Too Many Requests	Límites de tasa	100 RPM por defecto, agregado por equipo; consulte las cabeceras de respuesta para saber cuánto esperar
Una solicitud bloqueada o suspendida por la seguridad de contenido	Seguridad de contenido	Reglas de activación, duración de la suspensión y cómo recuperar el acceso

SDK y frameworks

Para integrar OfoxAI en su código con un SDK o framework existente, solo es necesario cambiar la URL de la API y la API Key.

Utilizo…	Guía
El SDK oficial de OpenAI (migración de un proyecto existente)	OpenAI SDK
LangChain	LangChain
LlamaIndex	LlamaIndex