Render

Render prepared Podcast workspaces using the Web render pipeline. Poll get_project for completion and video URL.

POST /open/podcast/v1/render

render

cURL

curl --request POST \
  --url https://api-services.podcastor.ai/open/podcast/v1/render \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "tasks": [
    {
      "project_id": "<string>",
      "index": 123,
      "workspace": "<string>",
      "workspace_obj": {
        "aspect_ratio": 123,
        "condition": "<string>",
        "ext": "<string>",
        "flags": {
          "emotions": true,
          "podcast": true,
          "ppt2video": true,
          "uhd": true
        },
        "h": 123,
        "has_edit_media": true,
        "keying_enable": 123,
        "music_id": 123,
        "name": "<string>",
        "person_id": 123,
        "person_source": 123,
        "preview_cover_time": 123,
        "preview_cover_url": "<string>",
        "render_subtitle": true,
        "scenes": [
          {
            "audio_script": {
              "duration": 123,
              "id": 123,
              "name": "<string>",
              "type": 123,
              "url": "<string>"
            },
            "bg_color": "<string>",
            "duration": 123,
            "emotion_description": "<string>",
            "key": "<string>",
            "new_duration": 123,
            "placeholder_script": {
              "duration": 123
            },
            "script": "<string>",
            "script_config": {
              "emotion": "<string>",
              "model_id": "<string>",
              "pitch": 123,
              "similarity": 123,
              "speaker_boost": true,
              "stability": 123,
              "style_exaggeration": 123,
              "tts_speed": 123,
              "volume": 123
            },
            "script_type": "<string>",
            "speak_person": {
              "id": 123,
              "person_source": 123
            },
            "speaker_order": 123,
            "subtitle_info": [
              {
                "end_time": 123,
                "start_time": 123,
                "text": "<string>"
              }
            ],
            "tracks": [
              {
                "index": 123,
                "key": "<string>",
                "layers": [
                  {
                    "alpha": 123,
                    "api_template_meta": {
                      "replace_key": "<string>"
                    },
                    "color": "<string>",
                    "crop": {
                      "h": 123,
                      "w": 123,
                      "x": 123,
                      "y": 123
                    },
                    "fit_mode": "<string>",
                    "flip": "<string>",
                    "gauss": 123,
                    "h": 123,
                    "key": "<string>",
                    "mode": "<string>",
                    "moving_camera": {
                      "type": "<string>"
                    },
                    "path": "<string>",
                    "person_cover": "<string>",
                    "person_preview_url": "<string>",
                    "preview_path": "<string>",
                    "prop": {
                      "animationInfo": {
                        "cycle": {
                          "duration": 123,
                          "effectType": "<string>"
                        },
                        "enter": {
                          "duration": 123,
                          "effectType": "<string>"
                        },
                        "leave": {
                          "duration": 123,
                          "effectType": "<string>"
                        }
                      },
                      "audioPath": "<string>",
                      "bg_transparent": true,
                      "clip": {
                        "end": 123,
                        "start": 123
                      },
                      "emotion": {
                        "cover": "<string>",
                        "id": 123,
                        "name": "<string>",
                        "preview_transparent_video": "<string>",
                        "preview_video": "<string>"
                      },
                      "meta": {
                        "cover": "<string>",
                        "id": 123,
                        "name": "<string>",
                        "origin_height": 123,
                        "origin_width": 123,
                        "person_source": 123,
                        "playback_type": "<string>",
                        "preview_transparent_video": "<string>",
                        "preview_video": "<string>",
                        "show_type_preset": {
                          "all": {
                            "shape": {
                              "color": "<string>",
                              "h": 123,
                              "r": 123,
                              "type": "<string>",
                              "w": 123,
                              "x": 123,
                              "y": 123
                            },
                            "size": {
                              "h": 123,
                              "w": 123
                            }
                          },
                          "circle": {
                            "shape": {
                              "color": "<string>",
                              "h": 123,
                              "r": 123,
                              "type": "<string>",
                              "w": 123,
                              "x": 123,
                              "y": 123
                            },
                            "size": {
                              "h": 123,
                              "w": 123
                            }
                          }
                        },
                        "sub_type": "<string>",
                        "tts_url": "<string>",
                        "type": "<string>"
                      },
                      "play_mode": "<string>",
                      "renderScale": 123,
                      "shapeInfo": {
                        "color": "<string>",
                        "html": "<string>",
                        "strokeColor": "<string>",
                        "strokeType": "<string>",
                        "strokeWidth": 123,
                        "type": "<string>"
                      },
                      "show_type": "<string>",
                      "templateInfo": {},
                      "textConfig": {
                        "align": "<string>",
                        "background": {},
                        "color": "<string>",
                        "fontFamily": {},
                        "fontSize": 123,
                        "fontStyle": {},
                        "padding": {},
                        "shadow": {},
                        "stroke": {},
                        "textDecoration": "<string>",
                        "verticalAlign": "<string>"
                      },
                      "textInfo": {
                        "backgroundColor": "<string>",
                        "color": "<string>",
                        "content": "<string>",
                        "fontFamily": "<string>",
                        "fontFamilyID": "<string>",
                        "fontFileName": "<string>",
                        "fontSize": 123,
                        "fontStyle": "<string>",
                        "fontWeight": "<string>",
                        "paddingBottom": 123,
                        "paddingLeft": 123,
                        "paddingRight": 123,
                        "paddingTop": 123,
                        "radius": 123,
                        "strokeColor": "<string>",
                        "strokeWidth": 123,
                        "textAlign": "<string>",
                        "textDecoration": "<string>",
                        "textOrientation": "<string>",
                        "textShadowBlur": 123,
                        "textShadowColor": "<string>",
                        "textShadowH": 123,
                        "textShadowV": 123,
                        "writingMode": "<string>"
                      },
                      "waveformConfig": {},
                      "word_seq": [
                        {
                          "break": "<string>",
                          "end": 123,
                          "hide": true,
                          "key": "<string>",
                          "start": 123,
                          "text": "<string>"
                        }
                      ]
                    },
                    "r": 123,
                    "radius": "<string>",
                    "shape": {
                      "background_gauss": 123,
                      "color": "<string>",
                      "content_position": {
                        "h": 123,
                        "r": 123,
                        "w": 123,
                        "x": 123,
                        "y": 123
                      },
                      "disable_shape": true,
                      "object_fit": "<string>",
                      "radius": 123,
                      "type": "<string>"
                    },
                    "subtitle": {
                      "font_family": {
                        "name": "<string>",
                        "url": "<string>"
                      },
                      "html": "<string>",
                      "line_size": 123,
                      "mss": 123,
                      "prop": {},
                      "text": "<string>",
                      "tts_info_index": 123,
                      "word_seq": [
                        {
                          "break": "<string>",
                          "end": 123,
                          "hide": true,
                          "key": "<string>",
                          "start": 123,
                          "text": "<string>"
                        }
                      ]
                    },
                    "template_meta": {
                      "is_goods_media": true,
                      "is_logo": true,
                      "no_need_replace": true
                    },
                    "timeline": {
                      "cross": {
                        "in": [
                          "<string>"
                        ],
                        "in_time": 123,
                        "out": [
                          "<string>"
                        ],
                        "out_time": 123
                      },
                      "end": 123,
                      "key_frames": [
                        {
                          "func": "<string>",
                          "properties": {
                            "alpha": 123,
                            "h": 123,
                            "r": 123,
                            "scale": 123,
                            "w": 123,
                            "x": 123,
                            "y": 123
                          },
                          "timestamp": 123
                        }
                      ],
                      "start": 123
                    },
                    "top_level_key": "<string>",
                    "tts_audio_url": "<string>",
                    "type": "<string>",
                    "volume": 123,
                    "w": 123,
                    "x": 123,
                    "y": 123
                  }
                ],
                "type": "<string>"
              }
            ],
            "transition": {
              "type": "<string>"
            },
            "tts_args": {
              "locale": "<string>",
              "style": "<string>"
            },
            "tts_axis": [
              {
                "duration": 123,
                "endTime": 123,
                "startTime": 123,
                "text": "<string>",
                "wordLen": 123
              }
            ],
            "tts_payment_id": "<string>",
            "tts_voice_id": "<string>"
          }
        ],
        "subtitle_version": 123,
        "t_id": 123,
        "total_duration": 123,
        "tracks": [
          {
            "index": 123,
            "key": "<string>",
            "layers": [
              {
                "alpha": 123,
                "api_template_meta": {
                  "replace_key": "<string>"
                },
                "color": "<string>",
                "crop": {
                  "h": 123,
                  "w": 123,
                  "x": 123,
                  "y": 123
                },
                "fit_mode": "<string>",
                "flip": "<string>",
                "gauss": 123,
                "h": 123,
                "key": "<string>",
                "mode": "<string>",
                "moving_camera": {
                  "type": "<string>"
                },
                "path": "<string>",
                "person_cover": "<string>",
                "person_preview_url": "<string>",
                "preview_path": "<string>",
                "prop": {
                  "animationInfo": {
                    "cycle": {
                      "duration": 123,
                      "effectType": "<string>"
                    },
                    "enter": {
                      "duration": 123,
                      "effectType": "<string>"
                    },
                    "leave": {
                      "duration": 123,
                      "effectType": "<string>"
                    }
                  },
                  "audioPath": "<string>",
                  "bg_transparent": true,
                  "clip": {
                    "end": 123,
                    "start": 123
                  },
                  "emotion": {
                    "cover": "<string>",
                    "id": 123,
                    "name": "<string>",
                    "preview_transparent_video": "<string>",
                    "preview_video": "<string>"
                  },
                  "meta": {
                    "cover": "<string>",
                    "id": 123,
                    "name": "<string>",
                    "origin_height": 123,
                    "origin_width": 123,
                    "person_source": 123,
                    "playback_type": "<string>",
                    "preview_transparent_video": "<string>",
                    "preview_video": "<string>",
                    "show_type_preset": {
                      "all": {
                        "shape": {
                          "color": "<string>",
                          "h": 123,
                          "r": 123,
                          "type": "<string>",
                          "w": 123,
                          "x": 123,
                          "y": 123
                        },
                        "size": {
                          "h": 123,
                          "w": 123
                        }
                      },
                      "circle": {
                        "shape": {
                          "color": "<string>",
                          "h": 123,
                          "r": 123,
                          "type": "<string>",
                          "w": 123,
                          "x": 123,
                          "y": 123
                        },
                        "size": {
                          "h": 123,
                          "w": 123
                        }
                      }
                    },
                    "sub_type": "<string>",
                    "tts_url": "<string>",
                    "type": "<string>"
                  },
                  "play_mode": "<string>",
                  "renderScale": 123,
                  "shapeInfo": {
                    "color": "<string>",
                    "html": "<string>",
                    "strokeColor": "<string>",
                    "strokeType": "<string>",
                    "strokeWidth": 123,
                    "type": "<string>"
                  },
                  "show_type": "<string>",
                  "templateInfo": {},
                  "textConfig": {
                    "align": "<string>",
                    "background": {},
                    "color": "<string>",
                    "fontFamily": {},
                    "fontSize": 123,
                    "fontStyle": {},
                    "padding": {},
                    "shadow": {},
                    "stroke": {},
                    "textDecoration": "<string>",
                    "verticalAlign": "<string>"
                  },
                  "textInfo": {
                    "backgroundColor": "<string>",
                    "color": "<string>",
                    "content": "<string>",
                    "fontFamily": "<string>",
                    "fontFamilyID": "<string>",
                    "fontFileName": "<string>",
                    "fontSize": 123,
                    "fontStyle": "<string>",
                    "fontWeight": "<string>",
                    "paddingBottom": 123,
                    "paddingLeft": 123,
                    "paddingRight": 123,
                    "paddingTop": 123,
                    "radius": 123,
                    "strokeColor": "<string>",
                    "strokeWidth": 123,
                    "textAlign": "<string>",
                    "textDecoration": "<string>",
                    "textOrientation": "<string>",
                    "textShadowBlur": 123,
                    "textShadowColor": "<string>",
                    "textShadowH": 123,
                    "textShadowV": 123,
                    "writingMode": "<string>"
                  },
                  "waveformConfig": {},
                  "word_seq": [
                    {
                      "break": "<string>",
                      "end": 123,
                      "hide": true,
                      "key": "<string>",
                      "start": 123,
                      "text": "<string>"
                    }
                  ]
                },
                "r": 123,
                "radius": "<string>",
                "shape": {
                  "background_gauss": 123,
                  "color": "<string>",
                  "content_position": {
                    "h": 123,
                    "r": 123,
                    "w": 123,
                    "x": 123,
                    "y": 123
                  },
                  "disable_shape": true,
                  "object_fit": "<string>",
                  "radius": 123,
                  "type": "<string>"
                },
                "subtitle": {
                  "font_family": {
                    "name": "<string>",
                    "url": "<string>"
                  },
                  "html": "<string>",
                  "line_size": 123,
                  "mss": 123,
                  "prop": {},
                  "text": "<string>",
                  "tts_info_index": 123,
                  "word_seq": [
                    {
                      "break": "<string>",
                      "end": 123,
                      "hide": true,
                      "key": "<string>",
                      "start": 123,
                      "text": "<string>"
                    }
                  ]
                },
                "template_meta": {
                  "is_goods_media": true,
                  "is_logo": true,
                  "no_need_replace": true
                },
                "timeline": {
                  "cross": {
                    "in": [
                      "<string>"
                    ],
                    "in_time": 123,
                    "out": [
                      "<string>"
                    ],
                    "out_time": 123
                  },
                  "end": 123,
                  "key_frames": [
                    {
                      "func": "<string>",
                      "properties": {
                        "alpha": 123,
                        "h": 123,
                        "r": 123,
                        "scale": 123,
                        "w": 123,
                        "x": 123,
                        "y": 123
                      },
                      "timestamp": 123
                    }
                  ],
                  "start": 123
                },
                "top_level_key": "<string>",
                "tts_audio_url": "<string>",
                "type": "<string>",
                "volume": 123,
                "w": 123,
                "x": 123,
                "y": 123
              }
            ],
            "type": "<string>"
          }
        ],
        "tts_args": {
          "locale": "<string>",
          "style": "<string>"
        },
        "tts_voice_id": "<string>",
        "used_bg_transparent": true,
        "version": "<string>",
        "w": 123
      }
    }
  ],
  "afterTTS": true,
  "createFrom": 123,
  "is_draft_render": true
}
'

200

{
  "cause": "<string>",
  "code": 123,
  "data": "<unknown>",
  "details": "<unknown>",
  "msg": "<string>",
  "rid": "<string>"
}

MCP tool: podcast_render. OAuth scope: podcast.generate.

Authorizations

X-Api-Key · string · header · required

Headers

Idempotency-Key · string

Replay a completed identical request without repeating side effects.

Maximum string length: 128

Body

application/json

请求体

tasks · object[] · required

任务列表

Show child attributes

afterTTS · boolean

内部使用参数 如果是tts之后的才能使用场景时长。否则为预估

createFrom · integer

内部使用参数

is_draft_render · boolean

Response

200 - application/json

OK

cause · string

code · integer

data · any

details · any

msg · string

rid · string