> ## Documentation Index > Fetch the complete documentation index at: https://docs.vidgo.ai/llms.txt > Use this file to discover all available pages before exploring further. # Seedream 4 Edit > Transform images with Seedream 4 using multiple visual references, with batch variations and output up to 4K. 1. Submit the request with `VIDGO_API_KEY`. A `task_id` is returned immediately. Keep it until the task reaches `finished` or `failed`. 2. Use [Query Task Status](/api-manual/task-management/status) to retrieve the result. If you provide a `callback_url`, Vidgo sends the result to your [webhook](/api-manual/task-management/webhooks) when the task finishes or fails. # Seedream 4 Edit Transform images with Seedream 4 using multiple visual references, with batch variations and output up to 4K. ## Available Models * **bytedance/seedream/v4/edit** - Edit images using a prompt and image references. ## Output Options ### Image Size * `size`: Optional. Accepted values: `1:1`, `3:4`, `4:3`, `16:9`, `9:16`, `3:2`, `2:3`, `21:9`. Default: `1:1`. ### Resolution * `resolution`: Optional. Accepted values: `1K`, `2K`, `4K`. Default: `2K`. ### Image Count * `n`: Optional. Number of images to generate. Integer from `1` to `15`. Default: `1`. * The number of `image_urls` plus `n` totals 15 or fewer. ## Key Features * Edit images using a prompt and image references. * Accepts 1-10 images in `image_urls`. * Choose from `1K`, `2K`, `4K` output resolutions. * Control the number of output images with `n`. ## Advanced Parameters Set `model` and optional `callback_url` at the request root. Place all workflow parameters, including output options, inside `input`. Input image URLs use HTTP(S) and point to publicly accessible image files. ### Prompt * `prompt`: Required. Describe the requested changes. Length: **1-5,000 characters**. * Include at least one non-whitespace character. ### Image URLs * `image_urls`: Required. Provide publicly accessible image URLs. Supply 1-10 items. Each item must be an HTTP(S) URL. ## OpenAPI ````yaml api-manual/image-series/bytedance-seedream-v4-edit.json POST /api/generate/submit openapi: 3.0.0 info: title: Vidgo API - Seedream 4 Edit description: >- Transform images with Seedream 4 using multiple visual references, with batch variations and output up to 4K. version: 1.0.0 servers: - url: https://api.vidgo.ai security: - BearerAuth: [] paths: /api/generate/submit: post: tags: - Image Series summary: Seedream 4 Edit description: >- Submit an asynchronous image editing task. Provide a prompt containing 1–5,000 characters with at least one non-whitespace character, and 1–10 public HTTP(S) image URLs. The number of image_urls plus n totals 15 or fewer. operationId: submit_bytedance_seedream_v4_edit requestBody: required: true content: application/json: schema: type: object required: - model - input additionalProperties: true properties: model: type: string example: bytedance/seedream/v4/edit enum: - bytedance/seedream/v4/edit input: type: object required: - image_urls - prompt properties: prompt: type: string maxLength: 5000 minLength: 1 description: >- Describe the requested changes using 1–5,000 characters, including at least one non-whitespace character. image_urls: type: array items: type: string format: uri description: Public HTTP(S) URL of a reference image. minItems: 1 maxItems: 10 description: >- 1–10 ordered public HTTP(S) reference image URLs. The number of image_urls plus n totals 15 or fewer. size: type: string enum: - '1:1' - '3:4' - '4:3' - '16:9' - '9:16' - '3:2' - '2:3' - '21:9' default: '1:1' description: >- Output aspect ratio: 1:1, 3:4, 4:3, 16:9, 9:16, 3:2, 2:3, or 21:9. Default: 1:1. resolution: type: string enum: - 1K - 2K - 4K default: 2K description: 'Output resolution preset: 1K, 2K, or 4K. Default: 2K.' 'n': type: integer minimum: 1 maximum: 15 default: 1 description: >- Number of images to generate, from 1 to 15. Default: 1. The number of image_urls plus n totals 15 or fewer. additionalProperties: false callback_url: type: string nullable: true description: >- Optional public HTTP(S) URL for task completion notifications. description: >- Set model and optional callback_url at the request root. Place generation parameters inside input. examples: edit-01: summary: The Coptic Bookbinder value: model: bytedance/seedream/v4/edit input: prompt: >- Combine the three reference images into one natural documentary photograph. Use the elderly bookbinder from image 1 with exactly the same face, wrinkles, eyes, grey beard, navy galabeya, brown leather apron and silver cross. Use only the goatskin cover, gold-and-red interlaced cross, brass bosses and leather ties from image 2; do not copy the white table or the isolated still-life setup. Set the scene in the Cairo workshop from image 3 with its mashrabiya window, wooden press, shelves of quires and the ochre street beyond. The man stands in three-quarter view at the table, pressing the finished cover onto a text block in the wooden press. Relight him and the book with the same warm low afternoon sun from the left and matching lattice shadows, consistent scale and perspective, no text, no watermark. size: '4:3' resolution: 2K 'n': 1 image_urls: - >- https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4/edit/v1/01/input-01.png - >- https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4/edit/v1/01/input-02.png - >- https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4/edit/v1/01/input-03.png edit-02: summary: Opening the Spice Loft value: model: bytedance/seedream/v4/edit input: prompt: >- Extend image 1 into a wide 16:9 photograph. Keep the clove basket, the crate, the slatted shutter and the stripe of sun exactly as they are, with the same size, angle and relative position. Naturally expand the scene on both sides and upward: to the left reveal more of the loft with stacked jute sacks of cinnamon bark and a hanging brass scale; to the right open a doorway onto a bright stone stair and a glimpse of a turquoise harbor; above, show the timber rafters and a few swallows on a beam. Seamless continuation of the same late-afternoon light, dust motes and wood grain with no visible seams or borders, no text, no watermark. size: '16:9' resolution: 2K 'n': 1 image_urls: - >- https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4/edit/v1/02/input-01.png edit-03: summary: Cyanotype of the Fes Tanneries value: model: bytedance/seedream/v4/edit input: prompt: >- Redraw image 1 in the exact visual style of image 2. Image 1 defines all content: keep the same high terrace viewpoint and framing, the honeycomb vats, the tanners in the same positions, the drying skins and the surrounding stone walls. Image 2 defines only the style: a cyanotype on textured watercolor paper with a Prussian-blue ground, white or pale-blue highlights, slightly uneven chemical wash and visible paper fibers. Do not copy any ferns, plants or botanical shapes from image 2. No text, no signature, no watermark. size: '3:4' resolution: 2K 'n': 1 image_urls: - >- https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4/edit/v1/03/input-01.png - >- https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4/edit/v1/03/input-02.png callback: summary: Receive a completion callback value: model: bytedance/seedream/v4/edit input: prompt: >- Combine the three reference images into one natural documentary photograph. Use the elderly bookbinder from image 1 with exactly the same face, wrinkles, eyes, grey beard, navy galabeya, brown leather apron and silver cross. Use only the goatskin cover, gold-and-red interlaced cross, brass bosses and leather ties from image 2; do not copy the white table or the isolated still-life setup. Set the scene in the Cairo workshop from image 3 with its mashrabiya window, wooden press, shelves of quires and the ochre street beyond. The man stands in three-quarter view at the table, pressing the finished cover onto a text block in the wooden press. Relight him and the book with the same warm low afternoon sun from the left and matching lattice shadows, consistent scale and perspective, no text, no watermark. size: '4:3' resolution: 2K 'n': 1 image_urls: - >- https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4/edit/v1/01/input-01.png - >- https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4/edit/v1/01/input-02.png - >- https://cdn.vidgo.ai/apis/models/bytedance/seedream/v4/edit/v1/01/input-03.png callback_url: https://your-domain.com/callback responses: '200': description: Task submitted content: application/json: schema: type: object required: - code - data properties: code: type: integer enum: - 200 data: type: object required: - task_id - status - created_time properties: task_id: type: string status: type: string enum: - not_started - running - finished - failed created_time: type: string format: date-time example: code: 200 data: task_id: MJH8FQO824KBO4VG status: running created_time: '2026-09-26T10:59:58' '400': description: Request validation or account balance error content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '401': description: Authentication error content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '403': description: Access denied content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '404': description: Unknown or disabled model content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '408': description: Request timed out content: text/plain: schema: type: string example: Request timeout '422': description: Invalid JSON or non-object request body content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '429': description: Request rate or account limit reached content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '500': description: Internal server error content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '502': description: Task creation error content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '503': description: Service temporarily unavailable content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} components: securitySchemes: BearerAuth: type: http scheme: bearer description: Use VIDGO_API_KEY. ````