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

# Make a depth map with Video Depth Anything

> Turns a video into a depth map video: near is white, far is black, steady from frame to frame, at the input's size (up to 1080p) and frame rate (up to 30 fps). Feed it to a video model as a structure or motion reference. Three sizes: small is fastest, base adds edge detail, large draws the finest detail (hair, thin poles, distant people) and is the steadiest. Priced per second of the INPUT video, rounded up, 5 seconds minimum: small 20, base 30, large 40 credits/second (input up to 30 seconds, ≤100MB). Output is H.264 MP4.

**Asynchronous.** Returns a job `id` (the video is not in this response). Poll [`GET /v1/depth-maps/{id}`](/api-reference/depth-maps/get-depth-map-job-status) until `status` is `succeeded` — the depth video's URL is in that response's `video_url`.

Examples, sample output and pricing: [Video Depth Anything](https://budgetpixel.com/models/video-depth-anything)



## OpenAPI

````yaml /openapi.yaml post /depth-maps/video-depth-anything
openapi: 3.1.0
info:
  contact:
    email: support@budgetpixel.com
    name: BudgetPixel Support
  description: >
    The BudgetPixel developer API for programmatic image, video, music and

    sound-effect generation.


    Generation is **asynchronous**: you create a job, then poll its status until
    it

    reaches a terminal state (`succeeded` / `failed`). You are charged in
    credits

    only on success — never for failures, timeouts, or content blocked before

    generation.


    **Authentication.** All requests require an API key sent as a bearer token:

        Authorization: Bearer bpx_live_xxx

    Create and manage keys from your BudgetPixel account dashboard. The
    developer

    API is available on **every paid plan**. On the **Free** plan, API keys can
    call

    the free library searches only: `GET /v1/stock/images`,

    `GET /v1/stock/sound-effects` and `GET /v1/stock/music`.


    **Pricing.** API usage is metered in credits at each model's published price

    (see `GET /v1/models`), and your plan's model discounts and active
    promotions

    apply to API charges exactly as they do on the web — `POST /v1/cost` quotes

    your discounted price. Pro and Ultra plans include a daily free-models

    allowance (a shared pool of free generations per day across qualified image

    models such as FLUX 2 Klein and Qwen-Image) that covers API

    requests too — the standard price applies once the day's pool is used.

    Other promotional free daily generations remain web/app-only. Failed

    generations are never charged.


    **Rate limits.** Requests are limited per minute: **600 requests/min per API

    key** and **1200 requests/min per source IP** (defaults; subject to tuning).

    Every response carries `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and

    `X-RateLimit-Reset` (seconds until the window resets). Exceeding a limit

    returns HTTP `429` with a `Retry-After` header — wait that long before

    retrying. Rejected requests still count against the window, so a tight retry

    loop keeps you limited; back off instead. Generation jobs additionally have
    a

    per-plan concurrency cap (the same one as the web workshop), independent of

    these request limits. `POST /v1/uploads` also has a dedicated **60
    uploads/min

    per account** cap (it's free/unmetered) on top of these limits.
  title: BudgetPixel API
  version: '2026-06-20'
servers:
  - description: Production
    url: https://api.budgetpixel.com/v1
security:
  - ApiKeyAuth: []
tags:
  - description: Account and credit balance
    name: Account
  - description: Discover available models and pricing
    name: Models
  - description: Upload input media for image/video generation
    name: Uploads
  - description: Image job status
    name: Images
  - description: FLUX image models
    name: Black Forest Labs
  - description: SeeDream image models
    name: Bytedance
  - description: Video job status
    name: Videos
  - description: Kuaishou Kling video models
    name: Kling
  - description: SeeDance video models
    name: ByteDance (SeeDance)
  - description: Music and sound-effect job status
    name: Audios
  - description: Music generation models
    name: Music
  - description: Text-to-sound-effect models (priced per second)
    name: Sound Effects
  - description: >-
      Image-to-3D models — a picture in, a textured 3D model (GLB, plus
      FBX/USDZ/STL on Meshy) out
    name: 3D Models
  - description: Format conversion for images, video, and audio
    name: Conversions
  - description: Publish posts to your BudgetPixel feed and enter clan themes
    name: Social
  - description: Content moderation — NSFW rating and CSAM detection
    name: Moderation
  - description: Content classification — music genre detection
    name: Classification
  - description: >-
      Search the free stock image library — available on every plan, including
      Free
    name: Stock Images
  - description: >-
      Search the free sound effect library — available on every plan, including
      Free
    name: Stock Sound Effects
  - description: >-
      Search the free background music library — available on every plan,
      including Free
    name: Stock Music
  - description: >-
      Turn a video into a depth map video to guide other video models with its
      structure and motion
    name: Depth Maps
paths:
  /depth-maps/video-depth-anything:
    post:
      tags:
        - Depth Maps
      summary: Make a depth map with Video Depth Anything
      description: >-
        Turns a video into a depth map video: near is white, far is black,
        steady from frame to frame, at the input's size (up to 1080p) and frame
        rate (up to 30 fps). Feed it to a video model as a structure or motion
        reference. Three sizes: small is fastest, base adds edge detail, large
        draws the finest detail (hair, thin poles, distant people) and is the
        steadiest. Priced per second of the INPUT video, rounded up, 5 seconds
        minimum: small 20, base 30, large 40 credits/second (input up to 30
        seconds, ≤100MB). Output is H.264 MP4.


        **Asynchronous.** Returns a job `id` (the video is not in this
        response). Poll [`GET
        /v1/depth-maps/{id}`](/api-reference/depth-maps/get-depth-map-job-status)
        until `status` is `succeeded` — the depth video's URL is in that
        response's `video_url`.


        Examples, sample output and pricing: [Video Depth
        Anything](https://budgetpixel.com/models/video-depth-anything)
      operationId: createDepthMap_video_depth_anything
      requestBody:
        content:
          application/json:
            schema:
              properties:
                colormap:
                  default: grayscale
                  description: >-
                    grayscale (near = white) is what video models take as a
                    depth reference; turbo, inferno, magma and viridis colour it
                    for viewing.
                  enum:
                    - grayscale
                    - turbo
                    - inferno
                    - magma
                    - viridis
                  type: string
                keep_audio:
                  default: false
                  description: Copy the input's audio into the depth video.
                  type: boolean
                resolution:
                  default: auto
                  description: >-
                    The output's short side; auto keeps the input's size up to
                    1080p. Never upscales. The price is the same at every
                    resolution.
                  enum:
                    - auto
                    - 360p
                    - 480p
                    - 720p
                    - 1080p
                  type: string
                side_by_side:
                  default: false
                  description: >-
                    Return the input on the left and the depth map on the right,
                    twice the width.
                  type: boolean
                size:
                  default: small
                  description: >-
                    Model size, which sets the per-second rate: small 20, base
                    30, large 40 credits.
                  enum:
                    - small
                    - base
                    - large
                  type: string
                video:
                  description: >-
                    The video to turn into a depth map (up to 30 seconds,
                    MP4/MOV/WebM, ≤100MB). A public video URL or an
                    uploaded-file URL from POST /v1/uploads (videos are passed
                    by URL, not inlined).
                  type: string
                  x-bpx-media: video
              required:
                - video
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateDepthMapResponse'
          description: Job accepted.
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
components:
  schemas:
    CreateDepthMapResponse:
      properties:
        credits:
          charged when it succeeds.: null
          description: >-
            Total price of this job (seconds x the size's per-second rate). Held
            now
          type: integer
        id:
          description: Opaque job id (`dpt_...`) — use it to poll status.
          type: string
        message:
          type: string
        model:
          type: string
        seconds:
          description: >-
            Billed duration — the input video's length, rounded up to whole
            seconds, at least 5.
          type: integer
        size:
          description: The model size the job runs at.
          enum:
            - small
            - base
            - large
          type: string
        status:
          $ref: '#/components/schemas/JobStatus'
      type: object
    JobStatus:
      description: Lifecycle state. `succeeded`/`failed`/`timeout` are terminal.
      enum:
        - pending
        - starting
        - processing
        - completing
        - succeeded
        - failed
        - timeout
      type: string
    Error:
      properties:
        error:
          properties:
            code:
              description: Stable machine-readable code.
              example: model_not_available
              type: string
            message:
              type: string
            type:
              description: Error category.
              example: invalid_request_error
              type: string
          required:
            - type
            - code
            - message
          type: object
      required:
        - error
      type: object
    ModerationBlocked:
      description: >-
        Returned (with HTTP 400) when the input content moderation gate blocks a
        generation request. The block is a property of the request's prompt or
        input media — reword the prompt or change the input and retry. Branch on
        `restriction_reason`, which is stable and machine-readable.
      properties:
        error:
          description: Human-readable explanation of the block.
          type: string
        restriction_reason:
          description: Stable machine-readable block reason.
          enum:
            - input_csam
            - input_explicit_adult
            - input_upload_nudity
            - input_celebrity_likeness
            - strict_model_nsfw
          type: string
      required:
        - error
        - restriction_reason
      type: object
  responses:
    BadRequest:
      content:
        application/json:
          schema:
            oneOf:
              - $ref: '#/components/schemas/Error'
              - $ref: '#/components/schemas/ModerationBlocked'
      description: >-
        The request was malformed, referenced an unavailable model, or was
        blocked by input content moderation (moderation blocks carry a
        `restriction_reason` — see ModerationBlocked).
    Unauthorized:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Missing or invalid API key.
    Forbidden:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: >-
        Authenticated but not permitted (plan gate, ownership, account
        restriction). Content-moderation blocks are 400, not 403.
    TooManyRequests:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Rate or queue limit reached. Retry after a short delay.
  securitySchemes:
    ApiKeyAuth:
      bearerFormat: bpx_live_*
      description: 'API key as a bearer token: Authorization: Bearer bpx_live_xxx'
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.