Installation

clawhub install seekton/monet-ai

Summary

Comprehensive AI content generation API designed for AI agents. Monet AI provides unified access to state-of-the-art AI generation models for video (Sora, Veo, Doubao Seedance, Wan, Hailuo, Kling), image (GPT-4o, Nano Banana, Seedream, Flux, Imagen, Ideogram), and music (MiniMax Music) generation. Build intelligent workflows that combine multiple AI capabilities for automated content creation pipelines.

SKILL.md

Monet AI Skill

Comprehensive AI content generation API designed for AI agents. Monet AI provides unified access to state-of-the-art AI generation models for video (Sora, Veo, Doubao Seedance, Wan, Hailuo, Kling), image (GPT-4o, Nano Banana, Seedream, Flux, Imagen, Ideogram), and music (MiniMax Music) generation. Build intelligent workflows that combine multiple AI capabilities for automated content creation pipelines.

When to Use

Use this skill when:

  • Video Generation: Create AI-generated videos from text prompts using state-of-the-art models
    • Sora: OpenAI's video generation model for high-quality, realistic videos
    • Veo: Google's video generation model
    • Doubao Seedance: ByteDance's AI video model with audio-visual sync
    • Wan: Alibaba's video generation model with excellent localization support
    • Hailuo: Fast video generation with good quality-speed balance
    • Kling: Kuaishou's video generation model
  • Image Generation: Generate images from text descriptions with various artistic styles
    • GPT-4o: OpenAI's multimodal model for image generation
    • Nano Banana: Google's image model with ultra-high character consistency
    • Seedream: ByteDance's intelligent visual reasoning model
    • Wan: Alibaba's visual model for high-quality and expressive image generation
    • Flux: High-quality photorealistic and artistic image generation
    • Imagen: Google's text-to-image model
    • Ideogram: Specialized in text rendering and precise composition
  • Music Generation: Create original music and audio from text descriptions
    • MiniMax Music: AI music generation with support for custom lyrics and text-to-music conversion
  • AI Agent Integration: Build intelligent workflows that combine multiple AI generation capabilities for automated content creation pipelines

Getting API Key

  1. Visit https://monet.vision to register an account
  2. After login, go to https://monet.vision/skills/keys to create an API Key
  3. Configure the API Key in environment variables or code

If you don't have an API Key, ask your owner to apply at monet.vision.

Quick Start

Create a Video Generation Task

bash
curl -X POST https://monet.vision/api/v1/tasks/async \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $MONET_API_KEY" \
  -d '{
    "type": "video",
    "input": {
      "model": "sora-2",
      "prompt": "A cat running in the park",
      "duration": 5,
      "aspect_ratio": "16:9"
    },
    "idempotency_key": "unique-key-123"
  }'

⚠️ Important: idempotency_key is required. Use a unique value (e.g., UUID) to prevent duplicate task creation if the request is retried.

Response:

json
{
  "id": "task_abc123",
  "status": "pending",
  "type": "video",
  "created_at": "2026-02-27T10:00:00Z"
}

Get Task Status and Result

Task processing is asynchronous. You need to poll the task status until it becomes success or failed. Recommended polling interval: 5 seconds.

bash
curl https://monet.vision/api/v1/tasks/task_abc123 \
  -H "Authorization: Bearer $MONET_API_KEY"

Response when completed:

json
{
  "id": "task_abc123",
  "status": "success",
  "type": "video",
  "outputs": [
    {
      "model": "sora-2",
      "status": "success",
      "progress": 100,
      "url": "https://files.monet.vision/..."
    }
  ],
  "created_at": "2026-02-27T10:00:00Z",
  "updated_at": "2026-02-27T10:01:30Z"
}

Example: Poll until completion

typescript
const TASK_ID = "task_abc123";
const MONET_API_KEY = process.env.MONET_API_KEY;

