뉴스카드 생성 API

curl -X POST https://algoajae.info/api/cards \
  -H "X-API-Key: $CARD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://n.news.naver.com/mnews/article/654/0000192269"}'

{
  "cardId": "7dc12ecf2080",
  "imageUrl": "https://algoajae.info/api/cards/7dc12ecf2080/image.png?v=0",
  "selected": 0,
  "line1": "레버리지 ETF 규제",
  "line2": "거래대금 30% 급감했다",
  "variants": [
    { "line1": "레버리지 ETF 규제", "line2": "거래대금 30% 급감했다", "angle": "숫자강조" },
    { "line1": "31일부터 예탁금 3배", "line2": "투자자들 발걸음 멈췄다", "angle": "반전" }
    // ... 총 10개
  ],
  "caption": "오는 31일부터 레버리지 ETF 규제가 강화됩니다.\n기본예탁금이...",
  "hashtags": ["레버리지ETF", "투자규제", "금융시장"],
  "hashtagText": "#레버리지ETF #투자규제 #금융시장",
  "source": { "adapter": "naver-news", "title": "...", "chars": 1265 },
  "cost": { "usd": 0.0583, "krw": 77 },
  "expiresAt": "2026-07-28T12:00:00.000Z"
}

X-API-Key: your-api-key-here

curl -X POST https://algoajae.info/api/cards \
  -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d '{"url": "https://...", "noAI": true}'   # 약 6초

curl -X POST https://algoajae.info/api/cards \
  -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d '{"url": "https://...", "async": true, "webhookUrl": "https://my-bot/hook"}'

{
  "jobId": "j_601a22b8cb71",
  "status": "queued",
  "statusUrl": "https://algoajae.info/api/cards/j_601a22b8cb71"
}

curl https://algoajae.info/api/cards/j_601a22b8cb71 -H "X-API-Key: $KEY"

# 진행 중
{ "jobId": "j_601a22b8cb71", "status": "running", "stage": "generating_image" }

curl -X POST https://algoajae.info/api/cards/7dc12ecf2080/variant \
  -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d '{"index": 4}'

# ① 카피만 — 6초, 17원
POST /api/cards
{ "url": "https://...", "noAI": true }

# ② 헤드라인이 마음에 들면 배경 추가 — 48초, +65원
POST /api/cards/<cardId>/background
{}                                  # AI로 생성
{ "imageUrl": "https://..." }        # 또는 내 이미지로
{ "imageBase64": "..." }             # 또는 직접 업로드
{ "prompt": "다른 장면 묘사" }         # 프롬프트를 바꿔 재생성

GET /api/cards/7dc12ecf2080/image.png       # 현재 선택된 헤드라인
GET /api/cards/7dc12ecf2080/image.png?v=4   # 4번 후보 버전

{ "text": "여기에 기사 본문 전체를 붙여넣기..." }

{
  "url": "https://...",
  "style": {
    "hw": 900, "hmax": 76, "lh": 1.25, "tr": -0.03,
    "pad": 72, "bottom": 168, "badgeTop": 178,
    "grad": 0.52, "topgrad": 0.22,
    "shadow": 14, "align": "center",
    "sub": "자세한 내용은 본문 참고",
    "badge": "이해를 돕기 위한 AI 이미지"
  }
}

{ "copyPrompt": "20대 여성 독자 대상, 친근한 반말체. 헤드라인은 질문형 위주로." }

{ "imageStyle": "always Korean people in their 20s-30s, warm color grading, subtle film grain" }

{ "error": "인스타그램은 Apify 토큰이 필요합니다.", "needsApify": true }

const API = 'https://algoajae.info';
const KEY = process.env.CARD_API_KEY;

// 1) 링크 수신 → 카드 생성
async function onLink(chatId, url) {
  await tg('sendMessage', { chat_id: chatId, text: '카드 만드는 중… (약 1분)' });

  const r = await fetch(`${API}/api/cards`, {
    method: 'POST',
    headers: { 'X-API-Key': KEY, 'Content-Type': 'application/json' },
    body: JSON.stringify({ url }),
  });
  const card = await r.json();
  if (!r.ok) return tg('sendMessage', { chat_id: chatId, text: '실패: ' + card.error });

  // 2) 이미지 + 캡션 전송 (imageUrl을 그대로 넘기면 됨)
  await tg('sendPhoto', {
    chat_id: chatId,
    photo: card.imageUrl,
    caption: `${card.caption}\n\n${card.hashtagText}\n\n비용 ${card.cost.krw}원`,
  });

  // 3) 헤드라인 후보를 버튼으로
  await tg('sendMessage', {
    chat_id: chatId,
    text: '다른 헤드라인으로 바꿀까요? (무료)',
    reply_markup: {
      inline_keyboard: card.variants.map((v, i) => [{
        text: `${v.line1} / ${v.line2}`,
        callback_data: `v:${card.cardId}:${i}`,
      }]),
    },
  });
}

// 4) 버튼 클릭 → 해당 후보로 교체 (추가 비용 없음)
async function onPick(chatId, cardId, index) {
  const r = await fetch(`${API}/api/cards/${cardId}/variant`, {
    method: 'POST',
    headers: { 'X-API-Key': KEY, 'Content-Type': 'application/json' },
    body: JSON.stringify({ index: Number(index) }),
  });
  const card = await r.json();
  await tg('sendPhoto', { chat_id: chatId, photo: card.imageUrl });
}

function tg(method, body) {
  return fetch(`https://api.telegram.org/bot${process.env.TG_TOKEN}/${method}`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(body),
  }).then(r => r.json());
}

await fetch(`${API}/api/cards`, {
  method: 'POST',
  headers: { 'X-API-Key': KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    url,
    async: true,
    webhookUrl: `https://my-bot.example.com/card-done?chat=${chatId}`,
  }),
});
// → 즉시 202. 완료되면 webhookUrl로 카드 정보가 POST됨

{ "url": "https://...", "noAI": true, "imageUrl": "https://my-cdn/photo.jpg" }
// 약 6초, 13원