# Haven Video Sound Generator

> Haven Video Sound Generator is a paid API for AI agents from api.havenagent.ai, paid per call via x402, $1.5/call, status unknown (last checked 2026-09-15).

Generates an AI-created video with synchronized sound from an image and text prompt, returned as an async job

## Facts

- Endpoint: POST https://api.havenagent.ai/x402/api/v1/video-sound
- Price: $1.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/haven-video-sound-generator-3fb9422e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_l87GOxiT-p_a7b-z_y-9b

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 haven-video-sound-generator-3fb9422e -d '<json body>'
```

Example prompt: Take this image of my living room and generate a 5-second video with ambient sound — like a cozy evening vibe — using Haven's video-sound generator.

## When to prefer this

Choose this endpoint when you need to generate a short AI video (4–10 seconds) with synchronized sound starting from a still image and a descriptive text prompt. It is specifically suited for home-context media generation (e.g., ambient clips, property visuals) and produces MP4 output with embedded AI disclosure metadata. Prefer this over text-only or image-only generation endpoints when the output must include both visual motion and audio. Note the async/polling model means it is not suitable for real-time or latency-sensitive workflows.

## Known failure modes

- Invalid or malformed base64 image data causing rejection
- Image media type mismatch (sending JPEG but declaring PNG or vice versa)
- Prompt exceeding 2000-character limit
- Duration outside allowed range of 4–10 seconds
- Payment failure via x402 protocol resulting in 402 response
- Job timeout or failure detected via status polling beyond pollBudgetSeconds (1800s)
- Result URL returning empty or error if generation fails on the backend

## How this service works

Haven is a private AI agent for your home. Join the waitlist for h1 speaker updates and early app access.

## Output

An asynchronous job response containing a jobId, a statusUrl to poll for completion, a resultUrl where the finished MP4 video can be downloaded, an estimated ETA of up to 900 seconds, and embedded AI disclosure metadata (label, statement, terms URL) baked into the MP4 metadata indicating the content is machine-generated.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "prompt": {
   "type": "string",
   "maxLength": 2000,
   "minLength": 1
  },
  "mediaType": {
   "enum": [
    "image/png",
    "image/jpeg"
   ],
   "type": "string"
  },
  "imageBase64": {
   "type": "string",
   "description": "base64 image bytes, no data-URI prefix"
  },
  "durationSeconds": {
   "type": "integer",
   "default": 5,
   "maximum": 10,
   "minimum": 4
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "kind": "video_sound",
  "jobId": "00000000-0000-0000-0000-000000000000",
  "status": "queued",
  "resultUrl": "https://api.havenagent.ai/x402/api/v1/video-sound/jobs/00000000-0000-0000-0000-000000000000/result",
  "statusUrl": "https://api.havenagent.ai/x402/api/v1/video-sound/jobs/00000000-0000-0000-0000-000000000000",
  "etaSeconds": 900,
  "aiDisclosure": {
   "label": "AI Generated",
   "termsUrl": "https://havenagent.ai/terms/terms-of-service",
   "statement": "AI Generated: this video is machine-generated by Haven Media and does not depict real events. Use terms: https://havenagent.ai/terms/terms-of-service",
   "embeddedIn": "mp4-metadata",
   "aiGenerated": true
  },
  "pollBudgetSeconds": 1800
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/haven-video-sound-generator-3fb9422e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.havenagent.ai](https://www.zero.xyz/host/api.havenagent.ai/llms.txt)