> For the complete documentation index, see [llms.txt](https://hourone.gitbook.io/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hourone.gitbook.io/api-docs/blueprint-quick-start.md).

# Blueprint - Quick Start

## Get your API keys

{% content-ref url="/pages/ZJ1yPGsS9kK7l4YceevL" %}
[Get Your API Keys](/api-docs/get-your-api-keys.md)
{% endcontent-ref %}

## Create your first Base Project in HourOne

Login to the HourOne platform <https://app.hourone.ai>&#x20;

Create a project by choosing from one of our templates, give the project a name, and create a project based on it by clicking the Use This Template button.

Your project will be created with prefilled content.

Configure the number of scenes you would like your base project to have. you can do so by clicking on the deleted scene and adding scene buttons.

Choose layouts for the scenes. You can open the layout panel by clicking on the “scene” button on the right-side panel.&#x20;

Layouts are simply a definition of how the scene will look like, for example, a scene with an image, a scene with some text, and more.

## Make your first request

To easily create your first request we recommend clicking on the **Copy API curl** button which will generate a curl command you can use to generate a video.

The copied command will include the body of the request in the form of a JSON, you will be able to enter your data and replace the values within the JSON.

![](/files/w0QScMcYVJO5spnWlPZc)

Now paste in your favorite tool, for example, Postman.

<figure><img src="/files/U762e9H4rFif4YG8OAl7" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Don't forget to enter your API key
{% endhint %}

Once you have modified the JSON use your API key to make a call to the videos endpoint.

{% hint style="info" %}
**Good to know:** the DraftID of your project can be found in the project’s editor URL
{% endhint %}

{% openapi src="/files/7dpuvSCz0OWK9rlAYGlG" path="/videos" method="post" %}
[openapi.json](https://4056101549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE2BIsAJcoZJkBZEYT3ss%2Fuploads%2FCMccnb5ESpusHNeb0B2R%2Fopenapi.json?alt=media\&token=9dfd448b-cf23-460d-ab32-043c828859aa)
{% endopenapi %}

The number of scenes sent in the request must be equal to the base project’s number of scenes.&#x20;

Example of a draft with 3 scenes,

```json
{
    "source_draft_id": "<your draft_id here>",
    "character_id": "<optional>", # if you wish to override base
    "voice_id": "<optional>", # if you wish to override the base
    "scenes": [
        {
            "name": "SCENE 1",
            "transcript": "this is the first scenes transcript"
        },
        {
            "name": "SCENE 2",
            "media": [
                "https://cdn.searchenginejournal.com/wp-content/uploads/2018/04/durable-urls.png"
            ],
            "texts": [
                "this is the second scenes title"
            ],
            "transcript": "this is the second scenes transcript"
        },
        {
            "name": "SCENE 3",
            "texts": [
                "this is the third scenes title"
            ],
            "transcript": "this is the third scenes transcript"
        }
    ]
}

```

## Get the video status

Using the **id** received in the video creation call you will be able to poll the status of your video by calling the following API<br>

{% hint style="info" %}
You can always go to the Reals platform and see your videos and status there.
{% endhint %}

{% openapi src="/files/7dpuvSCz0OWK9rlAYGlG" path="/videos" method="get" %}
[openapi.json](https://4056101549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE2BIsAJcoZJkBZEYT3ss%2Fuploads%2FCMccnb5ESpusHNeb0B2R%2Fopenapi.json?alt=media\&token=9dfd448b-cf23-460d-ab32-043c828859aa)
{% endopenapi %}

{% openapi src="/files/7dpuvSCz0OWK9rlAYGlG" path="/videos/{video\_id}" method="get" %}
[openapi.json](https://4056101549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FE2BIsAJcoZJkBZEYT3ss%2Fuploads%2FCMccnb5ESpusHNeb0B2R%2Fopenapi.json?alt=media\&token=9dfd448b-cf23-460d-ab32-043c828859aa)
{% endopenapi %}