[Doc] Rewrite checklist & update docs. (#360)

Signed-off-by: Alicia Wang <115451386+congw729@users.noreply.github.com>
Signed-off-by: Alicia <115451386+congw729@users.noreply.github.com>
Signed-off-by: Hongsheng Liu <liuhongsheng4@huawei.com>
Co-authored-by: Hongsheng Liu <liuhongsheng4@huawei.com>
This commit is contained in:
AliciaandHongsheng Liu authored and GitHub committed 2025-12-19 06:11:54 +08:00
1 parent b5e50d552a
commit d6310e2ea9
7 files changed
+103 -100

No files matched your search

@@ -1,6 +1,6 @@
# Qwen-Image-Edit Online Serving
# Image-To-Image
Source <https://github.com/vllm-project/vllm-omni/tree/main/examples/online_serving/qwen_image_edit>.
Source <https://github.com/vllm-project/vllm-omni/tree/main/examples/online_serving/image_to_image>.
This example demonstrates how to deploy Qwen-Image-Edit model for online image editing service using vLLM-Omni.
@@ -15,6 +15,7 @@ vllm serve Qwen/Qwen-Image-Edit --omni --port 8092
### Start with Parameters
Or use the startup script:
```bash
@@ -125,13 +126,16 @@ Use `extra_body` to pass generation parameters:
## Generation Parameters (extra_body)
| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `num_inference_steps` | int | 50 | Number of denoising steps |
| `guidance_scale` | float | 7.5 | CFG guidance scale |
| `seed` | int | None | Random seed (reproducible) |
| `negative_prompt` | str | None | Negative prompt |
| `num_outputs_per_prompt` | int | 1 | Number of images to generate |
| Parameter | Type | Default | Description |
| ------------------------ | ----- | ------- | ------------------------------------- |
| `height` | int | None | Output image height in pixels |
| `width` | int | None | Output image width in pixels |
| `size` | str | None | Output image size (e.g., "1024x1024") |
| `num_inference_steps` | int | 50 | Number of denoising steps |
| `guidance_scale` | float | 7.5 | CFG guidance scale |
| `seed` | int | None | Random seed (reproducible) |
| `negative_prompt` | str | None | Negative prompt |
| `num_outputs_per_prompt` | int | 1 | Number of images to generate |
## Response Format
@@ -159,39 +163,35 @@ Use `extra_body` to pass generation parameters:
## Common Editing Instructions Examples
| Instruction | Description |
|-------------|-------------|
| `Convert this image to watercolor style` | Style transfer |
| `Convert the image to black and white` | Desaturation |
| `Enhance the color saturation` | Color adjustment |
| `Convert to cartoon style` | Cartoonization |
| `Add vintage filter effect` | Filter effect |
| `Convert daytime scene to nighttime` | Scene conversion |
| Instruction | Description |
| ---------------------------------------- | ---------------- |
| `Convert this image to watercolor style` | Style transfer |
| `Convert the image to black and white` | Desaturation |
| `Enhance the color saturation` | Color adjustment |
| `Convert to cartoon style` | Cartoonization |
| `Add vintage filter effect` | Filter effect |
| `Convert daytime scene to nighttime` | Scene conversion |
## File Description
| File | Description |
|------|-------------|
| `run_server.sh` | Server startup script |
| `run_curl_image_edit.sh` | curl image editing example |
| `openai_chat_client.py` | Python client |
| `gradio_demo.py` | Gradio interactive interface |
| File | Description |
| ------------------------ | ---------------------------- |
| `run_server.sh` | Server startup script |
| `run_curl_image_edit.sh` | curl image editing example |
| `openai_chat_client.py` | Python client |
| `gradio_demo.py` | Gradio interactive interface |
## Example materials
??? abstract "gradio_demo.py"
``````py
--8<-- "examples/online_serving/qwen_image_edit/gradio_demo.py"
--8<-- "examples/online_serving/image_to_image/gradio_demo.py"
``````
??? abstract "openai_chat_client.py"
``````py
--8<-- "examples/online_serving/qwen_image_edit/openai_chat_client.py"
``````
??? abstract "run_curl_image_edit.sh"
``````sh
--8<-- "examples/online_serving/qwen_image_edit/run_curl_image_edit.sh"
--8<-- "examples/online_serving/image_to_image/openai_chat_client.py"
``````
??? abstract "run_server.sh"
``````sh
--8<-- "examples/online_serving/qwen_image_edit/run_server.sh"
--8<-- "examples/online_serving/image_to_image/run_server.sh"
``````
@@ -1,6 +1,6 @@
# Qwen-Image/Z-Image Online Serving
# Text-To-Image
Source <https://github.com/vllm-project/vllm-omni/tree/main/examples/online_serving/qwen_image>.
Source <https://github.com/vllm-project/vllm-omni/tree/main/examples/online_serving/text_to_image>.
This example demonstrates how to deploy Qwen-Image model for online image generation service using vLLM-Omni.
@@ -15,7 +15,6 @@ vllm serve Qwen/Qwen-Image --omni --port 8091
### Start with Parameters
Or use the startup script:
```bash
@@ -62,7 +61,7 @@ python gradio_demo.py
## Request Format
### Simple Text-to-Image Generation
### Simple Text Generation
```json
{
@@ -108,15 +107,16 @@ Use `extra_body` to pass generation parameters:
## Generation Parameters (extra_body)
| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `height` | int | None | Image height in pixels |
| `width` | int | None | Image width in pixels |
| `num_inference_steps` | int | 50 | Number of denoising steps |
| `true_cfg_scale` | float | 4.0 | Qwen-Image CFG scale |
| `seed` | int | None | Random seed (reproducible) |
| `negative_prompt` | str | None | Negative prompt |
| `num_outputs_per_prompt` | int | 1 | Number of images to generate |
| Parameter | Type | Default | Description |
| ------------------------ | ----- | ------- | ------------------------------ |
| `height` | int | None | Image height in pixels |
| `width` | int | None | Image width in pixels |
| `size` | str | None | Image size (e.g., "1024x1024") |
| `num_inference_steps` | int | 50 | Number of denoising steps |
| `true_cfg_scale` | float | 4.0 | Qwen-Image CFG scale |
| `seed` | int | None | Random seed (reproducible) |
| `negative_prompt` | str | None | Negative prompt |
| `num_outputs_per_prompt` | int | 1 | Number of images to generate |
## Response Format
@@ -151,28 +151,28 @@ cat response.json | jq -r '.choices[0].message.content[0].image_url.url' | cut -
## File Description
| File | Description |
|------|-------------|
| `run_server.sh` | Server startup script |
| `run_curl_text_to_image.sh` | curl example |
| `openai_chat_client.py` | Python client |
| `gradio_demo.py` | Gradio interactive interface |
| File | Description |
| --------------------------- | ---------------------------- |
| `run_server.sh` | Server startup script |
| `run_curl_text_to_image.sh` | curl example |
| `openai_chat_client.py` | Python client |
| `gradio_demo.py` | Gradio interactive interface |
## Example materials
??? abstract "gradio_demo.py"
``````py
--8<-- "examples/online_serving/qwen_image/gradio_demo.py"
--8<-- "examples/online_serving/text_to_image/gradio_demo.py"
``````
??? abstract "openai_chat_client.py"
``````py
--8<-- "examples/online_serving/qwen_image/openai_chat_client.py"
--8<-- "examples/online_serving/text_to_image/openai_chat_client.py"
``````
??? abstract "run_curl_text_to_image.sh"
``````sh
--8<-- "examples/online_serving/qwen_image/run_curl_text_to_image.sh"
--8<-- "examples/online_serving/text_to_image/run_curl_text_to_image.sh"
``````
??? abstract "run_server.sh"
``````sh
--8<-- "examples/online_serving/qwen_image/run_server.sh"
--8<-- "examples/online_serving/text_to_image/run_server.sh"
``````