---
title: "POST /api/v1/client/txt2video"
method: POST
path: "/api/v1/client/txt2video"
tags: ["Client API"]
---

# POST /api/v1/client/txt2video

`POST /api/v1/client/txt2video`

Endpoint for requesting text2video inference

## Headers

- `Accept` 'application/json', required

## Request body

- object
  - `prompt` string, required — The main prompt for video generation
  - `negative_prompt` string, nullable — Elements to avoid in the generated video
  - `width` integer, required — Width of the generated video in pixels
  - `height` integer, required — Height of the generated video in pixels
  - `guidance` number, required — Guidance scale for the generation
  - `steps` integer, required — Number of inference steps
  - `frames` integer, required — Number of video frames to generate
  - `fps` integer — FPS of generated video
  - `seed` integer, required — Random seed for generation
  - `model` string, required — The model to use for video generation. Available models can be retrieved via the GET /api/v1/client/models endpoint.
  - `webhook_url` string, uri, nullable — Optional HTTPS URL to receive webhook notifications for job status changes (processing, completed, failed). Must be HTTPS. Max 2048 characters. See [Webhook Documentation](/execution-modes-and-integrations/webhooks) for payload structure and authentication details.

## Response `200`

ID of the inference request.

- JobRequestResponseResource
  - `data` object — Information from success endpoint
    - `request_id` string — Request Id

## Other responses

- `401` — Unauthorized user.
- `404` — Not found.
- `422` — Validation failed. Common errors include: model does not exist, model does not support the inference type for this endpoint, or invalid request parameters.
- `429` — Rate limit exceeded. Check X-RateLimit-Type header to determine if minute (RPM) or daily (RPD) limit was hit.

---

[API](https://skmtc.net/deapi/apis/deapi-rest-api.md) · [All operations](https://skmtc.net/deapi/apis/deapi-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/deapi/deapi-rest-api/versions/c70b8b231ca8/schema)