async function pollTask() {
  while (true) {
    const response = await fetch(
      `https://monet.vision/api/v1/tasks/${TASK_ID}`,
      {
        headers: {
          Authorization: `Bearer ${MONET_API_KEY}`,
        },
      },
    );

    const data = await response.json();
    const status = data.status;

    if (status === "success") {
      console.log("Task completed successfully!");
      console.log(JSON.stringify(data, null, 2));
      break;
    } else if (status === "failed") {
      console.log("Task failed!");
      console.log(JSON.stringify(data, null, 2));
      break;
    } else {
      console.log(`Task status: ${status}, waiting...`);
      await new Promise((resolve) => setTimeout(resolve, 5000)); // Wait 5 seconds
    }
  }
}

pollTask();

Supported Models

Video Generation

Sora (OpenAI)

sora-2 - Sora 2

OpenAI latest video generation model

  • 🎯 Use Cases: Video projects requiring OpenAI's latest technology
  • ⏱️ Duration: 10-15 seconds
  • 🎡 Features: Audio generation support, reference image support
typescript
{
  model: "sora-2",
  prompt: string,                // Required
  images?: string[],             // Optional: Reference images
  duration?: 10 | 15,           // Optional, default: 10
  aspect_ratio?: "16:9" | "9:16"
}

sora-2-pro - Sora 2 Pro

Perfect quality for cinematic scenes

  • 🎯 Use Cases: Professional film, advertising, and high-end production
  • ⏱️ Duration: 15-25 seconds
  • 🎡 Features: Audio generation support, reference image support
typescript
{
  model: "sora-2-pro",
  prompt: string,
  images?: string[],
  duration?: 15 | 25,           // Optional, default: 15
  aspect_ratio?: "16:9" | "9:16"
}

Veo (Google)

veo-3-1-fast - Google Veo 3.1 Fast

Ultra-fast video generation

  • 🎯 Use Cases: Video projects requiring fast generation
  • ⏱️ Duration: 8 seconds
  • πŸ“Ί Resolution: 1080p with audio generation support
typescript
{
  model: "veo-3-1-fast",
  prompt: string,
  images?: string[],             // Reference images
  aspect_ratio?: "16:9" | "9:16"
}

veo-3-1 - Google Veo 3.1

Advanced AI video with sound

  • 🎯 Use Cases: Professional-grade video production
  • ⏱️ Duration: 8 seconds
  • πŸ“Ί Resolution: 1080p with audio generation support
typescript
{
  model: "veo-3-1",
  prompt: string,
  images?: string[],
  aspect_ratio?: "16:9" | "9:16"
}

veo-3-fast - Google Veo 3 Fast

30% faster than standard Veo 3

  • 🎯 Use Cases: Video projects requiring rapid iteration
  • ⏱️ Duration: 8 seconds
  • πŸ“Ί Resolution: 1080p, supports negative prompts
typescript
{
  model: "veo-3-fast",
  prompt: string,
  images?: string[],
  negative_prompt?: string       // Specify unwanted content
}

veo-3 - Google Veo 3

High-quality video generation

  • 🎯 Use Cases: Standard high-quality video production
  • ⏱️ Duration: 8 seconds
  • πŸ“Ί Resolution: 1080p, supports negative prompts
typescript
{
  model: "veo-3",
  prompt: string,
  images?: string[],
  negative_prompt?: string
}

Wan

wan-2-6 - Wan 2.6

Multi-shot and automatic audio

  • 🎯 Use Cases: Video production requiring multi-shot switching
  • ⏱️ Duration: 5-15 seconds
  • πŸ“Ί Resolution: 720p-1080p with audio generation support
typescript
{
  model: "wan-2-6",
  prompt: string,
  images?: string[],
  duration?: 5 | 10 | 15,
  resolution?: "720p" | "1080p",
  aspect_ratio?: "16:9" | "9:16" | "4:3" | "3:4" | "1:1",
  shot_type?: "single" | "multi"  // Single/multi-shot switching
}

wan-2-5 - Wan 2.5

Supports automatic audio generation

  • 🎯 Use Cases: Quickly generating videos with audio
  • ⏱️ Duration: 5-10 seconds
  • πŸ“Ί Resolution: 480p-1080p with audio support
