Vidu Q2 | Reference to Image
Generate images using reference images to maintain consistent subject appearance across generations. Combine text prompts with visual references for precise control.
Quick Start
Requires an each::labs API key. Get one at eachlabs.ai.
curl -X POST https://api.eachlabs.ai/v1/prediction \
-H "Content-Type: application/json" \
-H "X-API-Key: $EACHLABS_API_KEY" \
-d '{
"model": "vidu-q2-reference-to-image",
"version": "0.0.1",
"input": {
"prompt": "the character standing in front of a castle, heroic pose",
"reference_image_urls": ["https://example.com/character-ref.jpg"],
"aspect_ratio": "16:9"
}
}'
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
| aspect_ratio | string | 16:9 | The aspect ratio of the output image. enum: 16:9, 9:16, 1:1 |
| prompt | string | Text prompt for image generation, max 1500 characters. | |
| reference_image_urls | array | URLs of the reference images to use for consistent subject appearance. | |
| seed | integer | Random seed for generation. |
Examples
Character in new scene:
curl -X POST https://api.eachlabs.ai/v1/prediction \
-H "Content-Type: application/json" \
-H "X-API-Key: $EACHLABS_API_KEY" \
-d '{
"model": "vidu-q2-reference-to-image",
"version": "0.0.1",
"input": {
"prompt": "the person sitting in a modern coffee shop, reading a book",
"reference_image_urls": ["https://example.com/person-ref.jpg"],
"aspect_ratio": "1:1",
"seed": 42
}
}'
Multiple references for consistency:
curl -X POST https://api.eachlabs.ai/v1/prediction \
-H "Content-Type: application/json" \
-H "X-API-Key: $EACHLABS_API_KEY" \
-d '{
"model": "vidu-q2-reference-to-image",
"version": "0.0.1",
"input": {
"prompt": "the character wearing a spacesuit, walking on Mars surface",
"reference_image_urls": ["https://example.com/char-front.jpg", "https://example.com/char-side.jpg"],
"aspect_ratio": "16:9"
}
}'
Related Models
- Vidu Q2 | Text to Image - Generate images from text only
- Kling O1 - Image generation with reference image support