API를 사용하여 Twitter Card 이미지 생성하기
Twitter (X) 카드 이미지는 X에서 링크가 공유될 때 표시되는 큰 미리보기 이미지입니다. FastOG는 이를 1200×630 크기로 동적으로 생성하고 summary_large_image를 설정하므로, 수동으로 이미지를 생성하지 않아도 모든 페이지에 적절한 X 카드가 적용됩니다.
X 카드 이미지에 필요한 사항
X는 Open Graph 태그를 읽으며, 페이지가 twitter:card = summary_large_image 링크를 포함할 경우 summary_large_image 카드를 렌더링합니다. 이미지는 1200×630 크기로 렌더링됩니다. FastOG는 정확히 해당 크기의 이미지를 생성하며, twitter:image을 og:image와 동일한 동적 URL로 지정해야 합니다.
동적 트위터 카드 연결 방법
FastOG URL을 한 번 생성한 후, OG 메타 태그와 트위터 메타 태그 모두에 해당 URL을 설정하세요.
<meta property="og:image" content="https://fastog.com/api/v1/og?template=default&title=My+Post&key=sk_...&s=...">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="My Post">
<meta name="twitter:image" content="https://fastog.com/api/v1/og?template=default&title=My+Post&key=sk_...&s=...">
동일한 URL이 두 태그 모두에서 작동합니다. X(구 트위터)는
twitter:image이 없는 경우og:image으로 폴백하지만, 두 태그 모두에 설정해도 무방하며 명시적인 접근 방식입니다.
X 카드 검증기 팁
| 확인 항목 | 세부 내용 |
|---|---|
| 공개 URL | 이미지는 인증 없이 X에서 접근 가능해야 합니다 |
| 파일 크기 / 형식 | 5MB 미만으로 유지하세요. 텍스트 카드에는 PNG가 가장 적합합니다 |
| 캐시 | X는 캐시를 적극적으로 사용하므로, 카드 갱신을 강제하려면 카드 검증기를 사용하세요 |
| 서명된 URL | FastOG의 콘텐츠 서명된 URL은 첫 렌더링만 제한하며, 캐시된 카드는 유효성을 유지합니다 |
자주 묻는 질문
X와 Open Graph용 이미지를 별도로 준비해야 하나요?
아니요. X는 동일한 1200×630 크기의 이미지를 사용합니다. 이 페이지가 존재하는 이유는 올바른 twitter:card 태그를 설정하기가 생각보다 까다롭기 때문입니다.
제목을 변경했는데도 X 카드가 업데이트되지 않아요.
X는 이전 카드를 캐싱합니다. X Card Validator를 열어 URL을 붙여넣고 다시 스크래핑하세요.
FastOG가 twitter 메타 태그도 처리해 주나요?
FastOG는 이미지를 생성합니다. 페이지에 twitter:card 및 twitter:image 메타 태그를 직접 추가해야 합니다(위 예시 참조). 저희 무료 Open Graph Meta Tag Generator는 모든 태그를 자동으로 작성해 줍니다.