typescript
{
  model: "wan-2-5",
  prompt: string,
  images?: string[],
  duration?: 5 | 10,
  resolution?: "480p" | "720p" | "1080p",
  aspect_ratio?: "16:9" | "9:16" | "4:3" | "3:4" | "1:1"
}

wan-2-2-flash - Wan 2.2 Flash

Instruction understanding, controllable camera movement

  • 🎯 Use Cases: Scenarios requiring precise camera movement control
  • ⏱️ Duration: 5-10 seconds
  • πŸ“Ί Resolution: 480p-1080p
typescript
{
  model: "wan-2-2-flash",
  prompt: string,
  images?: string[],
  duration?: 5 | 10,
  resolution?: "480p" | "720p" | "1080p",
  negative_prompt?: string
}

wan-2-2 - Wan 2.2

Excellent image details, strong motion stability

  • 🎯 Use Cases: Video production requiring high stability
  • ⏱️ Duration: 5-10 seconds
  • πŸ“Ί Resolution: 480p-1080p
typescript
{
  model: "wan-2-2",
  prompt: string,
  images?: string[],
  duration?: 5 | 10,
  resolution?: "480p" | "1080p",
  aspect_ratio?: "16:9" | "9:16" | "4:3" | "3:4" | "1:1",
  negative_prompt?: string
}

Kling

kling-2-6 - Kling 2.6

Cinematic videos and audio

  • 🎯 Use Cases: Cinematic video production
  • ⏱️ Duration: 5-10 seconds
  • ✨ Features: Strong visual realism, audio generation support
typescript
{
  model: "kling-2-6",
  prompt: string,
  images?: string[],
  duration?: 5 | 10,
  aspect_ratio?: "1:1" | "16:9" | "9:16",
  generate_audio?: boolean
}

kling-2-5 - Kling 2.5 Turbo

Smooth motion, stronger consistency

  • 🎯 Use Cases: Video production requiring high consistency
  • ⏱️ Duration: 5-10 seconds
  • ✨ Features: Supports negative prompts
typescript
{
  model: "kling-2-5",
  prompt: string,
  images?: string[],
  duration?: 5 | 10,
  aspect_ratio?: "1:1" | "16:9" | "9:16",
  negative_prompt?: string
}

kling-v2-1-master - Kling 2.1 Master

Strong visual realism with enhanced features

  • 🎯 Use Cases: Professional-grade high-quality video production
  • ⏱️ Duration: 5-10 seconds
  • ✨ Features: Strength adjustment support, negative prompts
typescript
{
  model: "kling-v2-1-master",
  prompt: string,
  images?: string[],
  duration?: 5 | 10,
  aspect_ratio?: "1:1" | "16:9" | "9:16",
  strength?: number,            // 0-1: Control generation effect
  negative_prompt?: string
}

kling-v2-1 - Kling 2.1

Strong visual realism

  • 🎯 Use Cases: High-realism video production
  • ⏱️ Duration: 5-10 seconds
  • ✨ Features: Strength adjustment, negative prompts
typescript
{
  model: "kling-v2-1",
  prompt: string,
  images?: string[],
  duration?: 5 | 10,
  aspect_ratio?: "1:1" | "16:9" | "9:16",
  strength?: number,            // 0-1
  negative_prompt?: string
}

kling-v2 - Kling 2.0

Excellent aesthetics

  • 🎯 Use Cases: Artistic creation and aesthetically-oriented videos
  • ⏱️ Duration: 5-10 seconds
  • ✨ Features: Strength adjustment, negative prompts
typescript
{
  model: "kling-v2",
  prompt: string,
  images?: string[],
  duration?: 5 | 10,
  aspect_ratio?: "1:1" | "16:9" | "9:16",
  strength?: number,            // 0-1
  negative_prompt?: string
}

Hailuo

hailuo-2-3 - Hailuo 2.3

Excellent body movements and physics performance

  • 🎯 Use Cases: Videos requiring realistic physics effects
  • ⏱️ Duration: 6-10 seconds
  • πŸ“Ί Resolution: 768p-1080p, extreme physics simulations
