[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-letta-image-generation":3,"mdc-frs680-key":40,"related-repo-letta-image-generation":1670,"related-org-letta-image-generation":1764},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":12,"stars":22,"repoUrl":23,"updatedAt":24,"license":25,"forks":26,"topics":27,"repo":35,"sourceUrl":38,"mdContent":39},"image-generation","generate images from text prompts","Generate images from text prompts (and optionally edit\u002Fremix input images). Use when the user asks to create, generate, draw, render, or edit an image, illustration, logo, icon, diagram, or photo.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},"letta","Letta","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fletta.png","letta-ai",[13,17,20],{"name":14,"slug":15,"type":16},"Graphics","graphics","tag",{"name":18,"slug":19,"type":16},"Creative","creative",{"name":21,"slug":4,"type":16},"Image Generation",2831,"https:\u002F\u002Fgithub.com\u002Fletta-ai\u002Fletta-code","2026-07-13T06:23:06.189403",null,329,[28,29,30,31,32,8,33,34],"agent-memory","ai","claude","codex","continual-learning","memgpt","stateful-agents",{"repoUrl":23,"stars":22,"forks":26,"topics":36,"description":37},[28,29,30,31,32,8,33,34],"Stateful agents that are like people, with memory, identity, and the ability to learn and adapt","https:\u002F\u002Fgithub.com\u002Fletta-ai\u002Fletta-code\u002Ftree\u002FHEAD\u002Fsrc\u002Fskills\u002Fbuiltin\u002Fimage-generation","---\nname: image-generation\ndescription: Generate images from text prompts (and optionally edit\u002Fremix input images). Use when the user asks to create, generate, draw, render, or edit an image, illustration, logo, icon, diagram, or photo.\n---\n\n# Image Generation\n\nGenerate images via Letta's hosted endpoint `POST \u002Fv1\u002Fimages\u002Fgenerations`. The API\nusually returns base64 image bytes, but some providers return signed image URLs;\nsave either form to a local image file before replying.\n\n## Example\n\nGenerate the image, save it locally, then show it inline:\n\n```bash\nbase_url=\"${LETTA_BASE_URL%\u002F}\"\n\ncurl -sS -X POST \"$base_url\u002Fv1\u002Fimages\u002Fgenerations\" \\\n  -H \"Authorization: Bearer $LETTA_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"provider\":\"gemini\",\"prompt\":\"a friendly robot mascot waving, flat vector logo, mint green background\",\"n\":1}' \\\n  > image-response.json\n\npython3 - \u003C\u003C'PY'\nimport base64, json, urllib.request\n\nwith open(\"image-response.json\") as f:\n    response = json.load(f)\n\nimage = response[\"images\"][0]\nif image.get(\"b64_json\"):\n    data = base64.b64decode(image[\"b64_json\"])\nelse:\n    data = urllib.request.urlopen(image[\"url\"]).read()\n\nwith open(\"robot-mascot.png\", \"wb\") as f:\n    f.write(data)\n\nprint(\"saved robot-mascot.png; credits:\", response[\"billing\"][\"credits_charged\"])\nPY\n```\n\nIn Bash tools launched by Letta Code, use the runtime-provided\n`LETTA_BASE_URL` and `LETTA_API_KEY` together for Letta API calls. Build URLs\nrelative to `${LETTA_BASE_URL%\u002F}` and send `Authorization: Bearer $LETTA_API_KEY`.\nDo not hardcode `https:\u002F\u002Fapi.letta.com`: Desktop and remote runtimes may provide\na proxy base URL, and the credential may only be valid through that URL. If\neither variable is missing, the user needs to authenticate with Letta Cloud (or\nprovide a Letta API key); do **not** ask for an OpenAI\u002FGemini provider key. This\nendpoint also does not use `\u002Fconnect` BYOK providers — the only `provider` values\nsupported here are `flux`, `gemini`, and `openai`.\n\nThen **show the image to the user** by embedding the saved file in your reply:\n\n```markdown\nHere's the mascot:\n\n![a friendly robot mascot waving, flat vector logo](.\u002Frobot-mascot.png)\n```\n\nThe Letta Code UI renders local file paths in markdown image tags, so the image\nappears inline. **Always display generated images this way** — don't just report\nthe path, and never paste the raw base64 \u002F a `data:` URI. The markdown path must\nmatch where you saved the file. For `n > 1`, save each image to its own file and\nembed each on its own line. Also tell the user the `credits_charged`.\n\n## Request body\n\n| Field | Type | Notes |\n|-------|------|-------|\n| `provider` | `\"flux\"` \\| `\"gemini\"` \\| `\"openai\"` | Required. |\n| `prompt` | string | Required, 1–32000 chars. |\n| `model` | string | Optional; defaults per provider (below). |\n| `n` | int 1–4 | Optional, default 1. Request variations in one call. |\n| `size` | string | Optional, e.g. `\"1024x1024\"` (OpenAI). |\n| `quality` | `low`\\|`medium`\\|`high`\\|`auto` | Optional (OpenAI; higher = more credits). |\n| `output_format` | `png`\\|`jpeg`\\|`webp` | Optional (OpenAI). |\n| `input_images` | string[] (max 14) | Optional. Base64 **data URLs** for edit\u002Fremix. |\n| `seed` | int | Optional. |\n\n| Provider | Default model | Use for |\n|----------|---------------|---------|\n| `flux` | `flux-2-pro` | Default for normal text-to-image. High-quality general image generation; commonly returns signed URLs. |\n| `gemini` | `gemini-3-pro-image` | Strong prompt adherence, image editing\u002Fremix. |\n| `openai` | `gpt-image-2` | Photoreal output, explicit `size`\u002F`quality`\u002F`output_format`. |\n\nDefault to `flux` for normal text-to-image requests. Use `gemini` when the user\nprovides input images or wants image editing\u002Fremix. Use `openai` when the user\nwants photoreal output or a specific size\u002Fquality.\n\n## Response\n\n```json\n{\n  \"provider\": \"gemini\",\n  \"model\": \"gemini-3-pro-image\",\n  \"images\": [{ \"b64_json\": \"\u003Cbase64>\", \"mime_type\": \"image\u002Fpng\" }],\n  \"billing\": { \"credits_charged\": 12, \"...\": \"...\" }\n}\n```\n\nEach `images[]` entry has either `b64_json` or `url`, plus `mime_type`. Gemini\nalways returns `b64_json`. Flux commonly returns a signed `url`; download it to\nyour local image file immediately because signed URLs expire. If OpenAI returns a\n`url`, download that URL instead of base64-decoding.\n\n## Editing \u002F remixing images\n\nPass source images in `input_images` as base64 **data URLs**\n(`data:\u003Cmime>;base64,\u003Cdata>`) and describe the edit in `prompt`. Gemini handles\nmulti-image edits well. To build a data URL from a local file:\n\n```bash\nDATA_URL=\"data:image\u002Fpng;base64,$(base64 \u003C input.png | tr -d '\\n')\"\n```\n\n## Notes\n\n- **Billing**: every success charges credits; don't loop needlessly, and report\n  `credits_charged`.\n- **Errors**: `402` = insufficient credits (`credits_required` in body); `400`\u002F`500`\n  return `{ \"message\": \"...\" }` — surface it to the user.\n- Only `flux`, `gemini`, and `openai` are supported here.\n",{"data":41,"body":42},{"name":4,"description":6},{"type":43,"children":44},"root",[45,52,67,74,79,454,546,558,611,646,652,962,1083,1109,1115,1394,1450,1456,1489,1565,1570,1664],{"type":46,"tag":47,"props":48,"children":49},"element","h1",{"id":4},[50],{"type":51,"value":21},"text",{"type":46,"tag":53,"props":54,"children":55},"p",{},[56,58,65],{"type":51,"value":57},"Generate images via Letta's hosted endpoint ",{"type":46,"tag":59,"props":60,"children":62},"code",{"className":61},[],[63],{"type":51,"value":64},"POST \u002Fv1\u002Fimages\u002Fgenerations",{"type":51,"value":66},". The API\nusually returns base64 image bytes, but some providers return signed image URLs;\nsave either form to a local image file before replying.",{"type":46,"tag":68,"props":69,"children":71},"h2",{"id":70},"example",[72],{"type":51,"value":73},"Example",{"type":46,"tag":53,"props":75,"children":76},{},[77],{"type":51,"value":78},"Generate the image, save it locally, then show it inline:",{"type":46,"tag":80,"props":81,"children":86},"pre",{"className":82,"code":83,"language":84,"meta":85,"style":85},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","base_url=\"${LETTA_BASE_URL%\u002F}\"\n\ncurl -sS -X POST \"$base_url\u002Fv1\u002Fimages\u002Fgenerations\" \\\n  -H \"Authorization: Bearer $LETTA_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"provider\":\"gemini\",\"prompt\":\"a friendly robot mascot waving, flat vector logo, mint green background\",\"n\":1}' \\\n  > image-response.json\n\npython3 - \u003C\u003C'PY'\nimport base64, json, urllib.request\n\nwith open(\"image-response.json\") as f:\n    response = json.load(f)\n\nimage = response[\"images\"][0]\nif image.get(\"b64_json\"):\n    data = base64.b64decode(image[\"b64_json\"])\nelse:\n    data = urllib.request.urlopen(image[\"url\"]).read()\n\nwith open(\"robot-mascot.png\", \"wb\") as f:\n    f.write(data)\n\nprint(\"saved robot-mascot.png; credits:\", response[\"billing\"][\"credits_charged\"])\nPY\n","bash","",[87],{"type":46,"tag":59,"props":88,"children":89},{"__ignoreMap":85},[90,123,133,184,215,240,268,282,290,314,323,331,340,349,357,366,375,384,393,402,410,419,428,436,445],{"type":46,"tag":91,"props":92,"children":95},"span",{"class":93,"line":94},"line",1,[96,102,108,113,118],{"type":46,"tag":91,"props":97,"children":99},{"style":98},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[100],{"type":51,"value":101},"base_url",{"type":46,"tag":91,"props":103,"children":105},{"style":104},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[106],{"type":51,"value":107},"=",{"type":46,"tag":91,"props":109,"children":110},{"style":104},[111],{"type":51,"value":112},"\"${",{"type":46,"tag":91,"props":114,"children":115},{"style":98},[116],{"type":51,"value":117},"LETTA_BASE_URL",{"type":46,"tag":91,"props":119,"children":120},{"style":104},[121],{"type":51,"value":122},"%\u002F}\"\n",{"type":46,"tag":91,"props":124,"children":126},{"class":93,"line":125},2,[127],{"type":46,"tag":91,"props":128,"children":130},{"emptyLinePlaceholder":129},true,[131],{"type":51,"value":132},"\n",{"type":46,"tag":91,"props":134,"children":136},{"class":93,"line":135},3,[137,143,149,154,159,164,169,174,179],{"type":46,"tag":91,"props":138,"children":140},{"style":139},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[141],{"type":51,"value":142},"curl",{"type":46,"tag":91,"props":144,"children":146},{"style":145},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[147],{"type":51,"value":148}," -sS",{"type":46,"tag":91,"props":150,"children":151},{"style":145},[152],{"type":51,"value":153}," -X",{"type":46,"tag":91,"props":155,"children":156},{"style":145},[157],{"type":51,"value":158}," POST",{"type":46,"tag":91,"props":160,"children":161},{"style":104},[162],{"type":51,"value":163}," \"",{"type":46,"tag":91,"props":165,"children":166},{"style":98},[167],{"type":51,"value":168},"$base_url",{"type":46,"tag":91,"props":170,"children":171},{"style":145},[172],{"type":51,"value":173},"\u002Fv1\u002Fimages\u002Fgenerations",{"type":46,"tag":91,"props":175,"children":176},{"style":104},[177],{"type":51,"value":178},"\"",{"type":46,"tag":91,"props":180,"children":181},{"style":98},[182],{"type":51,"value":183}," \\\n",{"type":46,"tag":91,"props":185,"children":187},{"class":93,"line":186},4,[188,193,197,202,207,211],{"type":46,"tag":91,"props":189,"children":190},{"style":145},[191],{"type":51,"value":192},"  -H",{"type":46,"tag":91,"props":194,"children":195},{"style":104},[196],{"type":51,"value":163},{"type":46,"tag":91,"props":198,"children":199},{"style":145},[200],{"type":51,"value":201},"Authorization: Bearer ",{"type":46,"tag":91,"props":203,"children":204},{"style":98},[205],{"type":51,"value":206},"$LETTA_API_KEY",{"type":46,"tag":91,"props":208,"children":209},{"style":104},[210],{"type":51,"value":178},{"type":46,"tag":91,"props":212,"children":213},{"style":98},[214],{"type":51,"value":183},{"type":46,"tag":91,"props":216,"children":218},{"class":93,"line":217},5,[219,223,227,232,236],{"type":46,"tag":91,"props":220,"children":221},{"style":145},[222],{"type":51,"value":192},{"type":46,"tag":91,"props":224,"children":225},{"style":104},[226],{"type":51,"value":163},{"type":46,"tag":91,"props":228,"children":229},{"style":145},[230],{"type":51,"value":231},"Content-Type: application\u002Fjson",{"type":46,"tag":91,"props":233,"children":234},{"style":104},[235],{"type":51,"value":178},{"type":46,"tag":91,"props":237,"children":238},{"style":98},[239],{"type":51,"value":183},{"type":46,"tag":91,"props":241,"children":243},{"class":93,"line":242},6,[244,249,254,259,264],{"type":46,"tag":91,"props":245,"children":246},{"style":145},[247],{"type":51,"value":248},"  -d",{"type":46,"tag":91,"props":250,"children":251},{"style":104},[252],{"type":51,"value":253}," '",{"type":46,"tag":91,"props":255,"children":256},{"style":145},[257],{"type":51,"value":258},"{\"provider\":\"gemini\",\"prompt\":\"a friendly robot mascot waving, flat vector logo, mint green background\",\"n\":1}",{"type":46,"tag":91,"props":260,"children":261},{"style":104},[262],{"type":51,"value":263},"'",{"type":46,"tag":91,"props":265,"children":266},{"style":98},[267],{"type":51,"value":183},{"type":46,"tag":91,"props":269,"children":271},{"class":93,"line":270},7,[272,277],{"type":46,"tag":91,"props":273,"children":274},{"style":104},[275],{"type":51,"value":276},"  >",{"type":46,"tag":91,"props":278,"children":279},{"style":145},[280],{"type":51,"value":281}," image-response.json\n",{"type":46,"tag":91,"props":283,"children":285},{"class":93,"line":284},8,[286],{"type":46,"tag":91,"props":287,"children":288},{"emptyLinePlaceholder":129},[289],{"type":51,"value":132},{"type":46,"tag":91,"props":291,"children":293},{"class":93,"line":292},9,[294,299,304,309],{"type":46,"tag":91,"props":295,"children":296},{"style":139},[297],{"type":51,"value":298},"python3",{"type":46,"tag":91,"props":300,"children":301},{"style":145},[302],{"type":51,"value":303}," -",{"type":46,"tag":91,"props":305,"children":306},{"style":104},[307],{"type":51,"value":308}," \u003C\u003C",{"type":46,"tag":91,"props":310,"children":311},{"style":104},[312],{"type":51,"value":313},"'PY'\n",{"type":46,"tag":91,"props":315,"children":317},{"class":93,"line":316},10,[318],{"type":46,"tag":91,"props":319,"children":320},{"style":145},[321],{"type":51,"value":322},"import base64, json, urllib.request\n",{"type":46,"tag":91,"props":324,"children":326},{"class":93,"line":325},11,[327],{"type":46,"tag":91,"props":328,"children":329},{"emptyLinePlaceholder":129},[330],{"type":51,"value":132},{"type":46,"tag":91,"props":332,"children":334},{"class":93,"line":333},12,[335],{"type":46,"tag":91,"props":336,"children":337},{"style":145},[338],{"type":51,"value":339},"with open(\"image-response.json\") as f:\n",{"type":46,"tag":91,"props":341,"children":343},{"class":93,"line":342},13,[344],{"type":46,"tag":91,"props":345,"children":346},{"style":145},[347],{"type":51,"value":348},"    response = json.load(f)\n",{"type":46,"tag":91,"props":350,"children":352},{"class":93,"line":351},14,[353],{"type":46,"tag":91,"props":354,"children":355},{"emptyLinePlaceholder":129},[356],{"type":51,"value":132},{"type":46,"tag":91,"props":358,"children":360},{"class":93,"line":359},15,[361],{"type":46,"tag":91,"props":362,"children":363},{"style":145},[364],{"type":51,"value":365},"image = response[\"images\"][0]\n",{"type":46,"tag":91,"props":367,"children":369},{"class":93,"line":368},16,[370],{"type":46,"tag":91,"props":371,"children":372},{"style":145},[373],{"type":51,"value":374},"if image.get(\"b64_json\"):\n",{"type":46,"tag":91,"props":376,"children":378},{"class":93,"line":377},17,[379],{"type":46,"tag":91,"props":380,"children":381},{"style":145},[382],{"type":51,"value":383},"    data = base64.b64decode(image[\"b64_json\"])\n",{"type":46,"tag":91,"props":385,"children":387},{"class":93,"line":386},18,[388],{"type":46,"tag":91,"props":389,"children":390},{"style":145},[391],{"type":51,"value":392},"else:\n",{"type":46,"tag":91,"props":394,"children":396},{"class":93,"line":395},19,[397],{"type":46,"tag":91,"props":398,"children":399},{"style":145},[400],{"type":51,"value":401},"    data = urllib.request.urlopen(image[\"url\"]).read()\n",{"type":46,"tag":91,"props":403,"children":405},{"class":93,"line":404},20,[406],{"type":46,"tag":91,"props":407,"children":408},{"emptyLinePlaceholder":129},[409],{"type":51,"value":132},{"type":46,"tag":91,"props":411,"children":413},{"class":93,"line":412},21,[414],{"type":46,"tag":91,"props":415,"children":416},{"style":145},[417],{"type":51,"value":418},"with open(\"robot-mascot.png\", \"wb\") as f:\n",{"type":46,"tag":91,"props":420,"children":422},{"class":93,"line":421},22,[423],{"type":46,"tag":91,"props":424,"children":425},{"style":145},[426],{"type":51,"value":427},"    f.write(data)\n",{"type":46,"tag":91,"props":429,"children":431},{"class":93,"line":430},23,[432],{"type":46,"tag":91,"props":433,"children":434},{"emptyLinePlaceholder":129},[435],{"type":51,"value":132},{"type":46,"tag":91,"props":437,"children":439},{"class":93,"line":438},24,[440],{"type":46,"tag":91,"props":441,"children":442},{"style":145},[443],{"type":51,"value":444},"print(\"saved robot-mascot.png; credits:\", response[\"billing\"][\"credits_charged\"])\n",{"type":46,"tag":91,"props":446,"children":448},{"class":93,"line":447},25,[449],{"type":46,"tag":91,"props":450,"children":451},{"style":104},[452],{"type":51,"value":453},"PY\n",{"type":46,"tag":53,"props":455,"children":456},{},[457,459,464,466,472,474,480,482,488,490,496,498,504,506,512,514,520,522,528,530,536,538,544],{"type":51,"value":458},"In Bash tools launched by Letta Code, use the runtime-provided\n",{"type":46,"tag":59,"props":460,"children":462},{"className":461},[],[463],{"type":51,"value":117},{"type":51,"value":465}," and ",{"type":46,"tag":59,"props":467,"children":469},{"className":468},[],[470],{"type":51,"value":471},"LETTA_API_KEY",{"type":51,"value":473}," together for Letta API calls. Build URLs\nrelative to ",{"type":46,"tag":59,"props":475,"children":477},{"className":476},[],[478],{"type":51,"value":479},"${LETTA_BASE_URL%\u002F}",{"type":51,"value":481}," and send ",{"type":46,"tag":59,"props":483,"children":485},{"className":484},[],[486],{"type":51,"value":487},"Authorization: Bearer $LETTA_API_KEY",{"type":51,"value":489},".\nDo not hardcode ",{"type":46,"tag":59,"props":491,"children":493},{"className":492},[],[494],{"type":51,"value":495},"https:\u002F\u002Fapi.letta.com",{"type":51,"value":497},": Desktop and remote runtimes may provide\na proxy base URL, and the credential may only be valid through that URL. If\neither variable is missing, the user needs to authenticate with Letta Cloud (or\nprovide a Letta API key); do ",{"type":46,"tag":499,"props":500,"children":501},"strong",{},[502],{"type":51,"value":503},"not",{"type":51,"value":505}," ask for an OpenAI\u002FGemini provider key. This\nendpoint also does not use ",{"type":46,"tag":59,"props":507,"children":509},{"className":508},[],[510],{"type":51,"value":511},"\u002Fconnect",{"type":51,"value":513}," BYOK providers — the only ",{"type":46,"tag":59,"props":515,"children":517},{"className":516},[],[518],{"type":51,"value":519},"provider",{"type":51,"value":521}," values\nsupported here are ",{"type":46,"tag":59,"props":523,"children":525},{"className":524},[],[526],{"type":51,"value":527},"flux",{"type":51,"value":529},", ",{"type":46,"tag":59,"props":531,"children":533},{"className":532},[],[534],{"type":51,"value":535},"gemini",{"type":51,"value":537},", and ",{"type":46,"tag":59,"props":539,"children":541},{"className":540},[],[542],{"type":51,"value":543},"openai",{"type":51,"value":545},".",{"type":46,"tag":53,"props":547,"children":548},{},[549,551,556],{"type":51,"value":550},"Then ",{"type":46,"tag":499,"props":552,"children":553},{},[554],{"type":51,"value":555},"show the image to the user",{"type":51,"value":557}," by embedding the saved file in your reply:",{"type":46,"tag":80,"props":559,"children":563},{"className":560,"code":561,"language":562,"meta":85,"style":85},"language-markdown shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","Here's the mascot:\n\n![a friendly robot mascot waving, flat vector logo](.\u002Frobot-mascot.png)\n","markdown",[564],{"type":46,"tag":59,"props":565,"children":566},{"__ignoreMap":85},[567,575,582],{"type":46,"tag":91,"props":568,"children":569},{"class":93,"line":94},[570],{"type":46,"tag":91,"props":571,"children":572},{"style":98},[573],{"type":51,"value":574},"Here's the mascot:\n",{"type":46,"tag":91,"props":576,"children":577},{"class":93,"line":125},[578],{"type":46,"tag":91,"props":579,"children":580},{"emptyLinePlaceholder":129},[581],{"type":51,"value":132},{"type":46,"tag":91,"props":583,"children":584},{"class":93,"line":135},[585,590,595,600,606],{"type":46,"tag":91,"props":586,"children":587},{"style":104},[588],{"type":51,"value":589},"![",{"type":46,"tag":91,"props":591,"children":592},{"style":145},[593],{"type":51,"value":594},"a friendly robot mascot waving, flat vector logo",{"type":46,"tag":91,"props":596,"children":597},{"style":104},[598],{"type":51,"value":599},"](",{"type":46,"tag":91,"props":601,"children":603},{"style":602},"--shiki-light:#90A4AE;--shiki-light-text-decoration:underline;--shiki-default:#EEFFFF;--shiki-default-text-decoration:underline;--shiki-dark:#BABED8;--shiki-dark-text-decoration:underline",[604],{"type":51,"value":605},".\u002Frobot-mascot.png",{"type":46,"tag":91,"props":607,"children":608},{"style":104},[609],{"type":51,"value":610},")\n",{"type":46,"tag":53,"props":612,"children":613},{},[614,616,621,623,629,631,637,639,645],{"type":51,"value":615},"The Letta Code UI renders local file paths in markdown image tags, so the image\nappears inline. ",{"type":46,"tag":499,"props":617,"children":618},{},[619],{"type":51,"value":620},"Always display generated images this way",{"type":51,"value":622}," — don't just report\nthe path, and never paste the raw base64 \u002F a ",{"type":46,"tag":59,"props":624,"children":626},{"className":625},[],[627],{"type":51,"value":628},"data:",{"type":51,"value":630}," URI. The markdown path must\nmatch where you saved the file. For ",{"type":46,"tag":59,"props":632,"children":634},{"className":633},[],[635],{"type":51,"value":636},"n > 1",{"type":51,"value":638},", save each image to its own file and\nembed each on its own line. Also tell the user the ",{"type":46,"tag":59,"props":640,"children":642},{"className":641},[],[643],{"type":51,"value":644},"credits_charged",{"type":51,"value":545},{"type":46,"tag":68,"props":647,"children":649},{"id":648},"request-body",[650],{"type":51,"value":651},"Request body",{"type":46,"tag":653,"props":654,"children":655},"table",{},[656,680],{"type":46,"tag":657,"props":658,"children":659},"thead",{},[660],{"type":46,"tag":661,"props":662,"children":663},"tr",{},[664,670,675],{"type":46,"tag":665,"props":666,"children":667},"th",{},[668],{"type":51,"value":669},"Field",{"type":46,"tag":665,"props":671,"children":672},{},[673],{"type":51,"value":674},"Type",{"type":46,"tag":665,"props":676,"children":677},{},[678],{"type":51,"value":679},"Notes",{"type":46,"tag":681,"props":682,"children":683},"tbody",{},[684,725,747,768,790,819,867,907,940],{"type":46,"tag":661,"props":685,"children":686},{},[687,696,720],{"type":46,"tag":688,"props":689,"children":690},"td",{},[691],{"type":46,"tag":59,"props":692,"children":694},{"className":693},[],[695],{"type":51,"value":519},{"type":46,"tag":688,"props":697,"children":698},{},[699,705,707,713,714],{"type":46,"tag":59,"props":700,"children":702},{"className":701},[],[703],{"type":51,"value":704},"\"flux\"",{"type":51,"value":706}," | ",{"type":46,"tag":59,"props":708,"children":710},{"className":709},[],[711],{"type":51,"value":712},"\"gemini\"",{"type":51,"value":706},{"type":46,"tag":59,"props":715,"children":717},{"className":716},[],[718],{"type":51,"value":719},"\"openai\"",{"type":46,"tag":688,"props":721,"children":722},{},[723],{"type":51,"value":724},"Required.",{"type":46,"tag":661,"props":726,"children":727},{},[728,737,742],{"type":46,"tag":688,"props":729,"children":730},{},[731],{"type":46,"tag":59,"props":732,"children":734},{"className":733},[],[735],{"type":51,"value":736},"prompt",{"type":46,"tag":688,"props":738,"children":739},{},[740],{"type":51,"value":741},"string",{"type":46,"tag":688,"props":743,"children":744},{},[745],{"type":51,"value":746},"Required, 1–32000 chars.",{"type":46,"tag":661,"props":748,"children":749},{},[750,759,763],{"type":46,"tag":688,"props":751,"children":752},{},[753],{"type":46,"tag":59,"props":754,"children":756},{"className":755},[],[757],{"type":51,"value":758},"model",{"type":46,"tag":688,"props":760,"children":761},{},[762],{"type":51,"value":741},{"type":46,"tag":688,"props":764,"children":765},{},[766],{"type":51,"value":767},"Optional; defaults per provider (below).",{"type":46,"tag":661,"props":769,"children":770},{},[771,780,785],{"type":46,"tag":688,"props":772,"children":773},{},[774],{"type":46,"tag":59,"props":775,"children":777},{"className":776},[],[778],{"type":51,"value":779},"n",{"type":46,"tag":688,"props":781,"children":782},{},[783],{"type":51,"value":784},"int 1–4",{"type":46,"tag":688,"props":786,"children":787},{},[788],{"type":51,"value":789},"Optional, default 1. Request variations in one call.",{"type":46,"tag":661,"props":791,"children":792},{},[793,802,806],{"type":46,"tag":688,"props":794,"children":795},{},[796],{"type":46,"tag":59,"props":797,"children":799},{"className":798},[],[800],{"type":51,"value":801},"size",{"type":46,"tag":688,"props":803,"children":804},{},[805],{"type":51,"value":741},{"type":46,"tag":688,"props":807,"children":808},{},[809,811,817],{"type":51,"value":810},"Optional, e.g. ",{"type":46,"tag":59,"props":812,"children":814},{"className":813},[],[815],{"type":51,"value":816},"\"1024x1024\"",{"type":51,"value":818}," (OpenAI).",{"type":46,"tag":661,"props":820,"children":821},{},[822,831,862],{"type":46,"tag":688,"props":823,"children":824},{},[825],{"type":46,"tag":59,"props":826,"children":828},{"className":827},[],[829],{"type":51,"value":830},"quality",{"type":46,"tag":688,"props":832,"children":833},{},[834,840,842,848,849,855,856],{"type":46,"tag":59,"props":835,"children":837},{"className":836},[],[838],{"type":51,"value":839},"low",{"type":51,"value":841},"|",{"type":46,"tag":59,"props":843,"children":845},{"className":844},[],[846],{"type":51,"value":847},"medium",{"type":51,"value":841},{"type":46,"tag":59,"props":850,"children":852},{"className":851},[],[853],{"type":51,"value":854},"high",{"type":51,"value":841},{"type":46,"tag":59,"props":857,"children":859},{"className":858},[],[860],{"type":51,"value":861},"auto",{"type":46,"tag":688,"props":863,"children":864},{},[865],{"type":51,"value":866},"Optional (OpenAI; higher = more credits).",{"type":46,"tag":661,"props":868,"children":869},{},[870,879,902],{"type":46,"tag":688,"props":871,"children":872},{},[873],{"type":46,"tag":59,"props":874,"children":876},{"className":875},[],[877],{"type":51,"value":878},"output_format",{"type":46,"tag":688,"props":880,"children":881},{},[882,888,889,895,896],{"type":46,"tag":59,"props":883,"children":885},{"className":884},[],[886],{"type":51,"value":887},"png",{"type":51,"value":841},{"type":46,"tag":59,"props":890,"children":892},{"className":891},[],[893],{"type":51,"value":894},"jpeg",{"type":51,"value":841},{"type":46,"tag":59,"props":897,"children":899},{"className":898},[],[900],{"type":51,"value":901},"webp",{"type":46,"tag":688,"props":903,"children":904},{},[905],{"type":51,"value":906},"Optional (OpenAI).",{"type":46,"tag":661,"props":908,"children":909},{},[910,919,928],{"type":46,"tag":688,"props":911,"children":912},{},[913],{"type":46,"tag":59,"props":914,"children":916},{"className":915},[],[917],{"type":51,"value":918},"input_images",{"type":46,"tag":688,"props":920,"children":921},{},[922,923,926],{"type":51,"value":741},{"type":46,"tag":91,"props":924,"children":925},{},[],{"type":51,"value":927}," (max 14)",{"type":46,"tag":688,"props":929,"children":930},{},[931,933,938],{"type":51,"value":932},"Optional. Base64 ",{"type":46,"tag":499,"props":934,"children":935},{},[936],{"type":51,"value":937},"data URLs",{"type":51,"value":939}," for edit\u002Fremix.",{"type":46,"tag":661,"props":941,"children":942},{},[943,952,957],{"type":46,"tag":688,"props":944,"children":945},{},[946],{"type":46,"tag":59,"props":947,"children":949},{"className":948},[],[950],{"type":51,"value":951},"seed",{"type":46,"tag":688,"props":953,"children":954},{},[955],{"type":51,"value":956},"int",{"type":46,"tag":688,"props":958,"children":959},{},[960],{"type":51,"value":961},"Optional.",{"type":46,"tag":653,"props":963,"children":964},{},[965,986],{"type":46,"tag":657,"props":966,"children":967},{},[968],{"type":46,"tag":661,"props":969,"children":970},{},[971,976,981],{"type":46,"tag":665,"props":972,"children":973},{},[974],{"type":51,"value":975},"Provider",{"type":46,"tag":665,"props":977,"children":978},{},[979],{"type":51,"value":980},"Default model",{"type":46,"tag":665,"props":982,"children":983},{},[984],{"type":51,"value":985},"Use for",{"type":46,"tag":681,"props":987,"children":988},{},[989,1014,1039],{"type":46,"tag":661,"props":990,"children":991},{},[992,1000,1009],{"type":46,"tag":688,"props":993,"children":994},{},[995],{"type":46,"tag":59,"props":996,"children":998},{"className":997},[],[999],{"type":51,"value":527},{"type":46,"tag":688,"props":1001,"children":1002},{},[1003],{"type":46,"tag":59,"props":1004,"children":1006},{"className":1005},[],[1007],{"type":51,"value":1008},"flux-2-pro",{"type":46,"tag":688,"props":1010,"children":1011},{},[1012],{"type":51,"value":1013},"Default for normal text-to-image. High-quality general image generation; commonly returns signed URLs.",{"type":46,"tag":661,"props":1015,"children":1016},{},[1017,1025,1034],{"type":46,"tag":688,"props":1018,"children":1019},{},[1020],{"type":46,"tag":59,"props":1021,"children":1023},{"className":1022},[],[1024],{"type":51,"value":535},{"type":46,"tag":688,"props":1026,"children":1027},{},[1028],{"type":46,"tag":59,"props":1029,"children":1031},{"className":1030},[],[1032],{"type":51,"value":1033},"gemini-3-pro-image",{"type":46,"tag":688,"props":1035,"children":1036},{},[1037],{"type":51,"value":1038},"Strong prompt adherence, image editing\u002Fremix.",{"type":46,"tag":661,"props":1040,"children":1041},{},[1042,1050,1059],{"type":46,"tag":688,"props":1043,"children":1044},{},[1045],{"type":46,"tag":59,"props":1046,"children":1048},{"className":1047},[],[1049],{"type":51,"value":543},{"type":46,"tag":688,"props":1051,"children":1052},{},[1053],{"type":46,"tag":59,"props":1054,"children":1056},{"className":1055},[],[1057],{"type":51,"value":1058},"gpt-image-2",{"type":46,"tag":688,"props":1060,"children":1061},{},[1062,1064,1069,1071,1076,1077,1082],{"type":51,"value":1063},"Photoreal output, explicit ",{"type":46,"tag":59,"props":1065,"children":1067},{"className":1066},[],[1068],{"type":51,"value":801},{"type":51,"value":1070},"\u002F",{"type":46,"tag":59,"props":1072,"children":1074},{"className":1073},[],[1075],{"type":51,"value":830},{"type":51,"value":1070},{"type":46,"tag":59,"props":1078,"children":1080},{"className":1079},[],[1081],{"type":51,"value":878},{"type":51,"value":545},{"type":46,"tag":53,"props":1084,"children":1085},{},[1086,1088,1093,1095,1100,1102,1107],{"type":51,"value":1087},"Default to ",{"type":46,"tag":59,"props":1089,"children":1091},{"className":1090},[],[1092],{"type":51,"value":527},{"type":51,"value":1094}," for normal text-to-image requests. Use ",{"type":46,"tag":59,"props":1096,"children":1098},{"className":1097},[],[1099],{"type":51,"value":535},{"type":51,"value":1101}," when the user\nprovides input images or wants image editing\u002Fremix. Use ",{"type":46,"tag":59,"props":1103,"children":1105},{"className":1104},[],[1106],{"type":51,"value":543},{"type":51,"value":1108}," when the user\nwants photoreal output or a specific size\u002Fquality.",{"type":46,"tag":68,"props":1110,"children":1112},{"id":1111},"response",[1113],{"type":51,"value":1114},"Response",{"type":46,"tag":80,"props":1116,"children":1120},{"className":1117,"code":1118,"language":1119,"meta":85,"style":85},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"provider\": \"gemini\",\n  \"model\": \"gemini-3-pro-image\",\n  \"images\": [{ \"b64_json\": \"\u003Cbase64>\", \"mime_type\": \"image\u002Fpng\" }],\n  \"billing\": { \"credits_charged\": 12, \"...\": \"...\" }\n}\n","json",[1121],{"type":46,"tag":59,"props":1122,"children":1123},{"__ignoreMap":85},[1124,1132,1171,1206,1301,1386],{"type":46,"tag":91,"props":1125,"children":1126},{"class":93,"line":94},[1127],{"type":46,"tag":91,"props":1128,"children":1129},{"style":104},[1130],{"type":51,"value":1131},"{\n",{"type":46,"tag":91,"props":1133,"children":1134},{"class":93,"line":125},[1135,1140,1145,1149,1154,1158,1162,1166],{"type":46,"tag":91,"props":1136,"children":1137},{"style":104},[1138],{"type":51,"value":1139},"  \"",{"type":46,"tag":91,"props":1141,"children":1143},{"style":1142},"--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA",[1144],{"type":51,"value":519},{"type":46,"tag":91,"props":1146,"children":1147},{"style":104},[1148],{"type":51,"value":178},{"type":46,"tag":91,"props":1150,"children":1151},{"style":104},[1152],{"type":51,"value":1153},":",{"type":46,"tag":91,"props":1155,"children":1156},{"style":104},[1157],{"type":51,"value":163},{"type":46,"tag":91,"props":1159,"children":1160},{"style":145},[1161],{"type":51,"value":535},{"type":46,"tag":91,"props":1163,"children":1164},{"style":104},[1165],{"type":51,"value":178},{"type":46,"tag":91,"props":1167,"children":1168},{"style":104},[1169],{"type":51,"value":1170},",\n",{"type":46,"tag":91,"props":1172,"children":1173},{"class":93,"line":135},[1174,1178,1182,1186,1190,1194,1198,1202],{"type":46,"tag":91,"props":1175,"children":1176},{"style":104},[1177],{"type":51,"value":1139},{"type":46,"tag":91,"props":1179,"children":1180},{"style":1142},[1181],{"type":51,"value":758},{"type":46,"tag":91,"props":1183,"children":1184},{"style":104},[1185],{"type":51,"value":178},{"type":46,"tag":91,"props":1187,"children":1188},{"style":104},[1189],{"type":51,"value":1153},{"type":46,"tag":91,"props":1191,"children":1192},{"style":104},[1193],{"type":51,"value":163},{"type":46,"tag":91,"props":1195,"children":1196},{"style":145},[1197],{"type":51,"value":1033},{"type":46,"tag":91,"props":1199,"children":1200},{"style":104},[1201],{"type":51,"value":178},{"type":46,"tag":91,"props":1203,"children":1204},{"style":104},[1205],{"type":51,"value":1170},{"type":46,"tag":91,"props":1207,"children":1208},{"class":93,"line":186},[1209,1213,1218,1222,1226,1231,1235,1240,1244,1248,1252,1257,1261,1266,1270,1275,1279,1283,1287,1292,1296],{"type":46,"tag":91,"props":1210,"children":1211},{"style":104},[1212],{"type":51,"value":1139},{"type":46,"tag":91,"props":1214,"children":1215},{"style":1142},[1216],{"type":51,"value":1217},"images",{"type":46,"tag":91,"props":1219,"children":1220},{"style":104},[1221],{"type":51,"value":178},{"type":46,"tag":91,"props":1223,"children":1224},{"style":104},[1225],{"type":51,"value":1153},{"type":46,"tag":91,"props":1227,"children":1228},{"style":104},[1229],{"type":51,"value":1230}," [{",{"type":46,"tag":91,"props":1232,"children":1233},{"style":104},[1234],{"type":51,"value":163},{"type":46,"tag":91,"props":1236,"children":1237},{"style":139},[1238],{"type":51,"value":1239},"b64_json",{"type":46,"tag":91,"props":1241,"children":1242},{"style":104},[1243],{"type":51,"value":178},{"type":46,"tag":91,"props":1245,"children":1246},{"style":104},[1247],{"type":51,"value":1153},{"type":46,"tag":91,"props":1249,"children":1250},{"style":104},[1251],{"type":51,"value":163},{"type":46,"tag":91,"props":1253,"children":1254},{"style":145},[1255],{"type":51,"value":1256},"\u003Cbase64>",{"type":46,"tag":91,"props":1258,"children":1259},{"style":104},[1260],{"type":51,"value":178},{"type":46,"tag":91,"props":1262,"children":1263},{"style":104},[1264],{"type":51,"value":1265},",",{"type":46,"tag":91,"props":1267,"children":1268},{"style":104},[1269],{"type":51,"value":163},{"type":46,"tag":91,"props":1271,"children":1272},{"style":139},[1273],{"type":51,"value":1274},"mime_type",{"type":46,"tag":91,"props":1276,"children":1277},{"style":104},[1278],{"type":51,"value":178},{"type":46,"tag":91,"props":1280,"children":1281},{"style":104},[1282],{"type":51,"value":1153},{"type":46,"tag":91,"props":1284,"children":1285},{"style":104},[1286],{"type":51,"value":163},{"type":46,"tag":91,"props":1288,"children":1289},{"style":145},[1290],{"type":51,"value":1291},"image\u002Fpng",{"type":46,"tag":91,"props":1293,"children":1294},{"style":104},[1295],{"type":51,"value":178},{"type":46,"tag":91,"props":1297,"children":1298},{"style":104},[1299],{"type":51,"value":1300}," }],\n",{"type":46,"tag":91,"props":1302,"children":1303},{"class":93,"line":217},[1304,1308,1313,1317,1321,1326,1330,1334,1338,1342,1348,1352,1356,1361,1365,1369,1373,1377,1381],{"type":46,"tag":91,"props":1305,"children":1306},{"style":104},[1307],{"type":51,"value":1139},{"type":46,"tag":91,"props":1309,"children":1310},{"style":1142},[1311],{"type":51,"value":1312},"billing",{"type":46,"tag":91,"props":1314,"children":1315},{"style":104},[1316],{"type":51,"value":178},{"type":46,"tag":91,"props":1318,"children":1319},{"style":104},[1320],{"type":51,"value":1153},{"type":46,"tag":91,"props":1322,"children":1323},{"style":104},[1324],{"type":51,"value":1325}," {",{"type":46,"tag":91,"props":1327,"children":1328},{"style":104},[1329],{"type":51,"value":163},{"type":46,"tag":91,"props":1331,"children":1332},{"style":139},[1333],{"type":51,"value":644},{"type":46,"tag":91,"props":1335,"children":1336},{"style":104},[1337],{"type":51,"value":178},{"type":46,"tag":91,"props":1339,"children":1340},{"style":104},[1341],{"type":51,"value":1153},{"type":46,"tag":91,"props":1343,"children":1345},{"style":1344},"--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C",[1346],{"type":51,"value":1347}," 12",{"type":46,"tag":91,"props":1349,"children":1350},{"style":104},[1351],{"type":51,"value":1265},{"type":46,"tag":91,"props":1353,"children":1354},{"style":104},[1355],{"type":51,"value":163},{"type":46,"tag":91,"props":1357,"children":1358},{"style":139},[1359],{"type":51,"value":1360},"...",{"type":46,"tag":91,"props":1362,"children":1363},{"style":104},[1364],{"type":51,"value":178},{"type":46,"tag":91,"props":1366,"children":1367},{"style":104},[1368],{"type":51,"value":1153},{"type":46,"tag":91,"props":1370,"children":1371},{"style":104},[1372],{"type":51,"value":163},{"type":46,"tag":91,"props":1374,"children":1375},{"style":145},[1376],{"type":51,"value":1360},{"type":46,"tag":91,"props":1378,"children":1379},{"style":104},[1380],{"type":51,"value":178},{"type":46,"tag":91,"props":1382,"children":1383},{"style":104},[1384],{"type":51,"value":1385}," }\n",{"type":46,"tag":91,"props":1387,"children":1388},{"class":93,"line":242},[1389],{"type":46,"tag":91,"props":1390,"children":1391},{"style":104},[1392],{"type":51,"value":1393},"}\n",{"type":46,"tag":53,"props":1395,"children":1396},{},[1397,1399,1405,1407,1412,1414,1420,1422,1427,1429,1434,1436,1441,1443,1448],{"type":51,"value":1398},"Each ",{"type":46,"tag":59,"props":1400,"children":1402},{"className":1401},[],[1403],{"type":51,"value":1404},"images[]",{"type":51,"value":1406}," entry has either ",{"type":46,"tag":59,"props":1408,"children":1410},{"className":1409},[],[1411],{"type":51,"value":1239},{"type":51,"value":1413}," or ",{"type":46,"tag":59,"props":1415,"children":1417},{"className":1416},[],[1418],{"type":51,"value":1419},"url",{"type":51,"value":1421},", plus ",{"type":46,"tag":59,"props":1423,"children":1425},{"className":1424},[],[1426],{"type":51,"value":1274},{"type":51,"value":1428},". Gemini\nalways returns ",{"type":46,"tag":59,"props":1430,"children":1432},{"className":1431},[],[1433],{"type":51,"value":1239},{"type":51,"value":1435},". Flux commonly returns a signed ",{"type":46,"tag":59,"props":1437,"children":1439},{"className":1438},[],[1440],{"type":51,"value":1419},{"type":51,"value":1442},"; download it to\nyour local image file immediately because signed URLs expire. If OpenAI returns a\n",{"type":46,"tag":59,"props":1444,"children":1446},{"className":1445},[],[1447],{"type":51,"value":1419},{"type":51,"value":1449},", download that URL instead of base64-decoding.",{"type":46,"tag":68,"props":1451,"children":1453},{"id":1452},"editing-remixing-images",[1454],{"type":51,"value":1455},"Editing \u002F remixing images",{"type":46,"tag":53,"props":1457,"children":1458},{},[1459,1461,1466,1468,1472,1474,1480,1482,1487],{"type":51,"value":1460},"Pass source images in ",{"type":46,"tag":59,"props":1462,"children":1464},{"className":1463},[],[1465],{"type":51,"value":918},{"type":51,"value":1467}," as base64 ",{"type":46,"tag":499,"props":1469,"children":1470},{},[1471],{"type":51,"value":937},{"type":51,"value":1473},"\n(",{"type":46,"tag":59,"props":1475,"children":1477},{"className":1476},[],[1478],{"type":51,"value":1479},"data:\u003Cmime>;base64,\u003Cdata>",{"type":51,"value":1481},") and describe the edit in ",{"type":46,"tag":59,"props":1483,"children":1485},{"className":1484},[],[1486],{"type":51,"value":736},{"type":51,"value":1488},". Gemini handles\nmulti-image edits well. To build a data URL from a local file:",{"type":46,"tag":80,"props":1490,"children":1492},{"className":82,"code":1491,"language":84,"meta":85,"style":85},"DATA_URL=\"data:image\u002Fpng;base64,$(base64 \u003C input.png | tr -d '\\n')\"\n",[1493],{"type":46,"tag":59,"props":1494,"children":1495},{"__ignoreMap":85},[1496],{"type":46,"tag":91,"props":1497,"children":1498},{"class":93,"line":94},[1499,1504,1508,1512,1517,1522,1527,1532,1537,1541,1546,1551,1555,1560],{"type":46,"tag":91,"props":1500,"children":1501},{"style":98},[1502],{"type":51,"value":1503},"DATA_URL",{"type":46,"tag":91,"props":1505,"children":1506},{"style":104},[1507],{"type":51,"value":107},{"type":46,"tag":91,"props":1509,"children":1510},{"style":104},[1511],{"type":51,"value":178},{"type":46,"tag":91,"props":1513,"children":1514},{"style":145},[1515],{"type":51,"value":1516},"data:image\u002Fpng;base64,",{"type":46,"tag":91,"props":1518,"children":1519},{"style":104},[1520],{"type":51,"value":1521},"$(",{"type":46,"tag":91,"props":1523,"children":1524},{"style":139},[1525],{"type":51,"value":1526},"base64",{"type":46,"tag":91,"props":1528,"children":1529},{"style":104},[1530],{"type":51,"value":1531}," \u003C",{"type":46,"tag":91,"props":1533,"children":1534},{"style":145},[1535],{"type":51,"value":1536}," input.png ",{"type":46,"tag":91,"props":1538,"children":1539},{"style":104},[1540],{"type":51,"value":841},{"type":46,"tag":91,"props":1542,"children":1543},{"style":139},[1544],{"type":51,"value":1545}," tr",{"type":46,"tag":91,"props":1547,"children":1548},{"style":145},[1549],{"type":51,"value":1550}," -d ",{"type":46,"tag":91,"props":1552,"children":1553},{"style":104},[1554],{"type":51,"value":263},{"type":46,"tag":91,"props":1556,"children":1557},{"style":145},[1558],{"type":51,"value":1559},"\\n",{"type":46,"tag":91,"props":1561,"children":1562},{"style":104},[1563],{"type":51,"value":1564},"')\"\n",{"type":46,"tag":68,"props":1566,"children":1568},{"id":1567},"notes",[1569],{"type":51,"value":679},{"type":46,"tag":1571,"props":1572,"children":1573},"ul",{},[1574,1591,1640],{"type":46,"tag":1575,"props":1576,"children":1577},"li",{},[1578,1583,1585,1590],{"type":46,"tag":499,"props":1579,"children":1580},{},[1581],{"type":51,"value":1582},"Billing",{"type":51,"value":1584},": every success charges credits; don't loop needlessly, and report\n",{"type":46,"tag":59,"props":1586,"children":1588},{"className":1587},[],[1589],{"type":51,"value":644},{"type":51,"value":545},{"type":46,"tag":1575,"props":1592,"children":1593},{},[1594,1599,1601,1607,1609,1615,1617,1623,1624,1630,1632,1638],{"type":46,"tag":499,"props":1595,"children":1596},{},[1597],{"type":51,"value":1598},"Errors",{"type":51,"value":1600},": ",{"type":46,"tag":59,"props":1602,"children":1604},{"className":1603},[],[1605],{"type":51,"value":1606},"402",{"type":51,"value":1608}," = insufficient credits (",{"type":46,"tag":59,"props":1610,"children":1612},{"className":1611},[],[1613],{"type":51,"value":1614},"credits_required",{"type":51,"value":1616}," in body); ",{"type":46,"tag":59,"props":1618,"children":1620},{"className":1619},[],[1621],{"type":51,"value":1622},"400",{"type":51,"value":1070},{"type":46,"tag":59,"props":1625,"children":1627},{"className":1626},[],[1628],{"type":51,"value":1629},"500",{"type":51,"value":1631},"\nreturn ",{"type":46,"tag":59,"props":1633,"children":1635},{"className":1634},[],[1636],{"type":51,"value":1637},"{ \"message\": \"...\" }",{"type":51,"value":1639}," — surface it to the user.",{"type":46,"tag":1575,"props":1641,"children":1642},{},[1643,1645,1650,1651,1656,1657,1662],{"type":51,"value":1644},"Only ",{"type":46,"tag":59,"props":1646,"children":1648},{"className":1647},[],[1649],{"type":51,"value":527},{"type":51,"value":529},{"type":46,"tag":59,"props":1652,"children":1654},{"className":1653},[],[1655],{"type":51,"value":535},{"type":51,"value":537},{"type":46,"tag":59,"props":1658,"children":1660},{"className":1659},[],[1661],{"type":51,"value":543},{"type":51,"value":1663}," are supported here.",{"type":46,"tag":1665,"props":1666,"children":1667},"style",{},[1668],{"type":51,"value":1669},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":1671,"total":395},[1672,1688,1703,1715,1727,1741,1753],{"slug":1673,"name":1673,"fn":1674,"description":1675,"org":1676,"tags":1677,"stars":22,"repoUrl":23,"updatedAt":1687},"acquiring-skills","discover and install agent skills","Discover and install skills from Hermes, ClawHub, GitHub, and other registries. Load this skill whenever a user asks for a capability you don't already have — image generation, social media, email, calendar, finance, DevOps, search, browser automation, etc.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1678,1681,1684],{"name":1679,"slug":1680,"type":16},"Agents","agents",{"name":1682,"slug":1683,"type":16},"Automation","automation",{"name":1685,"slug":1686,"type":16},"GitHub","github","2026-07-13T06:22:58.45767",{"slug":1689,"name":1690,"fn":1691,"description":1692,"org":1693,"tags":1694,"stars":22,"repoUrl":23,"updatedAt":1702},"context-doctor","Context Doctor","repair system prompt and memory degradation","Identify and repair degradation in system prompt, external memory, and skills preventing you from following instructions or remembering information as well as you should.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1695,1696,1699],{"name":1679,"slug":1680,"type":16},{"name":1697,"slug":1698,"type":16},"AI Context","ai-context",{"name":1700,"slug":1701,"type":16},"Debugging","debugging","2026-07-13T06:22:50.151002",{"slug":1704,"name":1704,"fn":1705,"description":1706,"org":1707,"tags":1708,"stars":22,"repoUrl":23,"updatedAt":1714},"converting-mcps-to-skills","connect MCP servers to create skills","Connect to MCP (Model Context Protocol) servers and create skills for repeated use. Load when a user wants to use an MCP server, connect to external tools via MCP, or when they mention MCP, model context protocol, or specific MCP servers.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1709,1710,1711],{"name":1679,"slug":1680,"type":16},{"name":1682,"slug":1683,"type":16},{"name":1712,"slug":1713,"type":16},"MCP","mcp","2026-07-13T06:23:37.646079",{"slug":1716,"name":1716,"fn":1717,"description":1718,"org":1719,"tags":1720,"stars":22,"repoUrl":23,"updatedAt":1726},"creating-mods","create and edit Letta Code mods","Creates and edits trusted local Letta Code mods, including tools, slash commands, local-only model providers, lifecycle\u002Fturn events, scoped conversation helpers, panels, and capability-gated behavior. Use when asked to make a mod, add an agent-callable tool, add a slash command, add a local provider\u002Fmodel adapter, transform turns, react to app events, or add lightweight mod UI outside the dedicated \u002Fstatusline flow.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1721,1722,1723],{"name":1679,"slug":1680,"type":16},{"name":1682,"slug":1683,"type":16},{"name":1724,"slug":1725,"type":16},"Coding","coding","2026-07-23T05:42:38.133565",{"slug":1728,"name":1728,"fn":1729,"description":1730,"org":1731,"tags":1732,"stars":22,"repoUrl":23,"updatedAt":1740},"creating-skills","create and update agent skills","Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Letta Code's capabilities with specialized knowledge, workflows, or tool integrations.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1733,1734,1737],{"name":1679,"slug":1680,"type":16},{"name":1735,"slug":1736,"type":16},"Documentation","documentation",{"name":1738,"slug":1739,"type":16},"Plugin Development","plugin-development","2026-07-13T06:22:56.998659",{"slug":1742,"name":1742,"fn":1743,"description":1744,"org":1745,"tags":1746,"stars":22,"repoUrl":23,"updatedAt":1752},"customizing-commands","create and manage Letta slash commands","Creates, edits, and enables Letta Code mod-provided slash commands. Use when the user asks to add a custom \u002Fcommand, slash command, command shortcut, scoped conversation-backed command, or command-driven panel behavior.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1747,1748,1749],{"name":1679,"slug":1680,"type":16},{"name":1682,"slug":1683,"type":16},{"name":1750,"slug":1751,"type":16},"CLI","cli","2026-07-13T06:23:18.266798",{"slug":1754,"name":1754,"fn":1755,"description":1756,"org":1757,"tags":1758,"stars":22,"repoUrl":23,"updatedAt":1763},"customizing-statusline","customize Letta Code statusline mods","Creates, edits, and migrates Letta Code statusline mods. Use when handling the \u002Fstatusline command or continuing work started by \u002Fstatusline.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1759,1760],{"name":1750,"slug":1751,"type":16},{"name":1761,"slug":1762,"type":16},"Engineering","engineering","2026-07-13T06:23:27.465985",{"items":1765,"total":1864},[1766,1772,1778,1784,1790,1796,1802,1807,1819,1835,1846,1858],{"slug":1673,"name":1673,"fn":1674,"description":1675,"org":1767,"tags":1768,"stars":22,"repoUrl":23,"updatedAt":1687},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1769,1770,1771],{"name":1679,"slug":1680,"type":16},{"name":1682,"slug":1683,"type":16},{"name":1685,"slug":1686,"type":16},{"slug":1689,"name":1690,"fn":1691,"description":1692,"org":1773,"tags":1774,"stars":22,"repoUrl":23,"updatedAt":1702},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1775,1776,1777],{"name":1679,"slug":1680,"type":16},{"name":1697,"slug":1698,"type":16},{"name":1700,"slug":1701,"type":16},{"slug":1704,"name":1704,"fn":1705,"description":1706,"org":1779,"tags":1780,"stars":22,"repoUrl":23,"updatedAt":1714},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1781,1782,1783],{"name":1679,"slug":1680,"type":16},{"name":1682,"slug":1683,"type":16},{"name":1712,"slug":1713,"type":16},{"slug":1716,"name":1716,"fn":1717,"description":1718,"org":1785,"tags":1786,"stars":22,"repoUrl":23,"updatedAt":1726},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1787,1788,1789],{"name":1679,"slug":1680,"type":16},{"name":1682,"slug":1683,"type":16},{"name":1724,"slug":1725,"type":16},{"slug":1728,"name":1728,"fn":1729,"description":1730,"org":1791,"tags":1792,"stars":22,"repoUrl":23,"updatedAt":1740},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1793,1794,1795],{"name":1679,"slug":1680,"type":16},{"name":1735,"slug":1736,"type":16},{"name":1738,"slug":1739,"type":16},{"slug":1742,"name":1742,"fn":1743,"description":1744,"org":1797,"tags":1798,"stars":22,"repoUrl":23,"updatedAt":1752},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1799,1800,1801],{"name":1679,"slug":1680,"type":16},{"name":1682,"slug":1683,"type":16},{"name":1750,"slug":1751,"type":16},{"slug":1754,"name":1754,"fn":1755,"description":1756,"org":1803,"tags":1804,"stars":22,"repoUrl":23,"updatedAt":1763},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1805,1806],{"name":1750,"slug":1751,"type":16},{"name":1761,"slug":1762,"type":16},{"slug":1808,"name":1808,"fn":1809,"description":1810,"org":1811,"tags":1812,"stars":22,"repoUrl":23,"updatedAt":1818},"dispatching-coding-agents","dispatch stateless coding agents","Dispatch stateless coding agents (Claude Code or Codex) via Bash. Use when you're stuck, need a second opinion, or need parallel research on a hard problem. They have no memory — you must provide all context.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1813,1814,1815],{"name":1679,"slug":1680,"type":16},{"name":1724,"slug":1725,"type":16},{"name":1816,"slug":1817,"type":16},"Multi-Agent","multi-agent","2026-07-26T05:46:56.388845",{"slug":1820,"name":1820,"fn":1821,"description":1822,"org":1823,"tags":1824,"stars":22,"repoUrl":23,"updatedAt":1834},"editing-letta-code-desktop-preferences","edit Letta Code Desktop preferences","Edits Letta Code Desktop (LCD) preferences by safely reading and updating ~\u002F.letta\u002Fdesktop_preferences.json. Use only when the user asks to change current Desktop\u002FLCD settings such as theme, default working directory, remote access preference, or remote environment name via the preferences JSON.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1825,1828,1831],{"name":1826,"slug":1827,"type":16},"Configuration","configuration",{"name":1829,"slug":1830,"type":16},"Desktop","desktop",{"name":1832,"slug":1833,"type":16},"Themes","themes","2026-07-13T06:23:41.407811",{"slug":1836,"name":1836,"fn":1837,"description":1838,"org":1839,"tags":1840,"stars":22,"repoUrl":23,"updatedAt":1845},"finding-agents","locate and manage agents on server","Find other agents on the same server. Use when the user asks about other agents, wants to migrate memory from another agent, or needs to find an agent by name or tags.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1841,1842],{"name":1679,"slug":1680,"type":16},{"name":1843,"slug":1844,"type":16},"Management","management","2026-07-16T06:02:17.297841",{"slug":1847,"name":1847,"fn":1848,"description":1849,"org":1850,"tags":1851,"stars":22,"repoUrl":23,"updatedAt":1857},"generating-mod-envs","generate Letta mod learning environments","Generates and reviews mod learning env JSON files for Letta Code local mods. Use when asked to teach, learn, or optimize a mod behavior; create, draft, validate, improve, or explain envs for `\u002Fmods learn --env`; or design evaluation scenarios, memory fixtures, requiredResultMarkers, requiredTraceMarkers, negative controls, and candidate diversity hints.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1852,1853,1856],{"name":1679,"slug":1680,"type":16},{"name":1854,"slug":1855,"type":16},"AI Infrastructure","ai-infrastructure",{"name":1826,"slug":1827,"type":16},"2026-07-13T06:23:08.838181",{"slug":4,"name":4,"fn":5,"description":6,"org":1859,"tags":1860,"stars":22,"repoUrl":23,"updatedAt":24},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1861,1862,1863],{"name":18,"slug":19,"type":16},{"name":14,"slug":15,"type":16},{"name":21,"slug":4,"type":16},69]