Skip to main content

​
Setting up AI specs

Before generating content, configure your brand’s AI specifications. This ensures all AI output matches your brand voice. Navigate to Brands > [Your Brand] > AI Specs in the dashboard, or use the API: 
curl -X PATCH ".../brands/{brandId}/ai-specs" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tone_of_voice": "Professional yet approachable. Use active voice.",
    "target_audience": "Fashion-conscious millennials, 25-40",
    "keywords_always": ["sustainable", "premium", "crafted"],
    "keywords_never": ["cheap", "basic", "generic"],
    "content_policies": "Never mention competitor brands. Always highlight sustainability.",
    "custom_instructions": "Include care instructions when describing fabrics."
  }'

​
Generating content

​
New product descriptions

curl -X POST "https://app.alana.shopping/api/ai/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brandId": "BRAND_ID",
    "type": "description",
    "context": {
      "productTitle": "Organic Linen Blazer",
      "category": "Apparel > Outerwear > Blazers",
      "attributes": {"material": "100% organic linen", "color": "Navy"}
    }
  }'

​
Enhancing existing content

curl -X POST "https://app.alana.shopping/api/ai/enhance" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brandId": "BRAND_ID",
    "text": "Navy blazer made from linen. Good for office.",
    "type": "description",
    "instructions": "Make it more compelling and add sustainability messaging"
  }'

​
Interactive chat (Canvas)

The Canvas AI chat provides a conversational interface for content operations: 
curl -X POST "https://app.alana.shopping/api/ai/chat" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brandId": "BRAND_ID",
    "messages": [
      {"role": "user", "content": "Write 3 title variations for our organic linen blazer"}
    ]
  }'

​
AI credit usage

AI operations consume credits based on your workspace plan. Monitor usage via the billing dashboard or API.
AI credits reset monthly. If you exceed your plan’s limit, AI operations will be rate-limited until the next billing cycle.