Skip to main content
POST
create project
MCP tool: podcast_create_project. 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

Project input

attachments
object[]

Attachments used in the editor input.

input
object[]

Input messages using the OpenAI Responses input[].content[] structure.

language
string

Language.

long_text
string

Long-form text content.

mixInfo
integer

Mixed-source details, present when origin=8.

need_send_mq
boolean

Whether to enqueue script generation.

network_enabled
boolean

Whether to allow web search.

origin
enum<integer>

Input origin: 1 = webpage URL; 2 = YouTube URL; 3 = document URL; 4 = long text; 5 = original text; 6 = uploaded script; 7 = uploaded audio.

Available options:
1,
2,
3,
4,
5,
6,
7,
8
podcast_template_id
integer

Reference template.

prj_id
string

ID of the existing project to regenerate.

render_subtitle
integer

Subtitle rendering: 1 = enabled; 2 = disabled.

script_params
object

GPT script generation parameters.

text
string

Editor input text. Supports attachment references using {{ref:id}}.

tool_choice
enum<string>

none/auto/required

Available options:
none,
auto,
required
tools
object[]

For example: [{"type":"web_search","external_web_access":true}].

url
string

Comma-separated URLs for uploaded files or websites.

urls
string[]

URL array. Also accepts the legacy comma-separated url field.

video_duration
enum<string>

Total video duration.

Available options:
-3,
-5,
13-17,
18-22,
23-30,
4-6,
7-12,
22-28,
0.5,
0.5-1,
1-3,
3-5,
5-10

Response

OK

project_id
string