Letzai Api
Wire LetzAI image and video generation (Nano Banana Pro, Flux2 Max, VEO, Kling, custom @models) into solo-built apps or automation pipelines.
Overview
LetzAI API is an agent skill for the Build phase that integrates Letz’s image and video generation API (models, @custom models, editing, upscaling) into apps and automation.
Install
npx skills add https://github.com/letz-ai/letzai-skill --skill letzai-apiWhat is this skill?
- Bearer auth against https://api.letz.ai with Node (node-fetch) and Python (requests) examples
- Image models: gemini-3-pro-image-preview (Nano Banana Pro), Flux2 Max, SeeDream; video: VEO and Kling
- Custom trained models via @modelname in prompts for persons, objects, and styles
- Core flows: POST /images generation, context editing, and upscaling from SKILL.md
- Documented for content-creation apps and automation use cases
- Documents image base models including gemini-3-pro-image-preview (Nano Banana Pro), Flux2 Max, and SeeDream
- Video models VEO and Kling referenced in skill overview
- MIT-licensed skill with node-fetch and requests dependencies
Adoption & trust: 885 installs on skills.sh; 1/3 security scanners passed (skills.sh audits).
What problem does it solve?
You want AI images and videos in your app or pipeline but do not have LetzAI auth, endpoints, and model parameters wired correctly.
Who is it for?
Solo builders shipping content tools, internal automations, or SaaS features that need LetzAI-backed media generation with Node or Python.
Skip if: Teams that only need one-off manual image edits in a browser with no API integration, or builders without a Letz subscription API key.
When should I use this skill?
Generate AI images and videos via LetzAI API for content creation apps and automation; use custom @modelname, context editing, and upscaling.
What do I get? / Deliverables
After the skill runs, your agent can implement authenticated LetzAI calls for generation, editing, and upscaling with the documented models and @model syntax.
- Authenticated LetzAI client code (headers + POST /images)
- Configured prompts with optional @modelname and baseModel selection
Recommended Skills
Journey fit
Canonical shelf is Build → integrations because the skill is an external API integration for generative assets inside a product. Integrations subphase covers third-party generative APIs, auth headers, and POST workflows—not one-off manual design work.
How it compares
Use as a skill-backed LetzAI integration guide—not as a local Stable Diffusion install or a generic image prompt pack with no HTTP contract.
Common Questions / FAQ
Who is letzai-api for?
Indie developers and agent users building apps or scripts that call LetzAI for images and videos, including custom @trained models.
When should I use letzai-api?
During Build when integrating generative media—e.g. backend jobs for thumbnails, video snippets for landing pages, or automation that posts prompts to POST /images.
Is letzai-api safe to install?
Review the Security Audits panel on this Prism page before installing; the skill expects a bearer API key and outbound network calls to api.letz.ai.
SKILL.md
READMESKILL.md - Letzai Api
# LetzAI API Integration Skill ## Overview This skill enables Claude to help users integrate with the LetzAI API for AI-powered image and video generation, editing, and upscaling. Users can also leverage custom-trained AI models (persons, objects, styles) via the @modelname syntax. ## Authentication - **Base URL:** `https://api.letz.ai` - **Authentication:** Bearer token in Authorization header - **Get API Key:** [letz.ai/subscription](https://letz.ai/subscription) - **API Documentation:** [api.letz.ai/doc](https://api.letz.ai/doc) ### Setting Up Authentication ```javascript const headers = { 'Content-Type': 'application/json', 'Authorization': 'Bearer YOUR_API_KEY' }; ``` ```python headers = { 'Content-Type': 'application/json', 'Authorization': 'Bearer YOUR_API_KEY' } ``` ## Core Workflows ### 1. Image Generation **Endpoint:** `POST /images` **Required Parameters:** - `prompt` (string): Text description of the desired image. Can include `@modelname` to use trained models. **Optional Parameters:** - `baseModel`: AI model to use - `"gemini-3-pro-image-preview"` - Nano Banana Pro (recommended) - `"flux2-max"` - Flux2 Max - `"seedream-4-5-251128"` - SeeDream 4.5 - `mode`: Resolution mode (varies by model) - Nano Banana Pro: `"default"`, `"2k"`, `"4k"` - Flux2 Max: `"1k"`, `"hd"` - SeeDream: `"2k"`, `"4k"` - `width` / `height`: Image dimensions (520-2160px) **Workflow:** 1. POST to `/images` with parameters 2. Receive `id` in response 3. Poll `GET /images/{id}` every 3 seconds 4. When `status === "ready"`, access `imageVersions.original` For code examples, see [examples/image_generation.js](examples/image_generation.js) ### 2. Video Generation **Endpoint:** `POST /videos` **Required Parameters:** - `prompt` (string): Text description of the desired video - Source image (one of): - `imageUrl`: URL of source image - `originalImageCompletionId`: ID from previous image generation **Optional Parameters:** - `settings.mode`: Video model - `"default"` - Default model - `"veo31"` - VEO 3.1 - `"kling26"` - Kling 2.6 - `"wan25"` - Wan 2.5 - `settings.duration`: Video length in seconds (2-12 depending on model) **Workflow:** 1. Ensure you have a source image (generate one first if needed) 2. POST to `/videos` with parameters 3. Receive `id` in response 4. Poll `GET /videos/{id}` every 2-3 seconds 5. When `status === "ready"`, access `videoPaths` For code examples, see [examples/video_generation.py](examples/video_generation.py) ### 3. Image Editing (Context Editing) **Endpoint:** `POST /image-edits` **Required Parameters:** - `mode`: Edit mode - `"context"` - AI editing (primary mode) - `"skin"` - Skin fix - `prompt`: Edit instruction (e.g., "change background to beach") - Source image (one of): - `imageUrl`: URL of source image - `inputImageUrls[]`: Array of source image URLs (max 9) - `originalImageCompletionId`: ID of previously generated LetzAI image **Optional Parameters:** - `settings.model`: `"gemini-3-pro-image-preview"`, `"flux2-max"`, `"seedream-4-5-251128"` - `settings.resolution`: `"2k"` (HD) or `"4k"` (Ultra HD) - `settings.aspect_ratio`: `"1:1"`, `"16:9"`, `"9:16"`, `"4:3"`, `"3:4"`, `"21:9"`, `"9:21"` - `baseModel`: Alternative to settings.model - `webhookUrl`: Optional callback URL - `organizationId`: Optional org ID for billing **Workflow:** 1. POST to `/image-edits` with parameters 2. Receive `id` in response 3. Poll `GET /image-edits/{id}` every 3 seconds 4. When `status === "ready"`, access `generatedImageCompletion.imageVersions.original` **Note:** Inpainting (mode: "in") and Outpainting (mod