Generate UGC video
generate_ugc_videoMake a UGC-style creator video: a catalogue creator (template from list_ugc_avatars) or a person's own photo (image_url) speaks the script with lip-sync, optional voice choice and ambience. Requires a quote_id from estimate_ad_cost with kind "ugc", and image_rights_consent: true given by the person. Returns an id to poll with get_generation. Credits are charged only on success. SIGN-IN REQUIRED: connect this server with OAuth (the host prompts for it), or add an API key header "Authorization: Bearer acd_live_…" created at https://aicontentdrop.com/settings/integrations.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"quote_id": "<quote_id>",
"script": "<script>",
"image_rights_consent": "<image_rights_consent>"
},
"name": "generate_ugc_video"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| voice | No | Optional voice id or name. | |
| script | Yes | What the creator says, up to 1000 characters. | |
| ambience | No | Optional background sound, e.g. cafe, street, none. | |
| language | No | Optional language code, e.g. en. | |
| quote_id | Yes | The quote_id from estimate_ad_cost with kind "ugc". Required. | |
| template | No | A creator id from list_ugc_avatars. Alternative to image_url. | |
| image_url | No | Public https URL of the person's photo. Alternative to template. | |
| image_rights_consent | Yes | Must be true, and only after the person confirmed they hold the rights to the face and accept the acceptable-use terms. No default. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Poll this with get_generation. | |
| kind | Yes | ||
| status | Yes | ||
| replayed | Yes | ||
| next_step | Yes | ||
| credits_used | Yes | 0 until the render succeeds; billing is post-deduct. | |
| credits_quoted | Yes |