Channel Management/Publishing

Create Publish Flow

Interface description: Create a multi-platform publishing Flow; one request can create multiple single-platform tasks.

Before calling this endpoint, read the complete publishing flow guide. items[n].accountId must come from the account list endpoint. content.media[n].url must be a real, publicly accessible media URL; do not copy the placeholder from the example. We recommend following the asset upload guide: generate an upload signature, upload the file, confirm the upload, then use the confirmation response data.url. You may also use another real media URL that the service can access and parse directly. An inaccessible or unparseable URL returns 15051 (media_unreachable). publishAt must be a future ISO 8601 timestamp. After success, use data.flowId to query the flow and data.tasks[n].id to publish now, retry, cancel, or update the publish time. This endpoint creates real publishing tasks, so verify the parameters before sending.

Quota: Publishing API calls across all platforms share a total allowance of 1,000 free calls per month, and the allowance resets monthly. Check your current usage and remaining allowance on the China site API Key page or the international site API Key page. X/Twitter publishing counts toward this allowance and also incurs an additional fee charged by X/Twitter; see Social Publishing pricing for details. Support for overage API requests will be added; once available, they will be charged at 1.5 credits per request.

POST

api

channels

publish

flows

Create Publish Flow

curl --request POST \
  --url https://aitoearn.cn/api/v2/channels/publish/flows \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "content": {
    "title": "publish-demo-video",
    "body": "Publish a video using the AiToEarn API.",
    "media": [
      {
        "url": "https://assets.aitoearn.cn/6a3b48b5ec793a848a671de1/ai/video/doubao-seedance-2-0-260128/202607/I-lRTCBUkjE43NRd77eWC.mp4"
      }
    ],
    "cover": {
      "url": "https://assets.aitoearn.cn/6a3b48b5ec793a848a671de1/ai/images/gpt-image-2/202607/GlhuS1TEyXtDAyumLezfo.png"
    }
  },
  "publishAt": "2030-01-01T00:00:00.000Z",
  "items": [
    {
      "platform": "douyin",
      "accountId": "account-id-from-accounts-list"
    }
  ]
}
'

import requests

url = "https://aitoearn.cn/api/v2/channels/publish/flows"

payload = {
    "content": {
        "title": "publish-demo-video",
        "body": "Publish a video using the AiToEarn API.",
        "media": [{ "url": "https://assets.aitoearn.cn/6a3b48b5ec793a848a671de1/ai/video/doubao-seedance-2-0-260128/202607/I-lRTCBUkjE43NRd77eWC.mp4" }],
        "cover": { "url": "https://assets.aitoearn.cn/6a3b48b5ec793a848a671de1/ai/images/gpt-image-2/202607/GlhuS1TEyXtDAyumLezfo.png" }
    },
    "publishAt": "2030-01-01T00:00:00.000Z",
    "items": [
        {
            "platform": "douyin",
            "accountId": "account-id-from-accounts-list"
        }
    ]
}
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({
    content: {
      title: 'publish-demo-video',
      body: JSON.stringify('Publish a video using the AiToEarn API.'),
      media: [
        {
          url: 'https://assets.aitoearn.cn/6a3b48b5ec793a848a671de1/ai/video/doubao-seedance-2-0-260128/202607/I-lRTCBUkjE43NRd77eWC.mp4'
        }
      ],
      cover: {
        url: 'https://assets.aitoearn.cn/6a3b48b5ec793a848a671de1/ai/images/gpt-image-2/202607/GlhuS1TEyXtDAyumLezfo.png'
      }
    },
    publishAt: '2030-01-01T00:00:00.000Z',
    items: [{platform: 'douyin', accountId: 'account-id-from-accounts-list'}]
  })
};

