curl -X POST https://api.vibepeak.ai/v1/families/3fa85f64-5717-4562-b3fc-2c963f66afa6/members \
  -H "Authorization: Bearer vpk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 7d9f3e2b-4c5d-4e6f-a0b1-2c3d4e5f6a7b" \
  -d '{
    "role": "son",
    "type": "child",
    "age": "5-7",
    "ethnicity": "hispanic",
    "physical": "short dark hair, bright smile",
    "clothing": "casual t-shirt and shorts"
  }'

const response = await fetch('https://api.vibepeak.ai/v1/families/3fa85f64-5717-4562-b3fc-2c963f66afa6/members', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer vpk_live_xxxxx',
    'Content-Type': 'application/json',
    'Idempotency-Key': crypto.randomUUID()
  },
  body: JSON.stringify({
    role: 'son',
    type: 'child',
    age: '5-7',
    ethnicity: 'hispanic',
    physical: 'short dark hair, bright smile',
    clothing: 'casual t-shirt and shorts'
  })
});

const result = await response.json();
console.log(`Adding member, task: ${result.task_id}`);

import requests
import uuid

response = requests.post(
    'https://api.vibepeak.ai/v1/families/3fa85f64-5717-4562-b3fc-2c963f66afa6/members',
    headers={
        'Authorization': 'Bearer vpk_live_xxxxx',
        'Content-Type': 'application/json',
        'Idempotency-Key': str(uuid.uuid4())
    },
    json={
        'role': 'son',
        'type': 'child',
        'age': '5-7',
        'ethnicity': 'hispanic',
        'physical': 'short dark hair, bright smile',
        'clothing': 'casual t-shirt and shorts'
    }
)

result = response.json()
print(f"Adding member, task: {result['task_id']}")

{
  "family_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "task_id": "task_fam456add",
  "status": "generating",
  "livemode": true,
  "_links": {
    "self": "/v1/families/3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "task": "/v1/tasks/task_fam456add"
  }
}

{
  "error": {
    "code": "PLAN_NOT_ALLOWED",
    "message": "Families are available on the Pro, Max and Enterprise plans. Upgrade your plan to use this feature.",
    "request_id": "req_xyz123"
  }
}

{
  "error": {
    "code": "FAMILY_NOT_FOUND",
    "message": "Family not found or not accessible with this API key.",
    "request_id": "req_xyz123"
  }
}

{
  "error": {
    "code": "FAMILY_NOT_READY",
    "message": "Another generation is already in progress for this family. Poll the task until it finishes, then retry.",
    "request_id": "req_xyz123"
  }
}

{
  "error": {
    "code": "FAMILY_MEMBER_LIMIT_EXCEEDED",
    "message": "A family must have between 1 and 6 members.",
    "request_id": "req_xyz123"
  }
}