API로 맡기기
사진을 올리고, 맡기고, 끝나면 결과 파일을 받습니다.
API로 맡긴 일도 화면에서 맡긴 일처럼 프로젝트로 남고, 같은 잔액에서 빠집니다.
-
키 만들기
로그인한 뒤 왼쪽 메뉴의 「API 키」에서 만듭니다. 키는 작업 공간마다 한 사람에 하나입니다.
모든 요청은
Authorization: Bearer머리글에 키를 담습니다. 아래 코드는 키와 주소를 이 두 줄에서 읽습니다.export FLOW_API_KEY="<api_key>" export FLOW_URL="https://flow.unblanq.com" -
사진 올리기
사진 한 장마다 한 번 부릅니다.
slot은main_item_reference_images이고, 답의descriptor를 모아 둡니다.PNG·JPEG·WebP 형식을 한 건에 6장까지 받습니다. 올린 사진은
descriptor의expires_at까지 보관됩니다.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>" -
맡기기
모아 둔
descriptor를apparel.main_item_reference_images에 넣어 보냅니다.idempotency_key는 내가 정해 이 요청에 붙이는 번호입니다.답의
result.run_id로 상태를 보고,result.admission.target_id로 결과를 찾습니다.같은
idempotency_key와 같은inputs로 24시간 안에 다시 보내면 새로 맡기지 않고, 처음 맡긴 일의 답을 다시 줍니다(deduplicated: true).inputs가 다르면 409로 거절합니다.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" }' -
상태 보기
끝날 때까지 몇 초마다 부릅니다.
status가succeeded·failed·cancelled가운데 하나가 되면 끝난 것입니다.failed면public_errors에 까닭이 옵니다.curl "$FLOW_URL/v1/runs/<run_id>" \ -H "Authorization: Bearer $FLOW_API_KEY" -
결과 받기
결과는 프로젝트로 남습니다. 먼저 목록에서
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을 같은 키로 부르면 파일을 받습니다.# 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로 채웁니다.