Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Wondercraft Convo Mode API

The Convo Mode API from Wondercraft — 2 operation(s) for convo mode.

Wondercraft Convo Mode API is one of 4 APIs that Wondercraft publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Convo Mode. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 2 operations across 2 paths, and defines 7 schemas. It is described by OpenAPI 3.0.1, at version 0.0.1.

Requests are made against a single base URL, https://api.wondercraft.ai/v1.

2 operations 2 paths 7 schemas 2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
0.0.1
Base URL
https://api.wondercraft.ai/v1
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

Wondercraft Convo Mode API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-API-KEY (APIKeyHeader). By default, every request must be authenticated.

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 POST. Each is listed below with its method, path, parameters, and response codes.

Convo Mode 2
POST
/podcast/convo-mode/ai-scripted
Generate AI-scripted podcast with 2 hosts using Convo Mode
generate_ai_scripted_convo_mode_episode_podcast_convo_mode_ai_scripted_post body → 200422429
POST
/podcast/convo-mode/user-scripted
Generate podcast with 2 hosts using Convo Mode and a user-provided script
generate_user_scripted_convo_mode_episode_podcast_convo_mode_user_scripted_post body → 200422429

Schemas 7

The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are MusicTrackSpec (7 properties), GenerateAiScriptedConvoModeEpisodeRequest (4 properties), GenerateUserScriptedConvoModeEpisodeRequest (3 properties), ValidationError (3 properties). Each schema is shown below with its type and property counts.

GenerateAiScriptedConvoModeEpisodeRequest
object
4 properties 1 required
ValidationError
object
3 properties 3 required
GenerateEpisodeResponse
object
1 property 1 required
MusicTrackSpec
object
7 properties 1 required
GenerateUserScriptedConvoModeEpisodeRequest
object
3 properties 1 required
HTTPValidationError
object
1 property
ScriptSegment
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

wondercraft-convo-mode-api-openapi.yml Raw ↑

Other APIs Wondercraft publishes across the network.

Wondercraft Account API
Wondercraft Audio Generation API
Wondercraft Jobs API