Channel Management/Publishing

Create Publish Flow

Interface description: Create a multi-platform publishing flow, and one request can generate multiple single-platform tasks.

Before calling this interface, please make sure you understand the complete publishing process and click Learn the complete publishing process.

Tip: Except for X/Twitter (Twitter) publishing, publishing on other platforms is currently free; for X/Twitter publishing billing, please click to view.

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": {
    "body": "test",
    "media": [
      {
        "url": "https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/WZR5ZtF0t1lIQTx1_wW-_.mp4",
        "metadata": {
          "type": "video"
        }
      }
    ],
    "cover": {
      "url": "https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/dS2sNtXUgrLfosukfpXwd.jpg",
      "metadata": {
        "type": "image"
      }
    },
    "title": "test title"
  },
  "publishAt": "2026-06-29T09:43:42Z",
  "items": {
    "accountId": "KWAI_f1b6d99b9252a17314bf5724e666123f",
    "platform": "KWAI",
    "overrides": {
      "body": "test",
      "media": [
        {
          "url": "https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/WZR5ZtF0t1lIQTx1_wW-_.mp4",
          "metadata": {
            "type": "video"
          }
        }
      ],
      "cover": {
        "url": "https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/dS2sNtXUgrLfosukfpXwd.jpg",
        "metadata": {
          "type": "image"
        }
      },
      "title": "test title"
    }
  }
}
'

import requests

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

payload = {
    "content": {
        "body": "test",
        "media": [
            {
                "url": "https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/WZR5ZtF0t1lIQTx1_wW-_.mp4",
                "metadata": { "type": "video" }
            }
        ],
        "cover": {
            "url": "https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/dS2sNtXUgrLfosukfpXwd.jpg",
            "metadata": { "type": "image" }
        },
        "title": "test title"
    },
    "publishAt": "2026-06-29T09:43:42Z",
    "items": {
        "accountId": "KWAI_f1b6d99b9252a17314bf5724e666123f",
        "platform": "KWAI",
        "overrides": {
            "body": "test",
            "media": [
                {
                    "url": "https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/WZR5ZtF0t1lIQTx1_wW-_.mp4",
                    "metadata": { "type": "video" }
                }
            ],
            "cover": {
                "url": "https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/dS2sNtXUgrLfosukfpXwd.jpg",
                "metadata": { "type": "image" }
            },
            "title": "test title"
        }
    }
}
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: {
      body: JSON.stringify('test'),
      media: [
        {
          url: 'https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/WZR5ZtF0t1lIQTx1_wW-_.mp4',
          metadata: {type: 'video'}
        }
      ],
      cover: {
        url: 'https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/dS2sNtXUgrLfosukfpXwd.jpg',
        metadata: {type: 'image'}
      },
      title: 'test title'
    },
    publishAt: '2026-06-29T09:43:42Z',
    items: {
      accountId: 'KWAI_f1b6d99b9252a17314bf5724e666123f',
      platform: 'KWAI',
      overrides: {
        body: JSON.stringify('test'),
        media: [
          {
            url: 'https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/WZR5ZtF0t1lIQTx1_wW-_.mp4',
            metadata: {type: 'video'}
          }
        ],
        cover: {
          url: 'https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/dS2sNtXUgrLfosukfpXwd.jpg',
          metadata: {type: 'image'}
        },
        title: 'test title'
      }
    }
  })
};

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    \"body\": \"test\",\n    \"media\": [\n      {\n        \"url\": \"https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/WZR5ZtF0t1lIQTx1_wW-_.mp4\",\n        \"metadata\": {\n          \"type\": \"video\"\n        }\n      }\n    ],\n    \"cover\": {\n      \"url\": \"https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/dS2sNtXUgrLfosukfpXwd.jpg\",\n      \"metadata\": {\n        \"type\": \"image\"\n      }\n    },\n    \"title\": \"test title\"\n  },\n  \"publishAt\": \"2026-06-29T09:43:42Z\",\n  \"items\": {\n    \"accountId\": \"KWAI_f1b6d99b9252a17314bf5724e666123f\",\n    \"platform\": \"KWAI\",\n    \"overrides\": {\n      \"body\": \"test\",\n      \"media\": [\n        {\n          \"url\": \"https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/WZR5ZtF0t1lIQTx1_wW-_.mp4\",\n          \"metadata\": {\n            \"type\": \"video\"\n          }\n        }\n      ],\n      \"cover\": {\n        \"url\": \"https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/dS2sNtXUgrLfosukfpXwd.jpg\",\n        \"metadata\": {\n          \"type\": \"image\"\n        }\n      },\n      \"title\": \"test title\"\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": "douyin",
        "status": -1,
        "publishTime": "2026-07-02T12:00:00.000Z",
        "platformWorkId": "string",
        "workLink": "string",
        "linkStatus": "pending",
        "linkError": "string",
        "linkMeta": {},
        "errorMsg": "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

required

Post Flow ID

data.tasks

object[]

required

Post a task list

Hide child attributes

data.tasks.id

string

required

Post task ID

data.tasks.accountId

string

required

Account ID

data.tasks.platform

enum<string>

required

platform

Available options:

douyin,

xhs,

wxSph,

KWAI,

youtube,

wxGzh,

bilibili,

twitter,

tiktok,

facebook,

instagram,

threads,

pinterest,

