---
title: "Create a content generation task"
method: POST
path: "/api/v3/contents/generations/tasks"
tags: ["Official Native API"]
---

# Create a content generation task

`POST /api/v3/contents/generations/tasks`

## Request

- Base URL: `https://api.sandbase.ai`
- URL: `https://api.sandbase.ai/api/v3/contents/generations/tasks`
- Auth: HTTP bearer

Creates an asynchronous Seedance video generation task using the Volcengine Ark native request shape.

## Request body

- VolcengineContentsGenerationRequest
  - `model` 'doubao-seedance-2-0-260128' | 'doubao-seedance-2-0-fast-260128' | 'doubao-seedance-2-5-260628', required
  - `content` VolcengineContentItem[], required: Must include text. Media items select image-to-video or reference-to-video mode according to role.
    - `type` 'text' | 'image_url' | 'video_url' | 'audio_url', required
    - `text` string
    - `image_url` union
      - string
      - object
        - `url` string, required
    - `video_url` union
      - string
      - object
        - `url` string, required
    - `audio_url` union
      - string
      - object
        - `url` string, required
    - `role` 'first_frame' | 'last_frame' | 'reference_image' | 'reference_video' | 'reference_audio'
  - `callback_url` string: Receives the terminal task response.
  - `duration` integer
  - `resolution` string
  - `ratio` string
  - `generate_audio` boolean
  - `seed` integer
  - `camera_fixed` boolean
  - `watermark` boolean
  - `draft` boolean
  - `return_last_frame` boolean
  - `service_tier` string
  - `execution_expires_after` integer
  - `frames` integer
  - `framespersecond` integer
  - `tools` object[]

## Response `200`

Task accepted

- VolcengineTaskCreated
  - `id` string, required

## Other responses

- `400`: Invalid JSON, unsupported model or content mode, or rejected generation parameters
- `401`: Missing, invalid, revoked, or expired API key
- `402`: Organization balance and credit are exhausted
- `403`: API Key spending limit reached, organization disabled, or upstream permission rejected
- `404`: Model or upstream resource not found
- `429`: Provider rate limit exceeded
- `500`: Prediction lifecycle or provider error

---

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