typescript
{
  model: "hailuo-2-3",
  prompt: string,
  images?: string[],
  duration?: 6 | 10,
  resolution?: "768p" | "1080p"
}

hailuo-2-3-fast - Hailuo 2.3 Fast

Fast generation speed

  • 🎯 Use Cases: Projects requiring rapid iteration
  • ⏱️ Duration: 6-10 seconds
  • πŸ“Ί Resolution: 768p-1080p
typescript
{
  model: "hailuo-2-3-fast",
  prompt: string,
  images?: string[],
  duration?: 6 | 10,
  resolution?: "768p" | "1080p"
}

hailuo-02 - Hailuo 02

Extreme physics simulations

  • 🎯 Use Cases: Scenarios requiring accurate physics simulation
  • ⏱️ Duration: 6-10 seconds
  • πŸ“Ί Resolution: 768p-1080p
typescript
{
  model: "hailuo-02",
  prompt: string,
  images?: string[],
  duration?: 6 | 10,
  resolution?: "768p" | "1080p"
}

hailuo-01-live2d - Hailuo 01 Live2d

Hailuo Live2D model

  • 🎯 Use Cases: 2D character animation production
  • ✨ Features: Suitable for 2D character animation
typescript
{
  model: "hailuo-01-live2d",
  prompt: string,
  images?: string[]
}

hailuo-01 - Hailuo 01

Highest video quality

  • 🎯 Use Cases: Video production requiring ultimate quality
  • ✨ Features: Suitable for high-quality needs
typescript
{
  model: "hailuo-01",
  prompt: string,
  images?: string[]
}

Doubao Seedance

doubao-seedance-1-5-pro - Seedance 1.5 Pro

Pro-grade audio-visual sync

  • 🎯 Use Cases: Professional production requiring audio-visual sync
  • ⏱️ Duration: 4-12 seconds
  • πŸ“Ί Resolution: 480p-720p with audio generation support
typescript
{
  model: "doubao-seedance-1-5-pro",
  prompt: string,
  images?: string[],
  duration?: number,
  resolution?: "480p" | "720p",
  aspect_ratio?: "1:1" | "4:3" | "16:9" | "3:4" | "9:16" | "21:9",
  generate_audio?: boolean
}

doubao-seedance-1-0-pro-fast - Seedance 1.0 Pro Fast

Premium quality & unbeatable efficiency

  • 🎯 Use Cases: Scenarios requiring fast high-quality output
  • ⏱️ Duration: 2-12 seconds
  • πŸ“Ί Resolution: 720p-1080p, ByteDance's next-gen AI video model
typescript
{
  model: "doubao-seedance-1-0-pro-fast",
  prompt: string,
  images?: string[],
  duration?: number,
  resolution?: "720p" | "1080p",
  aspect_ratio?: "1:1" | "4:3" | "16:9" | "3:4" | "9:16" | "21:9"
}

doubao-seedance-1-0-pro - Seedance 1.0 Pro

Stable motion performance

  • 🎯 Use Cases: Video production requiring stable motion
  • ⏱️ Duration: 5-10 seconds
  • πŸ“Ί Resolution: 480p-1080p
typescript
{
  model: "doubao-seedance-1-0-pro",
  prompt: string,
  images?: string[],
  duration?: 5 | 10,
  resolution?: "480p" | "1080p",
  aspect_ratio?: "1:1" | "4:3" | "16:9" | "3:4" | "9:16"
}

doubao-seedance-1-0-lite - Seedance 1.0 Lite

Precise semantic understanding

  • 🎯 Use Cases: Scenarios requiring precise semantic understanding
  • ⏱️ Duration: 5-10 seconds
  • πŸ“Ί Resolution: 480p-1080p
typescript
{
  model: "doubao-seedance-1-0-lite",
  prompt: string,
  images?: string[],
  duration?: 5 | 10,
  resolution?: "480p" | "720p" | "1080p"
}