fetch('https://aitoearn.cn/api/v2/channels/publish/flows', 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/v2/channels/publish/flows"

	payload := strings.NewReader("{\n  \"content\": {\n    \"title\": \"publish-demo-video\",\n    \"body\": \"Publish a video using the AiToEarn API.\",\n    \"media\": [\n      {\n        \"url\": \"https://assets.aitoearn.cn/6a3b48b5ec793a848a671de1/ai/video/doubao-seedance-2-0-260128/202607/I-lRTCBUkjE43NRd77eWC.mp4\"\n      }\n    ],\n    \"cover\": {\n      \"url\": \"https://assets.aitoearn.cn/6a3b48b5ec793a848a671de1/ai/images/gpt-image-2/202607/GlhuS1TEyXtDAyumLezfo.png\"\n    }\n  },\n  \"publishAt\": \"2030-01-01T00:00:00.000Z\",\n  \"items\": [\n    {\n      \"platform\": \"douyin\",\n      \"accountId\": \"account-id-from-accounts-list\"\n    }\n  ]\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": {
    "flowId": "string",
    "tasks": [
      {
        "id": "string",
        "accountId": "string",
        "platform": "string",
        "status": "number",
        "publishTime": "string",
        "platformWorkId": "string",
        "workLink": "string",
        "linkStatus": "string",
        "linkError": "string",
        "linkMeta": "object",
        "errorMsg": "string"
      }
    ]
  },
  "requestId": "string"
}

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

content

object

required

Share content across platforms

Hide child attributes

content.title

string

title

content.body

string

text

content.media

object[]

Main media list

Hide child attributes

content.media.url

string<uri>

required

Media URL

content.media.options

object

Media handling options

Hide child attributes

content.media.options.adaptation

object

Media format conversion options

Hide child attributes

content.media.options.adaptation.imageFormat

enum<string>

Image and cover format conversion targets

Available options:

off,

auto,

jpeg,

png,

webp

content.cover

object

cover

Hide child attributes

content.cover.url

string<uri>

required

Cover URL

content.cover.options

object

Media handling options

Hide child attributes

content.cover.options.adaptation

object

Media format conversion options

Hide child attributes

content.cover.options.adaptation.imageFormat

enum<string>

Image and cover format conversion targets

Available options:

off,

auto,

jpeg,

png,

webp

publishAt

string<date-time>

required

Target release time

items

object[]

required

Platform release items

Minimum array length: 1

Hide child attributes

items.platform

enum<string>

required

platform

Available options:

bilibili

items.option

object

required

Bilibili publishing options

Option 1
Option 2

Hide child attributes

items.option.tid

integer

required

Partition ID

Required range: 0 < x <= 9007199254740991

items.option.no_reprint

enum<number>

Whether to allow reprinting 0-allowed, 1-not allowed

Available options:

0,

1

items.option.topic_id

integer

Topic ID

Required range: 0 < x <= 9007199254740991

items.option.mission_id

integer

Submission activity ID

Required range: 0 < x <= 9007199254740991

items.option.copyright

enum<number>

default:1

1-original, 2-reprinted

Available options:

1

items.option.source

string

Reprint source

items.accountId

string

required

Account ID

items.overrides

object

Platform coverage

Hide child attributes

items.overrides.title

string

title override

items.overrides.body

string

Text coverage

items.overrides.media

object[]

Main media list coverage

Hide child attributes

items.overrides.media.url

string<uri>

required

Media URL

items.overrides.media.options

object

Media handling options

Hide child attributes

items.overrides.media.options.adaptation

object

Media format conversion options

Hide child attributes

items.overrides.media.options.adaptation.imageFormat

enum<string>

Image and cover format conversion targets

Available options:

off,

auto,

jpeg,

png,

webp

items.overrides.cover

object | null

Cover coverage, passing null means clearing the cover

Hide child attributes

items.overrides.cover.url

string<uri>

required

Cover URL

items.overrides.cover.options

object

Media handling options

Hide child attributes

items.overrides.cover.options.adaptation

object

Media format conversion options

Hide child attributes

items.overrides.cover.options.adaptation.imageFormat

enum<string>

Image and cover format conversion targets

Available options:

off,

auto,

jpeg,

png,

webp

flowId

string

External flow ID

context

object

External business relationships

Hide child attributes

context.materialGroupId

string

Material group ID

context.materialId

string

Material ID

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.flowId

string

data.tasks

object[]

Hide child attributes

data.tasks.id

string

data.tasks.accountId

string

data.tasks.platform

string

data.tasks.status

number

data.tasks.publishTime

string

data.tasks.platformWorkId

string

data.tasks.workLink

string

data.tasks.linkStatus

string

data.tasks.linkError

string

data.tasks.linkMeta

object

data.tasks.errorMsg

string

requestId

string

Request ID.

timestamp

integer

Error response timestamp in Unix milliseconds.

Last modified on September 29, 2026

Create Publish Flow

curl --request POST \
  --url https://aitoearn.cn/api/v2/channels/publish/flows \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "content": {
    "title": "publish-demo-video",
    "body": "Publish a video using the AiToEarn API.",
    "media": [
      {
        "url": "https://assets.aitoearn.cn/6a3b48b5ec793a848a671de1/ai/video/doubao-seedance-2-0-260128/202607/I-lRTCBUkjE43NRd77eWC.mp4"
      }
    ],
    "cover": {
      "url": "https://assets.aitoearn.cn/6a3b48b5ec793a848a671de1/ai/images/gpt-image-2/202607/GlhuS1TEyXtDAyumLezfo.png"
    }
  },
  "publishAt": "2030-01-01T00:00:00.000Z",
  "items": [
    {
      "platform": "douyin",
      "accountId": "account-id-from-accounts-list"
    }
  ]
}
'

