Generate Video

Generating a video is a bit different from generating an image. Video generation uses specialized AI models to create fluid motion based on your text prompts.

Use Cases

Create stunning videos with our GenAI Video generation models. At Skytells, we offer a wide range of video models for different use cases, each with its own unique features and capabilities.

Video Generation Models

Skytells offers two powerful models for video generation:

Choosing Video Model

When deciding between truefusion-video and truefusion-video-pro, consider the following:

• TrueFusion Video offers a good balance of quality and cost at 720p resolution
• TrueFusion Video Pro provides higher quality 1080p video at a premium price
• Both models support the same input parameters and capabilities
• Processing time is slightly faster on TrueFusion Video Pro for the same duration
• For budget-conscious projects, TrueFusion Video is recommended
• For professional-quality outputs, TrueFusion Video Pro is recommended

How Video Generation Works

Unlike image generation, video predictions:

• Are processed asynchronously (the await parameter is disabled by default)
• Are queued for processing with webhook notifications upon completion
• Require longer processing times than images

Create a Video Prediction

curl -X POST "https://api.skytells.ai/v1/predict" \
  -H "x-api-key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "truefusion-video",
    "gpu": "H100",
    "safety_check": true,
    "input": {
      "prompt": "a portrait photo of a man with flowing hair, looking confident",
      "duration": 5,
      "cfg_scale": 0.5,
      "start_image": "IMAGE_URL",
      "aspect_ratio": "16:9",
      "negative_prompt": ""
    },
    "webhook": {
      "url": "YOUR_WEBHOOK_URL",
      "events": ["completed"]
    }
  }'

Prediction Notifications

The webhook is required for video generation.

After successful video generation, your server will receive the complete Prediction via the webhook URL you provided. The webhook payload will contain the same structure as the prediction response, including output URLs to the generated video.

Please note that the webhook is triggered for each prediction status change.

Learn more about the webhook in the Webhooks section.

If you need to check the status of your video generation at any time, you can query the prediction endpoint with the prediction ID, Meanwhile, we recommend using the webhook to get notified when the video generation is completed.

Video Generation Status

curl -X GET "https://api.skytells.ai/v1/predictions/{id}" \
  -H "x-api-key: your-api-key-here"

{
  "id": "PREDICTION_ID",
  "status": "succeeded",
  "stream": false,
  "input": {
    "prompt": "A man is coding for Skytells",
    "duration": 5,
    "cfg_scale": 0.5,
    "start_image": "YOUR_START_IMAGE_URL",
    "aspect_ratio": "16:9",
    "negative_prompt": ""
  },
  "output": [
    "VIDE_URL"
  ],
  "created_at": "2023-11-20T14:15:24.000000Z",
  "started_at": "2023-11-20T14:15:25.123456Z",
  "completed_at": "2023-11-20T14:19:52.987654Z",
  "updated_at": "2023-11-20T14:19:53.000000Z",
  "model": {
    "name": "truefusion-video"
  },
  "webhook": {
    "url": "YOUR_WEBHOOK_URL",
    "events": ["completed"]
  },
  "metrics": {
    "predict_time": 267.864198
  },
  "metadata": {
    "billing": {
      "credits_used": 0.56
    },
    "storage": {
      "files": [
        {
          "name": "vid_predictionid123456.mp4",
          "type": "video/mp4",
          "size": 28741832,
          "url": "VIDEO_URL"
        }
      ]
    }
  },
  "urls": {
    "get": "GET_URL",
    "cancel": "CANCEL_URL"
  }
}

Cancel a Video Generation

curl -X POST "https://api.skytells.ai/v1/predictions/{id}/cancel" \
  -H "x-api-key: your-api-key-here"

{
  "status": "canceled",
  "message": "Prediction canceled successfully"
}