I

Ideogram 4.5 API

Genera carteles, logotipos e imágenes con texto en 1K o 2K y tres niveles de calidad.

Comparar precios

Compara los precios públicos de los proveedores para la misma especificación de salida

Comparar otros modelos
Especificación de salidaProveedoresPrecio publicado del proveedorTiempo típicoProbar
1K
IdeogramOficial
Solo precio de referencia; no disponible a través de Yir
FAL
Tiempo típico 14 s
14 sProbar
2K
IdeogramOficial
Solo precio de referencia; no disponible a través de Yir
FAL
Probar
Notas de precios

Se cobra según el proveedor que realmente ejecuta la tarea. El failover puede cambiar de proveedor, lo que puede modificar el costo y el tiempo.

Usar la API

Deja el código a un agente de programación, genera en el chat con MCP o la Skill, o intégralo tú mismo con el SDK o la API compatible con OpenAI.

Deja que un agente de programación lo integre

Copia el prompt de integración o ábrelo directamente en Codex o Claude. El agente lee esta página y el contrato del modelo, y luego escribe en tu proyecto el envío, la espera y el manejo de resultados.

Añade el servidor MCP de Yir

Conéctalo a ChatGPT, Claude o Cursor, menciona @Yir y pide Ideogram 4.5 por su nombre. Primero te da el precio y solo genera cuando confirmas.

https://gateway.yir.ai/mcp
Pasos para cada cliente

Un comando para Claude Code

Crea una API key en la consola, guárdala como YIR_API_KEY y ejecuta:

claude mcp add --transport http yir https://gateway.yir.ai/mcp --header "Authorization: Bearer $YIR_API_KEY"

Instala la Skill de Yir

Define YIR_API_KEY donde se ejecuta tu agente, añade la Skill a Claude Code, Codex u otro agente de programación y di “usa Ideogram 4.5 en Yir para crear…”.

npx skills add yir-ai/skills
Sobre la Skill de Yir

Instala el SDK oficial con tu gestor de paquetes o copia el fragmento de código de abajo para empezar

$pnpm add @yir-ai/sdk
import { createNodeYirClient } from "@yir-ai/sdk/server";
 
// Lee YIR_API_KEY del entorno por defecto: process.env.YIR_API_KEY
const client = createNodeYirClient();
 
// 1. Envía una tarea de generación de imagen
const job = await client.submitImage({
model: "ideogram/ideogram-4.5",
input: {
type: "text",
prompt: "Crea un póster de producto de agua con gas de cítricos: una botella de vidrio transparente y naranjas frescas, fondo crema, luz natural suave y una etiqueta de producto nítida",
},
parameters: {
quality: "medium",
resolution: "1K",
aspect_ratio: "1:1",
n: 1,
},
});
 
// 2. Espera a que la tarea termine y entregue el resultado
const result = await client.waitForJob(job.id);
console.log("Archivos entregados:", result.result);
if (result.result && "files" in result.result) {
for (const file of result.result.files) {
console.log("->", file.url);
}
}

Los proyectos que ya usan el protocolo de OpenAI, o gateways como new-api, solo necesitan una nueva Base URL y una nueva clave. Guía de compatibilidad con OpenAI

base_url del SDK de OpenAI
https://gateway.yir.ai/openai/v1
Base URL del canal en new-api
https://gateway.yir.ai/openai
Clave
API Key de Yir
ID del modelo
ideogram/ideogram-4.5
curl https://gateway.yir.ai/openai/v1/images/generations \
  -H "Authorization: Bearer $YIR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ideogram/ideogram-4.5",
    "prompt": "Crea un póster de producto de agua con gas de cítricos: una botella de vidrio transparente y naranjas frescas, fondo crema, luz natural suave y una etiqueta de producto nítida",
    "resolution": "1K",
    "aspect_ratio": "1:1",
    "quality": "medium"
  }'

Resumen de parámetros

Parámetros comunes; los límites dependen del modelo actual y del proveedor seleccionado

Documentación de la API
Resolución
resolution
  • 1K
  • 2K

Nivel de resolución de salida. Las resoluciones más altas dan mayor nitidez y el precio aumenta en consecuencia

Relación de aspecto
aspect_ratio
  • 1:1
  • 4:3
  • 3:4
  • 16:9
  • 9:16

Proporción geométrica. Elígela según el medio de destino (vertical, banner o cuadrado)

Modo de entrada
input_mode
  • Entrada de texto

Genera contenido solo a partir de prompts en lenguaje natural

Preguntas frecuentes

Empieza a crear con Ideogram 4.5

Compara la misma especificación entre proveedores y llama a varios proveedores desde una sola billetera.