Couple Photo AI Guide

A complete guide to Couple Photo AI — the AI-powered platform for creating stunning couple photos, portraits, and romantic visuals in seconds.

What is Couple Photo AI?

Couple Photo AI is an AI-powered couple photo and portrait creation platform that lets you generate high-quality couple photos, romantic portraits, and memorable visuals from text descriptions or images. No photography experience required — just describe what you want and let AI do the work.

Tech Stack

AI Models: State-of-the-art generative AI for couple photo and image creation
Framework: Next.js App Router with TypeScript
Auth: Better Auth (GitHub + Google OAuth, email/password)
Database: PostgreSQL with Drizzle ORM
Payments: Stripe (subscriptions, one-time purchases, credit packages)
UI: Tailwind CSS + Radix UI + Lucide icons
i18n: next-intl (English + Chinese)
Email: Resend with React Email templates
Content: Fumadocs for documentation, MDX for blog

Quick Start

Prerequisites

Node.js 18+
pnpm (recommended)
PostgreSQL database

Installation

git clone https://github.com/zhangst23/couple-photo-ai.git
cd couple-photo-ai
pnpm install

Environment Setup

Copy the example environment file and fill in your values:

cp env.example .env.local

Key environment variables:

# Database
DATABASE_URL=postgresql://user:password@localhost:5432/couple-photo-ai

# Auth
BETTER_AUTH_SECRET=your-secret-key
GITHUB_CLIENT_ID=your-github-client-id
GITHUB_CLIENT_SECRET=your-github-client-secret
GOOGLE_CLIENT_ID=your-google-client-id
GOOGLE_CLIENT_SECRET=your-google-client-secret

# Stripe
STRIPE_SECRET_KEY=sk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...

# Email
RESEND_API_KEY=re_...

# AI (Kie API for image generation)
KIE_API_KEY=your-kie-api-key
NEXT_PUBLIC_KIE_MODEL=z-image

Database Setup

Generate and run migrations:

pnpm db:generate
pnpm db:migrate

Start Development

pnpm dev

Visit http://localhost:3000 to see your app.

Key Features

AI Couple Photo Generation

Generate couple photos from text or images:

Text to Image: Describe any couple photo scene in natural language
Image to Image: Upload reference photos to create styled couple portraits
Smart Scenes: Automatically set in romantic locations and settings
Style Presets: Generate photos that match your preferred aesthetic

Multi-format Export

Export your creations in any format:

PNG — High-quality with transparency support
JPG — Optimized for web and social media
WebP — Modern format with better compression

Use Cases

Couple photos for every occasion:

Romantic Portraits — Beautiful couple portraits for any occasion
Anniversary Memories — Celebrate your special moments
Social Media — Perfectly sized for Instagram, Facebook, and more
Wedding Photos — Dreamy wedding and engagement portraits
Travel Couples — Photos in stunning destinations
Gifts & Surprises — Personalized couple photo gifts

Credit System

Flexible usage-based billing:

Monthly credit refresh for subscribers
Registration bonus credits
Credit packages for additional generations
Usage tracking with transaction history

Supported Use Cases

Anniversaries — Beautiful anniversary photos to celebrate your journey
Engagements — Dreamy engagement photos capturing the magic
Social Media — Stunning couple photos for your profiles
Personalized Gifts — Unique photo gifts for your loved one
Long Distance — Virtual couple photos that bring you together
Just for Fun — Creative and fun couple photo ideas

API Integration

Couple Photo AI provides a REST API for programmatic photo generation:

# Generate a couple photo from text
POST /api/v1/generate
{
  "prompt": "A romantic couple walking on a sunset beach, cinematic style",
  "aspect_ratio": "1:1",
  "style": "romantic"
}

API keys can be managed from your dashboard under Settings → API Keys.

Common Tasks

Adding a New Page

Create a new file in src/app/[locale]/(marketing)/
Add the route to src/routes.ts
Add navigation links in src/config/navbar-config.tsx

Deploying to Production

pnpm build

The app is ready for deployment on Vercel, Docker, or any Node.js hosting platform.

Learn More

Configuration Guide — Customize the platform for your needs
API Reference — Explore available endpoints and actions