Create video generation task

curl --request POST \
  --url https://api.gravitex.ai/api/v3/contents/generations/tasks \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "content": [
    {}
  ],
  "prompt": "<string>",
  "callback_url": "<string>",
  "return_last_frame": true,
  "service_tier": "<string>",
  "execution_expires_after": 123,
  "generate_audio": true,
  "safety_identifier": "<string>",
  "resolution": "<string>",
  "ratio": "<string>",
  "duration": 123,
  "seed": 123,
  "watermark": true
}
'

import requests

url = "https://api.gravitex.ai/api/v3/contents/generations/tasks"

payload = {
    "model": "<string>",
    "content": [{}],
    "prompt": "<string>",
    "callback_url": "<string>",
    "return_last_frame": True,
    "service_tier": "<string>",
    "execution_expires_after": 123,
    "generate_audio": True,
    "safety_identifier": "<string>",
    "resolution": "<string>",
    "ratio": "<string>",
    "duration": 123,
    "seed": 123,
    "watermark": True
}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    content: [{}],
    prompt: '<string>',
    callback_url: '<string>',
    return_last_frame: true,
    service_tier: '<string>',
    execution_expires_after: 123,
    generate_audio: true,
    safety_identifier: '<string>',
    resolution: '<string>',
    ratio: '<string>',
    duration: 123,
    seed: 123,
    watermark: true
  })
};

fetch('https://api.gravitex.ai/api/v3/contents/generations/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gravitex.ai/api/v3/contents/generations/tasks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => '<string>',
    'content' => [
        [
                
        ]
    ],
    'prompt' => '<string>',
    'callback_url' => '<string>',
    'return_last_frame' => true,
    'service_tier' => '<string>',
    'execution_expires_after' => 123,
    'generate_audio' => true,
    'safety_identifier' => '<string>',
    'resolution' => '<string>',
    'ratio' => '<string>',
    'duration' => 123,
    'seed' => 123,
    'watermark' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gravitex.ai/api/v3/contents/generations/tasks"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"content\": [\n    {}\n  ],\n  \"prompt\": \"<string>\",\n  \"callback_url\": \"<string>\",\n  \"return_last_frame\": true,\n  \"service_tier\": \"<string>\",\n  \"execution_expires_after\": 123,\n  \"generate_audio\": true,\n  \"safety_identifier\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"ratio\": \"<string>\",\n  \"duration\": 123,\n  \"seed\": 123,\n  \"watermark\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.gravitex.ai/api/v3/contents/generations/tasks")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"content\": [\n    {}\n  ],\n  \"prompt\": \"<string>\",\n  \"callback_url\": \"<string>\",\n  \"return_last_frame\": true,\n  \"service_tier\": \"<string>\",\n  \"execution_expires_after\": 123,\n  \"generate_audio\": true,\n  \"safety_identifier\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"ratio\": \"<string>\",\n  \"duration\": 123,\n  \"seed\": 123,\n  \"watermark\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.gravitex.ai/api/v3/contents/generations/tasks")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"<string>\",\n  \"content\": [\n    {}\n  ],\n  \"prompt\": \"<string>\",\n  \"callback_url\": \"<string>\",\n  \"return_last_frame\": true,\n  \"service_tier\": \"<string>\",\n  \"execution_expires_after\": 123,\n  \"generate_audio\": true,\n  \"safety_identifier\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"ratio\": \"<string>\",\n  \"duration\": 123,\n  \"seed\": 123,\n  \"watermark\": true\n}"

response = http.request(request)
puts response.read_body

POST

api

contents

generations

tasks

Create video generation task

curl --request POST \
  --url https://api.gravitex.ai/api/v3/contents/generations/tasks \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "content": [
    {}
  ],
  "prompt": "<string>",
  "callback_url": "<string>",
  "return_last_frame": true,
  "service_tier": "<string>",
  "execution_expires_after": 123,
  "generate_audio": true,
  "safety_identifier": "<string>",
  "resolution": "<string>",
  "ratio": "<string>",
  "duration": 123,
  "seed": 123,
  "watermark": true
}
'

import requests

url = "https://api.gravitex.ai/api/v3/contents/generations/tasks"

payload = {
    "model": "<string>",
    "content": [{}],
    "prompt": "<string>",
    "callback_url": "<string>",
    "return_last_frame": True,
    "service_tier": "<string>",
    "execution_expires_after": 123,
    "generate_audio": True,
    "safety_identifier": "<string>",
    "resolution": "<string>",
    "ratio": "<string>",
    "duration": 123,
    "seed": 123,
    "watermark": True
}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    content: [{}],
    prompt: '<string>',
    callback_url: '<string>',
    return_last_frame: true,
    service_tier: '<string>',
    execution_expires_after: 123,
    generate_audio: true,
    safety_identifier: '<string>',
    resolution: '<string>',
    ratio: '<string>',
    duration: 123,
    seed: 123,
    watermark: true
  })
};

