{"items":[{"type":"link","label":"單位系統","link":"/zh-tw/reference/unit_system","routeSlug":"/zh-tw/reference/unit_system","content":{"contentType":"overview","meta":{"name":"單位系統"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"unit_system.json","url":"/_bundle/@l10n/zh-TW/reference/unit_system.json?download"},{"kind":"download","label":"unit_system.yaml","url":"/_bundle/@l10n/zh-TW/reference/unit_system.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[{"kind":"email","title":"E-mail","titleTranslationKey":"info.contact.name","email":"YouCamOnlineEditor_API@perfectcorp.com","label":"YouCamOnlineEditor_API@perfectcorp.com","withCopyButton":true,"copyContent":"YouCamOnlineEditor_API@perfectcorp.com"},{"kind":"externallink","title":"License","titleTranslationKey":"info.license","label":"Privacy policy","url":"https://www.makeupar.com/perfectbeauty/youcam/privacy-policy-api"},{"kind":"externallink","label":"Terms of Service","labelTranslationKey":"info.termsOfService","url":"https://www.makeupar.com/perfectbeauty/youcam/terms-of-service-api"}]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"curl","title":"curl","lang":"curl"},{"key":"javascript","title":"JavaScript","lang":"JavaScript"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"python","title":"Python","lang":"Python"},{"key":"java","title":"Java","lang":"Java"},{"key":"csharp","title":"C#","lang":"C#"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"go","title":"Go","lang":"Go"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"r","title":"R","lang":"R"},{"key":"payload","title":"Payload","lang":"Payload"}]}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"https://yce-api-01.makeupar.com"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"單位系統","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"查詢您的點數明細與使用紀錄。請注意，Units 是 YouCam API 運作所用的計費單位；不同的 AI 功能會扣除不同數量的點數。在本文件中，Unit 的代號為「Credit」。"},"children":[],"type":"text"}],"type":"paragraph"}]}],"sectionId":"/"}],"sectionId":"/"}]}]}},{"label":"取得點數資訊","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh-tw/reference/unit_system/paths/~1s2s~1v1.0~1client~1credit/get","routeSlug":"/zh-tw/reference/unit_system/paths/~1s2s~1v1.0~1client~1credit/get","metadata":{"seo":{"title":"取得點數資訊","description":"以小數第二位顯示可用的 API 點數"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"name":"取得點數資訊","isWebhook":false,"pointer":"/paths/~1s2s~1v1.0~1client~1credit/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"取得點數資訊","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"以小數第二位顯示可用的 API 點數"},"children":[],"type":"text"}],"type":"paragraph"}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuthentication","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"使用從認證取得的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"access_token"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，並放入標頭："},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"Authorization:Bearer <access_token>"},"children":[],"type":"code"}],"type":"paragraph"}]}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/s2s/v1.0/client/credit","servers":[{"url":"https://yce-api-01.makeupar.com"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuthentication","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","401"],"pointer":"/s2s/v1.0/client/credit","href":"paths/~1s2s~1v1.0~1client~1credit/get","summary":"取得點數資訊"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://yce-api-01.makeupar.com"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"成功取得點數資訊"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_0"}},"schemaId":"schema_0"},{"code":"401","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"認證失敗，或使用者沒有必要的權限"},"children":[],"type":"text"}],"type":"paragraph"}]}],"pointer":"/paths/~1s2s~1v1.0~1client~1credit/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_0","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_0"}}},{"code":"401"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/paths/~1s2s~1v1.0~1client~1credit/get"}],"panels":[]}]},"httpPath":"/s2s/v1.0/client/credit"},{"label":"檢視點數紀錄","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh-tw/reference/unit_system/paths/~1s2s~1v1.0~1client~1credit~1history/get","routeSlug":"/zh-tw/reference/unit_system/paths/~1s2s~1v1.0~1client~1credit~1history/get","metadata":{"seo":{"title":"檢視點數紀錄","description":"檢視點數紀錄"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"name":"檢視點數紀錄","isWebhook":false,"pointer":"/paths/~1s2s~1v1.0~1client~1credit~1history/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"檢視點數紀錄","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuthentication","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"使用從認證取得的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"access_token"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，並放入標頭："},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"Authorization:Bearer <access_token>"},"children":[],"type":"code"}],"type":"paragraph"}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"page_size","in":"query","schemaId":"schema_1","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"每一頁要回傳的結果數量。有效值應介於 1 到 30 之間。預設為 20。"},"children":[],"type":"text"}],"type":"paragraph"}]},{"name":"starting_token","in":"query","schemaId":"schema_2","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"目前頁面的令牌。第一頁以 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"null"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 開始，並使用上一個回應中的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"next_token"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 開始下一頁"},"children":[],"type":"text"}],"type":"paragraph"}]}],"pointer":"/paths/~1s2s~1v1.0~1client~1credit~1history/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/s2s/v1.0/client/credit/history","servers":[{"url":"https://yce-api-01.makeupar.com"}],"parameters":{"path":[],"query":[{"name":"page_size","in":"query","example":20,"schemaId":"schema_1"},{"name":"starting_token","in":"query","example":"73a3c9e69b89","schemaId":"schema_2"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuthentication","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","400","401"],"pointer":"/s2s/v1.0/client/credit/history","href":"paths/~1s2s~1v1.0~1client~1credit~1history/get","summary":"檢視點數紀錄"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://yce-api-01.makeupar.com"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"成功取得點數使用紀錄"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_3"}},"schemaId":"schema_3"},{"code":"400","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"請求參數無效"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_4"}},"schemaId":"schema_4"},{"code":"401","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"Access token 無效"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_5"}},"schemaId":"schema_5"}],"pointer":"/paths/~1s2s~1v1.0~1client~1credit~1history/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_3","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_3"}}},{"code":"400","schemaId":"schema_4","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_4"}}},{"code":"401","schemaId":"schema_5","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_5"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/paths/~1s2s~1v1.0~1client~1credit~1history/get"}],"panels":[]}]},"httpPath":"/s2s/v1.0/client/credit/history"},{"label":"取得功能費用","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh-tw/reference/unit_system/paths/~1s2s~1v2.0~1credit~1feature-cost/get","routeSlug":"/zh-tw/reference/unit_system/paths/~1s2s~1v2.0~1credit~1feature-cost/get","metadata":{"seo":{"title":"取得功能費用","description":"查詢每個 API 的點數消耗。這些數值與 https://yce.perfectcorp.com/ai-api/api-pricing 列出的內容一致。"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"name":"取得功能費用","isWebhook":false,"pointer":"/paths/~1s2s~1v2.0~1credit~1feature-cost/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"取得功能費用","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"查詢每個 API 的點數消耗。這些數值與 https://yce.perfectcorp.com/ai-api/api-pricing 列出的內容一致。"},"children":[],"type":"text"}],"type":"paragraph"}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuthenticationV2","scopes":[],"type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"使用標準的 'Bearer authentication'。請在標頭中放入您的 'API Key'："},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"Authorization:Bearer YOUR_API_KEY"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。請注意 'Bearer' 與 'YOUR_API_KEY' 之間有一個空格。"},"children":[],"type":"text"}],"type":"paragraph"}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"page_size","in":"query","schemaId":"schema_6","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"每一頁要回傳的結果數量。預設為 20。值範圍：[1 - 20]"},"children":[],"type":"text"}],"type":"paragraph"}]},{"name":"starting_token","in":"query","schemaId":"schema_7","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"目前頁面的令牌。第一頁以 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"null"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 開始，並使用上一個回應中的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"next_token"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 開始下一頁"},"children":[],"type":"text"}],"type":"paragraph"}]}],"pointer":"/paths/~1s2s~1v2.0~1credit~1feature-cost/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/s2s/v2.0/credit/feature-cost","servers":[{"url":"https://yce-api-01.makeupar.com"}],"parameters":{"path":[],"query":[{"name":"page_size","in":"query","example":20,"schemaId":"schema_6"},{"name":"starting_token","in":"query","example":"MjA","schemaId":"schema_7"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuthenticationV2","type":"http","scheme":"bearer"}],"scopes":[]}],"responseCodes":["200","400","401"],"pointer":"/s2s/v2.0/credit/feature-cost","href":"paths/~1s2s~1v2.0~1credit~1feature-cost/get","summary":"取得功能費用"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://yce-api-01.makeupar.com"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"成功取得各 sku 的功能費用"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_8","exampleIds":["paths/~1s2s~1v2.0~1credit~1feature-cost/get/responses/200/content/application~1json/example"]}},"schemaId":"schema_8","exampleIds":["paths/~1s2s~1v2.0~1credit~1feature-cost/get/responses/200/content/application~1json/example"]},{"code":"400","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"請求參數無效"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_4"}},"schemaId":"schema_4"},{"code":"401","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"API 金鑰無效或缺失"},"children":[],"type":"text"}],"type":"paragraph"}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_9"}},"schemaId":"schema_9"}],"pointer":"/paths/~1s2s~1v2.0~1credit~1feature-cost/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"schema_8","exampleIds":["paths/~1s2s~1v2.0~1credit~1feature-cost/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_8","exampleIds":["paths/~1s2s~1v2.0~1credit~1feature-cost/get/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"schema_4","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_4"}}},{"code":"401","schemaId":"schema_9","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_9"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/paths/~1s2s~1v2.0~1credit~1feature-cost/get"}],"panels":[]}]},"httpPath":"/s2s/v2.0/credit/feature-cost"}],"store":{"schemaStore":{"schema_0":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"type":"integer","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"回應狀態"},"children":[],"type":"text"}],"type":"paragraph"}],"example":200},"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"這個點數的唯一識別碼"},"children":[],"type":"text"}],"type":"paragraph"}],"example":13105541279084536},"type":{"type":"string","enum":["ApiSubsToken","ApiPaygToken"],"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"這個點數的類型"},"children":[],"type":"text"}],"type":"paragraph"}]},"amount":{"deprecated":true,"type":"integer","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"此參數已棄用。請改用 amount_dec。目前的點數餘額。"},"children":[],"type":"text"}],"type":"paragraph"}],"example":10},"amount_dec":{"type":"number","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"以小數第二位顯示的剩餘點數。"},"children":[],"type":"text"}],"type":"paragraph"}],"example":10.04},"expiry":{"type":"integer","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"這個點數到期日的 Unix 時間戳（毫秒）"},"children":[],"type":"text"}],"type":"paragraph"}],"example":1704789135000}}}}}},"id":"schema_0"},"schema_1":{"kind":"json-schema","data":{"type":"integer","example":20},"id":"schema_1"},"schema_2":{"kind":"json-schema","data":{"type":"string","example":"73a3c9e69b89"},"id":"schema_2"},"schema_3":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"type":"integer","example":200,"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"回應狀態"},"children":[],"type":"text"}],"type":"paragraph"}]},"result":{"type":"object","properties":{"next_token":{"type":"string","example":"73a3c9e69b89","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"查詢下一頁的令牌。"},"children":[],"type":"text"}],"type":"paragraph"}]},"history":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","example":38173479337460984,"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"紀錄的唯一識別碼"},"children":[],"type":"text"}],"type":"paragraph"}]},"timestamp":{"type":"integer","example":1703146067000,"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"紀錄的 Unix 時間戳（毫秒）"},"children":[],"type":"text"}],"type":"paragraph"}]},"action":{"type":"string","example":"photo_enhance","enum":["photo_enhance","api_photo_enhance","object_removal","api_object_removal","background_removal","api_background_removal","colorize","api_colorize","text_to_image","api_text_to_image","hair_style","api_hair_style","blur_background","change_background","wig","trial_gift_text_to_image","sign_up_gift","subscription_credits","subscriber_gift","permanent_credits","compensation_from_customer_service","renew","expire"],"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"這個紀錄的動作"},"children":[],"type":"text"}],"type":"paragraph"}]},"target_id":{"type":"string","example":"7TWFkuE2Z9uR0NOxSmQ1rh4PJ5Zx7YJ5U9SAz51q0QHVwMP+Jb1XbjPsf7ZgUgLY","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"這個點數的目標 id。例如，執行 AI 照片修復任務時，這條紀錄的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"target_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 就是該 AI 照片修復任務的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"task_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。購買點數時，這條紀錄的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"target_id"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 就是 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"order_id"},"children":[],"type":"code"}],"type":"paragraph"}]},"info":{"type":"object","properties":{"credits":{"type":"array","example":[{"id":24409059381740548,"amount":-2},{"id":27297116883780870,"amount":0}],"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"每個點數的詳細資訊"},"children":[],"type":"text"}],"type":"paragraph"}],"items":{"type":"object","properties":{"id":{"type":"integer","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"點數的 id"},"children":[],"type":"text"}],"type":"paragraph"}]},"amount":{"deprecated":true,"type":"integer","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"此參數已棄用。請改用 amount_dec。這個點數變更的總量。"},"children":[],"type":"text"}],"type":"paragraph"}]},"amount_dec":{"type":"number","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"以小數第二位呈現的點數淨變動量。"},"children":[],"type":"text"}],"type":"paragraph"}]}}}},"dst_actions":{"type":"array","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"肌膚檢測的 dst_actions"},"children":[],"type":"text"}],"type":"paragraph"}],"items":{"type":"string"},"example":"[ \"hd_wrinkle\", \"hd_pore\", \"hd_texture\" ]"}}}}}}}}}},"id":"schema_3"},"schema_4":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"type":"integer","example":400,"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"回應狀態"},"children":[],"type":"text"}],"type":"paragraph"}]},"error":{"type":"string","example":"Invalid parameter value"},"error_code":{"type":"string","example":"InvalidParameters"}}},"id":"schema_4"},"schema_5":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"type":"integer","example":401,"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"回應狀態"},"children":[],"type":"text"}],"type":"paragraph"}]},"error_code":{"type":"string","enum":["InvalidAccessToken"],"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"錯誤代碼："},"children":[],"type":"text"}],"type":"paragraph"},{"$$mdtype":"Node","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"InvalidAccessToken - 未提供 access token 或無效"},"children":[],"type":"text"}],"type":"item"}],"type":"list"}]}}},"id":"schema_5"},"schema_6":{"kind":"json-schema","data":{"type":"integer","example":20,"minimum":1,"maximum":20},"id":"schema_6"},"schema_7":{"kind":"json-schema","data":{"type":"string","example":"MjA"},"id":"schema_7"},"schema_8":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"type":"integer","example":200,"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"回應狀態"},"children":[],"type":"text"}],"type":"paragraph"}]},"result":{"type":"object","properties":{"next_token":{"type":"string","example":"MjA","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"查詢下一頁的令牌。沒有更多頁面時為 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"null"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。"},"children":[],"type":"text"}],"type":"paragraph"}]},"skus":{"type":"array","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"sku 清單"},"children":[],"type":"text"}],"type":"paragraph"}],"items":{"type":"object","properties":{"description":{"type":"string","example":"AI Skin Analysis for SD 1~4 concerns","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"sku 的說明"},"children":[],"type":"text"}],"type":"paragraph"}]},"amount":{"type":"number","example":9,"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"每個 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"proc_unit"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 消耗的點數"},"children":[],"type":"text"}],"type":"paragraph"}]},"unit":{"type":"string","enum":["result_image","second"],"example":"result_image","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"費用的計量單位"},"children":[],"type":"text"}],"type":"paragraph"}]},"proc_unit":{"type":"integer","example":1,"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"一次 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"amount"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 收費中包含的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"unit"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":" 數量"},"children":[],"type":"text"}],"type":"paragraph"}]},"run_task_url":{"type":"string","example":"https://yce-api-01.makeupar.com/s2s/v2.0/task/skin-analysis","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"消耗這個 sku 的任務端點完整網址"},"children":[],"type":"text"}],"type":"paragraph"}]}}}}}}}},"id":"schema_8"},"schema_9":{"kind":"json-schema","data":{"type":"object","properties":{"status":{"type":"integer","example":401,"description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"回應狀態"},"children":[],"type":"text"}],"type":"paragraph"}]},"error":{"type":"string","example":"Invalid API key"}}},"id":"schema_9"}},"exampleStore":{"paths/~1s2s~1v2.0~1credit~1feature-cost/get/responses/200/content/application~1json/example":{"value":{"status":200,"result":{"next_token":"MjA","skus":[{"description":"用於 SD 1~4 項目的 AI 肌膚檢測","amount":9,"unit":"result_image","proc_unit":1,"run_task_url":"https://yce-api-01.makeupar.com/s2s/v2.0/task/skin-analysis"},{"description":"用於 SD 5~7 項目的 AI 肌膚檢測","amount":12,"unit":"result_image","proc_unit":1,"run_task_url":"https://yce-api-01.makeupar.com/s2s/v2.0/task/skin-analysis"}]}},"id":"paths/~1s2s~1v2.0~1credit~1feature-cost/get/responses/200/content/application~1json/example"}},"securitySchemeStore":{"BearerAuthentication":{"id":"BearerAuthentication","type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"使用從認證取得的 "},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"access_token"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"，並放入標頭："},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"Authorization:Bearer <access_token>"},"children":[],"type":"code"}],"type":"paragraph"}]},"BearerAuthenticationV2":{"id":"BearerAuthenticationV2","type":"http","scheme":"bearer","description":[{"$$mdtype":"Node","attributes":{},"children":[{"$$mdtype":"Node","inline":true,"attributes":{"content":"使用標準的 'Bearer authentication'。請在標頭中放入您的 'API Key'："},"children":[],"type":"text"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"Authorization:Bearer YOUR_API_KEY"},"children":[],"type":"code"},{"$$mdtype":"Node","inline":true,"attributes":{"content":"。請注意 'Bearer' 與 'YOUR_API_KEY' 之間有一個空格。"},"children":[],"type":"text"}],"type":"paragraph"}]}},"specVersion":"3.0.0","servers":[{"url":"https://yce-api-01.makeupar.com"}],"specType":"openapi"},"options":{"layout":"stacked","mockServer":{"off":true,"position":"off"},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/@l10n/zh-TW/reference/unit_system.json?download"},{"url":"/_bundle/@l10n/zh-TW/reference/unit_system.yaml?download"}],"excludeFromSearch":false,"replayFeatures":{"graphql":false,"asyncapi":false},"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"單位系統","description":"查詢您的點數明細與使用紀錄。請注意，Units 是 YouCam API 運作所用的計費單位；不同的 AI 功能會扣除不同數量的點數。在本文件中，Unit 的代號為「Credit」。\n"}},"baseSlug":"/zh-tw/reference/unit_system","routesMapping":{}}