로그인
Lookbook Studio

API로 맡기기

사진을 올리고, 맡기고, 끝나면 결과 파일을 받습니다.

API로 맡긴 일도 화면에서 맡긴 일처럼 프로젝트로 남고, 같은 잔액에서 빠집니다.

  1. 키 만들기

    로그인한 뒤 왼쪽 메뉴의 「API 키」에서 만듭니다. 키는 작업 공간마다 한 사람에 하나입니다.

    모든 요청은 Authorization: Bearer 머리글에 키를 담습니다. 아래 코드는 키와 주소를 이 두 줄에서 읽습니다.

    shell
    export FLOW_API_KEY="<api_key>"
    export FLOW_URL="https://flow.unblanq.com"
  2. 사진 올리기

    사진 한 장마다 한 번 부릅니다. slot은 main_item_reference_images이고, 답의 descriptor를 모아 둡니다.

    PNG·JPEG·WebP 형식을 한 건에 6장까지 받습니다. 올린 사진은 descriptor의 expires_at까지 보관됩니다.

    curl
    curl -X POST \
      "$FLOW_URL/v1/agencies/agency%3Afashion_atelier/actions/fashion_studio_create_product_cuts/uploads" \
      -H "Authorization: Bearer $FLOW_API_KEY" \
      -F "slot=main_item_reference_images" \
      -F "file=@<file>"
  3. 맡기기

    모아 둔 descriptor를 apparel.main_item_reference_images에 넣어 보냅니다. idempotency_key는 내가 정해 이 요청에 붙이는 번호입니다.

    답의 result.run_id로 상태를 보고, result.admission.target_id로 결과를 찾습니다.

    같은 idempotency_key와 같은 inputs로 24시간 안에 다시 보내면 새로 맡기지 않고, 처음 맡긴 일의 답을 다시 줍니다(deduplicated: true). inputs가 다르면 409로 거절합니다.

    curl
    curl -X POST \
      "$FLOW_URL/v1/agencies/agency%3Afashion_atelier/actions/fashion_studio_create_product_cuts/runs" \
      -H "Authorization: Bearer $FLOW_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "inputs": {
          "schema_version": "fashion_studio_create_product_cuts.input.v12",
          "generation_mode": "initial",
          "initial_source": {"mode": "uploads"},
          "product": {"title": "트랙 수트", "target_gender": "unisex"},
          "apparel": {
            "main_item_title": "트랙 수트",
            "main_item_reference_images": [<descriptor>, <descriptor>]
          },
          "model": {"selection_mode": "auto", "pose_mode": "auto"},
          "space": {"mode": "auto"},
          "outputs": {
            "model_editorial": {"enabled": true, "count": 4},
            "product_detail": {"enabled": true, "count": 4, "style": "styled_flat_lay"}
          }
        },
        "idempotency_key": "request-001"
      }'
  4. 상태 보기

    끝날 때까지 몇 초마다 부릅니다. status가 succeeded·failed·cancelled 가운데 하나가 되면 끝난 것입니다.

    failed면 public_errors에 까닭이 옵니다.

    curl
    curl "$FLOW_URL/v1/runs/<run_id>" \
      -H "Authorization: Bearer $FLOW_API_KEY"
  5. 결과 받기

    결과는 프로젝트로 남습니다. 먼저 목록에서 record_key가 target_id인 항목의 record_id를 찾습니다. 첫 쪽에 없으면 답의 next_cursor를 cursor에 넣어 다음 쪽을 봅니다.

    그 record_id로 읽으면 결과 파일 목록이 result.outputs로 옵니다. 받을 파일의 record_id와 revision_id를 고릅니다. target_id를 record_id 자리에 넣지 않습니다.

    내려받기에는 프로젝트의 record_id, 고른 파일의 record_id(output_record_id)와 revision_id를 넣습니다. 답의 result.download_url을 같은 키로 부르면 파일을 받습니다.

    curl
    # 1. 목록: record_key가 target_id인 항목의 record_id
    curl -X POST \
      "$FLOW_URL/v1/agencies/agency%3Afashion_atelier/actions/fashion_studio_list_products/runs" \
      -H "Authorization: Bearer $FLOW_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"inputs": {"relation": "owned", "limit": 50}}'
    
    # 2. 읽기: 결과 파일 목록은 result.outputs
    curl -X POST \
      "$FLOW_URL/v1/agencies/agency%3Afashion_atelier/actions/fashion_studio_read_product/runs" \
      -H "Authorization: Bearer $FLOW_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"inputs": {"record_id": "<record_id>"}}'
    
    # 3. 내려받기: 파일의 주소는 result.download_url
    curl -X POST \
      "$FLOW_URL/v1/agencies/agency%3Afashion_atelier/actions/fashion_studio_download_product_version/runs" \
      -H "Authorization: Bearer $FLOW_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "inputs": {
          "record_id": "<record_id>",
          "output_record_id": "<output_record_id>",
          "revision_id": "<revision_id>",
          "output_format": "png"
        }
      }'
    
    # 4. 파일 받기: $FLOW_URL 뒤에 download_url
    curl -L "$FLOW_URL<download_url>" \
      -H "Authorization: Bearer $FLOW_API_KEY" \
      -o <filename>

