Logo

소셜 스튜디오

패션 이미지에 고도로 양식화된 창의적인 효과와 템플릿을 적용하여 소셜 미디어용으로 만듭니다.

소셜 스튜디오

소셜 스튜디오 엔드포인트는 패션 이미지에 고도로 양식화된 창의적인 미학 템플릿을 적용하여 소셜 미디어 마케팅에 완벽하게 적합한 시선을 사로잡는 콘텐츠로 변환합니다.

모델 이름: social-studio

수명 주기: stable

처리 시간: ~15s–30s

출력 형식: Auto (JPEG or PNG)

전달 방식: URL

크레딧: 생성당 2~5개 (품질에 따라 다름)

요청

이미지와 선택한 스타일 ID를 범용 /v1/run 엔드포인트로 제출하세요:

POSThttps://fititon.app/api/v1/run

요청 예시

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "social-studio",
           "inputs": {
             "personImage": "https://example.com/model-shot.jpg",
             "styleId": "action-figure",
             "quality": "2k",
             "sampleCount": 1
           }
         }'

응답

이미지 생성은 최대 30초가 소요될 수 있으므로, /v1/run 엔드포인트는 비동기 작업 id와 함께 즉시 201 Created 상태를 반환합니다. 최종 이미지를 검색하려면 이 id를 사용하여 상태 API를 폴링해야 합니다. 또는 웹훅을 구성하여 알림을 자동으로 받을 수 있습니다. 당사의 웹훅 디스패처는 엄격한 15초 타임아웃을 적용합니다. 서버는 15초 이내에 2xx 상태 코드로 웹훅을 승인해야 하며, 그렇지 않으면 실패로 간주되어 나중에 다시 시도됩니다.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2024-03-10T12:00:00Z",
  "model_name": "social-studio"
}

작업이 완료되면 (status: "success"), output 필드에는 결과 URL 배열이 포함됩니다:

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "success",
  "output": [
    "https://cdn.fititon.app/users/123/results/social-studio-123-0.png"
  ],
  "error": null,
  "created_at": "2024-03-10T12:00:00Z",
  "updated_at": "2024-03-10T12:00:20Z"
}

요청 매개변수

필수 매개변수

personImageRequiredstring

스타일링할 원본 이미지입니다. 공개적으로 접근 가능한 URL 또는 Base64로 인코딩된 이미지 문자열일 수 있습니다.

전문가 팁: 전체 인물이 보이는 전신 사진이 가장 좋은 스타일링 결과를 만듭니다. 명확한 얼굴 가시성이 중요합니다. AI는 얼굴 특징을 사용하여 스타일링된 버전을 만듭니다. 단체 사진이나 물체 뒤에 부분적으로 숨겨진 이미지는 피하세요.

형식 요구 사항 Base64 문자열을 제출할 때, 표준 데이터 URI 접두사(예: data:image/jpeg;base64,...)를 포함해야 합니다. personImage가 Base64 문자열을 허용하지만, 요청 시 전역 JSON 페이로드 크기 제한(HTTP 413)에 도달하는 것을 방지하기 위해 3MB보다 큰 이미지에는 표준 HTTP URL을 사용하는 것을 강력히 권장합니다.

styleIdRequiredstring

생성된 이미지에 적용할 사진 스타일 ID입니다. 이는 조명, 미학 및 분위기를 결정합니다.

사용 가능한 스타일:

Style NameStyle ID (`styleId`)

선택적 매개변수

quality'1k' | '2k' | '4k'

출력 해상도 등급. 기본값: 1k

sampleCountinteger

요청당 생성할 이미지 변형 수입니다. 1에서 4 사이여야 합니다. 기본값: 1

ratiostring

종횡비 재정의. 비어 있으면 시스템은 1:1 (인스타그램/소셜 피드에 이상적)을 기본값으로 사용합니다.

지원되는 값: '1:1', '3:4', '4:3', '9:16', '16:9', '2:3', '3:2', '4:5', '5:4', '21:9'.

런타임 오류

이 기능의 런타임 오류는 오류 처리에 문서화된 공유 세트를 사용합니다. 처리 중 오류가 발생하면 status가 "error"로 업데이트되고 error 필드에 특정 실패 이유가 포함됩니다.

크레딧 비용

개발자 API 요청의 경우, 비용은 선택한 출력 quality 등급에 sampleCount를 곱한 값에 따라 달라집니다.

공식: Cost = QualityCredits × sampleCount

품질 등급이미지당 크레딧
1k (기본값)2
2k3
4k5