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

# Create a new job

`POST /v1/jobs`

Submit a job for AI media generation. Returns 202 Accepted with job details.

**Note:** Either `model` or `parent_job_id` is required. Chain actions (extend, upscale, vary) can inherit model from parent job.

## Request body

- union — Either `model` or `parent_job_id` is required.
  - object
    - `model` 'bytedance-seedream' | 'bytedance-seedream-v4-edit' | 'bytedance-seedream-v4-text-to-image' | 'claude-opus-4-6' | 'claude-opus-4-7' | 'claude-opus-4-8' | 'claude-sonnet-4-6' | 'elevenlabs-sfx' | 'elevenlabs-tts-multilingual' | 'elevenlabs-tts-turbo' | 'flux-2-flex-i2i' | 'flux-2-flex-t2i' | 'flux-2-pro-i2i' | 'flux-2-pro-t2i' | 'google-imagen4' | 'gpt-image-1.5-i2i' | 'gpt-image-1.5-t2i' | 'gpt-image-2-i2i' | 'gpt-image-2-t2i' | 'grok-imagine-i2i' | 'grok-imagine-i2v' | 'grok-imagine-t2i' | 'grok-imagine-t2v' | 'hailuo-02-pro-i2v' | 'hailuo-02-pro-t2v' | 'hailuo-02-standard-i2v' | 'hailuo-02-standard-t2v' | 'hailuo-2.3-pro-i2v' | 'hailuo-2.3-standard-i2v' | 'happyhorse-1-0-i2v' | 'happyhorse-1-0-r2v' | 'happyhorse-1-0-t2v' | 'happyhorse-1-0-v2v-edit' | 'ideogram-character' | 'ideogram-character-edit' | 'ideogram-character-remix' | 'ideogram-v3-reframe' | 'kling-3.0' | 'kling-3.0-motion-control' | 'kling-avatar-pro' | 'kling-avatar-standard' | 'kling-v2.1-master-i2v' | 'kling-v2.1-master-t2v' | 'kling-v2.1-pro-i2v' | 'kling-v2.1-standard-i2v' | 'kling-v2.5-turbo-i2v' | 'kling-v2.5-turbo-t2v' | 'kling-v2.6-motion-control' | 'kling-v2.6-pro-i2v' | 'kling-v2.6-pro-t2v' | 'ltxv-2' | 'ltxv-2-fast' | 'luma-ray2-v2v' | 'nano-banana-2-i2i' | 'nano-banana-2-t2i' | 'nano-banana-pro-i2i' | 'nano-banana-pro-t2i' | 'qwen-i2i' | 'qwen-image-edit' | 'qwen-t2i' | 'qwen2-image-edit' | 'qwen2-t2i' | 'recraft-crisp-upscale' | 'recraft-remove-background' | 'runway-i2v' | 'runway-t2v' | 'seedance-2' | 'seedance-2-fast' | 'seedance-v1-lite-i2v' | 'seedance-v1-lite-t2v' | 'seedance-v1-pro-fast-i2v' | 'seedance-v1-pro-i2v' | 'seedance-v1-pro-t2v' | 'seedance-v1.5-pro-i2v' | 'seedance-v1.5-pro-t2v' | 'seedream-4-5-edit' | 'seedream-4-5-text-to-image' | 'seedream-5-lite-edit' | 'seedream-5-lite-t2i' | 'suno' | 'suno-add-instrumental' | 'suno-add-vocals' | 'suno-lyrics' | 'suno-sounds' | 'topaz-image-upscale' | 'topaz-video-upscale' | 'veo3-i2v' | 'veo3-ref2v' | 'veo3-t2v' | 'wan-2-2-animate-move' | 'wan-2-2-animate-replace' | 'wan-2-2-speech-to-video' | 'wan-2-2-turbo-i2v' | 'wan-2-2-turbo-t2v' | 'wan-2-6-i2v' | 'wan-2-6-t2v' | 'wan-2-6-v2v' | 'wan-2-7-i2v' | 'wan-2-7-r2v' | 'wan-2-7-t2v', required — Model alias (required for generate actions)
    - `action` string — Action type: generate, extend, upscale, vary, modify, remix
    - `parent_job_id` string, uuid — Parent job ID for chain operations
    - `params` object — Model-specific generation parameters
  - object
    - `model` 'bytedance-seedream' | 'bytedance-seedream-v4-edit' | 'bytedance-seedream-v4-text-to-image' | 'claude-opus-4-6' | 'claude-opus-4-7' | 'claude-opus-4-8' | 'claude-sonnet-4-6' | 'elevenlabs-sfx' | 'elevenlabs-tts-multilingual' | 'elevenlabs-tts-turbo' | 'flux-2-flex-i2i' | 'flux-2-flex-t2i' | 'flux-2-pro-i2i' | 'flux-2-pro-t2i' | 'google-imagen4' | 'gpt-image-1.5-i2i' | 'gpt-image-1.5-t2i' | 'gpt-image-2-i2i' | 'gpt-image-2-t2i' | 'grok-imagine-i2i' | 'grok-imagine-i2v' | 'grok-imagine-t2i' | 'grok-imagine-t2v' | 'hailuo-02-pro-i2v' | 'hailuo-02-pro-t2v' | 'hailuo-02-standard-i2v' | 'hailuo-02-standard-t2v' | 'hailuo-2.3-pro-i2v' | 'hailuo-2.3-standard-i2v' | 'happyhorse-1-0-i2v' | 'happyhorse-1-0-r2v' | 'happyhorse-1-0-t2v' | 'happyhorse-1-0-v2v-edit' | 'ideogram-character' | 'ideogram-character-edit' | 'ideogram-character-remix' | 'ideogram-v3-reframe' | 'kling-3.0' | 'kling-3.0-motion-control' | 'kling-avatar-pro' | 'kling-avatar-standard' | 'kling-v2.1-master-i2v' | 'kling-v2.1-master-t2v' | 'kling-v2.1-pro-i2v' | 'kling-v2.1-standard-i2v' | 'kling-v2.5-turbo-i2v' | 'kling-v2.5-turbo-t2v' | 'kling-v2.6-motion-control' | 'kling-v2.6-pro-i2v' | 'kling-v2.6-pro-t2v' | 'ltxv-2' | 'ltxv-2-fast' | 'luma-ray2-v2v' | 'nano-banana-2-i2i' | 'nano-banana-2-t2i' | 'nano-banana-pro-i2i' | 'nano-banana-pro-t2i' | 'qwen-i2i' | 'qwen-image-edit' | 'qwen-t2i' | 'qwen2-image-edit' | 'qwen2-t2i' | 'recraft-crisp-upscale' | 'recraft-remove-background' | 'runway-i2v' | 'runway-t2v' | 'seedance-2' | 'seedance-2-fast' | 'seedance-v1-lite-i2v' | 'seedance-v1-lite-t2v' | 'seedance-v1-pro-fast-i2v' | 'seedance-v1-pro-i2v' | 'seedance-v1-pro-t2v' | 'seedance-v1.5-pro-i2v' | 'seedance-v1.5-pro-t2v' | 'seedream-4-5-edit' | 'seedream-4-5-text-to-image' | 'seedream-5-lite-edit' | 'seedream-5-lite-t2i' | 'suno' | 'suno-add-instrumental' | 'suno-add-vocals' | 'suno-lyrics' | 'suno-sounds' | 'topaz-image-upscale' | 'topaz-video-upscale' | 'veo3-i2v' | 'veo3-ref2v' | 'veo3-t2v' | 'wan-2-2-animate-move' | 'wan-2-2-animate-replace' | 'wan-2-2-speech-to-video' | 'wan-2-2-turbo-i2v' | 'wan-2-2-turbo-t2v' | 'wan-2-6-i2v' | 'wan-2-6-t2v' | 'wan-2-6-v2v' | 'wan-2-7-i2v' | 'wan-2-7-r2v' | 'wan-2-7-t2v' — Model alias (required for generate actions)
    - `action` string — Action type: generate, extend, upscale, vary, modify, remix
    - `parent_job_id` string, uuid, required — Parent job ID for chain operations
    - `params` object — Model-specific generation parameters

## Response `202`

Job created successfully

- object
  - `id` string, uuid
  - `status` 'pending' | 'submitted' | 'polling' | 'processing' | 'completed' | 'failed'
  - `action` string
  - `parent_job_id` string, uuid, nullable
  - `model` string — Model alias from request
  - `estimated_cost` union — Estimated cost in GL (may be string for Decimal precision)
    - string
    - number
  - `created_at` string, date-time

## Other responses

- `400` — Invalid request
- `401` — Authentication required
- `402` — Insufficient credits
- `403` — Forbidden
- `404` — Model or parent job not found

---

[API](https://skmtc.net/glio/apis/glio-api.md) · [All operations](https://skmtc.net/glio/apis/glio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/glio/glio-api/revisions/436d70017226/schema)