맡길 때 넣는 것fashion_studio_create_product_cuts

이름형식필수설명
apparel object 아니요 메인 아이템의 이름과 사진이며, 새 프로젝트에 꼭 넣습니다.
camera object 아니요 카메라 종류(camera_class)와 필름 스타일(film_profile)입니다. 보내지 않으면 dslr입니다.
composition_preferences object | null 아니요 비율(aspect_ratio), 초점(focus), 프레이밍(framing)을 고릅니다. 보내지 않으면 auto입니다.
design_text object 아니요 스토리 컷과 크리에이티브 컷에 들어갈 글자의 언어를 language_direction에 문장으로 적습니다.
environment_setting object 아니요 날씨(weather)와 시간대(time_of_day)입니다. 보내지 않으면 맑음, 늦은 오전~이른 오후입니다.
generation_mode enum: "initial", "additional" 예 새 프로젝트를 만들 때는 initial을 보냅니다.
initial_source object | null 아니요 프로젝트를 무엇에서 시작할지이며, 새 프로젝트에 꼭 넣습니다. 올린 사진에서 시작하면 {"mode": "uploads"}를 보냅니다.
model object 아니요 컷에 나올 모델과 포즈이며, 새 프로젝트에 꼭 넣습니다. auto면 내가 만들었거나 공유받은 모델(관리자는 관리하는 사람의 모델까지) 가운데 대상 성별에 맞는 모델을 고르고, 포즈도 자동으로 정합니다.
outputs object | null 아니요 해상도(resolution_tier)와 컷 종류별 장수입니다. 보내면 model_editorial·product_detail·story_card·creative 가운데 하나 이상을 enabled로 켭니다.
product object 예 상품 이름(title)과 대상 성별(target_gender: female·male·unisex)입니다.
round_request_id stringminLength: 1 · maxLength: 256 예 이 요청의 번호입니다.
schema_version const: "fashion_studio_create_product_cuts.input.v12" 예 입력 형식의 판입니다. 적힌 값을 그대로 보냅니다.
smart_retouch object 아니요 스마트 리터치입니다. on(기본)이면 모델 컷과 크리에이티브 컷을 컷마다 보정한 한 장으로 받습니다.
smart_retry object 아니요 스마트 재시도입니다. 켜면(enabled) 결과에 문제가 있는 컷을 다시 만들고, 그때마다 요금이 더해집니다.
space object 아니요 촬영 공간이며, 새 프로젝트에 꼭 넣습니다. auto면 자동으로 정합니다.

product.product_version_id, product.product_id와 round_request_id는 보내지 않아도 됩니다. Flow가 idempotency_key로 채웁니다.

Lookbook Studio

바로 맡기기