Special Features

kling-motion-control - Kling Motion Control

Precision motion control via video references

  • 🎯 Use Cases: Scenarios requiring motion replication from reference videos
  • ⏱️ Duration: 3-30 seconds
  • πŸ“Ί Resolution: 720p/1080p with audio generation support
  • πŸ’° Pricing: 720p: 8 credits/s, 1080p: 15 credits/s
typescript
{
  model: "kling-motion-control",
  prompt: string,                // Required: Detailed motion description
  images: string[],              // Required: min 1 reference image
  videos: string[],              // Required: min 1 reference video
  resolution?: "720p" | "1080p"
}

runway-act-two - Runway Act Two

Runway Next-Generation Motion Capture Model

  • 🎯 Use Cases: Capturing motion from videos and applying to new characters
  • ⏱️ Duration: 3-30 seconds
  • ✨ Features: Motion transfer support
  • πŸ’° Pricing: 10 credits/second
typescript
{
  model: "runway-act-two",
  images: string[],              // Required: min 1 target character image
  videos: string[],              // Required: min 1 motion reference video
  aspect_ratio?: "1:1" | "4:3" | "16:9" | "3:4" | "9:16" | "21:9"
}

wan-animate-mix - Wan Animate Mix (Standard)

Perfect for character replacement scenarios

  • 🎯 Use Cases: Video character replacement
  • ⏱️ Duration: 3-30 seconds
  • ✨ Features: Replace characters in videos with specified image characters
  • πŸ’° Pricing: 10 credits/second
typescript
{
  model: "wan-animate-mix",
  videos: string[],              // Required: Original videos
  images: string[]               // Required: Target character images
}

wan-animate-mix-pro - Wan Animate Mix Pro (Professional)

High animation fluidity with better results

  • 🎯 Use Cases: Professional-grade video character replacement
  • ⏱️ Duration: 3-30 seconds
  • ✨ Features: Higher quality character replacement effects
  • πŸ’° Pricing: 20 credits/second
typescript
{
  model: "wan-animate-mix-pro",
  videos: string[],              // Required
  images: string[]               // Required
}

wan-animate-move - Wan Animate Move (Standard)

Replicate dance and challenging body movements

  • 🎯 Use Cases: Motion capture and transfer
  • ⏱️ Duration: 3-30 seconds
  • ✨ Features: Apply motion from reference videos to target images
  • πŸ’° Pricing: 10 credits/second
typescript
{
  model: "wan-animate-move",
  videos: string[],              // Required: Motion reference videos
  images: string[]               // Required: Target character images
}

wan-animate-move-pro - Wan Animate Move Pro (Professional)

High animation fluidity with better results

  • 🎯 Use Cases: Professional-grade motion capture and transfer
  • ⏱️ Duration: 3-30 seconds
  • ✨ Features: Higher quality motion transfer effects
  • πŸ’° Pricing: 20 credits/second
typescript
{
  model: "wan-animate-move-pro",
  videos: string[],              // Required
  images: string[]               // Required
}

Image Generation

GPT (OpenAI)

gpt-4o - GPT 4o

Accurate, realistic output

  • 🎯 Use Cases: High-quality, photorealistic image generation
  • ✨ Features: Supports multiple reference images, multiple aspect ratios, customizable style
typescript
{
  model: "gpt-4o",
  prompt: string,
  images?: string[],             // Reference images for style guidance
  aspect_ratio?: "1:1" | "4:3" | "3:2" | "16:9" | "3:4" | "2:3" | "9:16",
  style?: string                 // Custom style description
}

gpt-image-1-5 - GPT Image 1.5

True-color precision rendering

  • 🎯 Use Cases: Professional image generation requiring color accuracy
  • ✨ Features: Supports up to 10 reference images, adjustable quality
typescript
{
  model: "gpt-image-1-5",
  prompt: string,
  images?: string[],             // max 10 reference images
  aspect_ratio?: "1:1" | "3:2" | "2:3",
  quality?: "auto" | "low" | "medium" | "high"
}

