{"openapi":"3.1.0","info":{"title":"AI Recipe Banner Studio","version":"1.1.0","description":"굿프·올루올루·야화·메이저택스·동행의 검증된 배너 구성을 참고해 PC와 모바일 광고 이미지를 만들어요. 제작만 수행하며 광고 게재·발송·유료 AI 호출은 하지 않아요."},"servers":[{"url":"https://ai.vibers.co.kr"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"BannerInput":{"type":"object","additionalProperties":false,"required":["reference"],"properties":{"reference":{"type":"string","enum":["goodff","oluolu","yahwa","majortax","startcorp"],"description":"원하는 광고의 스타일. 먼저 listBannerTemplates로 공식 문구와 자산을 확인하세요."},"brandName":{"type":"string","description":"생략하면 참고 브랜드. 다른 이름을 넣으면 원본 로고·사진을 제외하고 새 이름만 표시해요.","maxLength":20},"headline":{"type":"array","minItems":1,"maxItems":2,"items":{"type":"string","minLength":1,"maxLength":20},"description":"핵심 문구를 전달해요. PC는 한 줄, 모바일은 두 줄에 맞춰 표시해요. 다른 브랜드 이름을 쓸 때 필수예요."},"eyebrow":{"type":"string","description":"상단 소개 문구","maxLength":32},"subline":{"type":"string","description":"보조 문구","maxLength":36},"cta":{"type":"string","description":"클릭 링크의 접근성 안내 문구. 다른 브랜드는 필수예요.","maxLength":18},"destinationUrl":{"type":"string","format":"uri","maxLength":500,"description":"실제 공개 HTTPS 서비스 주소. 다른 브랜드는 필수예요."},"accent":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$","description":"브랜드 강조 색상. 예: #E95422"}}},"Error":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}}},"Output":{"type":"object","properties":{"format":{"type":"string","enum":["pc","mobile"]},"width":{"type":"integer"},"height":{"type":"integer"},"htmlUrl":{"type":"string","format":"uri"},"pngUrl":{"type":"string","format":"uri"},"svgUrl":{"type":"string","format":"uri"},"downloadUrl":{"type":"string","format":"uri"}}}}},"paths":{"/api/v1/banners/templates":{"get":{"operationId":"listBannerTemplates","summary":"참고 광고 3종과 기본 문구를 확인해요.","security":[],"responses":{"200":{"description":"참고 광고 목록","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"templates":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"headline":{"type":"array","items":{"type":"string"}},"preview":{"type":"string"},"cta":{"type":"string"},"destinationUrl":{"type":"string"}}}}}}}}}}}},"/api/v1/banners/render":{"post":{"operationId":"createBannerKit","summary":"대화에서 정한 문구로 PC·모바일 배너를 제작해요.","description":"이미지 제작 권한이 있는 AI Recipe 토큰이 필요해요. 결과는 24시간 유효한 PNG·SVG·애니메이션 HTML 및 미리보기 링크예요. 참고 브랜드와 다른 이름을 지정하면 원본 로고·사진은 제외해요. 사용자 첨부 파일이나 임의 이미지 URL은 이 버전에서 받지 않아요.","x-openai-isConsequential":false,"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BannerInput"}}}},"responses":{"200":{"description":"제작 링크. 이미지는 openaiFileResponse가 아닌 pngUrl·previewUrl로 보여 주세요.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"status":{"type":"string"},"brandName":{"type":"string"},"expiresAt":{"type":"string","format":"date-time"},"previewUrl":{"type":"string","format":"uri"},"outputs":{"type":"array","items":{"$ref":"#/components/schemas/Output"}},"assetsMode":{"type":"string","enum":["reference-brand","text-only-custom-brand"]},"published":{"type":"boolean"},"notice":{"type":"string"}}}}}},"400":{"description":"요청·인증·한도·연결 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"요청·인증·한도·연결 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"요청·인증·한도·연결 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"요청·인증·한도·연결 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"요청·인증·한도·연결 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"요청·인증·한도·연결 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}