Skip to main content

Output Components

Output components (SmartHopper → C. Output) receive one or more Input > wires from Input components, call the selected AI provider, and extract a typed Grasshopper output — without manual string parsing.

Every output component also includes the standard Settings (S) and Run? (R) inputs and emits per-branch JSON usage Metrics (M).

Catalog​

IconComponentNicknameExtra inputsOutputsPreview
AI to Text iconAI to TextAI→Text—Text (T)ai-to-text
AI to Text List iconAI to Text ListAI→TextListFallback (F, optional list)Text List (T), Used Fallback (UF)ai-to-text-list
AI to Markdown iconAI to MarkdownAI→MD—Markdown (M)ai-to-markdown
AI to Number icon AI to Number List iconAI to Number / AI to Number ListAI→Num / AI→NumListFallback (F, optional)Number / Number List (N), Used Fallback (UF)ai-to-number ai-to-number-list
AI to Integer icon AI to Integer List iconAI to Integer / AI to Integer ListAI→Int / AI→IntListFallback (F, optional)Integer / Integer List (I), Used Fallback (UF)ai-to-integer ai-to-integer-list
AI to Boolean icon AI to Boolean List iconAI to Boolean / AI to Boolean ListAI→Bool / AI→BoolListFallback (F, optional)Boolean / Boolean List (B), Used Fallback (UF)ai-to-boolean ai-to-boolean-list
AI to JSON iconAI to JSONAI→JSONSchema (S, optional), Fallback (F, optional)JSON (J), Used Fallback (UF)ai-to-json
AI to GhJSON iconAI to GhJSONAI→GhJSONPlace on Canvas (P, optional)GhJSON (G)ai-to-ghjson
AI to Image iconAI to ImageAI→ImgSize (Sz), Aspect Ratio (AR)Image (I)ai-to-image
AI to Speech iconAI to SpeechAI→SpeechVoice (V, optional), Speed (Sp, 0.25–4.0)Audio (A)ai-to-speech
AI to Script iconAI to ScriptAI→ScriptLanguage (L, python or csharp)Script (S)ai-to-script

Typed outputs & fallbacks​

Because AI to Number, AI to Integer, and AI to Boolean output native Grasshopper types, you can wire them directly into math, logic, or domain components:

Text to AI feeding an AI to Integer output

Numeric, boolean, list, and JSON output components include an optional Fallback (F) input and a Used Fallback (UF) boolean output so your downstream definition stays predictable even if a model produces an unparsable response.

Structured JSON output​

Wire a schema from the JSON Schema components into AI to JSON's Schema (S) input to constrain the response to your exact property structure, then extract fields with JSON Get Value.

Usage metrics​

Every output component emits Metrics (M) — one JSON entry per branch with token counts, completion time, model, and estimated cost. Wire it into Deconstruct SmartHopper Metrics or Combine SmartHopper Metrics to track usage across your definition.