본문으로 건너뛰기
버전: 1.5.x

프로젝트 생성 후 내보내기

프로젝트 내보내기는 JSON 형식으로 API 요청을 전송하여 새로운 이미지를 합성하는 방법을 다룹니다.


1. API endpoint​

https://app.aistudios.com/api/odin/v3/editor/project

2. Request parameter​

keydesctyperequireddefault
name프로젝트 이름StringfalseDefault Template
orientation프로젝트 형태
(landscape | portrait)		Stringfalselandscape
scenes각 장면별 정보Array(json)true-
scenes[].sceneIdx해당 장면의 순번Inttrue-
scenes[].scripts발화할 대사 데이터 리스트
(* 추후, 기능의 확장성을 위해 배열로 되어 있지만 대사 데이터는 하나만 입력해야 합니다.)		Jsontrue-
scenes[].scripts[].org발화할 대사 텍스트
<p />, <span /> 태그 등을 허용하지만 plain text만 입력하는 것을 권장합니다.		Stringtrue-
scenes[].scripts[].isTTS아바타의 목소리를 그대로 사용할 것인지, TTS로 합성된 목소리를 사용할 것인지 여부
아바타의 목소리를 사용할 경우 false, 다른 목소리를 사용할 경우 true		Booleantrue-
scenes[].scripts[].tts아바타의 목소리가 아닌 TTS로 합성된 목소리를 사용하는 경우, 해당 목소리의 데이터
아바타의 목소리를 사용할 경우 null, 다른 목소리를 사용할 경우 Json		Jsonnulltrue
scenes[].scripts[].modelId아바타의 모델 아이디Stringtrue-
scenes[].scripts[].clothId아바타의 복장 아이디Stringtrue-
scenes[].background장면별 배경화면 정보Jsontrue-
scenes[].clips모델, 텍스트, 이미지 등 추가할 클립들의 정보Array(json)true-
scenes[].clips[].scaleX클립의 크기 배율을 나타냅니다. 높이와 너비 입력을 기준으로 각각 x와 y의 크기 배율을 나타냅니다.Floatfalse1
scenes[].clips[].scaleY클립의 크기 배율을 나타냅니다. 높이와 너비 입력을 기준으로 각각 x와 y의 크기 배율을 나타냅니다.Floatfalse1
scenes[].clips[].height클립의 높이를 나타냅니다.Floattrue-
scenes[].clips[].width클립의 너비를 나타냅니다.Floattrue-
scenes[].clips[].left장면의 좌측을 기준으로 클립의 위치를 나타냅니다.Floattrue-
scenes[].clips[].top장면의 상단을 기준으로 클립의 위치를 나타냅니다.Floattrue-
scenes[].clips[].layer클립들의 정렬 순서 (번호가 높을수록 상단에 노출)Inttrue-
scenes[].clips[].id클립의 IdStringtrue-
scenes[].clips[].type추가할 클립의 종류
(aiModel | shape | image | textImage | videoImage | audio)		Stringtrue-
isExport이 프로젝트 내보내질지 여부
(false 일경우 프로젝트 대시보드에 노출)		Booleanfalsetrue
workspaceId작업공간 고유식별자 IDStringfalse-
resolution비디오 품질
(4k | 1080 | 720 | 480)		Stringfalse1080
webhookUrl합성 결과를 보내줄 주소Stringfalse-

scenes[].scripts[] 데이터 포맷

scenes[].scripts[]에는 발화할 대사(org) 이외에 몇가지 추가 정보를 필수로 지정해야 합니다. 잘못 지정된 경우 기능이 정상적으로 동작하지 않을 수 있습니다.

isTTS, tts
아바타의 목소리를 그대로 사용할 것인지, 아바타의 목소리가 아닌 TTS로 합성된 목소리를 사용할 것인지를 나타냅니다.
아바타의 목소리를 그대로 사용하는 경우 isTTS를 false, tts를 null로 지정합니다.
TTS로 합성된 목소리를 사용하는 경우 isTTS를 true, tts를 해당 TTS의 데이터로 지정합니다.
사용 가능한 TTS의 종류와 상테 데이터 포맷 등은 문의를 통한 확인이 필요합니다.

modelId, clothId
아바타의 모델 아이디와 복장 아이디를 나타냅니다.
이 값은 필수로 지정되어야 하고 해당 씬의 아바타 클립과 동일한 값이 지정되어야 합니다.
지정되지 않거나 아바타 클립과 다르게 지정된 경우 기능이 정상적으로 동작하지 않을 수 있습니다.

