SaaS API가이드라인 Trial (데모)
트렌드 컨셉 Top 3 (V5)
사전 분석된 트렌드 릴스와 campaignData를 비교해 트렌드 컨셉 Top 3를 자동 선정합니다.
트렌드 컨셉 Top 3 자동 선정 (V5)
Python /report/guideline/v5/concepts 를 호출해 사전 분석된 Instagram 트렌드 릴스 중 캠페인에 적합한 트렌드 컨셉 Top 3를 자동 선정합니다. prepare 로 저장한 campaignData 가 campaign_data_override 로 전달되며, 카테고리는 campaignData.category 기준입니다(트렌드 미지원 카테고리는 GENERAL 폴백). 세션 status 가 CONCEPTS_GENERATED 로 전이됩니다.
캠페인이 없으므로 트렌드 추천 이력(guideline_trend_recommendations)은 저장하지 않습니다.
HTTP 요청
POST /ai/guideline/trial/v5/{trialId}/concepts
Content-Type: application/json인증 불필요 (permitAll).
Path Parameters
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
trialId | String | 예 | prepare 로 발급된 세션 UUID |
Request Body
{
"conceptText": "촉촉한 무드로 진정 효과 강조",
"fileUrls": ["https://{bucket}.s3.{region}.amazonaws.com/guideline/generation/trial/...guide.pdf"],
"referenceLinks": ["https://instagram.com/reel/..."],
"regenerationPrompt": "",
"regenerate": false
}| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
conceptText | String | 아니오 | 컨셉 자유 입력 |
fileUrls | Array<String> | 아니오 | 가이드라인 PDF 등 S3 URL (upload-url 로 업로드) |
referenceLinks | Array<String> | 아니오 | 참고 릴스 링크 |
regenerationPrompt | String | 아니오 | 재생성 시 반영할 지시문 |
regenerate | Boolean | 아니오 | true 면 기존 세션 컨셉을 previous_concepts 로 전달 |
응답
내부 식별자를 제거한 공개 형태로 축약해 반환합니다 (V5 본 API와 동일).
{
"status": 200,
"message": "트렌드 컨셉 생성 완료",
"data": {
"concepts": [
{
"name": "...",
"description": "...",
"one_liner": "...",
"trend_name": "...",
"why_selected": "...",
"application_points": ["..."],
"reference_reels": [
{ "source_url": "https://instagram.com/reel/...", "observed_pattern": "..." }
]
}
]
}
}세션에는 concepts(원본)·geminiFileIds·pdfMetadata·referenceMetadata 가 저장됩니다.