1. Clarify Intent: Distinguish whether the user needs [Text-to-Image] (generate new images) or [Image-to-Image] (edit/modify existing images).
2. Prompt Analysis:
   • Use the user's original complete input: Directly use the user's original full question and requirement description as the main body of the

     -p

     prompt. Avoid rewriting, summarizing, or secondary creation on your own to prevent loss of details.
   • Confirm first before supplementing: If information is insufficient (e.g., missing style, number of subjects, shot language, scene details, text content, prohibited elements, etc.), ask the user for confirmation first; after the user confirms, append the supplementary content to the original prompt in an "appended" manner.
   • Examples:
     • User input: "Help me generate a picture of a cat, in a cute style."
     • Correct example: Use the user's input directly as the prompt:

       -p "Help me generate a picture of a cat, in a cute style."

     • Incorrect example: Unauthorized rewriting to "Generate a picture of a cat in cute style" will lose the details and tone of the user's original input.
     • If details need to be supplemented (e.g., color, background, etc.), ask for confirmation first: "What color do you want the cat to be? Any requirements for the background?" After the user replies, append to the prompt:

       -p "Help me generate a picture of a cat, in a cute style. The cat is orange, and the background is grass."

3. Key Parameter Organization:
   • Prompt (Required): The final prompt after analysis (default = the user's original complete and consistent input; only append supplementary information after user confirmation).
   • Filename (Optional): Output image filename/path (must include a random identifier to avoid duplicates). If not provided, the script will automatically generate a filename with a timestamp. It is recommended to generate a reasonable filename based on content (e.g.,

     cat_in_garden.png

     ), avoid using generic names.
   • Aspect Ratio (Optional): Infer the ratio based on the user's description. For example:
     • "Mobile wallpaper" ->

       9:16

     • "Computer wallpaper/video cover" ->

       16:9

     • "Avatar" ->

       1:1

     • Default: If the user does not specify an aspect ratio, leave it empty.
   • Resolution (Optional):
     • Default aspect ratio uses

       2K

       .
     • Only use

       4K

       for extreme high-definition needs or when specified by the user, and prompt the user friendly that generation will be slow, please wait patiently.
     • Note: Parameter values must be uppercase (

       1K

       ,

       2K

       ,

       4K

       ).

1. Check Environment: Confirm whether the

   APIYI_API_KEY

   environment variable is set (usually assumed to be set; prompt the user if execution fails).
2. Build and Run Commands:
   • Priority: Node.js Version: If Node is available in the environment (the

     node

     command works), prefer using

     scripts/generate_image.js

     (zero dependencies, parameters consistent with Python).
   • Use Python Version if Node is Unavailable: Use

     scripts/generate_image.py

     .
   Text-to-Image Command Template (Priority: Node.js):
   bash

   node scripts/generate_image.js -p "{prompt}" -f "{filename}" [-a {ratio}] [-r {res}]

   Image-to-Image Command Template (Priority: Node.js):
   bash

   node scripts/generate_image.js -p "{edit_instruction}" -i "{input_path}" -f "{output_filename}" [-r {res}]

   (Optional) Python Version Command Template (When Node is Unavailable):
   bash

   python scripts/generate_image.py -p "{prompt}" -f "{filename}" [-a {ratio}] [-r {res}]
   python scripts/generate_image.py -p "{edit_instruction}" -i "{input_path}" -f "{output_filename}" [-r {res}]

• "Image generation has started, expected to take 25 seconds to 5 minutes"

1. Quick Generation Scenario (1K Resolution)

"Quick Mode: Generate with 1K resolution, expected to complete within 30 seconds"

1. High-quality Generation Scenario (2K/4K Resolution)

"High-quality Mode: Generate with 2K resolution, expected to take 1-4 minutes\n⏳ Starting generation... 🔄"

1. Execution Feedback: Wait for the terminal command to complete execution.
2. Success: Inform the user that the image has been generated and indicate the save path.
3. Failure:
   • If prompted for missing API Key, guide the user to set the environment variable.
   • If prompted for network error, suggest the user check the network or try again later.

• Common Usage Scenarios Document: references/scene.md

Parameters for Python and Node.js versions are consistent (short parameters are equivalent to long parameters).

-p

--prompt

-f

--filename

-a

--aspect-ratio

1:1

16:9

9:16

4:3

3:4

3:2

2:3

5:4

4:5

21:9

-r

--resolution

1K

2K

4K

-i

--input-image

• API Key must be set, which can be provided via environment variable or command line parameter
• Resolution parameters must be uppercase (1K/2K/4K); lowercase will default to 1K
• Image generation time: 25 seconds to 5 minutes, depending on resolution and server load
• When editing images, the input image will be automatically converted to base64 encoding
• Ensure the output directory has write permission

1. Visit https://api.apiyi.com
2. Register/Log in to your account
3. Create an API Key in the console
4. Copy the key and set the environment variable or use it in the command line

1. --api-key

   command line parameter (temporary use)

2. APIYI_API_KEY

   environment variable (recommended)

undefined

• Everywhere Who Loves One Piece
• My WeChat Official Account: Ubiquitous Technology