-아바타 클립의 프로퍼티스크립트의 프로퍼티
모델 아이디model.ai_namemodelId
복장 아이디model.emotionclothId

3. Response parameters​

keydesctype
projectId합성 요청된 프로젝트의 IDString

4. Sample Request​

curl https://app.aistudios.com/api/odin/v3/editor/project  \
-H "Authorization: ${API KEY}" \
-H "Content-Type: application/json" \
-X POST \
-d '{
      "scenes": [{
        "background": {
          "id": "background",
          "type": "background",
          "source_type": "image",
          "source_url": "/images/background/bg_blue_gradient.png",
          "source_color": "rgb(54,188,37)"
        },
        "watermark": false,
        "scripts": [
          {
            "org": "<p>Hello, this is test video.</p>",
            "isTTS": false,
            "tts": null,
            "modelId": "M000045058",
            "clothId": "BG00002320"
          }
        ],
        "clips": [
          {
            "id": "aiModel-1h4ij5h8e87",
            "type": "aiModel",
            "layer": 1,
            "top": 146.74129135713008,
            "left": 630.2493927359487,
            "effects": [
              {
                "type": "head-only"
              }
            ],
            "height": 2229,
            "width": 679,
            "model": {
              "ai_name": "M000045058",
              "emotion": "BG00002320",
              "language": "en",
              "source_url": "https://cdn.aistudios.com/ai/ai_mov_thm/tight_ai_mov_thm_M000045058_BG00002320.png",
              "editor": {
                "headCenterX": 613.3333333333334,
                "headCenterY": 290,
                "headWidth": 182,
                "headHeight": 185,
                "modelTightX": 367.33333333333337,
                "modelTightY": 168.16666666666669,
                "modelTightS": 1,
                "modelTightW": 679,
                "modelTightH": 2229,
                "modelOriginW": 1374,
                "modelOriginH": 2444,
                "scale": 0.3,
                "adjustX": -0.016860747210092203,
                "adjustY": -0.024822695035461,
                "spaceB": 46.833333333333314,
                "spaceT": 168.16666666666669,
                "spaceL": 367.33333333333337,
                "spaceR": 327.66666666666663,
                "top": 168.16666666666669,
                "left": 367.33333333333337,
                "height": 2229,
                "width": 679
              },
              "origin": {
                "height": 2444,
                "width": 1374
              },
              "deployImage": {
                "themb_src": "https://cdn.aistudios.com/ai/model-introduce/thumbnails/M000045058_BG00002320.png",
                "themb_width": 384,
                "themb_height": 240,
                "org_src": "https://cdn.aistudios.com/ai/ai_mov_thm/tight_ai_mov_thm_M000045058_BG00002320_org.png",
                "org_width": 1374,
                "org_height": 2444,
                "edit_src": "https://cdn.aistudios.com/ai/ai_mov_thm/tight_ai_mov_thm_M000045058_BG00002320.png",
                "edit_width": 692,
                "edit_height": 2277
              },
              "deploySize": {
                "org_width": 1374,
                "org_height": 2444,
                "edit_width": 679,
                "edit_height": 2229
              },
              "editorValue": {
                "headCenterX": 613.3333333333334,
                "headCenterY": 290,
                "headWidth": 182,
                "headHeight": 185,
                "modelTightX": 367.33333333333337,
                "modelTightY": 168.16666666666669,
                "modelTightS": 1,
                "modelTightW": 679,
                "modelTightH": 2229,
                "modelOriginW": 1374,
                "modelOriginH": 2444,
                "scale": 0.3,
                "adjustX": -0.016860747210092203,
                "adjustY": -0.024822695035461,
                "spaceB": 46.833333333333314,
                "spaceT": 168.16666666666669,
                "spaceL": 367.33333333333337,
                "spaceR": 327.66666666666663
              },
              "maskFile": "M000045058_BG00002320H_alpha_INV.mp4"
            },
            "name": "aiModel-1h4ij5h8e87",
            "lockScalingFlip": true,
            "fill": "rgb(0,0,0)",
            "scaleX": 1,
            "scaleY": 1,
            "opacity": 100,
            "lockMovementX": false,
            "lockMovementY": false,
            "lockRotation": false,
            "lockScalingX": false,
            "lockScalingY": false,
            "lockSkewingX": false,
            "lockSkewingY": false,
            "lockUniScaling": false,
            "headOnly": null,
            "voiceOnly": false,
            "isDelete": false
          },
        ],
        "thumbnailUrl": null,
        "sceneIdx": 0
      }],
      "webhookUrl": ${webhook_delivery_address}
    }'