Gemini_Draw/README.md

Run and deploy your AI Studio app

This contains everything you need to run your app locally.

View your app in AI Studio: https://ai.studio/apps/96002e3b-5eec-4566-85e8-718714e15c2c

Run Locally

Prerequisites: Node.js

1. Install dependencies: npm install
2. Set the GEMINI_API_KEY in .env.local to your Gemini API key
3. Run the app: npm run dev

Run the API server

The UI runs on port 3000. The HTTP API runs separately on port 3002.

1. Set GEMINI_API_KEY in .env.local or your shell.
2. Start the API: npm run api
3. Check the API: http://localhost:3002/api/health

You can change the server API key without restarting:

curl -X POST http://localhost:3002/api/config/api-key \
  -H "Content-Type: application/json" \
  -d "{\"apiKey\":\"YOUR_GEMINI_API_KEY\",\"persist\":true}"

You can also pass a temporary Gemini key for one call:

curl -X POST http://localhost:3002/api/generate \
  -H "Content-Type: application/json" \
  -H "x-gemini-api-key: YOUR_GEMINI_API_KEY" \
  -d "{\"prompt\":\"Create a clean product poster\"}"

API examples

Generate or edit with JSON/base64:

curl -X POST http://localhost:3002/api/generate \
  -H "Content-Type: application/json" \
  -d "{\"prompt\":\"Create a clean product poster for a white coffee mug\",\"imageSize\":\"1K\",\"aspectRatio\":\"1:1\"}"

Upload an image or document with a prompt:

curl -X POST http://localhost:3002/api/generate/upload \
  -F "prompt=Change the background to a bright studio scene" \
  -F "imageSize=1K" \
  -F "aspectRatio=1:1" \
  -F "files=@input.png"

Analyze a document:

curl -X POST http://localhost:3002/api/analyze-document \
  -F "prompt=Summarize this document in Chinese" \
  -F "files=@report.pdf"

Optional API auth: set API_AUTH_TOKEN, then send either Authorization: Bearer <token> or x-api-key: <token>.

For Agent-facing image editing instructions, see API图片修改-Agent.md.