Create asset

Create asset

curl --request POST \
  --url https://api.gravitex.ai/v1/assets \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "<string>",
  "group_id": "<string>",
  "asset_type": "<string>",
  "name": "<string>"
}
'

import requests

url = "https://api.gravitex.ai/v1/assets"

payload = {
    "url": "<string>",
    "group_id": "<string>",
    "asset_type": "<string>",
    "name": "<string>"
}
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({
    url: '<string>',
    group_id: '<string>',
    asset_type: '<string>',
    name: '<string>'
  })
};

fetch('https://api.gravitex.ai/v1/assets', 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/v1/assets",
  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([
    'url' => '<string>',
    'group_id' => '<string>',
    'asset_type' => '<string>',
    'name' => '<string>'
  ]),
  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/v1/assets"

	payload := strings.NewReader("{\n  \"url\": \"<string>\",\n  \"group_id\": \"<string>\",\n  \"asset_type\": \"<string>\",\n  \"name\": \"<string>\"\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/v1/assets")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"url\": \"<string>\",\n  \"group_id\": \"<string>\",\n  \"asset_type\": \"<string>\",\n  \"name\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.gravitex.ai/v1/assets")

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  \"url\": \"<string>\",\n  \"group_id\": \"<string>\",\n  \"asset_type\": \"<string>\",\n  \"name\": \"<string>\"\n}"

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

POST

assets

Create asset

curl --request POST \
  --url https://api.gravitex.ai/v1/assets \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "<string>",
  "group_id": "<string>",
  "asset_type": "<string>",
  "name": "<string>"
}
'

import requests

url = "https://api.gravitex.ai/v1/assets"

payload = {
    "url": "<string>",
    "group_id": "<string>",
    "asset_type": "<string>",
    "name": "<string>"
}
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({
    url: '<string>',
    group_id: '<string>',
    asset_type: '<string>',
    name: '<string>'
  })
};

fetch('https://api.gravitex.ai/v1/assets', 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/v1/assets",
  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([
    'url' => '<string>',
    'group_id' => '<string>',
    'asset_type' => '<string>',
    'name' => '<string>'
  ]),
  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/v1/assets"

	payload := strings.NewReader("{\n  \"url\": \"<string>\",\n  \"group_id\": \"<string>\",\n  \"asset_type\": \"<string>\",\n  \"name\": \"<string>\"\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/v1/assets")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"url\": \"<string>\",\n  \"group_id\": \"<string>\",\n  \"asset_type\": \"<string>\",\n  \"name\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.gravitex.ai/v1/assets")

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  \"url\": \"<string>\",\n  \"group_id\": \"<string>\",\n  \"asset_type\": \"<string>\",\n  \"name\": \"<string>\"\n}"

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

Introduction

Create an asset in a group. Content-Type: application/json; public https URLs only (BytePlus must fetch directly). No Base64 / Data URI / multipart upload. Upload local files to OSS / TOS / S3 first. Both aigc and liveness_face libraries support Image / Video / Audio. Initial status is pending; poll until active (usually 1–3 minutes) before using asset://.

BytePlus CreateAsset no longer supports Base64 as of 2026. See Create an Asset.

Authentication

string

required

Bearer Token, e.g. Bearer sk-xxxxxxxxxx

Request body

string

required

Public https URL; passed through to upstream unchanged

string

required

Group ID from Create asset group or Create asset group (liveness)

string

default:"Image"

Image / Video / Audio (case-insensitive)

string

Display name (≤ 64 chars; UI/search only, not used in inference)

Format and size limits

Image (`Image`)

Item	Limit
Formats	jpeg / png / webp / bmp / tiff / gif / heic / heif
Size	< 30 MB
Aspect ratio	0.4 – 2.5
Dimensions	300 – 6000 px

Video (`Video`)

Item	Limit
Formats	mp4 / mov
Size	≤ 50 MB
Resolution	480p, 720p (no 1080p+)
Duration	2 – 15 s
FPS	24 – 60
Aspect ratio	0.4 – 2.5
Dimensions	300 – 6000 px
Total pixels (W×H)	409600 – 927408

Audio (`Audio`)

Item	Limit
Formats	mp3 / wav
Size	≤ 15 MB
Duration	2 – 15 s

Gateway checks URL suffix only; BytePlus validates size/duration asynchronously. Invalid assets end as status: failed.

Examples

Same JSON shape for image, video, and audio—only asset_type and URL differ:

# Image
curl -X POST "https://api.gravitex.ai/v1/assets" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://your-cdn.com/portrait.jpg","group_id":"group-xxx","asset_type":"Image","name":"portrait.jpg"}'

# Video
curl -X POST "https://api.gravitex.ai/v1/assets" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://your-cdn.com/dance.mp4","group_id":"group-xxx","asset_type":"Video","name":"dance.mp4"}'

# Audio
curl -X POST "https://api.gravitex.ai/v1/assets" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://your-cdn.com/voice.mp3","group_id":"group-xxx","asset_type":"Audio","name":"voice.mp3"}'

Response

{
  "virtual_id": "asset-20260508120145-pqwhc",
  "asset_url": "asset://asset-20260508120145-pqwhc",
  "group_id": "group-20260508120000-abcde",
  "asset_type": "Image",
  "status": "pending"
}

Field	Description
`asset_url`	Reference in video `content` (mapped by `asset_type`)
`status`	`pending` → `active` / `failed`

Next: List assets or Get asset to poll status.

Delete asset group List assets

API documentation

Chat & text

Safety & audio

Image Series

Video Series

Completions & Embeddings

Interface module

Introduction

Authentication

Request body

Format and size limits

Image (`Image`)

Video (`Video`)

Audio (`Audio`)

Examples

Response

​Introduction

​Authentication

​Request body

​Format and size limits

​Image (Image)

​Video (Video)

​Audio (Audio)

​Examples

​Response

Introduction

Authentication

Request body

Format and size limits

Image (`Image`)

Video (`Video`)

Audio (`Audio`)

Examples

Response