# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://hourone.gitbook.io/api-docs/blueprint-quick-start.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.