Create asset - AiToEarn Open Platform

POST

/

api

/

ai

/

volcengine

/

assets

/

items

Create asset

curl --request POST \
  --url https://aitoearn.cn/api/ai/volcengine/assets/items \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "groupId": "group_xxx",
  "url": "https://assets.example.com/person-reference.jpg",
  "assetType": "Image"
}
'

import requests

url = "https://aitoearn.cn/api/ai/volcengine/assets/items"

payload = {
    "groupId": "group_xxx",
    "url": "https://assets.example.com/person-reference.jpg",
    "assetType": "Image"
}
headers = {
    "X-Api-Key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    groupId: 'group_xxx',
    url: 'https://assets.example.com/person-reference.jpg',
    assetType: 'Image'
  })
};

fetch('https://aitoearn.cn/api/ai/volcengine/assets/items', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

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

func main() {

	url := "https://aitoearn.cn/api/ai/volcengine/assets/items"

	payload := strings.NewReader("{\n  \"groupId\": \"group_xxx\",\n  \"url\": \"https://assets.example.com/person-reference.jpg\",\n  \"assetType\": \"Image\"\n}")

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

	req.Header.Add("X-Api-Key", "<api-key>")
	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))

}

{
  "code": 0,
  "message": "Request succeeded",
  "data": {
    "assetId": "string",
    "groupId": "string",
    "assetType": "Image",
    "status": "Processing",
    "createdAt": "2026-07-02T12:00:00.000Z",
    "updatedAt": "2026-07-02T12:00:00.000Z",
    "name": "string",
    "url": "https://assets.aitoearn.cn/example.png"
  }
}

Authorizations

X-Api-Key

string

header

required

Need to get API Key from AiToEarn. Click to go to "API Key Obtaining Tutorial".

Body

application/json

groupId

string

required

Asset group ID. Real-person assets must use the group ID returned after verification.

Minimum string length: 1

url

string<uri>

required

Publicly accessible asset source file URL.

assetType

enum<string>

required

Asset type.

Available options:

Image,

Video,

Audio

name

string

Asset name.

Minimum string length: 1

Response

200 - application/json

The request has been processed by the service. Business success is determined by whether the response body has code === 0.

code

integer

required

Business status code. 0 means success; non-zero means a business error.

message

string

required

Response message.

data

object

Hide child attributes

data.assetId

string

required

Asset ID.

data.groupId

string

required

Asset group ID.

data.assetType

enum<string>

required

Asset type.

Available options:

Image,

Video,

Audio

data.status

enum<string>

required

Asset status. Only Active assets can be used for video generation.

Available options:

Processing,

Active,

Failed

data.createdAt

string<date-time>

required

Created at.

data.updatedAt

string<date-time>

required

Updated at.

data.name

string

Asset name.

data.url

string<uri>

Asset source file URL.

requestId

string

Request ID.

timestamp

integer

Error response timestamp in Unix milliseconds.

Last modified on September 2, 2026

Create asset

curl --request POST \
  --url https://aitoearn.cn/api/ai/volcengine/assets/items \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "groupId": "group_xxx",
  "url": "https://assets.example.com/person-reference.jpg",
  "assetType": "Image"
}
'

import requests

url = "https://aitoearn.cn/api/ai/volcengine/assets/items"

payload = {
    "groupId": "group_xxx",
    "url": "https://assets.example.com/person-reference.jpg",
    "assetType": "Image"
}
headers = {
    "X-Api-Key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    groupId: 'group_xxx',
    url: 'https://assets.example.com/person-reference.jpg',
    assetType: 'Image'
  })
};

fetch('https://aitoearn.cn/api/ai/volcengine/assets/items', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

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

func main() {

	url := "https://aitoearn.cn/api/ai/volcengine/assets/items"

	payload := strings.NewReader("{\n  \"groupId\": \"group_xxx\",\n  \"url\": \"https://assets.example.com/person-reference.jpg\",\n  \"assetType\": \"Image\"\n}")

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

	req.Header.Add("X-Api-Key", "<api-key>")
	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))

}

{
  "code": 0,
  "message": "Request succeeded",
  "data": {
    "assetId": "string",
    "groupId": "string",
    "assetType": "Image",
    "status": "Processing",
    "createdAt": "2026-07-02T12:00:00.000Z",
    "updatedAt": "2026-07-02T12:00:00.000Z",
    "name": "string",
    "url": "https://assets.aitoearn.cn/example.png"
  }
}