Skip to main content
Updates the prompt and/or reference image for the real-time model. This method allows you to change both the text prompt and reference image in a single operation.

​
Method Signature

set(input: SetInput): Promise<void>

​
Parameters

​
input
SetInput
required
Object containing the prompt and/or image to update. At least one of prompt or image must be provided.

​
Return Value

​
Promise<void>
Promise<void>
A promise that resolves when the update is complete, or rejects if:
  • The connection is not active
  • Input validation fails
  • The server rejects the update
  • The operation times out (30 seconds)

​
Error Handling

The method throws an error if:
  • Connection is not in "connected" or "generating" state
  • Neither prompt nor image is provided
  • prompt is an empty string
  • Image format is invalid or cannot be fetched
  • Server rejects the update
  • Operation times out after 30 seconds
try {
  await client.set({
    prompt: 'cyberpunk style',
    image: imageBlob
  });
  console.log('State updated successfully');
} catch (error) {
  console.error('Failed to update state:', error.message);
}

​
Usage Examples

​
Update Both Prompt and Image

import { createDecartClient, models } from '@decart/sdk';

const decart = createDecartClient({ apiKey: 'your-api-key' });
const stream = await navigator.mediaDevices.getUserMedia({ video: true });

const client = await decart.realtime.connect(stream, {
  model: models.realtime.lucy2Rt(),
  onRemoteStream: (remoteStream) => {
    videoElement.srcObject = remoteStream;
  }
});

// Update both prompt and reference image
const referenceImage = await fetch('/reference.jpg').then(r => r.blob());

await client.set({
  prompt: 'Match the style of the reference image',
  image: referenceImage,
  enhance: true
});

​
Update Only Prompt

// Update just the prompt
await client.set({
  prompt: 'anime style, vibrant colors'
});

​
Update Only Image

// Update just the reference image
const newImage = await fetch('https://example.com/new-ref.jpg')
  .then(r => r.blob());

await client.set({
  image: newImage
});

​
Clear Reference Image

// Remove the current reference image
await client.set({
  image: null,
  prompt: 'Continue without reference image'
});

​
Image from File Input

// Handle file upload from user
const fileInput = document.getElementById('image-upload');

fileInput.addEventListener('change', async (event) => {
  const file = event.target.files[0];
  if (!file) return;
  
  try {
    await client.set({
      image: file,
      prompt: 'Apply style from reference'
    });
    console.log('Reference image updated');
  } catch (error) {
    console.error('Failed to update:', error.message);
  }
});

​
Image from URL

// Set image from HTTP URL (automatically fetched)
await client.set({
  image: 'https://example.com/reference.jpg',
  prompt: 'Match this style'
});

​
Image from Data URL

// Set image from canvas or data URL
const canvas = document.getElementById('canvas');
const dataUrl = canvas.toDataURL('image/png');

await client.set({
  image: dataUrl,
  prompt: 'Transform based on this reference'
});

​
Sequential Updates

// Update state multiple times
const styles = [
  { prompt: 'watercolor painting', image: 'ref1.jpg' },
  { prompt: 'oil painting', image: 'ref2.jpg' },
  { prompt: 'digital art', image: 'ref3.jpg' }
];

for (const style of styles) {
  await client.set(style);
  await new Promise(resolve => setTimeout(resolve, 5000)); // Wait 5s between updates
}

​
Dynamic State Management

class RealtimeStateManager {
  constructor(private client: RealTimeClient) {}
  
  async updatePrompt(prompt: string) {
    await this.client.set({ prompt });
  }
  
  async updateImage(image: Blob | File | string) {
    await this.client.set({ image });
  }
  
  async updateBoth(prompt: string, image: Blob | File | string) {
    await this.client.set({ prompt, image });
  }
  
  async clearImage() {
    await this.client.set({ 
      image: null,
      prompt: 'Reset to default style'
    });
  }
}

const manager = new RealtimeStateManager(client);
await manager.updateBoth('anime style', referenceImage);

​
Implementation Details

​
Timeout

The method has a built-in timeout of 30 seconds for the update operation. This is longer than setPrompt() because image uploads may take additional time.

​
Image Processing

When an image is provided:
  1. If it’s a URL (HTTP/HTTPS), it’s fetched automatically
  2. If it’s a data URL, the base64 part is extracted
  3. If it’s a Blob/File, it’s converted to base64
  4. The base64 image is sent to the server via WebSocket

​
Validation

The method validates:
  • At least one of prompt or image must be provided
  • If prompt is provided, it must be a non-empty string
  • If image is provided, it must be a valid format
  • Connection must be active ("connected" or "generating" state)

​
Comparison with Other Methods

MethodUpdates PromptUpdates ImageUse Case
set()✓✓Update prompt and/or image together
setPrompt()✓✗Update only prompt with faster acknowledgment
setImage()✗✓Update only image with additional options

​
See Also

Build docs developers (and LLMs) love

Get started for freeTalk to us