> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.deerapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Veo 3 Create

> Use DeerAPI to call the Veo 3 Create endpoint with request details, response details, examples, and an OpenAPI playground.

## Overview

Use this endpoint to call the Veo 3 Create workflow through DeerAPI. The API reference on this page shows the request schema, response schema, authentication requirements, and runnable examples for the configured endpoint.

## Before you start

Use the DeerAPI base URL and pass your API Key in the `Authorization` header:

```text theme={null}
https://api.deerapi.com
```

```text theme={null}
Authorization: Bearer $DEERAPI_KEY
```

## Model selection

Choose a current model ID from the [live pricing page](https://api.deerapi.com/pricing). Model availability changes over time, so avoid copying a model ID from an old project without checking the live list first.

## Implementation notes

* Use the OpenAPI playground for the exact request fields accepted by this endpoint.
* Keep API Keys on the server side when you build production applications.
* Log the request ID from failed calls so support can investigate the request.
* Retry `429`, `500`, and `503` responses with exponential backoff.


## OpenAPI

````yaml /api/openapi/video/veo3/async/post-veo3-async.openapi.json POST /v1/videos
openapi: 3.1.0
info:
  title: Veo 3 Async API
  version: 1.0.0
servers:
  - url: https://api.deerapi.com
security:
  - bearerAuth: []
paths:
  /v1/videos:
    post:
      summary: Veo 3 Async API
      operationId: post_v1_videos
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                prompt:
                  type: string
                  description: Use this field according to the endpoint schema.
                  example: >-
                    A whimsical flying elephant soaring over a vibrant
                    candy-colored cityscape at sunset, with rainbow trails
                    behind its wings, playful monkeys riding on its back
                    throwing confetti, in a whimsical animated style like a
                    Pixar movie, camera panning smoothly from ground level to
                    aerial view,
                model:
                  type: string
                  enum:
                    - veo3
                    - veo3-fast
                    - veo3-pro
                    - veo3.1
                    - veo3.1-pro
                  x-apifox-enum:
                    - value: veo3
                      name: ''
                      description: ''
                    - value: veo3-fast
                      name: ' '
                      description: ''
                    - value: veo3-pro
                      name: ' '
                      description: ''
                    - value: veo3.1
                      name: ''
                      description: ''
                    - value: veo3.1-pro
                      name: ''
                      description: ''
                  description: Use this field according to the endpoint schema.
                  example: veo3.1
                size:
                  type: string
                  description: Use this field according to the endpoint schema.
                  example: 16x9
                input_reference:
                  format: binary
                  type: string
                  description: Use this field according to the endpoint schema.
                  example: cmMtdXBsb2FkLTE3NjI1MDM2MzU5NjMtNw==/image.jpg
              required:
                - prompt
              default:
                prompt: >-
                  A whimsical flying elephant soaring over a vibrant
                  candy-colored cityscape at sunset, with rainbow trails behind
                  its wings, playful monkeys riding on its back throwing
                  confetti, in a whimsical animated style like a Pixar movie,
                  camera panning smoothly from ground level to aerial view,
            example:
              prompt: >-
                A whimsical flying elephant soaring over a vibrant candy-colored
                cityscape at sunset, with rainbow trails behind its wings,
                playful monkeys riding on its back throwing confetti, in a
                whimsical animated style like a Pixar movie, camera panning
                smoothly from ground level to aerial view,
              model: veo3.1
            examples:
              Default:
                summary: Default request
                value:
                  prompt: >-
                    A whimsical flying elephant soaring over a vibrant
                    candy-colored cityscape at sunset, with rainbow trails
                    behind its wings, playful monkeys riding on its back
                    throwing confetti, in a whimsical animated style like a
                    Pixar movie, camera panning smoothly from ground level to
                    aerial view,
                  model: veo3.1
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - id
                  - object
                  - created_at
                  - status
                  - completed_at
                  - error
                  - expires_at
                  - model
                  - progress
                  - remixed_from_video_id
                  - seconds
                  - size
                properties:
                  id:
                    type: string
                  object:
                    type: string
                  created_at:
                    type: integer
                  status:
                    type: string
                  completed_at:
                    type: 'null'
                  error:
                    type: 'null'
                  expires_at:
                    type: 'null'
                  model:
                    type: string
                  progress:
                    type: integer
                  remixed_from_video_id:
                    type: 'null'
                  seconds:
                    type: string
                  size:
                    type: string
      x-codeSamples:
        - lang: Shell
          label: cURL
          source: |
            curl -s 'https://api.deerapi.com/v1/videos' \
              -H "Authorization: Bearer $DEERAPI_KEY" \
              -F 'prompt=A whimsical flying elephant soaring over a vibrant candy-colored cityscape at sunset, with rainbow trails behind its wings, playful monkeys riding on its back throwing confetti, in a whimsical animated style like a Pixar movie, camera panning smoothly from ground level to aerial view,' \
              -F 'model=veo3.1'
        - lang: Python
          label: requests
          source: >
            import os

            import requests


            url = "https://api.deerapi.com/v1/videos"

            headers = {"Authorization": "Bearer " + os.environ["DEERAPI_KEY"]}

            data = {
              "prompt": "A whimsical flying elephant soaring over a vibrant candy-colored cityscape at sunset, with rainbow trails behind its wings, playful monkeys riding on its back throwing confetti, in a whimsical animated style like a Pixar movie, camera panning smoothly from ground level to aerial view,",
              "model": "veo3.1"
            }

            files = {}


            response = requests.post(url, headers=headers, data=data,
            files=files)

            print(response.json())
        - lang: JavaScript
          label: fetch
          source: >
            const form = new FormData();

            form.append("prompt", "A whimsical flying elephant soaring over a
            vibrant candy-colored cityscape at sunset, with rainbow trails
            behind its wings, playful monkeys riding on its back throwing
            confetti, in a whimsical animated style like a Pixar movie, camera
            panning smoothly from ground level to aerial view,");

            form.append("model", "veo3.1");


            const response = await fetch("https://api.deerapi.com/v1/videos", {
              method: "POST",
              headers: { Authorization: `Bearer ${process.env.DEERAPI_KEY}` },
              body: form,
            });


            console.log(await response.json());
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Use a DeerAPI API Key as a Bearer token.

````