Skip to main content

CreativeCreateRequest

Request to create a creative and generate its host-voiced audio. The platform allocates the voice clone, synthesizes, and stores the audio behind the scenes --- the client just states what ad to make and for which campaign. voice_id defaults to the podcast's primary voice when omitted. ad_copy is an optional override: when omitted the copy is taken from the campaign variant (variant_id) or the campaign's default copy, so the client need not re-send text it read.

campaign_idstringnullable

Identifier of the campaign this creative is generated for.

Example: 9Wq4Zx7NpR2kLb6Hm0D
voice_idstringnullable

Identifier of the voice clone used to synthesize the audio. Defaults to the podcast's primary voice when omitted.

Example: 8Mp3Cq7VtL2nXw5Rk9H
offer_idstringnullable

Identifier of the offer this creative fulfills, when creating from an offer.

Example: 5Tn1Yv8QcM4dKw3Pr7E
variant_idstringnullable

Identifier of the campaign ad-copy variant to read. Its copy is used when ad_copy is omitted.

Example: 2Bx6Rk9LtN5mZq8Wv4G
ad_copystringnullable

Optional ad copy override. When omitted the copy is taken from the campaign variant or the campaign's default copy.

Example: This episode is brought to you by Acme...
language_codestringnullable

Optional BCP-47 language code to synthesize the audio in.

Example: en-US
CreativeCreateRequest
{
  "campaign_id": "9Wq4Zx7NpR2kLb6Hm0D",
  "voice_id": "8Mp3Cq7VtL2nXw5Rk9H",
  "offer_id": "5Tn1Yv8QcM4dKw3Pr7E",
  "variant_id": "2Bx6Rk9LtN5mZq8Wv4G",
  "ad_copy": "This episode is brought to you by Acme...",
  "language_code": "en-US"
}