---
title: "Run an AI video helper function"
method: POST
path: "/api/v1/ai/video-function"
tags: ["AI"]
---

# Run an AI video helper function

`POST /api/v1/ai/video-function`

## Request

- Base URL: `https://www.poster.ly`
- URL: `https://www.poster.ly/api/v1/ai/video-function`
- Auth: HTTP bearer

Run read-only helper functions for public video generation, such as estimating Veo credit cost or validating a prospective generation request. This endpoint does not generate video or spend credits.

## Request body

- VideoFunctionRequest
  - `identifier` 'google_veo' | 'veo3' | 'xai_grok' | 'grok_imagine', required
  - `functionName` 'list_input_modes' | 'estimate_cost' | 'validate_request', required
  - `params` object

## Response `200`

Video helper function completed

- VideoFunctionResponse

## Other responses

- `400`: Validation error
- `401`: Invalid or missing API key
- `429`: Too many requests

---

[API](https://skmtc.dev/poster/apis/posterly-api.md) · [All operations](https://skmtc.dev/poster/apis/posterly-api/llms.txt) · [OpenAPI document](https://skmtc.dev/poster/apis/posterly-api/revisions/60be02a61f95?raw)