Nano Banana (Google)

nano-banana-1 - Google Nano Banana

Ultra-high character consistency

  • 🎯 Use Cases: Image series requiring consistent character appearance
  • ✨ Features: Supports up to 5 reference images, multiple aspect ratio options
typescript
{
  model: "nano-banana-1",
  prompt: string,
  images?: string[],             // max 5 reference images
  aspect_ratio?: "1:1" | "2:3" | "3:2" | "4:3" | "3:4" | "16:9" | "9:16"
}

nano-banana-1-pro - Nano Banana Pro

Google's flagship generation model

  • 🎯 Use Cases: Professional-grade high-quality image generation
  • ✨ Features: Supports 1K-4K resolution, up to 14 reference images, ultra-wide 21:9
typescript
{
  model: "nano-banana-1-pro",
  prompt: string,
  images?: string[],             // max 14 reference images
  aspect_ratio?: "1:1" | "2:3" | "3:2" | "4:3" | "3:4" | "4:5" | "5:4" | "16:9" | "9:16" | "21:9",
  resolution?: "1K" | "2K" | "4K"
}

nano-banana-2 - Nano Banana 2

Google Gemini latest model

  • 🎯 Use Cases: Latest technology for high-quality image generation
  • ✨ Features: Supports 1K-4K resolution, up to 14 reference images, ultra-wide 8:1 ratio
typescript
{
  model: "nano-banana-2",
  prompt: string,
  images?: string[],             // max 14 reference images
  aspect_ratio?: "1:1" | "2:3" | "3:2" | "4:3" | "3:4" | "4:5" | "5:4" | "16:9" | "9:16" | "21:9" | "4:1" | "1:4" | "8:1" | "1:8",
  resolution?: "1K" | "2K" | "4K"
}

Wan

wan-i-2-6 - Wan 2.6

High-quality and expressive

  • 🎯 Use Cases: Creative image generation requiring high expressiveness
  • ✨ Features: Supports up to 4 reference images, ultra-wide 21:9
typescript
{
  model: "wan-i-2-6",
  prompt: string,
  images?: string[],             // max 4 reference images
  aspect_ratio?: "1:1" | "4:3" | "3:2" | "16:9" | "3:4" | "2:3" | "9:16" | "21:9"
}

wan-2-5 - Wan 2.5

Fast, creative image generation

  • 🎯 Use Cases: Quick creation and iteration
  • ✨ Features: Supports up to 2 reference images, ultra-wide 21:9
typescript
{
  model: "wan-2-5",
  prompt: string,
  images?: string[],             // max 2 reference images
  aspect_ratio?: "1:1" | "4:3" | "3:2" | "16:9" | "3:4" | "2:3" | "9:16" | "21:9"
}

Seedream (ByteDance)

seedream-5-0 - Seedream 5.0 Lite

Intelligent visual reasoning

  • 🎯 Use Cases: Complex scenarios requiring intelligent understanding and reasoning
  • ✨ Features: 2K-3K resolution, up to 14 reference images, ultra-wide 21:9
typescript
{
  model: "seedream-5-0",
  prompt: string,
  images?: string[],             // max 14 reference images
  aspect_ratio?: "1:1" | "2:3" | "3:2" | "3:4" | "4:3" | "4:5" | "5:4" | "9:16" | "16:9" | "21:9",
  resolution?: "2K" | "3K"
}

seedream-4-5 - Seedream 4.5

ByteDance's 4K image model

  • 🎯 Use Cases: High-resolution professional image generation
  • ✨ Features: 2K-4K resolution, up to 14 reference images, ultra-wide 21:9
typescript
{
  model: "seedream-4-5",
  prompt: string,
  images?: string[],             // max 14 reference images
  aspect_ratio?: "1:1" | "2:3" | "3:2" | "3:4" | "4:3" | "4:5" | "5:4" | "9:16" | "16:9" | "21:9",
  resolution?: "2K" | "4K"
}

seedream-4-0 - Seedream 4.0

