Conversor de Formato de Prompt

Convierte prompts entre formatos de OpenAI, Anthropic Claude, Google Gemini y otros proveedores de IA

~/prompt-format-converter

Pega un prompt en formato OpenAI, Anthropic o Google Gemini para convertirlo.

Detecta automáticamente el formato de origen. Gestiona arrays de mensajes, system prompts y mapeo de roles.

¿Qué es un Conversor de Formato de Prompt?

Un conversor de formato de prompt transforma prompts de IA entre las diferentes estructuras JSON que requieren los principales proveedores de IA — OpenAI, Anthropic Claude y Google Gemini. Aunque los tres proveedores usan interfaces de chat basadas en mensajes, sus formatos de API difieren en cómo estructuran los mensajes, manejan los system prompts y nombran los roles.

Migrar entre proveedores de IA es cada vez más común a medida que los equipos evalúan diferentes modelos por coste, calidad y características. Reformatear manualmente las plantillas de prompt es tedioso y propenso a errores, especialmente para conversaciones complejas de múltiples turnos con system prompts. Este conversor maneja la transformación estructural automáticamente, destacando exactamente qué cambió.

La herramienta detecta automáticamente tu formato de origen, convierte a cualquier proveedor de destino y muestra notas de conversión explicando cada transformación. Todo el procesamiento ocurre en tu navegador — no se envían datos a ningún servidor.

Cómo Usar Este Conversor

  1. Pega tu prompt — Copia el prompt JSON de tu código base. El conversor acepta cuerpos completos de solicitudes de API, arrays de mensajes o cualquier estructura JSON de prompt válida.
  2. Verifica el formato detectado — La herramienta detecta automáticamente si tu entrada es formato OpenAI, Anthropic o Google y muestra una etiqueta indicadora.
  3. Selecciona el formato de destino — Elige el proveedor al que quieres convertir desde el menú desplegable.
  4. Revisa la salida — El JSON convertido aparece con formato adecuado. Consulta las notas de conversión debajo de la salida para entender qué cambió.
  5. Copia y usa — Haz clic en "Copiar Salida" para copiar el JSON formateado listo para usar en la API de tu proveedor de destino.

Diferencias Clave Entre los Formatos de API de IA

Ubicación del System Prompt

La diferencia más significativa entre proveedores es dónde se coloca el system prompt. OpenAI lo pone en el array de mensajes como un mensaje con `role: "system"`. Anthropic requiere un campo `system` separado en el nivel superior. Google usa `system_instruction` con un array de parts. Colocar mal el system prompt es la causa #1 de errores de migración.

Estructura de Mensajes

OpenAI y Anthropic usan estructuras de mensaje similares con campos `role` y `content`. La API de Gemini de Google usa `contents` (plural) con una estructura interna diferente — cada mensaje tiene `parts` (un array) en lugar de una simple cadena de contenido.

Nomenclatura de Roles

OpenAI y Anthropic usan los roles "user" y "assistant". Google usa "user" pero reemplaza "assistant" con "model". Esta es una diferencia sutil pero importante — usar "assistant" en una solicitud a la API de Gemini causará un error.

Parámetros Requeridos

Anthropic requiere `max_tokens` en cada solicitud de API — no es opcional. OpenAI tiene un valor por defecto específico del modelo. Google tiene una configuración de generación opcional. El conversor añade los parámetros requeridos automáticamente.

Escenarios Comunes de Migración

  • OpenAI a Anthropic — La ruta de migración más común. El system prompt se mueve fuera del array de mensajes, max_tokens debe añadirse explícitamente.
  • OpenAI a Google — Requiere reestructurar los mensajes al formato contents/parts y mapear el rol assistant a model.
  • Anthropic a OpenAI — El system prompt vuelve al array de mensajes como primer mensaje. max_tokens se vuelve opcional.
  • Soporte multi-proveedor — Los equipos que construyen aplicaciones agnósticas de proveedor a menudo necesitan mantener prompts en múltiples formatos simultáneamente.

Preguntas Frecuentes

¿Qué formatos admite este conversor?

El conversor admite tres formatos principales de API de IA: Chat Completions de OpenAI (array de mensajes con roles system/user/assistant), API de Messages de Anthropic (campo system separado + array de mensajes) y Google Gemini (system_instruction + array de contents con parts). También acepta arrays de mensajes simples sin wrapper de proveedor.

¿Cómo maneja el conversor los system prompts?

El manejo del system prompt es la principal diferencia entre formatos. OpenAI incluye los mensajes system en el array de mensajes. Anthropic requiere un campo "system" separado fuera de los mensajes. Google usa un objeto "system_instruction" con un array de parts. El conversor mueve automáticamente los system prompts a la ubicación correcta para cada formato de destino.

¿El conversor maneja definiciones de tool/function?

La versión actual se centra en la conversión de formato de mensajes — system prompts, mensajes de usuario, respuestas del asistente y mapeo de roles. Para la conversión de definiciones de tool/function entre proveedores, usa nuestro Linter de Definiciones de Tool/Function que valida definiciones en los tres proveedores y destaca las diferencias de formato.

¿Qué es el rol "model" en el formato de Google Gemini?

Google Gemini usa "model" en lugar de "assistant" para las respuestas de IA. Al convertir de OpenAI o Anthropic a formato Google, todos los roles "assistant" se mapean automáticamente a "model". Al convertir de Google a otros formatos, "model" se mapea de vuelta a "assistant". El conversor maneja esto automáticamente.

¿Por qué la salida de Anthropic incluye max_tokens?

La API de Messages de Anthropic requiere el parámetro "max_tokens" en cada solicitud — no es opcional. El conversor añade un valor por defecto de 1024 para asegurar que la salida sea una solicitud válida de la API de Anthropic. Deberías ajustar este valor según la longitud de respuesta esperada antes de usarlo en producción.

Herramientas Relacionadas

Más herramientas para trabajar con APIs de IA:

Herramientas Relacionadas