API

Manage server-to-server access for external systems (the Email Design Tool, and any future internal tools) that consume assets through this API.

API base URL

https://photobank.gaoyaya.com

Configured via NEXT_PUBLIC_API_URL (frontend) / PUBLIC_API_BASE_URL (backend). In production, set both to your deployed URL - this page never hardcodes localhost.

Endpoints

POSThttps://photobank.gaoyaya.com/api/v1/assets/recommend
GEThttps://photobank.gaoyaya.com/api/v1/assets/search

Auth header:X-API-Key: <API_KEY>

Integration example

POST https://photobank.gaoyaya.com/api/v1/assets/recommend
X-API-Key: <API_KEY>
Content-Type: application/json

{
  "prompt": "Romantic sage bridesmaid dresses for a spring garden wedding",
  "use_case": "email_generation",
  "limit": 12
}

Replace <API_KEY> with a real key generated below - never a value shown in documentation.

API keys

Each client gets its own key so it can be rotated or revoked independently.

No API keys yet. Create one to get started.