title: "Imagen SVG del Horóscopo Natal" description: "POST /birth-chart/svg - Generate natal wheel SVG via in-house engine."

|| num_sys | string | No | Optional numerology system. Supported values: pythagorean, chaldean, vedic. Aliases also supported. Defaults to pythagorean. |¶

Imagen SVG del Horóscopo Natal¶

El punto final Imagen SVG del Horóscopo Natal devuelve la salida SVG de la rueda natal del motor interno, con soporte completo para la opción de renderizado de la rueda.

Soporte de idiomas: Admite los 26 idiomas. Las respuestas que no estén en inglés se traducen sobre la marcha mediante el asistente de traducción (LibreTranslate por defecto; DeepL BYOK, MyMemory o Google seleccionables por solicitud).

Punto Final¶

Cuerpo de la Solicitud¶

Campos de Nivel Superior¶

birth Campos del Objeto¶

wheel Campos del objeto¶

Temas personalizados de la rueda (theme: "custom" + theme_palette)¶

Los colores y la transparencia de la rueda son totalmente personalizables: establece wheel.theme en custom y pasa un objeto theme_palette. Solo se sobrescriben las claves que proporciones — todo lo demás vuelve a la paleta base oscura night.

json { "wheel": { "theme": "custom", "accent_color": "#3ddd77", "theme_palette": { "bg_0": "#0b1730", "bg_1": "#101d38", "bg_2": "#0a1326", "panel_fill": "#0c1730", "panel_opacity": 0.78, "sign_line": "#2b3f63", "ring_inner": "#34486a", "center_fill": "#0d1832", "center_stroke": "#1e2f4a", "divider": "#2a3f64", "subtitle": "#8fa2c2", "text": "#dbe7f8", "soft_text": "#9fb0cd" } } }

Claves de theme_palette¶

Reglas¶

• Sobrescrituras parciales — solo se aplican las claves que proporciones; el resto vuelve a la paleta base del tema (custom usa la base oscura night).
• Los valores de color deben ser hexadecimales de 7 caracteres (#rrggbb); panel_opacity debe ser un float en [0, 1]. Claves desconocidas o valores no válidos → error de validación 422.
• theme_palette es obligatorio cuando theme es "custom".
• En temas con nombre (p. ej. paper) theme_palette actúa como sobrescritura parcial.
• Solo cambian los elementos visuales de la rueda — los cálculos de la carta, las posiciones y los aspectos nunca se ven afectados.

Ejemplo de tema personalizado¶

bash curl --request POST \ --url "https://api.numerologyapi.com/api/v1/birth-chart/svg" \ --header "X-API-Key: YOUR_API_KEY" \ --header "Content-Type: application/json" \ --data '{ "birth": { "date": "1992-07-16", "time": "13:45", "coordinates": { "latitude": 40.7128, "longitude": -74.006 }, "timezone": "America/New_York" }, "wheel": { "theme": "custom", "accent_color": "#3ddd77", "theme_palette": { "bg_0": "#0b1730", "bg_1": "#101d38", "bg_2": "#0a1326", "panel_fill": "#0c1730", "panel_opacity": 0.78, "sign_line": "#2b3f63", "ring_inner": "#34486a", "center_fill": "#0d1832", "center_stroke": "#1e2f4a", "divider": "#2a3f64", "subtitle": "#8fa2c2", "text": "#dbe7f8", "soft_text": "#9fb0cd" } } }'

Precedencia de theme heredado en este punto final¶

El campo theme de nivel superior heredado aún está soportado:

1. Un theme de nivel superior explícito (p. ej. "theme": "dark") tiene prioridad.
2. De lo contrario, se usa wheel.theme (p. ej. "custom" + theme_palette).
3. De lo contrario, se aplica el valor predeterminado histórico classic (→ paper).

Alias heredados: classic → paper, light → day, dark → night, dark-high-contrast → obsidian.

Ejemplo en Modo Personalizado (Recomendado)¶

bash curl --request POST \ --url "https://api.numerologyapi.com/api/v1/birth-chart/svg?num_sys=pythagorean"" \ --header "X-API-Key: YOUR_API_KEY" \ --header "Content-Type: application/json" \ --data '{ "sign": "CANCER", "target_date": "2026-04-08", "zodiac_system": "tropical", "ayanamsa": "lahiri", "house_system": "placidus", "node_type": "true", "tenant_id": "docs-smoke", "user_name": "Docs Smoke User", "output_mode": "wheel_only", "include_wheel_svg": true, "split": false, "round_wheel_only": true, "transparent_background": true, "svg_compression": "none", "language": "en", "locale": "en-US", "birth": { "date": "1992-07-16", "time": "13:45", "coordinates": { "latitude": 40.7128, "longitude": -74.006 }, "timezone": "America/New_York" }, "wheel": { "preset_id": "minimal_app", "theme": "paper", "panel_layout": "bottom", "size": 720 } , "num_sys": "pythagorean" }'

Ejemplo en Modo Público (General, basado en señales)¶

bash curl --request POST \ --url "https://api.numerologyapi.com/api/v1/birth-chart/svg?num_sys=pythagorean"" \ --header "X-API-Key: YOUR_API_KEY" \ --header "Content-Type: application/json" \ --data '{ "sign": "CANCER", "target_date": "2026-04-08", "output_mode": "wheel_only", "split": false, "round_wheel_only": true, "language": "en", "locale": "en-US", "wheel": { "preset_id": "minimal_app", "theme": "paper", "size": 720 } , "num_sys": "pythagorean" }'

Ejemplo de Respuesta¶

Ejemplos de SVG Renderizados¶

Preestablecido de Impresión (Fusionar Override) Con Líneas de Aspecto Habilitadas¶

Ejemplo de Zenith Tropical¶

Ejemplo de Obsidiana Sidereal¶