API 레퍼런스카드뉴스
카드뉴스 생성
주제, 본문 또는 링크를 보내면 Posteady가 여러 장의 카드뉴스를 쓰고 디자인합니다.
curl -X POST "https://example.com/api/v1/carousels" \ -H "Content-Type: application/json" \ -d '{ "requestId": "77777777-7777-4777-8777-777777777777", "topic": "Five mistakes first-time cafe owners make in their opening month", "slideCount": 7, "language": "en" }'{ "carouselId": "cccccccc-cccc-4ccc-8ccc-cccccccccccc", "status": "completed", "editorUrl": "https://www.posteady.com/carousel/cccccccc-cccc-4ccc-8ccc-cccccccccccc", "title": "Five mistakes first-time cafe owners make", "caption": "Opening a cafe? Avoid these five mistakes in your first month.", "aspectRatio": "4:5", "slideCount": 7, "images": [ { "mediaId": "dddddddd-dddd-4ddd-8ddd-dddddddddddd", "url": "https://media.posteady.com/media/example/slide-01.jpg", "width": 1080, "height": 1350 } ]}카드뉴스 생성 요청을 접수합니다. Posteady가 주제, 본문 또는 링크로 장마다 문구를 쓰고 디자인한 뒤, 각 장을 JPEG 이미지로 렌더해 워크스페이스 미디어 라이브러리에 저장합니다. 생성 한 번의 비용은 옵션 엔드포인트가 알려 주는 크레딧이며, imageMode가 ai이면 생성한 이미지마다 추가로 차감됩니다. 이 요청은 작업을 대기열에 넣고 carouselId와 함께 202를 반환합니다. 생성에는 보통 1~3분이 걸립니다. status가 completed 또는 failed가 될 때까지 카드뉴스 조회 엔드포인트를 확인하세요. 생성이 실패하면 생성 크레딧은 환불됩니다. 호출자가 고칠 수 있는 문제(잘못된 입력, 요금제, 크레딧, 없는 템플릿이나 브랜드)는 실패한 카드뉴스가 되지 않고 즉시 오류로 반환됩니다.
인증
apiKey 인증Bearer <token>
위치: header
요청 본문
application/json
TypeScript 타입
TypeScript에서 request body 타입을 사용하세요.
topic, text, url 중 하나만 내용의 출처로 지정하세요. templateId를 지정하면 템플릿의 디자인을 유지한 채 새 문구를 쓰고, 지정하지 않으면 Posteady가 카드뉴스를 디자인합니다.
응답 본문
application/json
application/json
application/json
application/json
application/json