create_replica
Build an AI replica from a training video to generate synthetic video content with customizable properties like gaze correction and background options.
Instructions
Create a new AI replica from a training video
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| train_video_url | Yes | Direct link to training video (S3, etc.) | |
| replica_name | No | Name for the replica | |
| consent_video_url | No | Optional separate consent video URL | |
| callback_url | No | URL to receive training completion callback | |
| model_name | No | Phoenix model version (phoenix-3 default) | |
| properties | No | Additional replica properties |
Implementation Reference
- src/index.ts:781-789 (handler)Handler function that executes the create_replica tool logic - makes a POST request to /replicas endpoint with the provided arguments and returns the response data as formatted JSON text
private async createReplica(args: any) { const response = await this.axiosInstance.post('/replicas', args); return { content: [{ type: 'text', text: JSON.stringify(response.data, null, 2), }], }; } - src/index.ts:135-173 (schema)Tool schema definition with name, description, and inputSchema specifying the structure and validation rules for create_replica tool inputs (train_video_url is required, plus optional replica_name, consent_video_url, callback_url, model_name, and properties)
{ name: 'create_replica', description: 'Create a new AI replica from a training video', inputSchema: { type: 'object', properties: { train_video_url: { type: 'string', description: 'Direct link to training video (S3, etc.)', }, replica_name: { type: 'string', description: 'Name for the replica', }, consent_video_url: { type: 'string', description: 'Optional separate consent video URL', }, callback_url: { type: 'string', description: 'URL to receive training completion callback', }, model_name: { type: 'string', description: 'Phoenix model version (phoenix-3 default)', enum: ['phoenix-2', 'phoenix-3'], }, properties: { type: 'object', description: 'Additional replica properties', properties: { gaze_correction: { type: 'boolean' }, background_green_screen: { type: 'boolean' }, }, }, }, required: ['train_video_url'], }, }, - src/index.ts:692-693 (registration)Registration/routing logic in CallToolRequestSchema handler that maps the 'create_replica' tool name to its handler method
case 'create_replica': return await this.createReplica(request.params.arguments);