Surgepix Generate Logo

SurgePix Generate Logo

Generate one brand logo image from a brand/product name, optional design notes and reference images. Default output is transparent background.

Language consistency

Match the user's conversation language for --prompt design notes — unless the user explicitly requests another language.

• Reply to the user in the same language they used in their request.

When to use

• User says "生成logo", "做个标志", "generate logo", "brand logo", "透明底 logo"
• User provides a brand/product name and optional style notes or reference images

Prerequisites

• Node.js >= 18
• SURGEPIX_API_KEY and SURGEPIX_BASE_URL configured (see Step 0)

What the Skill Does

The script always submits asynchronously to the API (noWait=true). CLI --nowait controls local behavior:

• --nowait false (default) — poll until succeeded/failed and return download
• --nowait true — return taskId immediately; use surgepix-query-task later

Setup

Requirement: Set SURGEPIX_API_KEY and SURGEPIX_BASE_URL (see surgepix-setup). Do not ask the user to paste the API key into chat.

# project-root .env
SURGEPIX_API_KEY=your-token
SURGEPIX_BASE_URL=https://api.surgepix.ai/api

Script path: <skills-dir>/surgepix-generate-logo/scripts/generate_logo.mjs.

Usage Examples

Brand name only (sync):

node "<skills-dir>/surgepix-generate-logo/scripts/generate_logo.mjs" \
  --brand-name "NovaByte" \
  --prompt "Minimal geometric monogram, primary #2563EB"
# {"ok":true,"taskId":"...","sessionId":123,"progress":"succeeded","download":"https://example.com/files/result"}

With local reference and opaque background:

node "<skills-dir>/surgepix-generate-logo/scripts/generate_logo.mjs" \
  --brand-name "NovaByte" \
  --reference ./moodboard.png \
  --transparent false \
  --size 1024x1024

Async:

node "<skills-dir>/surgepix-generate-logo/scripts/generate_logo.mjs" \
  --brand-name "NovaByte" \
  --nowait true
# Then: node "<skills-dir>/surgepix-query-task/scripts/query_task.mjs" <taskId>

Workflow

Step 0: Check environment

node "<skills-dir>/surgepix-setup/scripts/check_env.mjs"

• Exit 0 → continue
• Exit 1 → follow surgepix-setup (user writes .env themselves)

Step 1: Collect inputs

• Required: brand/product name → --brand-name
• Optional: design notes → --prompt (match user language)
• Optional: size — only 1024x1024 / 1024x1536 / 1536x1024
• Optional: --reference (repeatable), --transparent (default true), --session-id, --nowait

Step 2: Run

node "<skills-dir>/surgepix-generate-logo/scripts/generate_logo.mjs" \
  --brand-name "<name>" \
  [--prompt "<text>"] \
  [--size <1024x1024|1024x1536|1536x1024>] \
  [--reference <path-or-url> ...] \
  [--transparent <true|false>] \
  [--session-id <id>] \
  [--nowait <true|false>]

Step 3: Present result

• Success: show only download (and sessionId for retries)
• Async: show taskId + hint to use surgepix-query-task
• Never invent image URLs; never echo API keys

Parameters

Notes

• Default transparent background; pass --transparent false for opaque.
• Download links may expire; tell the user to save promptly.
• Never pass local paths to the API — the script uploads references.
• On missing env → surgepix-setup, do not collect secrets in chat.