linkedin,

google_business

data.tasks.status

enum<number>

Release status

Available options:

-1,

0,

1,

2,

3,

4,

5,

6,

7,

8,

9

data.tasks.publishTime

string<date-time>

Release time

data.tasks.platformWorkId

string

Platform work ID

data.tasks.workLink

string

Work link

data.tasks.linkStatus

enum<string>

Work link status

Available options:

pending,

ready,

failed

data.tasks.linkError

string

Error getting link to work

data.tasks.linkMeta

object

Work link extension information

data.tasks.errorMsg

string

error message

requestId

string

Request ID.

timestamp

integer

Error response timestamp in Unix milliseconds.

Create Publish Option Value

Publish Flow Details

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": {
    "body": "test",
    "media": [
      {
        "url": "https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/WZR5ZtF0t1lIQTx1_wW-_.mp4",
        "metadata": {
          "type": "video"
        }
      }
    ],
    "cover": {
      "url": "https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/dS2sNtXUgrLfosukfpXwd.jpg",
      "metadata": {
        "type": "image"
      }
    },
    "title": "test title"
  },
  "publishAt": "2026-06-29T09:43:42Z",
  "items": {
    "accountId": "KWAI_f1b6d99b9252a17314bf5724e666123f",
    "platform": "KWAI",
    "overrides": {
      "body": "test",
      "media": [
        {
          "url": "https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/WZR5ZtF0t1lIQTx1_wW-_.mp4",
          "metadata": {
            "type": "video"
          }
        }
      ],
      "cover": {
        "url": "https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/dS2sNtXUgrLfosukfpXwd.jpg",
        "metadata": {
          "type": "image"
        }
      },
      "title": "test title"
    }
  }
}
'

import requests

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

payload = {
    "content": {
        "body": "test",
        "media": [
            {
                "url": "https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/WZR5ZtF0t1lIQTx1_wW-_.mp4",
                "metadata": { "type": "video" }
            }
        ],
        "cover": {
            "url": "https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/dS2sNtXUgrLfosukfpXwd.jpg",
            "metadata": { "type": "image" }
        },
        "title": "test title"
    },
    "publishAt": "2026-06-29T09:43:42Z",
    "items": {
        "accountId": "KWAI_f1b6d99b9252a17314bf5724e666123f",
        "platform": "KWAI",
        "overrides": {
            "body": "test",
            "media": [
                {
                    "url": "https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/WZR5ZtF0t1lIQTx1_wW-_.mp4",
                    "metadata": { "type": "video" }
                }
            ],
            "cover": {
                "url": "https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/dS2sNtXUgrLfosukfpXwd.jpg",
                "metadata": { "type": "image" }
            },
            "title": "test title"
        }
    }
}
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: {
      body: JSON.stringify('test'),
      media: [
        {
          url: 'https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/WZR5ZtF0t1lIQTx1_wW-_.mp4',
          metadata: {type: 'video'}
        }
      ],
      cover: {
        url: 'https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/dS2sNtXUgrLfosukfpXwd.jpg',
        metadata: {type: 'image'}
      },
      title: 'test title'
    },
    publishAt: '2026-06-29T09:43:42Z',
    items: {
      accountId: 'KWAI_f1b6d99b9252a17314bf5724e666123f',
      platform: 'KWAI',
      overrides: {
        body: JSON.stringify('test'),
        media: [
          {
            url: 'https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/WZR5ZtF0t1lIQTx1_wW-_.mp4',
            metadata: {type: 'video'}
          }
        ],
        cover: {
          url: 'https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/dS2sNtXUgrLfosukfpXwd.jpg',
          metadata: {type: 'image'}
        },
        title: 'test title'
      }
    }
  })
};

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    \"body\": \"test\",\n    \"media\": [\n      {\n        \"url\": \"https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/WZR5ZtF0t1lIQTx1_wW-_.mp4\",\n        \"metadata\": {\n          \"type\": \"video\"\n        }\n      }\n    ],\n    \"cover\": {\n      \"url\": \"https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/dS2sNtXUgrLfosukfpXwd.jpg\",\n      \"metadata\": {\n        \"type\": \"image\"\n      }\n    },\n    \"title\": \"test title\"\n  },\n  \"publishAt\": \"2026-06-29T09:43:42Z\",\n  \"items\": {\n    \"accountId\": \"KWAI_f1b6d99b9252a17314bf5724e666123f\",\n    \"platform\": \"KWAI\",\n    \"overrides\": {\n      \"body\": \"test\",\n      \"media\": [\n        {\n          \"url\": \"https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/WZR5ZtF0t1lIQTx1_wW-_.mp4\",\n          \"metadata\": {\n            \"type\": \"video\"\n          }\n        }\n      ],\n      \"cover\": {\n        \"url\": \"https://assets.aitoearn.cn/69a5882a0ae8abf6b443675f/user/media/202606/dS2sNtXUgrLfosukfpXwd.jpg\",\n        \"metadata\": {\n          \"type\": \"image\"\n        }\n      },\n      \"title\": \"test title\"\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": "douyin",
        "status": -1,
        "publishTime": "2026-07-02T12:00:00.000Z",
        "platformWorkId": "string",
        "workLink": "string",
        "linkStatus": "pending",
        "linkError": "string",
        "linkMeta": {},
        "errorMsg": "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