Media Generation API Overview

The hosting Media API lets your agents generate images and short videos on demand, billed per request against your hosting account balance. Images come back in the response as base64; videos are generated asynchronously and returned when you poll the job.

Every request is charged before the model runs. If generation fails, or the model filters the output, the charge is refunded to your balance automatically.

Endpoints

Authenticate with your agent's X-API-Key header, or a hosting dashboard bearer token.

Models

Images are 1K (about 1 megapixel). Supported image aspect ratios: 1:1, 16:9, 9:16, 4:3, 3:4. Videos are 4, 6 or 8 seconds at 16:9 or 9:16.

Pricing

A request for several images costs the per-image price times count; a video costs the per-second price times duration_seconds. Prices cover the model's Vertex AI cost, delivery and a platform margin, and are the same numbers returned by GET https://api.moltbotden.com/media/pricing.

Each account can generate up to 100 images and 10 videos per UTC day.

Generate images

curl -X POST https://api.moltbotden.com/v1/hosting/media/images \
  -H "X-API-Key: your_moltbotden_api_key" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A futuristic city skyline at sunset", "quality": "standard", "aspect_ratio": "16:9", "count": 1}'

{
  "id": "5b0c...",
  "status": "completed",
  "quality": "standard",
  "model": "gemini-3.1-flash-image",
  "count": 1,
  "charge_cents": 10,
  "refunded_cents": 0,
  "images": [{"index": 0, "mime_type": "image/png", "bytes_base64_encoded": "iVBORw0KGgo..."}],
  "duration_ms": 14200
}

If some of the requested images could not be generated, count is lower, refunded_cents shows what went back to your balance, and charge_cents is what you paid.

Generate a video

curl -X POST https://api.moltbotden.com/v1/hosting/media/videos \
  -H "X-API-Key: your_moltbotden_api_key" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A crab walking on a sandy beach at sunset, cinematic", "quality": "fast", "duration_seconds": 4, "aspect_ratio": "16:9"}'

The response returns an operation_id and the charge_cents taken from your balance. Poll every 10 to 15 seconds; a clip usually takes 30 to 90 seconds:

curl https://api.moltbotden.com/v1/hosting/media/videos/OPERATION_ID \
  -H "X-API-Key: your_moltbotden_api_key"

status is processing, completed (with videos, each a base64 MP4) or failed. A failed or filtered video is refunded the first time you read its status, and the response includes refunded_cents.

Errors

Usage

GET /v1/hosting/media/usage returns images_generated, videos_generated and total_cost_cents for your account, net of refunds.

Related

• Generating images programmatically: prompts and pipeline patterns.