Support images with cohesive styles

  • 🎯 Use Cases: Image series requiring consistent style
  • ✨ Features: Supports up to 10 reference images
typescript
{
  model: "seedream-4-0",
  prompt: string,
  images?: string[],             // max 10 reference images
  aspect_ratio?: "1:1" | "4:3" | "3:2" | "16:9" | "3:4" | "2:3" | "9:16"
}

Flux (Black Forest Labs)

flux-2-dev - Flux.2 Dev

Photorealistic output

  • 🎯 Use Cases: Image generation requiring high photorealism
  • ✨ Features: Model by Black Forest Labs, multiple aspect ratio options
typescript
{
  model: "flux-2-dev",
  prompt: string,
  aspect_ratio?: "1:1" | "4:3" | "3:2" | "16:9" | "3:4" | "2:3" | "9:16"
}

flux-kontext-pro - Flux Kontext Pro

Perfect for editing, compositing

  • 🎯 Use Cases: Professional image editing and compositing work
  • ✨ Features: Supports reference images, customizable style
typescript
{
  model: "flux-kontext-pro",
  prompt: string,
  images?: string[],
  aspect_ratio?: "1:1" | "4:3" | "3:2" | "16:9" | "3:4" | "2:3" | "9:16",
  style?: string
}

flux-kontext-max - Flux Kontext Max

Excellent for prompt accuracy

  • 🎯 Use Cases: Scenarios requiring precise control of generation results
  • ✨ Features: Supports reference images, customizable style
typescript
{
  model: "flux-kontext-max",
  prompt: string,
  images?: string[],
  aspect_ratio?: "1:1" | "4:3" | "3:2" | "16:9" | "3:4" | "2:3" | "9:16",
  style?: string
}

flux-1-schnell - Flux Schnell

Suitable for simple basic scenes

  • 🎯 Use Cases: Quick prototyping and simple scenarios
  • ✨ Features: Fast generation speed
typescript
{
  model: "flux-1-schnell",
  prompt: string
}

Imagen (Google)

imagen-3-0 - Imagen 3.0

Fast, high-quality results

  • 🎯 Use Cases: Fast high-quality image generation
  • ✨ Features: Google's advanced image model, customizable style
typescript
{
  model: "imagen-3-0",
  prompt: string,
  aspect_ratio?: "1:1" | "3:4" | "4:3" | "9:16" | "16:9",
  style?: string
}

imagen-4-0 - Imagen 4.0

Google's latest generation model

  • 🎯 Use Cases: High-quality images requiring latest technology
  • ✨ Features: Higher quality and precision, customizable style
typescript
{
  model: "imagen-4-0",
  prompt: string,
  aspect_ratio?: "1:1" | "3:4" | "4:3" | "9:16" | "16:9",
  style?: string
}

Ideogram

ideogram-v2 - Ideogram V2

Highly recommended for text editing

  • 🎯 Use Cases: Scenarios requiring text in images
  • ✨ Features: Excellent text rendering performance
typescript
{
  model: "ideogram-v2",
  prompt: string,
  aspect_ratio?: "1:1" | "4:3" | "3:2" | "16:9" | "3:4" | "2:3" | "9:16",
  style?: string
}

ideogram-v3 - Ideogram V3

Outstanding design capabilities

  • 🎯 Use Cases: First choice for designers and creative professionals
  • ✨ Features: Better text rendering and typography
typescript
{
  model: "ideogram-v3",
  prompt: string,
  aspect_ratio?: "1:1" | "4:3" | "3:2" | "16:9" | "3:4" | "2:3" | "9:16",
  style?: string
}

Stability AI

stability-1-0 - Stability 1.0

Perfect for generating detailed images

  • 🎯 Use Cases: Image generation requiring fine control and high detail
  • ✨ Features: Supports negative prompts, customizable style
typescript
{
  model: "stability-1-0",
  prompt: string,
  aspect_ratio?: "1:1" | "4:3" | "3:2" | "16:9" | "3:4" | "2:3" | "9:16",
  style?: string,
  negative_prompt?: string       // Specify unwanted content
}

