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.

Except for X/Twitter publishing, publishing on other platforms is currently free. For X/Twitter pricing, see the pricing page.

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 July 31, 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"
}

Overview

AI Services/Video Generation

AI Services/Image Generation

AI Services/Large Language Models

Channel Management/Accounts

Channel Management/Publishing

Channel Management/Platforms

Channel Management/Works

Channel Management/Account Groups

Channel Management/Authorization

Asset Management

Create Publish Flow

Authorizations

Body

Response