Skip to main content
1

Get API Key

Sign up and get your API key from RunBlob dashboard.
All requests require Bearer authentication with your API key.
2

Generate Video

Create a video generation task with a text prompt.
curl -X POST https://platform.runblob.io/v1/veo/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A cat playing with a ball in a sunny room"
  }'
Response:
{
  "generation_id": "ffd473d5-5bef-4e14-bf22-8d559be3c19f",
  "status": "pending",
  "seed": 319790131,
  "price": "0.2500"
}
3

Check Status

Monitor your video generation progress using the generation ID.
curl -X GET https://platform.runblob.io/v1/veo/generations/ffd473d5-5bef-4e14-bf22-8d559be3c19f -H "Authorization: Bearer YOUR_API_KEY"
Completed Response:
{
  "generation_id": "ffd473d5-5bef-4e14-bf22-8d559be3c19f",
  "status": "completed",
  "prompt": "A cat playing with a ball in a sunny room",
  "video_url": "https://your-video.mp4",
  "created_at": "2025-12-06T21:43:03.374000",
  "completed_at": "2025-12-06T21:44:06.143000",
  "seed": 319790131,
  "error": null
}
Video generation typically takes 1-10 minutes. Consider using webhooks for automatic notifications instead of polling.