Create Image Asset

Upload an image to an existing asset group. The returned Asset ID can be referenced as asset://<ID> in Seedance 2.0 requests for character reference, first frame, and similar scenarios. Image asset activation is typically 6–9 seconds in ideal conditions. Actual timing may vary with file size and review queue load; during congestion, activation may take about 10 seconds to 2 minutes. CreateAsset is asynchronous; system processing may queue the asset, and upload-time SLA is not guaranteed. Poll GetAsset after creation and use the asset only after Status becomes Active; Failed means preprocessing failed and the asset cannot be used. In generation requests, reference the asset as asset://<ID> instead of using the temporary GetAsset URL.

POST /volc/asset/CreateAsset

cURL

cURL

curl https://www.anyfast.ai/volc/asset/CreateAsset \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "volc-asset",
  "GroupId": "group-20260319072926-rrnmg",
  "Name": "character-reference",
  "AssetType": "Image",
  "URL": "https://example.com/image.jpg"
}'

import requests

url = "https://www.anyfast.ai/volc/asset/CreateAsset"

payload = {
    "GroupId": "group-20260319072926-rrnmg",
    "AssetType": "Image",
    "URL": "https://example.com/image.jpg",
    "model": "volc-asset",
    "Name": "character-reference"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    GroupId: 'group-20260319072926-rrnmg',
    AssetType: 'Image',
    URL: 'https://example.com/image.jpg',
    model: 'volc-asset',
    Name: 'character-reference'
  })
};

fetch('https://www.anyfast.ai/volc/asset/CreateAsset', 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://www.anyfast.ai/volc/asset/CreateAsset",
  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([
    'GroupId' => 'group-20260319072926-rrnmg',
    'AssetType' => 'Image',
    'URL' => 'https://example.com/image.jpg',
    'model' => 'volc-asset',
    'Name' => 'character-reference'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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://www.anyfast.ai/volc/asset/CreateAsset"

	payload := strings.NewReader("{\n  \"GroupId\": \"group-20260319072926-rrnmg\",\n  \"AssetType\": \"Image\",\n  \"URL\": \"https://example.com/image.jpg\",\n  \"model\": \"volc-asset\",\n  \"Name\": \"character-reference\"\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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://www.anyfast.ai/volc/asset/CreateAsset")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"GroupId\": \"group-20260319072926-rrnmg\",\n  \"AssetType\": \"Image\",\n  \"URL\": \"https://example.com/image.jpg\",\n  \"model\": \"volc-asset\",\n  \"Name\": \"character-reference\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.anyfast.ai/volc/asset/CreateAsset")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"GroupId\": \"group-20260319072926-rrnmg\",\n  \"AssetType\": \"Image\",\n  \"URL\": \"https://example.com/image.jpg\",\n  \"model\": \"volc-asset\",\n  \"Name\": \"character-reference\"\n}"

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

200

{
  "Id": "asset-20260320120147-pqwhc"
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

Authorizations

Authorization · string · header · required

Bearer token authentication. Format Bearer <token> where <token> is your API Key.

Body

application/jsonmultipart/form-data

GroupId · string · required

Asset group ID.

Example:

"group-20260319072926-rrnmg"

AssetType · enum<string> · required

Asset type. Fixed value Image for images.

Available options: Image

Example:

"Image"

URL · string · required

Image URL, Data URI, or raw Base64 string.

Example:

"https://example.com/image.jpg"

model · enum<string>

Billing model. Fixed value volc-asset for images.

Available options: volc-asset

Example:

"volc-asset"

Name · string

Asset name.

Example:

"character-reference"

Response

200

application/json

Image asset created successfully

Id · string

Asset ID. Use as asset://<ID> in Seedance 2.0 requests.

Example:

"asset-20260320120147-pqwhc"