fetch('https://api.gravitex.ai/api/v3/contents/generations/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gravitex.ai/api/v3/contents/generations/tasks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => '<string>',
    'content' => [
        [
                
        ]
    ],
    'prompt' => '<string>',
    'callback_url' => '<string>',
    'return_last_frame' => true,
    'service_tier' => '<string>',
    'execution_expires_after' => 123,
    'generate_audio' => true,
    'safety_identifier' => '<string>',
    'resolution' => '<string>',
    'ratio' => '<string>',
    'duration' => 123,
    'seed' => 123,
    'watermark' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gravitex.ai/api/v3/contents/generations/tasks"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"content\": [\n    {}\n  ],\n  \"prompt\": \"<string>\",\n  \"callback_url\": \"<string>\",\n  \"return_last_frame\": true,\n  \"service_tier\": \"<string>\",\n  \"execution_expires_after\": 123,\n  \"generate_audio\": true,\n  \"safety_identifier\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"ratio\": \"<string>\",\n  \"duration\": 123,\n  \"seed\": 123,\n  \"watermark\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<authorization>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.gravitex.ai/api/v3/contents/generations/tasks")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"content\": [\n    {}\n  ],\n  \"prompt\": \"<string>\",\n  \"callback_url\": \"<string>\",\n  \"return_last_frame\": true,\n  \"service_tier\": \"<string>\",\n  \"execution_expires_after\": 123,\n  \"generate_audio\": true,\n  \"safety_identifier\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"ratio\": \"<string>\",\n  \"duration\": 123,\n  \"seed\": 123,\n  \"watermark\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.gravitex.ai/api/v3/contents/generations/tasks")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"<string>\",\n  \"content\": [\n    {}\n  ],\n  \"prompt\": \"<string>\",\n  \"callback_url\": \"<string>\",\n  \"return_last_frame\": true,\n  \"service_tier\": \"<string>\",\n  \"execution_expires_after\": 123,\n  \"generate_audio\": true,\n  \"safety_identifier\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"ratio\": \"<string>\",\n  \"duration\": 123,\n  \"seed\": 123,\n  \"watermark\": true\n}"

response = http.request(request)
puts response.read_body

Introduction

Submit an async Seedance 2.0 official mirror video generation task; returns task id on success. Provide at least one of content or prompt. Identical request and response bodies to the BytePlus Ark official API.

Authentication

string

required

Bearer Token, e.g. Bearer sk-your_token_key

string

application/json

Request parameters

string

required

Model ID: seedance-2-0 / seedance-2-0-fast / seedance-2-0-NSFW

array

Content array: text / image_url / video_url / audio_url; each element may include role (first_frame / last_frame / reference_image / reference_video / reference_audio); at least one of content or prompt required

string

Simplified alternative to content

string

Callback URL on task status changes

boolean

default:"false"

Whether to return the last frame image

string

default:"default"

default / flex

integer

default:"172800"

Task expiration time in seconds, range [3600, 259200]

boolean

default:"true"

Whether to generate audio

string

End-user unique identifier (recommend a hash of user ID)

string

default:"720p"

480p / 720p / 1080p / 4K (seedance-2-0-fast supports only 480p/720p)

string

default:"adaptive"

16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive

integer

default:"5"

Duration in seconds, [4,15] or -1 (auto)

integer

default:"-1"

Random seed

boolean

default:"false"

Add watermark

content[].image_url.url / video_url.url / audio_url.url support three value types: public URL, Base64 (data:image/png;base64,...), and asset://<ASSET_ID> asset library references.

Request example

curl -X POST https://api.gravitex.ai/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer sk-your_token_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "content": [
      {"type": "text", "text": "黄金时刻，无人机航拍连绵山脉"}
    ],
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": true
  }'

Response example

{
  "id": "cgt-20260708094649-mxfjc"
}

Next: Get video generation task

Get moderation result Get video generation task

API documentation

Chat & text

Safety & audio

Image Series

Video Series

Completions & Embeddings

Interface module

Create video generation task

Introduction

Authentication

Request parameters

Request example

Response example

​Introduction

​Authentication

​Request parameters

​Request example

​Response example

Introduction

Authentication

Request parameters

Request example

Response example