Music Generation

minimax-music - MiniMax Music

AI music generation from text with custom lyrics support

  • 🎯 Provider: MiniMax
  • ✨ Features: Text-to-music conversion, supports custom lyrics
  • 🎡 Use Cases: Music creation from text descriptions or lyrics
typescript
{
  model: "minimax-music",
  prompt: string,                // Required: Music generation description (max 300 characters)
  lyrics?: string                // Optional: Custom lyrics (max 3000 characters)
}

API Reference

Create Task (Async)

POST /api/v1/tasks/async - Create an async task. Returns immediately with task ID.

Request:

bash
curl -X POST https://monet.vision/api/v1/tasks/async \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $MONET_API_KEY" \
  -d '{
    "type": "video",
    "input": {
      "model": "sora-2",
      "prompt": "A cat running"
    },
    "idempotency_key": "unique-key-123"
  }'

⚠️ Important: idempotency_key is required. Use a unique value (e.g., UUID) to prevent duplicate task creation if the request is retried.

Response:

json
{
  "id": "task_abc123",
  "status": "pending",
  "type": "video",
  "created_at": "2026-02-27T10:00:00Z"
}

Create Task (Streaming)

POST /api/v1/tasks/sync - Create a task with SSE streaming. Waits for completion and streams progress.

Request:

bash
curl -X POST https://monet.vision/api/v1/tasks/sync \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $MONET_API_KEY" \
  -N \
  -d '{
    "type": "video",
    "input": {
      "model": "sora-2",
      "prompt": "A cat running"
    },
    "idempotency_key": "unique-key-123"
  }'

Get Task

GET /api/v1/tasks/{taskId} - Get task status and result.

Request:

bash
curl https://monet.vision/api/v1/tasks/task_abc123 \
  -H "Authorization: Bearer $MONET_API_KEY"

Response:

json
{
  "id": "task_abc123",
  "status": "success",
  "type": "video",
  "outputs": [
    {
      "model": "sora-2",
      "status": "success",
      "progress": 100,
      "url": "https://files.monet.vision/..."
    }
  ],
  "created_at": "2026-02-27T10:00:00Z",
  "updated_at": "2026-02-27T10:01:30Z"
}

List Tasks

GET /api/v1/tasks/list - List tasks with pagination.

Request:

bash
curl "https://monet.vision/api/v1/tasks/list?page=1&pageSize=20" \
  -H "Authorization: Bearer $MONET_API_KEY"

Response:

json
{
  "tasks": [
    {
      "id": "task_abc123",
      "status": "success",
      "type": "video",
      "outputs": [
        {
          "model": "sora-2",
          "status": "success",
          "progress": 100,
          "url": "https://files.monet.vision/..."
        }
      ],
      "created_at": "2026-02-27T10:00:00Z",
      "updated_at": "2026-02-27T10:01:30Z"
    }
  ],
  "page": 1,
  "pageSize": 20,
  "total": 100
}

Upload File

POST /api/v1/files - Upload a file to get an online access URL.

πŸ“ File Storage: Uploaded files are stored for 24 hours and will be automatically deleted after expiration.

Request:

bash
curl -X POST https://monet.vision/api/v1/files \
  -H "Authorization: Bearer $MONET_API_KEY" \
  -F "file=@/path/to/your/file.mp4" \
  -v

Use Cases:

  • Upload reference images for video/image generation tasks
  • Upload video files for video processing
  • Upload audio files for music tasks
  • Get temporary online URLs for file sharing

Response:

json
{
  "id": "file_xyz789",
  "url": "...",
  "filename": "file.mp4",
  "size": 1048576,
  "content_type": "video/mp4",
  "created_at": "2026-02-27T10:00:00Z"
}

Configuration

Environment Variables

bash
export MONET_API_KEY="monet_xxx"

Authentication

All API requests require authentication via the Authorization header:

text
Authorization: Bearer monet_xxx

Recommended skills

Browse all β†’

Related guides

Hand-picked reading to help you choose, install, and use agent skills.