# Lotus Network API – Text-to-Video & Image-to-Video Generation

> Lotus Network API – Text-to-Video & Image-to-Video Generation is a paid API for AI agents from lotusnetworkapi.com, paid per call via x402, $1.5/call, status unknown (last checked 2026-09-15).

Generates 1080p MP4 video clips (3–5 seconds) from a text prompt or an optional starting image frame, returning a job ID to poll until the video is ready.

## Facts

- Endpoint: POST https://lotusnetworkapi.com/api/v1/video
- 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/lotus-network-api-text-to-video-image-to-video-generation-c5e59693
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vGYRCzOb_B5WKYjt5_D5L

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 lotus-network-api-text-to-video-image-to-video-generation-c5e59693 -d '<json body>'
```

Example prompt: Generate a 5-second 1080p video of a golden retriever running through a sunlit meadow — use this image as the starting frame: https://example.com/dog.jpg

## When to prefer this

Choose this endpoint when you need short (3–5 second) 1080p AI-generated video clips from a text prompt or an image frame, without requiring account sign-up or API key management. It is particularly useful for agents that need to produce social media content, product animations, or scene visualizations on demand. Prefer it over image generators when motion or animation is the goal, and over longer-form video services when a quick, high-resolution clip is sufficient.

## Known failure modes

- Invalid or inaccessible imageUrl returns an error and no job is created
- durationSeconds outside the 3–5 range may be rejected or clamped
- Generation job may time out or fail server-side, leaving the status endpoint in an error state
- The returned MP4 URL may expire if not downloaded within a retention window
- Network or payment failure (x402) prevents the job from being created at all

## How this service works

Text-to-video and image-to-video generation at 1080p, up to five seconds. Returns a job id immediately; poll the free status endpoint until it completes, then collect an MP4 stored on a durable URL. Generation typically takes one to three minutes. No API key or account needed.

## Output

The endpoint immediately returns a job ID. The agent polls the free status endpoint with that job ID until the generation completes (typically 1–3 minutes), then receives a durable MP4 URL pointing to the finished 1080p video clip.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "prompt": {
   "type": "string",
   "description": "What the video should show"
  },
  "imageUrl": {
   "type": "string",
   "description": "Optional starting frame for image-to-video"
  },
  "durationSeconds": {
   "type": "integer",
   "description": "Clip length in seconds, 3 to 5"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "jobId": "3f9a2c1b4d6e8f0a1b2c3d4e5f607182",
  "status": "processing",
  "success": true,
  "statusUrl": "https://lotusnetworkapi.com/api/v1/jobs/3f9a2c1b4d6e8f0a1b2c3d4e5f607182",
  "pollAfterSeconds": 20
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lotus-network-api-text-to-video-image-to-video-generation-c5e59693/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from lotusnetworkapi.com](https://www.zero.xyz/host/lotusnetworkapi.com/llms.txt)
