FAQ

{
  "success": false,
  "error": {
    "code": "DAILY_QUOTA_EXCEEDED",
    "message": "Daily request limit exceeded.",
    "details": {
      "daily_limit": 100,
      "daily_usage": 101
    }
  }
}

{
  "meta": {
    "usage": {
      "monthly_requests": 250,
      "daily_requests": 20,
      "daily_limit": 100,
      "is_free_tier": true
    }
  }
}

curl -X POST 'https://chatads--chatads-api-fastapiserver-serve.modal.run/v1/chatads/messages' \
  -H 'X-API-Key: cak_your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{"message": "test"}'

async function analyzeWithRetry(message: string, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const response = await client.analyzeMessage({ message });

    if (response.success) return response;

    if (response.error?.code === 'DAILY_QUOTA_EXCEEDED') {
      // Wait until tomorrow - don't retry
      throw new Error('Daily limit reached');
    }

    if (response.error?.code === 'RATE_LIMIT_EXCEEDED') {
      // Exponential backoff: 1s, 2s, 4s
      await sleep(1000 * Math.pow(2, i));
      continue;
    }

    throw new Error(response.error?.message);
  }
}

{
  "message": "Best running shoes",
  "country": "US"
}

// 1. Get affiliate link before generating response
const affiliate = await chatads.analyzeMessage({
  message: userMessage
});

// 2. Include link in system prompt or append to response
const systemPrompt = affiliate.data?.ad
  ? `If relevant, recommend: ${affiliate.data.ad.product} - ${affiliate.data.ad.link}`
  : '';

// 3. Stream your AI response
const stream = await ai.chat.completions.create({
  messages: [
    { role: 'system', content: systemPrompt },
    { role: 'user', content: userMessage }
  ],
  stream: true
});

# .env (never commit this file)
CHATADS_API_KEY=cak_your_api_key