Posteady
Posteady Docs
가이드API 레퍼런스MCP
API 레퍼런스카드뉴스

카드뉴스 옵션 조회

카드뉴스를 만들 때 고를 수 있는 템플릿과 브랜드를 확인합니다.

GET
/api/v1/carousels/options
curl -X GET "https://example.com/api/v1/carousels/options?templateSource=posteady&cursor=eyJjcmVhdGVkQXQiOiIyMDI2LTEwLTAxVDAwOjAwOjAwWiJ9"
{  "generationCredits": 20,  "brands": [    {      "brandId": "99999999-9999-4999-8999-999999999999",      "name": "Your brand",      "hasLogo": true    }  ],  "templates": [    {      "templateId": "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb",      "name": "Minimal photo essay",      "aspectRatio": "4:5",      "slideCount": 8,      "language": "en",      "previewUrl": "https://media.posteady.com/media/example/template-01.jpg"    }  ],  "nextTemplateCursor": null}

API 키의 워크스페이스에서 카드뉴스 요청에 쓸 수 있는 항목을 반환합니다. 브랜드는 이름과 로고가 장에 들어가고, 템플릿은 디자인을 고정한 채 Posteady가 새 문구를 씁니다. 생성 한 번의 크레딧 비용도 함께 반환합니다.

인증

apiKey
인증Bearer <token>

위치: header

쿼리 매개변수

templateSource?string

posteady(기본값)는 Posteady가 제공하는 템플릿을, workspace는 이 워크스페이스에 저장한 템플릿을 조회합니다.

허용값

  • "posteady"
  • "workspace"
cursor?string

이전 응답의 nextTemplateCursor입니다.

응답 본문

application/json

application/json