ambient-imagegen
Generate raster images through hosted APIs such as OpenAI, Google Nano Banana Pro, fal/FLUX, Replicate, Stability AI, and Ideogram.
- License 许可
- MIT
- 最近更新
- 2026-07-25
- Stars
- ★ 7
- Forks
- 4
01 前言 Front Matter
- name
- ambient-imagegen
- description
- Generate raster images through hosted APIs such as OpenAI, Google Nano Banana Pro, fal/FLUX, Replicate, Stability AI, and Ideogram.
02 资源文件 2
- 参考文档ambient-cli.json2.0 KB
- 脚本scripts/run.mjs33.2 KB
03 SKILL.md 正文
Ambient Hosted Image Generation
Use this package when the user asks for a bitmap image from a hosted image API and accepts cloud execution, provider policy, cost, and secret setup. Prefer local ComfyUI only when the user wants local model control, offline/privacy-first generation, or an explicit workflow/model cache.
Discovery And Setup
- Find this package with
ambient_cli_searchusing terms likehosted image generation,OpenAI image,Google Nano Banana,Nano Banana Pro,Flux,fal image,Replicate image,Stability image, orIdeogram. - Call
ambient_cli_describebefore first use so the current provider aliases, env names, and artifact contract are visible. - Run
hosted_image_doctor --jsonto see provider aliases and which secret env names are configured. It does not call provider APIs and must not reveal secret values. - Use Ambient-managed secret flows for keys. Do not ask the user to paste API keys into chat.
Providers
openai: OpenAI GPT Image, default modelgpt-image-2, envOPENAI_API_KEY.google: Google Nano Banana efficient image route, default modelgemini-3.1-flash-image, envGEMINI_API_KEYorGOOGLE_API_KEY.google-nano-banana-pro: Google Nano Banana Pro, default modelgemini-3-pro-image, envGEMINI_API_KEYorGOOGLE_API_KEY.fal: fal Model APIs, default modelfal-ai/flux/dev, envFAL_KEY.flux: convenience alias for the fal FLUX route, default modelfal-ai/flux/dev, envFAL_KEY.replicate: Replicate predictions for hosted image models, default modelblack-forest-labs/flux-schnell, envREPLICATE_API_TOKEN.stability: Stability AI Stable Image, default modelstable-image-ultra, envSTABILITY_API_KEY.ideogram: Ideogram 4.0 image generation, envIDEOGRAM_API_KEY.
Commands
hosted_image_doctor --json: reports supported providers, aliases, required env names, default models, and key presence.hosted_image_generate --provider <provider> --prompt <text> --output <path> --json: generates one image and writes a metadata JSON next to the image.hosted_image_generate --provider <provider> --prompt-file <path> --dry-run --json: returns the planned provider/model/host/env contract without making a network request.
Useful flags:
--model <id>overrides the provider default.--size <WxH>requests dimensions when the provider supports it.--aspect-ratio <ratio>requests provider-native aspect ratio when supported.--format png|jpeg|webprequests output format when supported.--negative-prompt <text>is passed only to providers that support it.
Artifact Contract
Every successful generation writes:
- The generated image file in the workspace.
- A sibling metadata JSON file with provider id, model id, byte size, MIME type, dimensions when detectable, SHA-256, latency, and secret env names only.
- Bounded stdout JSON for the transcript.
The command downloads temporary remote URLs into workspace files. Do not leave only provider-hosted URLs as the durable result.
Safety And Boundaries
- Provider prompts and source images leave the machine. State this when the user has not already acknowledged cloud use.
- Never print, log, or store secret values. Report only env names and configured/not-configured state.
- Surface provider policy, quota, auth, and malformed-request errors as errors. Do not rewrite prompts to bypass policy.
- Keep generated images as raster artifacts. Use document, SVG, or authored-motion tools when the user asks for editable documents, vector artwork, or deterministic video.
04 同仓库更多 Skills
ambient-tinystyler
Create reusable TinyStyler style profiles from user text examples and apply TinyStyler-style text transfer through Ambient CLI.
ambient-qwen3-asr
Local Qwen3-ASR speech-to-text provider for Ambient push-to-talk.
ambient-minicpm-v-vision
Local MiniCPM-V visual-understanding provider for Ambient screenshot, UI, game-frame, and image evidence.
hyperframes
Create deterministic authored-motion MP4/WebM/MOV videos from HTML/CSS/JS compositions through Ambient's bundled HyperFrames adapter.
ambient-faster-whisper-stt
Local faster-whisper STT provider for Ambient speech input validation.
ambient-blockchain
Safely observe the Ambient Blockchain, plan Tool Oracle and x402 interactions, prepare Ambient program deployment work, and run local live-test evidence gates.