---
title: "Draft video from URL"
method: POST
path: "/videos/drafts/url"
---

# Draft video from URL

`POST /videos/drafts/url`

## Request

- Base URL: `https://api.shortgenius.com/v1`
- URL: `https://api.shortgenius.com/v1/videos/drafts/url`
- Auth: HTTP bearer

Retrieve the content of a webpage and write a video based on it. ___Only text is currently supported___ -- the AI cannot watch videos. After calling this endpoint, call [Create Video](#tag/videos/POST/videos) with the results to create the video.

## Request body

- object
  - `url` string, required: URL of a webpage to summarize into a video. Only textual data can be processed; sites that block requests may fail.
  - `prompt` string: Instructions for the AI that is reading the webpage and writing the script.
  - `locale` 'af-ZA' | 'id-ID' | 'ms-MY' | 'ca-ES' | 'cs-CZ' | 'da-DK' | 'de-DE' | 'en-US' | 'es-ES' | 'es-419' | 'fr-CA' | 'fr-FR' | 'hr-HR' | 'it-IT' | 'hu-HU' | 'nl-NL' | 'no-NO' | 'pl-PL' | 'pt-BR' | 'pt-PT' | 'ro-RO' | 'sk-SK' | 'fi-FI' | 'sv-SE' | 'vi-VN' | 'tr-TR' | 'el-GR' | 'ru-RU' | 'sr-SP' | 'uk-UA' | 'hy-AM' | 'he-IL' | 'ur-PK' | 'ar-SA' | 'hi-IN' | 'th-TH' | 'ko-KR' | 'ja-JP' | 'zh-CN' | 'zh-TW' | 'auto': The locale of the video.

## Response `200`

Successful response

- DraftVideo
  - `title` string, required: The title of the video.
  - `caption` string, required: The description shown beside the video when posted to social media.
  - `scenes` DraftScene[], required
    - `title` string, nullable: If a news video, the headline for the story. Otherwise, blank.
    - `caption` string, required: The text narrated during the scene.
    - `image_query` string, nullable: The query for images search.
    - `first_image_description` string, nullable: The prompt for the first AI generated image.
    - `second_image_description` string, nullable: The prompt for the second AI generated image.
    - `first_image_animation_model` 'None' | 'Seedance' | 'Kling' | 'Hailuo02Standard' | 'Hailuo02Pro' | 'Veo3' | 'SeedanceTTV': Animation model for the first image.
    - `second_image_animation_model` 'None' | 'Seedance' | 'Kling' | 'Hailuo02Standard' | 'Hailuo02Pro' | 'Veo3' | 'SeedanceTTV': Animation model for the second image.
  - `image_style_recommendations` object[]: AI-generated image style recommendations for the video.
    - `preset_id` string, uuid, required: ID of the recommended image style preset.
    - `reason` string, required: Reason why this style is recommended for the video.
  - `selected_image_style_preset_id` string, uuid: ID of the currently selected image style preset.

## Other responses

- `400`: Invalid request
- `401`: Unauthorized request

---

[API](https://skmtc.dev/shortgenius/apis/shortgenius-api.md) · [All operations](https://skmtc.dev/shortgenius/apis/shortgenius-api/llms.txt) · [OpenAPI document](https://skmtc.dev/shortgenius/apis/shortgenius-api/revisions/532abda8ff32?raw)