# Suede AI Music Video Generator

> Suede AI Music Video Generator is a paid API for AI agents from app.suedeai.ai, paid per call via x402, $4.99/call, status unknown (last checked 2026-09-15).

Generates a fully owned short-form music-video clip from a narrative or visual prompt, with configurable resolution, aspect ratio, and duration.

## Facts

- Endpoint: POST https://app.suedeai.ai/agent/video
- Price: $4.99/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suede-ai-music-video-generator-f9b72111
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LnEifQ6NSLNW0MSL-bIBu

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability suede-ai-music-video-generator-f9b72111 -d '<json body>'
```

Example prompt: Generate a 16-second Suede AI music video clip for my indie-pop song campaign — use a cinematic concert crowd aesthetic, render it in 1024p at 16:9, and return the asset URL when it's done.

## When to prefer this

Choose this endpoint when you need a creator-owned, rights-clear short-form music video clip generated from a text prompt — especially when pairing with Suede's full-length song generation endpoint for an end-to-end music content pipeline. Prefer this over generic video generators when provenance fingerprinting and creator ownership are required, or when vertical/square social media formats are needed for music or campaign content.

## Known failure modes

- Invalid or missing prompt returns a 400 validation error
- Unsupported resolution or aspect ratio enum value returns 400
- durationSeconds out of allowed range returns 400 or capped silently
- Async mode may return a pending state without an assetUrl until render completes
- Payment failure (insufficient USDC) returns 402
- Render timeout or model overload may return 503 or delayed async result
- Invalid seed integer may be ignored or cause a 400 error

## How this service works

AI video generation from a text prompt. Returns an 8-second 720p clip with native audio. Use for short-form video, b-roll, product shots, music-video visuals, social clips, and ads. Include sound cues (instruments, voices, weather, movement) since audio is generated from the scene; a silent scene renders near-silent by design. Async by default: poll the returned pollUrl for videoUrl, or pass ?async=false to block.

## Output

Returns a videoId, a direct CDN asset URL (.mp4), a shareable link to the rendered clip, and a provenance fingerprint hash for creator ownership verification.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "prompt": {
   "type": "string",
   "description": "Narrative or visual prompt to drive the video concept."
  },
  "aspectRatio": {
   "enum": [
    "16:9",
    "9:16",
    "1:1"
   ],
   "type": "string",
   "description": "Desired frame aspect ratio."
  },
  "durationSeconds": {
   "type": "integer",
   "default": 8,
   "maximum": 15,
   "minimum": 3,
   "description": "Requested clip length in seconds; the service maps it to a supported render length."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "jobId": "video-job-example",
 "status": "queued",
 "pollUrl": "https://app.suedeai.ai/agent/video/video-job-example",
 "provider": "suede"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/suede-ai-music-video-generator-f9b72111/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from app.suedeai.ai](https://www.zero.xyz/host/app.suedeai.ai/llms.txt)