import requests

url = "https://aitoearn.cn/api/v2/channels/publish/flows"

payload = {
    "content": {
        "title": "publish-demo-video",
        "body": "Publish a video using the AiToEarn API.",
        "media": [{ "url": "https://assets.aitoearn.cn/6a3b48b5ec793a848a671de1/ai/video/doubao-seedance-2-0-260128/202607/I-lRTCBUkjE43NRd77eWC.mp4" }],
        "cover": { "url": "https://assets.aitoearn.cn/6a3b48b5ec793a848a671de1/ai/images/gpt-image-2/202607/GlhuS1TEyXtDAyumLezfo.png" }
    },
    "publishAt": "2030-01-01T00:00:00.000Z",
    "items": [
        {
            "platform": "douyin",
            "accountId": "account-id-from-accounts-list"
        }
    ]
}
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({
    content: {
      title: 'publish-demo-video',
      body: JSON.stringify('Publish a video using the AiToEarn API.'),
      media: [
        {
          url: 'https://assets.aitoearn.cn/6a3b48b5ec793a848a671de1/ai/video/doubao-seedance-2-0-260128/202607/I-lRTCBUkjE43NRd77eWC.mp4'
        }
      ],
      cover: {
        url: 'https://assets.aitoearn.cn/6a3b48b5ec793a848a671de1/ai/images/gpt-image-2/202607/GlhuS1TEyXtDAyumLezfo.png'
      }
    },
    publishAt: '2030-01-01T00:00:00.000Z',
    items: [{platform: 'douyin', accountId: 'account-id-from-accounts-list'}]
  })
};

fetch('https://aitoearn.cn/api/v2/channels/publish/flows', 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/v2/channels/publish/flows"

	payload := strings.NewReader("{\n  \"content\": {\n    \"title\": \"publish-demo-video\",\n    \"body\": \"Publish a video using the AiToEarn API.\",\n    \"media\": [\n      {\n        \"url\": \"https://assets.aitoearn.cn/6a3b48b5ec793a848a671de1/ai/video/doubao-seedance-2-0-260128/202607/I-lRTCBUkjE43NRd77eWC.mp4\"\n      }\n    ],\n    \"cover\": {\n      \"url\": \"https://assets.aitoearn.cn/6a3b48b5ec793a848a671de1/ai/images/gpt-image-2/202607/GlhuS1TEyXtDAyumLezfo.png\"\n    }\n  },\n  \"publishAt\": \"2030-01-01T00:00:00.000Z\",\n  \"items\": [\n    {\n      \"platform\": \"douyin\",\n      \"accountId\": \"account-id-from-accounts-list\"\n    }\n  ]\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": {
    "flowId": "string",
    "tasks": [
      {
        "id": "string",
        "accountId": "string",
        "platform": "string",
        "status": "number",
        "publishTime": "string",
        "platformWorkId": "string",
        "workLink": "string",
        "linkStatus": "string",
        "linkError": "string",
        "linkMeta": "object",
        "errorMsg": "string"
      }
    ]
  },
  "requestId": "string"
}