---
title: "Create a generation job"
method: POST
path: "/v1/jobs"
tags: ["Jobs"]
---

# Create a generation job

`POST /v1/jobs`

## Request

- Base URL: `https://api.lizzflix.xyz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.lizzflix.xyz/v1/jobs`
- Auth: none declared

## Request body

- CreateGenerationJobRequest
  - `modelKey` string, required
  - `operation` string, required
  - `inputs` object
  - `targetRef` object

## Response `202`

Job queued (new) or reused (idempotency)

- union
  - CreateGenerationJobResponse
    - `jobId` string, required
    - `status` string, required
    - `statusUrl` string, required
    - `eventsUrl` string, required
  - StudioJob, nullable
    - `id` string, required
    - `jobType` string, nullable
    - `status` string, required
    - `queueMode` string
    - `sceneId` string, nullable
    - `provider` string, nullable
    - `model` string
    - `modelKey` string
    - `operation` string
    - `providerJobId` string, nullable
    - `attempt` number
    - `pollAfter` string, nullable
    - `request` object
    - `result` object, nullable
    - `errorMessage` string, nullable
    - `error` object, nullable
    - `createdAt` string
    - `updatedAt` string
    - `completedAt` string, nullable
    - `assets` object[]
  - unknown

## Other responses

- `400`: Bad request: the request breaks the model's limits, or (reason model_unavailable) its binding has not passed a live test (adapterVerified false) and the caller is neither an admin nor the worker
- `401`: Unauthorized
- `404`: A targetRef id or input asset is not the viewer's, or options.voiceId is not a voice the viewer may use
- `422`: CONTENT_BLOCKED: the safety layer refused the request's text; nothing was held, written or queued
- `503`: options.voiceId is not one of the viewer's own voices and the ElevenLabs voice catalog cannot be read right now (code PROVIDER_UNAVAILABLE, reason voice_catalog_unavailable)

---

[API](https://skmtc.dev/lizzflix/apis/lizzflix-api.md) · [All operations](https://skmtc.dev/lizzflix/apis/lizzflix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lizzflix/apis/lizzflix-api/revisions/4536ce9d80ff?raw)