Media

Generate a new image from a text prompt and return tracked asset ids. `kind` picks the model (`logo`, `illustration`, `photo`, `background`) — it is a job kind, not a model id, so the underlying model can change without your call changing. The call returns immediately with `queued` asset ids; the work runs on the media queue and the file lands in Putty's own storage, so poll `media_status` for the signed URL. Never returns a third-party URL. Refuses prompts asking for a real brand's logo or a real person's likeness, and explains why. For anything with WORDS on it — an OG card, an X header, a launch post — use `media_compose_graphic` instead: image models garble text, so a card with copy is an HTML layout rendered to PNG over a background this tool generates.