Especificación v0.5.0 · 35+ Proveedores

La Especificación
Que Impulsa Todo.

AI-Protocol separa "qué hacer" de "cómo hacerlo". La especificación V2 utiliza una arquitectura de tres capas: Protocolo Principal → Extensiones de Capacidad → Perfil de Entorno. Los manifiestos de proveedores declaran endpoints, autenticación, mapeos de parámetros, decodificadores de streaming y manejo de errores — todo en YAML, todo validado por JSON Schema.

Leer la Documentación Ver en GitHub

Arquitectura V2 de Tres Capas

V2 organiza la especificación en tres capas: Protocolo Principal (chat base, streaming, errores) → Extensiones de Capacidad (herramientas, visión, salida estructurada) → Perfil de Entorno (configuración específica del proveedor). Los manifiestos V2-alpha están disponibles para OpenAI, Anthropic y Gemini.

Qué Contiene

spec.yaml

Especificación Principal

Define parámetros estándar (temperature, max_tokens), eventos de streaming (PartialContentDelta, ToolCallStarted), clases de error (13 tipos) y políticas de reintento.

providers/

35+ Manifiestos de Proveedores

Cada archivo YAML declara el endpoint del proveedor, autenticación, mapeos de parámetros, configuración del decodificador SSE, clasificación de errores, cabeceras de límite de tasa y capacidades.

models/

Registro de Modelos

Instancias de modelos con referencias a proveedores, ventanas de contexto, banderas de capacidad y precios por token. GPT, Claude, Gemini, DeepSeek, Qwen y más.

schemas/

Validación JSON Schema

Las definiciones JSON Schema 2020-12 validan cada manifiesto. Los pipelines CI aseguran la corrección de la configuración. Cero sorpresas en tiempo de ejecución.

Un Manifiesto de Proveedor

Cada proveedor se describe mediante un manifiesto YAML. Declara todo lo que un runtime necesita para comunicarse con el proveedor — endpoint, autenticación, mapeo de parámetros, decodificador de streaming, manejo de errores y capacidades.

Los runtimes leen estos manifiestos y "compilan" las peticiones de usuario en llamadas HTTP específicas del proveedor. Sin ramas if provider == "openai" en ningún lugar.

Endpoint y Auth — URL base, protocolo, tokens bearer, cabeceras de API key
Mapeo de Parámetros — Nombres estándar a campos JSON específicos del proveedor
Decodificador de Streaming — Formato SSE/NDJSON, reglas de extracción de eventos JSONPath
Clasificación de Errores — Códigos de estado HTTP a 13 tipos de error estándar

id: anthropic
protocol_version: "0.5.0"
endpoint:
  base_url: "https://api.anthropic.com/v1"
  chat_path: "/messages"
auth:
  type: bearer
  token_env: "ANTHROPIC_API_KEY"
parameter_mappings:
  temperature: "temperature"
  max_tokens: "max_tokens"
  stream: "stream"
streaming:
  decoder:
    format: "anthropic_sse"
  event_map:
    - match: "$.type == 'content_block_delta'"
      emit: "PartialContentDelta"
error_classification:
  by_http_status:
    "429": "rate_limited"
    "401": "authentication"
capabilities:
  streaming: true
  tools: true
  vision: true

Dónde Encaja el Protocolo

AI-Protocol es la capa de fundamento. Los runtimes lo consumen. Las aplicaciones consumen runtimes.

Proveedores Soportados

Cada proveedor tiene un manifiesto YAML completo con endpoint, autenticación, mapeos de parámetros, decodificador de streaming, manejo de errores y banderas de capacidad.

OpenAI

Anthropic

Google Gemini

Groq

Mistral

DeepSeek

Qwen

Cohere

Azure OpenAI

Together AI

Perplexity

NVIDIA

Fireworks AI

Replicate

OpenRouter

DeepInfra

AI21 Labs

Cerebras

Lepton AI

Zhipu GLM

Doubao

Baidu ERNIE

Tencent Hunyuan

iFlytek Spark

Moonshot

MiniMax

Baichuan

Yi / 01.AI

SiliconFlow

SenseNova

Explorar el Protocolo

Lee la especificación, explora los manifiestos de proveedores o contribuye con un nuevo proveedor.

Documentación Contribuir un Proveedor

La Especificación Que Impulsa Todo.