{"id":10021353,"date":"2026-04-29T22:58:30","date_gmt":"2026-04-29T14:58:30","guid":{"rendered":"https:\/\/itmax.cn\/?p=10021353"},"modified":"2026-04-29T22:58:30","modified_gmt":"2026-04-29T14:58:30","slug":"%e3%80%90%e5%bc%80%e6%ba%90%e5%89%aa%e6%98%a0%e5%b0%8f%e5%8a%a9%e6%89%8b%e3%80%91api-%e6%8e%a5%e5%8f%a3%e6%96%87%e6%a1%a3","status":"publish","type":"post","link":"https:\/\/itmax.cn\/?p=10021353","title":{"rendered":"\u3010\u5f00\u6e90\u526a\u6620\u5c0f\u52a9\u624b\u3011API \u63a5\u53e3\u6587\u6863"},"content":{"rendered":"<h2>API \u63a5\u53e3\u6587\u6863<\/h2>\n<h3>\u76ee\u5f55<\/h3>\n<ol>\n<li><a href=\"https:\/\/segmentfault.com\/a\/#\u7b80\u4ecb\" target=\"_blank\" rel=\"noopener noreferrer\">\u7b80\u4ecb<\/a><\/li>\n<li><a href=\"https:\/\/segmentfault.com\/a\/#\u9879\u76ee\u7ed3\u6784\" target=\"_blank\" rel=\"noopener noreferrer\">\u9879\u76ee\u7ed3\u6784<\/a><\/li>\n<li><a href=\"https:\/\/segmentfault.com\/a\/#\u6838\u5fc3\u7ec4\u4ef6\" target=\"_blank\" rel=\"noopener noreferrer\">\u6838\u5fc3\u7ec4\u4ef6<\/a><\/li>\n<li><a href=\"https:\/\/segmentfault.com\/a\/#\u67b6\u6784\u6982\u89c8\" target=\"_blank\" rel=\"noopener noreferrer\">\u67b6\u6784\u6982\u89c8<\/a><\/li>\n<li><a href=\"https:\/\/segmentfault.com\/a\/#\u8be6\u7ec6\u7ec4\u4ef6\u5206\u6790\" target=\"_blank\" rel=\"noopener noreferrer\">\u8be6\u7ec6\u7ec4\u4ef6\u5206\u6790<\/a><\/li>\n<li><a href=\"https:\/\/segmentfault.com\/a\/#\u53cc\u8bed\u6587\u6863\" target=\"_blank\" rel=\"noopener noreferrer\">\u53cc\u8bed\u6587\u6863<\/a><\/li>\n<li><a href=\"https:\/\/segmentfault.com\/a\/#\u4f9d\u8d56\u5173\u7cfb\u5206\u6790\" target=\"_blank\" rel=\"noopener noreferrer\">\u4f9d\u8d56\u5173\u7cfb\u5206\u6790<\/a><\/li>\n<li><a href=\"https:\/\/segmentfault.com\/a\/#\u6027\u80fd\u8003\u8651\" target=\"_blank\" rel=\"noopener noreferrer\">\u6027\u80fd\u8003\u8651<\/a><\/li>\n<li><a href=\"https:\/\/segmentfault.com\/a\/#\u6545\u969c\u6392\u9664\u6307\u5357\" target=\"_blank\" rel=\"noopener noreferrer\">\u6545\u969c\u6392\u9664\u6307\u5357<\/a><\/li>\n<li><a href=\"https:\/\/segmentfault.com\/a\/#\u5c0f\u7ed3\" target=\"_blank\" rel=\"noopener noreferrer\">\u5c0f\u7ed3<\/a><\/li>\n<\/ol>\n<h3>\u7b80\u4ecb<\/h3>\n<p>CapCut Mate \u63d0\u4f9b RESTful API\uff0c\u7528\u4e8e\u81ea\u52a8\u5316\u526a\u6620\u8349\u7a3f\u7ba1\u7406\u4e0e\u89c6\u9891\u751f\u6210\u3002API \u57fa\u4e8e FastAPI \u6784\u5efa\uff0c\u9075\u5faa OpenAPI \u89c4\u8303\uff0c\u652f\u6301\u8349\u7a3f\u521b\u5efa\u3001\u5a92\u4f53\u6dfb\u52a0\u3001\u7279\u6548\u4e0e\u8d34\u7eb8\u5e94\u7528\u3001\u5b57\u5e55\u5904\u7406\u3001\u65f6\u95f4\u7ebf\u8ba1\u7b97\u3001\u7d20\u6750\u4fe1\u606f\u751f\u6210\u4ee5\u53ca\u4e91\u7aef\u6e32\u67d3\u5bfc\u51fa\u7b49\u529f\u80fd\u3002<\/p>\n<h3>\u9879\u76ee\u7ed3\u6784<\/h3>\n<ul>\n<li>\n<p>\u5e94\u7528\u5165\u53e3\u4e0e\u8def\u7531\u6302\u8f7d<\/p>\n<ul>\n<li>\u5e94\u7528\u5165\u53e3\u6587\u4ef6\u8d1f\u8d23\u521b\u5efa FastAPI \u5b9e\u4f8b\u3001\u6ce8\u518c\u8def\u7531\u4e0e\u4e2d\u95f4\u4ef6\uff0c\u5e76\u542f\u52a8\u670d\u52a1<\/li>\n<li>\u8def\u7531\u7edf\u4e00\u6302\u8f7d\u5728 <code>\/openapi\/capcut-mate\/v1<\/code> \u524d\u7f00\u4e0b\uff0c\u4fbf\u4e8e\u7248\u672c\u5316\u7ba1\u7406<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u8def\u7531\u4e0e\u63a7\u5236\u5668<\/p>\n<ul>\n<li>v1 \u8def\u7531\u6a21\u5757\u96c6\u4e2d\u5b9a\u4e49\u5404\u4e1a\u52a1\u63a5\u53e3\uff0c\u6bcf\u4e2a\u63a5\u53e3\u5bf9\u5e94\u4e00\u4e2a\u8bf7\u6c42\/\u54cd\u5e94\u6a21\u578b\u4e0e\u670d\u52a1\u5c42\u8c03\u7528<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u6570\u636e\u6a21\u578b\u4e0e\u6821\u9a8c<\/p>\n<ul>\n<li>\u4f7f\u7528 Pydantic \u6a21\u578b\u5b9a\u4e49\u8bf7\u6c42\u53c2\u6570\u4e0e\u54cd\u5e94\u7ed3\u6784\uff0c\u5185\u7f6e\u5b57\u6bb5\u7ea7\u6821\u9a8c\u4e0e\u9ed8\u8ba4\u503c<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u6587\u6863\u4e0e\u793a\u4f8b<\/p>\n<ul>\n<li>OpenAPI YAML \u63d0\u4f9b\u63a5\u53e3\u5b9a\u4e49\u3001\u53c2\u6570\u8bf4\u660e\u4e0e\u793a\u4f8b\uff0c\u4fbf\u4e8e\u96c6\u6210\u4e0e\u6d4b\u8bd5<\/li>\n<li>\u90e8\u5206\u63a5\u53e3\u53e6\u6709\u4e2d\u6587\u8bf4\u660e\u6587\u6863\uff0c\u4fbf\u4e8e\u5bf9\u7167\u9605\u8bfb<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<pre style=\"display:none;\"><code class=\"mermaid\">graph TB\nA[&quot;\u5e94\u7528\u5165\u53e3&lt;br\/&gt;main.py&quot;] --&gt; B[&quot;\u8def\u7531\u6ce8\u518c&lt;br\/&gt;\/openapi\/capcut-mate\/v1\/*&quot;]\nB --&gt; C[&quot;v1 \u8def\u7531\u6a21\u5757&lt;br\/&gt;src\/router\/v1.py&quot;]\nC --&gt; D[&quot;\u8bf7\u6c42\u6a21\u578b&lt;br\/&gt;src\/schemas\/*.py&quot;]\nC --&gt; E[&quot;\u670d\u52a1\u5c42\u8c03\u7528&lt;br\/&gt;service.*&quot;]\nE --&gt; F[&quot;\u526a\u6620\u63a7\u5236&lt;br\/&gt;JianyingController&quot;]\nG[&quot;\u4e2d\u6587\u6587\u6863&lt;br\/&gt;docs\/*.zh.md&quot;] --&gt; C\nH[&quot;\u82f1\u6587\u6587\u6863&lt;br\/&gt;docs\/*.md&quot;] --&gt; C<\/code><\/pre>\n<h3>\u6838\u5fc3\u7ec4\u4ef6<\/h3>\n<ul>\n<li>\n<p>\u5e94\u7528\u5165\u53e3\u4e0e\u4e2d\u95f4\u4ef6<\/p>\n<ul>\n<li>\u4e2d\u95f4\u4ef6\u987a\u5e8f\uff1aPrepareMiddleware \u2192 ResponseMiddleware\uff0c\u786e\u4fdd\u8bf7\u6c42\u9884\u5904\u7406\u4e0e\u7edf\u4e00\u54cd\u5e94\u683c\u5f0f<\/li>\n<li>\u8def\u7531\u524d\u7f00\uff1a<code>\/openapi\/capcut-mate\/v1<\/code>\uff0c\u6807\u7b7e\uff1a<code>capcut-mate<\/code><\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u8def\u7531\u6a21\u5757<\/p>\n<ul>\n<li>v1 \u8def\u7531\u6a21\u5757\u5305\u542b\u8349\u7a3f\u7ba1\u7406\u3001\u5a92\u4f53\u5904\u7406\u3001\u7f16\u8f91\u6548\u679c\u3001\u89c6\u9891\u751f\u6210\u3001\u5de5\u5177\u7c7b\u63a5\u53e3\u7b49<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u6570\u636e\u6a21\u578b<\/p>\n<ul>\n<li>\u8bf7\u6c42\/\u54cd\u5e94\u6a21\u578b\u57fa\u4e8e Pydantic\uff0c\u5185\u7f6e\u7c7b\u578b\u3001\u8303\u56f4\u4e0e\u9ed8\u8ba4\u503c\u6821\u9a8c\uff0c\u51cf\u5c11\u91cd\u590d\u6821\u9a8c\u903b\u8f91<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u6587\u6863\u4e0e\u793a\u4f8b<\/p>\n<ul>\n<li>OpenAPI YAML \u63d0\u4f9b\u63a5\u53e3\u5b9a\u4e49\u3001\u53c2\u6570\u8bf4\u660e\u3001\u793a\u4f8b\u4e0e\u54cd\u5e94\u7ed3\u6784\uff0c\u4fbf\u4e8e\u5ba2\u6237\u7aef\u96c6\u6210<\/li>\n<li>\u4e2d\u6587\u6587\u6863\u7248\u672c\uff0c\u63d0\u4f9b\u8be6\u7ec6\u7684\u4e2d\u6587\u63a5\u53e3\u8bf4\u660e\u4e0e\u4f7f\u7528\u793a\u4f8b<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h3>\u67b6\u6784\u6982\u89c8<\/h3>\n<p>API \u91c7\u7528\u4e09\u5c42\u67b6\u6784\uff1a<\/p>\n<ul>\n<li>\u8868\u73b0\u5c42\uff1aFastAPI \u8def\u7531\u4e0e\u8bf7\u6c42\/\u54cd\u5e94\u6a21\u578b<\/li>\n<li>\u4e1a\u52a1\u5c42\uff1a\u670d\u52a1\u5c42\u5c01\u88c5\u5177\u4f53\u4e1a\u52a1\u903b\u8f91\uff0c\u5982\u8349\u7a3f\u521b\u5efa\u3001\u5a92\u4f53\u6dfb\u52a0\u3001\u6e32\u67d3\u5bfc\u51fa\u7b49<\/li>\n<li>\u63a7\u5236\u5c42\uff1a\u4e0e\u526a\u6620\u4ea4\u4e92\uff0c\u6267\u884c\u7a97\u53e3\u6fc0\u6d3b\u3001\u7d20\u6750\u5bfc\u5165\u4e0e\u6e32\u67d3\u64cd\u4f5c<\/li>\n<\/ul>\n<pre style=\"display:none;\"><code class=\"mermaid\">graph TB\nsubgraph &quot;\u8868\u73b0\u5c42&quot;\nR[&quot;FastAPI \u8def\u7531&lt;br\/&gt;src\/router\/v1.py&quot;]\nM[&quot;\u8bf7\u6c42\/\u54cd\u5e94\u6a21\u578b&lt;br\/&gt;src\/schemas\/*.py&quot;]\nD[&quot;\u6587\u6863\u4e0e OpenAPI&quot;]\nend\nsubgraph &quot;\u4e1a\u52a1\u5c42&quot;\nS[&quot;\u670d\u52a1\u5c42&lt;br\/&gt;service.*&quot;]\nend\nsubgraph &quot;\u63a7\u5236\u5c42&quot;\nJ[&quot;\u526a\u6620\u63a7\u5236\u5668&lt;br\/&gt;JianyingController&quot;]\nend\nR --&gt; M\nR --&gt; S\nS --&gt; J\nD --&gt; R<\/code><\/pre>\n<h3>\u8be6\u7ec6\u7ec4\u4ef6\u5206\u6790<\/h3>\n<h4>\u8349\u7a3f\u7ba1\u7406<\/h4>\n<h5>\u521b\u5efa\u8349\u7a3f (CREATE_DRAFT)<\/h5>\n<ul>\n<li>\u65b9\u6cd5\u4e0e\u8def\u5f84\uff1aPOST \/openapi\/capcut-mate\/v1\/create_draft<\/li>\n<li>\u8ba4\u8bc1\uff1a\u65e0\u9700\u8ba4\u8bc1<\/li>\n<li>\n<p>\u8bf7\u6c42\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>width: \u6574\u6570\uff0c\u6700\u5c0f\u503c 1\uff0c\u793a\u4f8b\uff1a1920<\/li>\n<li>height: \u6574\u6570\uff0c\u6700\u5c0f\u503c 1\uff0c\u793a\u4f8b\uff1a1080<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u54cd\u5e94\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>draft_url: \u5b57\u7b26\u4e32\uff0c\u8349\u7a3f\u8bbf\u95ee URL<\/li>\n<li>tip_url: \u5b57\u7b26\u4e32\uff0c\u5e2e\u52a9\u6587\u6863 URL<\/li>\n<\/ul>\n<\/li>\n<li>\u793a\u4f8b\u8bf7\u6c42\u4e0e\u54cd\u5e94\uff1a\u89c1 OpenAPI YAML \u4e2d\u7684 create_draft \u793a\u4f8b<\/li>\n<\/ul>\n<h5>\u4fdd\u5b58\u8349\u7a3f (SAVE_DRAFT)<\/h5>\n<ul>\n<li>\u65b9\u6cd5\u4e0e\u8def\u5f84\uff1aPOST \/openapi\/capcut-mate\/v1\/save_draft<\/li>\n<li>\n<p>\u8bf7\u6c42\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>draft_url: \u5b57\u7b26\u4e32\uff0c\u8349\u7a3f URL<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u54cd\u5e94\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>draft_url: \u5b57\u7b26\u4e32\uff0c\u8349\u7a3f URL<\/li>\n<li>message: \u5b57\u7b26\u4e32\uff0c\u64cd\u4f5c\u7ed3\u679c\u6d88\u606f<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h5>\u83b7\u53d6\u8349\u7a3f\u6587\u4ef6\u5217\u8868 (GET_DRAFT)<\/h5>\n<ul>\n<li>\u65b9\u6cd5\u4e0e\u8def\u5f84\uff1aGET \/openapi\/capcut-mate\/v1\/get_draft<\/li>\n<li>\n<p>\u67e5\u8be2\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>draft_id: \u5b57\u7b26\u4e32\uff0c\u957f\u5ea6 20-32\uff0c\u793a\u4f8b\uff1a202511262111301f5fceff<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u54cd\u5e94\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>files: \u5b57\u7b26\u4e32\u6570\u7ec4\uff0c\u6587\u4ef6\u8def\u5f84\u5217\u8868<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h4>\u5a92\u4f53\u5904\u7406<\/h4>\n<h5>\u6279\u91cf\u6dfb\u52a0\u89c6\u9891 (ADD_VIDEOS)<\/h5>\n<ul>\n<li>\u65b9\u6cd5\u4e0e\u8def\u5f84\uff1aPOST \/openapi\/capcut-mate\/v1\/add_videos<\/li>\n<li>\n<p>\u8bf7\u6c42\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>draft_url: \u5b57\u7b26\u4e32\uff0c\u8349\u7a3f URL<\/li>\n<li>video_infos: \u5b57\u7b26\u4e32\uff0cJSON \u6570\u7ec4\uff0c\u5305\u542b\u89c6\u9891 URL\u3001\u5c3a\u5bf8\u3001\u65f6\u95f4\u7ebf\u4e0e\u8f6c\u573a\u7b49<\/li>\n<li>alpha: \u6d6e\u70b9\u6570\uff0c\u8303\u56f4 [0,1]<\/li>\n<li>scale_x\/scale_y: \u6d6e\u70b9\u6570\uff0c\u5efa\u8bae\u8303\u56f4 [0.1,5.0]<\/li>\n<li>transform_x\/transform_y: \u6574\u6570\uff0c\u50cf\u7d20\u504f\u79fb<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u54cd\u5e94\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>draft_url: \u5b57\u7b26\u4e32<\/li>\n<li>track_id: \u5b57\u7b26\u4e32<\/li>\n<li>video_ids: \u5b57\u7b26\u4e32\u6570\u7ec4<\/li>\n<li>segment_ids: \u5b57\u7b26\u4e32\u6570\u7ec4<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h5>\u6279\u91cf\u6dfb\u52a0\u97f3\u9891 (ADD_AUDIOS)<\/h5>\n<ul>\n<li>\u65b9\u6cd5\u4e0e\u8def\u5f84\uff1aPOST \/openapi\/capcut-mate\/v1\/add_audios<\/li>\n<li>\n<p>\u8bf7\u6c42\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>draft_url: \u5b57\u7b26\u4e32<\/li>\n<li>audio_infos: \u5b57\u7b26\u4e32\uff0cJSON \u6570\u7ec4\uff0c\u5305\u542b\u97f3\u9891 URL\u3001\u65f6\u957f\u4e0e\u65f6\u95f4\u7ebf<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u54cd\u5e94\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>draft_url: \u5b57\u7b26\u4e32<\/li>\n<li>track_id: \u5b57\u7b26\u4e32<\/li>\n<li>audio_ids: \u5b57\u7b26\u4e32\u6570\u7ec4<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h5>\u6279\u91cf\u6dfb\u52a0\u56fe\u7247 (ADD_IMAGES)<\/h5>\n<ul>\n<li>\u65b9\u6cd5\u4e0e\u8def\u5f84\uff1aPOST \/openapi\/capcut-mate\/v1\/add_images<\/li>\n<li>\n<p>\u8bf7\u6c42\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>draft_url: \u5b57\u7b26\u4e32<\/li>\n<li>image_infos: \u5b57\u7b26\u4e32\uff0cJSON \u6570\u7ec4\uff0c\u5305\u542b\u56fe\u7247 URL\u3001\u5c3a\u5bf8\u3001\u900f\u660e\u5ea6\u4e0e\u52a8\u753b<\/li>\n<li>alpha\/scale_x\/scale_y: \u6d6e\u70b9\u6570<\/li>\n<li>transform_x\/transform_y: \u6574\u6570<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u54cd\u5e94\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>draft_url: \u5b57\u7b26\u4e32<\/li>\n<li>track_id: \u5b57\u7b26\u4e32<\/li>\n<li>image_ids: \u5b57\u7b26\u4e32\u6570\u7ec4<\/li>\n<li>segment_ids: \u5b57\u7b26\u4e32\u6570\u7ec4<\/li>\n<li>segment_infos: \u7247\u6bb5\u4fe1\u606f\u6570\u7ec4\uff08\u542b id\/start\/end\uff09<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h4>\u7f16\u8f91\u6548\u679c<\/h4>\n<h5>\u6dfb\u52a0\u8d34\u7eb8 (ADD_STICKER)<\/h5>\n<ul>\n<li>\u65b9\u6cd5\u4e0e\u8def\u5f84\uff1aPOST \/openapi\/capcut-mate\/v1\/add_sticker<\/li>\n<li>\n<p>\u8bf7\u6c42\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>draft_url: \u5b57\u7b26\u4e32<\/li>\n<li>sticker_id: \u5b57\u7b26\u4e32\uff0c\u8d34\u7eb8 ID<\/li>\n<li>start\/end: \u6574\u6570\uff0c\u5fae\u79d2\u65f6\u95f4\u6233<\/li>\n<li>scale: \u6d6e\u70b9\u6570\uff0c\u5efa\u8bae\u8303\u56f4 [0.1,5.0]<\/li>\n<li>transform_x\/transform_y: \u6574\u6570\uff0c\u50cf\u7d20\u504f\u79fb<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u54cd\u5e94\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>draft_url: \u5b57\u7b26\u4e32<\/li>\n<li>sticker_id: \u5b57\u7b26\u4e32<\/li>\n<li>track_id: \u5b57\u7b26\u4e32<\/li>\n<li>segment_id: \u5b57\u7b26\u4e32<\/li>\n<li>duration: \u6574\u6570\uff0c\u5fae\u79d2<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h5>\u6dfb\u52a0\u7279\u6548 (ADD_EFFECTS)<\/h5>\n<ul>\n<li>\u65b9\u6cd5\u4e0e\u8def\u5f84\uff1aPOST \/openapi\/capcut-mate\/v1\/add_effects<\/li>\n<li>\n<p>\u8bf7\u6c42\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>draft_url: \u5b57\u7b26\u4e32<\/li>\n<li>effect_infos: \u5b57\u7b26\u4e32\uff0cJSON \u6570\u7ec4\uff0c\u5305\u542b\u7279\u6548\u6807\u9898\u4e0e\u65f6\u95f4\u7ebf<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u54cd\u5e94\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>draft_url: \u5b57\u7b26\u4e32<\/li>\n<li>track_id: \u5b57\u7b26\u4e32<\/li>\n<li>effect_ids: \u5b57\u7b26\u4e32\u6570\u7ec4<\/li>\n<li>segment_ids: \u5b57\u7b26\u4e32\u6570\u7ec4<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h5>\u6dfb\u52a0\u5b57\u5e55 (ADD_CAPTIONS)<\/h5>\n<ul>\n<li>\u65b9\u6cd5\u4e0e\u8def\u5f84\uff1aPOST \/openapi\/capcut-mate\/v1\/add_captions<\/li>\n<li>\n<p>\u8bf7\u6c42\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>draft_url: \u5b57\u7b26\u4e32<\/li>\n<li>captions: \u5b57\u7b26\u4e32\uff0cJSON \u6570\u7ec4\uff0c\u5305\u542b\u5b57\u5e55\u6587\u672c\u4e0e\u65f6\u95f4\u7ebf<\/li>\n<li>text_color\/alignment\/alpha\/font_size \u7b49\u6837\u5f0f\u53c2\u6570<\/li>\n<li>transform_x\/transform_y\/scale_x\/scale_y \u7b49\u53d8\u6362\u53c2\u6570<\/li>\n<li>style_text\/underline\/italic\/bold\/has_shadow \u7b49\u5f00\u5173<\/li>\n<li>shadow_info: \u9634\u5f71\u53c2\u6570\u5bf9\u8c61\uff08\u5f53 has_shadow=true \u65f6\u751f\u6548\uff09<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u54cd\u5e94\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>draft_url: \u5b57\u7b26\u4e32<\/li>\n<li>track_id: \u5b57\u7b26\u4e32<\/li>\n<li>text_ids: \u5b57\u7b26\u4e32\u6570\u7ec4<\/li>\n<li>segment_ids: \u5b57\u7b26\u4e32\u6570\u7ec4<\/li>\n<li>segment_infos: \u7247\u6bb5\u4fe1\u606f\u6570\u7ec4<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h4>\u89c6\u9891\u751f\u6210<\/h4>\n<h5>\u751f\u6210\u89c6\u9891 (GEN_VIDEO)<\/h5>\n<ul>\n<li>\u65b9\u6cd5\u4e0e\u8def\u5f84\uff1aPOST \/openapi\/capcut-mate\/v1\/gen_video<\/li>\n<li>\n<p>\u8bf7\u6c42\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>draft_url: \u5b57\u7b26\u4e32\uff0c\u8349\u7a3f URL<\/li>\n<li>apiKey: \u53ef\u9009\u5b57\u7b26\u4e32\uff0c\u5408\u6cd5 UUID \u683c\u5f0f<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u54cd\u5e94\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>message: \u5b57\u7b26\u4e32\uff0c\u54cd\u5e94\u6d88\u606f<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h5>\u67e5\u8be2\u89c6\u9891\u751f\u6210\u4efb\u52a1\u72b6\u6001 (GEN_VIDEO_STATUS)<\/h5>\n<ul>\n<li>\u65b9\u6cd5\u4e0e\u8def\u5f84\uff1aPOST \/openapi\/capcut-mate\/v1\/gen_video_status<\/li>\n<li>\n<p>\u8bf7\u6c42\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>draft_url: \u5b57\u7b26\u4e32\uff0c\u8349\u7a3f URL<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u54cd\u5e94\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>\u4efb\u52a1\u72b6\u6001\u4fe1\u606f\uff08\u5177\u4f53\u5b57\u6bb5\u7531\u670d\u52a1\u5c42\u8fd4\u56de\uff09<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h4>\u5de5\u5177\u4e0e\u7d20\u6750<\/h4>\n<h5>\u5feb\u901f\u521b\u5efa\u7d20\u6750\u8f68\u9053 (EASY_CREATE_MATERIAL)<\/h5>\n<ul>\n<li>\u65b9\u6cd5\u4e0e\u8def\u5f84\uff1aPOST \/openapi\/capcut-mate\/v1\/easy_create_material<\/li>\n<li>\n<p>\u8bf7\u6c42\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>draft_url: \u5b57\u7b26\u4e32<\/li>\n<li>audio_url\/text\/img_url\/video_url: \u5b57\u7b26\u4e32<\/li>\n<li>text_color\/font_size\/text_transform_y: \u6837\u5f0f\u53c2\u6570<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u54cd\u5e94\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>draft_url: \u5b57\u7b26\u4e32<\/li>\n<li>message: \u5b57\u7b26\u4e32\uff0c\u64cd\u4f5c\u7ed3\u679c\u6d88\u606f<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h5>\u83b7\u53d6\u97f3\u9891\u65f6\u957f (GET_AUDIO_DURATION)<\/h5>\n<ul>\n<li>\u65b9\u6cd5\u4e0e\u8def\u5f84\uff1aPOST \/openapi\/capcut-mate\/v1\/get_audio_duration<\/li>\n<li>\n<p>\u8bf7\u6c42\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>mp3_url: \u5b57\u7b26\u4e32\uff0c\u97f3\u9891 URL<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u54cd\u5e94\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>duration: \u6574\u6570\uff0c\u97f3\u9891\u65f6\u957f\uff08\u5fae\u79d2\uff09<\/li>\n<li>message: \u5b57\u7b26\u4e32\uff0c\u64cd\u4f5c\u7ed3\u679c\u6d88\u606f<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h5>\u83b7\u53d6\u6587\u5b57\u52a8\u753b (GET_TEXT_ANIMATIONS)<\/h5>\n<ul>\n<li>\u65b9\u6cd5\u4e0e\u8def\u5f84\uff1aPOST \/openapi\/capcut-mate\/v1\/get_text_animations<\/li>\n<li>\n<p>\u8bf7\u6c42\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>mode\/type: \u6574\u6570\uff0c\u52a8\u753b\u6a21\u5f0f\u4e0e\u7c7b\u578b<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u54cd\u5e94\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>effects: \u52a8\u753b\u6548\u679c\u6570\u7ec4\uff08\u5305\u542b\u540d\u79f0\u3001\u65f6\u957f\u3001\u56fe\u6807\u7b49\uff09<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h5>\u83b7\u53d6\u56fe\u7247\u52a8\u753b (GET_IMAGE_ANIMATIONS)<\/h5>\n<ul>\n<li>\u65b9\u6cd5\u4e0e\u8def\u5f84\uff1aPOST \/openapi\/capcut-mate\/v1\/get_image_animations<\/li>\n<li>\n<p>\u8bf7\u6c42\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>mode\/type: \u6574\u6570\uff0c\u52a8\u753b\u6a21\u5f0f\u4e0e\u7c7b\u578b<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u54cd\u5e94\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>effects: \u52a8\u753b\u6548\u679c\u6570\u7ec4\uff08\u5305\u542b\u540d\u79f0\u3001\u65f6\u957f\u3001\u56fe\u6807\u7b49\uff09<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h5>\u641c\u7d22\u8d34\u7eb8 (SEARCH_STICKER)<\/h5>\n<ul>\n<li>\u65b9\u6cd5\u4e0e\u8def\u5f84\uff1aPOST \/openapi\/capcut-mate\/v1\/search_sticker<\/li>\n<li>\n<p>\u8bf7\u6c42\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>keyword: \u5b57\u7b26\u4e32\uff0c\u5173\u952e\u8bcd<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u54cd\u5e94\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>data: \u8d34\u7eb8\u6570\u636e\u6570\u7ec4\uff0c\u5305\u542b\u8d34\u7eb8\u4fe1\u606f\u3001ID \u4e0e\u6807\u9898<\/li>\n<li>message: \u5b57\u7b26\u4e32\uff0c\u64cd\u4f5c\u7ed3\u679c\u6d88\u606f<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h5>\u63d0\u53d6\u94fe\u63a5 (GET_URL)<\/h5>\n<ul>\n<li>\u65b9\u6cd5\u4e0e\u8def\u5f84\uff1aPOST \/openapi\/capcut-mate\/v1\/get_url<\/li>\n<li>\n<p>\u8bf7\u6c42\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>output: \u5b57\u7b26\u4e32\uff0c\u63d0\u53d6\u5185\u5bb9<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u54cd\u5e94\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>output: \u5b57\u7b26\u4e32\uff0c\u63d0\u53d6\u7ed3\u679c<\/li>\n<\/ul>\n<\/li>\n<li>\u54cd\u5e94\u683c\u5f0f\u66f4\u7b80\u6d01\uff0c\u4e13\u6ce8\u4e8e output \u5b57\u6bb5\u7684\u8bf4\u660e<\/li>\n<\/ul>\n<h5>\u5b57\u7b26\u4e32\u5217\u8868\u8f6c\u5bf9\u8c61 (STR_LIST_TO_OBJS)<\/h5>\n<ul>\n<li>\u65b9\u6cd5\u4e0e\u8def\u5f84\uff1aPOST \/openapi\/capcut-mate\/v1\/str_list_to_objs<\/li>\n<li>\n<p>\u8bf7\u6c42\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>infos: \u5b57\u7b26\u4e32\u6570\u7ec4<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u54cd\u5e94\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>infos: \u5bf9\u8c61\u6570\u7ec4\uff0c\u6bcf\u4e2a\u5bf9\u8c61\u5305\u542b output \u5b57\u6bb5<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h5>\u5bf9\u8c61\u5217\u8868\u8f6c\u5b57\u7b26\u4e32 (OBJS_TO_STR_LIST)<\/h5>\n<ul>\n<li>\u65b9\u6cd5\u4e0e\u8def\u5f84\uff1aPOST \/openapi\/capcut-mate\/v1\/objs_to_str_list<\/li>\n<li>\n<p>\u8bf7\u6c42\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>outputs: \u5bf9\u8c61\u6570\u7ec4\uff0c\u6bcf\u4e2a\u5bf9\u8c61\u5305\u542b output \u5b57\u6bb5<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u54cd\u5e94\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>infos: \u5b57\u7b26\u4e32\u6570\u7ec4<\/li>\n<\/ul>\n<\/li>\n<li>\u54cd\u5e94\u683c\u5f0f\u66f4\u7b80\u6d01\uff0c\u4e13\u6ce8\u4e8e infos \u5b57\u6bb5\u7684\u8bf4\u660e<\/li>\n<\/ul>\n<h4>\u65f6\u95f4\u7ebf\u4e0e\u7d20\u6750\u4fe1\u606f\u751f\u6210<\/h4>\n<ul>\n<li>\n<p>\u65f6\u95f4\u7ebf\u8ba1\u7b97<\/p>\n<ul>\n<li>\u65b9\u6cd5\u4e0e\u8def\u5f84\uff1aPOST \/openapi\/capcut-mate\/v1\/timelines<\/li>\n<li>\n<p>\u8bf7\u6c42\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>duration\/num\/start\/type: \u6574\u6570\uff0c\u65f6\u957f\u3001\u4efd\u6570\u3001\u8d77\u59cb\u4e0e\u5206\u914d\u7b56\u7565<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u54cd\u5e94\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>timelines\/all_timelines: \u65f6\u95f4\u7ebf\u6570\u7ec4<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u97f3\u9891\u65f6\u95f4\u7ebf<\/p>\n<ul>\n<li>\u65b9\u6cd5\u4e0e\u8def\u5f84\uff1aPOST \/openapi\/capcut-mate\/v1\/audio_timelines<\/li>\n<li>\n<p>\u8bf7\u6c42\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>links: \u5b57\u7b26\u4e32\u6570\u7ec4\uff0c\u97f3\u9891 URL \u5217\u8868<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u54cd\u5e94\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>timelines\/all_timelines: \u65f6\u95f4\u7ebf\u6570\u7ec4<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u97f3\u9891\/\u56fe\u7247\/\u5b57\u5e55\/\u89c6\u9891\u4fe1\u606f\u751f\u6210<\/p>\n<ul>\n<li>\n<p>\u65b9\u6cd5\u4e0e\u8def\u5f84\uff1a<\/p>\n<ul>\n<li>\/openapi\/capcut-mate\/v1\/audio_infos<\/li>\n<li>\/openapi\/capcut-mate\/v1\/imgs_infos<\/li>\n<li>\/openapi\/capcut-mate\/v1\/caption_infos<\/li>\n<li>\/openapi\/capcut-mate\/v1\/video_infos<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u8bf7\u6c42\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>mp3_urls\/imgs\/texts\/video_urls: \u5217\u8868<\/li>\n<li>timelines: \u65f6\u95f4\u7ebf\u6570\u7ec4<\/li>\n<li>\u5176\u4ed6\u6837\u5f0f\u4e0e\u52a8\u753b\u53c2\u6570\uff08\u5982 font_size\u3001mask\u3001transition \u7b49\uff09<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u54cd\u5e94\u53c2\u6570\uff1a<\/p>\n<ul>\n<li>infos: JSON \u5b57\u7b26\u4e32\uff0c\u5305\u542b\u751f\u6210\u7684\u5a92\u4f53\u4fe1\u606f<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h4>\u53c2\u6570\u9a8c\u8bc1\u89c4\u5219\u4e0e\u6570\u636e\u7c7b\u578b<\/h4>\n<ul>\n<li>\n<p>\u7c7b\u578b\u4e0e\u8303\u56f4<\/p>\n<ul>\n<li>\u6574\u6570\uff1a\u5982 width\/height\u3001start\/end\u3001font_size \u7b49\uff0c\u9700\u6ee1\u8db3\u6700\u5c0f\u503c\u6216\u8303\u56f4\u8981\u6c42<\/li>\n<li>\u6d6e\u70b9\u6570\uff1a\u5982 alpha\u3001scale_x\/scale_y\u3001volume \u7b49\uff0c\u9700\u6ee1\u8db3\u8303\u56f4\u9650\u5236<\/li>\n<li>\u5b57\u7b26\u4e32\uff1a\u5982 draft_url\u3001sticker_id\u3001keyword \u7b49\uff0c\u9700\u7b26\u5408\u957f\u5ea6\u4e0e\u683c\u5f0f\u8981\u6c42<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u53ef\u9009\u53c2\u6570<\/p>\n<ul>\n<li>\u591a\u6570\u6837\u5f0f\u4e0e\u52a8\u753b\u53c2\u6570\u4e3a\u53ef\u9009\uff0c\u672a\u63d0\u4f9b\u65f6\u4f7f\u7528\u9ed8\u8ba4\u503c<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u6821\u9a8c\u5668<\/p>\n<ul>\n<li>apiKey \u4f7f\u7528 UUID \u6821\u9a8c\u5668\uff0c\u975e\u6cd5\u683c\u5f0f\u5c06\u89e6\u53d1\u9519\u8bef<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h4>\u9519\u8bef\u5904\u7406\u4e0e\u72b6\u6001\u7801<\/h4>\n<ul>\n<li>\n<p>\u6807\u51c6\u54cd\u5e94<\/p>\n<ul>\n<li>\u6210\u529f\uff1aHTTP 200\uff0c\u5305\u542b code\/message\/draft_url \u7b49\u5b57\u6bb5\uff08\u90e8\u5206\u63a5\u53e3\u7701\u7565 code\/message\uff09<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u6821\u9a8c\u9519\u8bef<\/p>\n<ul>\n<li>\u53c2\u6570\u4e0d\u7b26\u5408\u7c7b\u578b\u6216\u8303\u56f4\u65f6\uff0cFastAPI \u5c06\u8fd4\u56de 422 Unprocessable Entity<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>API \u5bc6\u94a5\u9519\u8bef<\/p>\n<ul>\n<li>apiKey \u975e\u5408\u6cd5 UUID \u683c\u5f0f\u65f6\uff0c\u5c06\u8fd4\u56de\u6821\u9a8c\u9519\u8bef<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u4e1a\u52a1\u9519\u8bef<\/p>\n<ul>\n<li>\u7531\u670d\u52a1\u5c42\u629b\u51fa\u7684\u5f02\u5e38\u5c06\u901a\u8fc7\u7edf\u4e00\u54cd\u5e94\u4e2d\u95f4\u4ef6\u8f6c\u6362\u4e3a\u6807\u51c6\u683c\u5f0f<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h4>\u8c03\u7528\u793a\u4f8b\u4e0e\u6700\u4f73\u5b9e\u8df5<\/h4>\n<ul>\n<li>\n<p>\u8c03\u7528\u793a\u4f8b<\/p>\n<ul>\n<li>\u6240\u6709\u63a5\u53e3\u7684\u8bf7\u6c42\u4e0e\u54cd\u5e94\u793a\u4f8b\u53ef\u5728 OpenAPI YAML \u4e2d\u67e5\u770b\uff0c\u6db5\u76d6\u8349\u7a3f\u521b\u5efa\u3001\u5a92\u4f53\u6dfb\u52a0\u3001\u7279\u6548\u4e0e\u8d34\u7eb8\u5e94\u7528\u3001\u5b57\u5e55\u5904\u7406\u3001\u65f6\u95f4\u7ebf\u8ba1\u7b97\u4e0e\u7d20\u6750\u4fe1\u606f\u751f\u6210\u7b49\u573a\u666f<\/li>\n<li>\u90e8\u5206\u63a5\u53e3\u53e6\u6709\u4e2d\u6587\u8bf4\u660e\u9875\uff0c\u53ef\u5bf9\u7167\u9605\u8bfb<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u6700\u4f73\u5b9e\u8df5<\/p>\n<ul>\n<li>\u4f7f\u7528\u8349\u7a3f URL \u4f5c\u4e3a\u8de8\u63a5\u53e3\u7684\u4e0a\u4e0b\u6587\u6807\u8bc6\uff0c\u907f\u514d\u91cd\u590d\u521b\u5efa\u8349\u7a3f<\/li>\n<li>\u6279\u91cf\u6dfb\u52a0\u5a92\u4f53\u65f6\uff0c\u5408\u7406\u8bbe\u7f6e\u900f\u660e\u5ea6\u4e0e\u7f29\u653e\u6bd4\u4f8b\uff0c\u786e\u4fdd\u753b\u9762\u534f\u8c03<\/li>\n<li>\u4f7f\u7528\u65f6\u95f4\u7ebf\u5de5\u5177\u751f\u6210\u5747\u5300\u6216\u968f\u673a\u5206\u5272\u7684\u65f6\u95f4\u6bb5\uff0c\u63d0\u5347\u7d20\u6750\u7ec4\u7ec7\u6548\u7387<\/li>\n<li>\u4e3a\u5b57\u5e55\u4e0e\u7279\u6548\u8bbe\u7f6e\u5408\u7406\u7684\u5f00\u59cb\/\u7ed3\u675f\u65f6\u95f4\uff0c\u907f\u514d\u91cd\u53e0\u51b2\u7a81<\/li>\n<li>\u4f7f\u7528\u7edf\u4e00\u54cd\u5e94\u4e2d\u95f4\u4ef6\u5904\u7406\u5f02\u5e38\uff0c\u4fbf\u4e8e\u524d\u7aef\u7edf\u4e00\u5904\u7406\u9519\u8bef<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h3>\u53cc\u8bed\u6587\u6863<\/h3>\n<ul>\n<li>\u4ed3\u5e93\u4e2d\u8bb8\u591a\u63a5\u53e3\u63d0\u4f9b\u4e2d\u6587\u8bf4\u660e\uff08\u6587\u4ef6\u540d\u5e38\u542b Zh \u6216\u4e0e\u82f1\u6587\u7248\u6210\u5bf9\uff09\uff0c\u5e76\u4e0e OpenAPI \u63cf\u8ff0\u4e00\u81f4\u3002<\/li>\n<li>\u82e5\u6587\u6863\u4e0e OpenAPI \u4e0d\u4e00\u81f4\uff0c\u4ee5 OpenAPI \u4e0e\u6e90\u7801\u4e3a\u51c6\u3002<\/li>\n<\/ul>\n<h3>\u4f9d\u8d56\u5173\u7cfb\u5206\u6790<\/h3>\n<ul>\n<li>\n<p>\u7ec4\u4ef6\u8026\u5408<\/p>\n<ul>\n<li>\u8def\u7531\u6a21\u5757\u4f9d\u8d56\u8bf7\u6c42\/\u54cd\u5e94\u6a21\u578b\u4e0e\u670d\u52a1\u5c42\uff1b\u670d\u52a1\u5c42\u4f9d\u8d56\u526a\u6620\u63a7\u5236\u5668\u8fdb\u884c\u5e95\u5c42\u64cd\u4f5c<\/li>\n<li>\u6587\u6863\u7cfb\u7edf\u4e0e\u8def\u7531\u6a21\u5757\u76f8\u4e92\u72ec\u7acb\uff0c\u901a\u8fc7\u63a5\u53e3\u5b9a\u4e49\u8fdb\u884c\u5173\u8054<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u5916\u90e8\u4f9d\u8d56<\/p>\n<ul>\n<li>FastAPI \u63d0\u4f9b\u8def\u7531\u4e0e\u8bf7\u6c42\/\u54cd\u5e94\u6a21\u578b\u6821\u9a8c\uff1b\u526a\u6620\u63a7\u5236\u5668\u8d1f\u8d23\u7a97\u53e3\u4e0e\u7d20\u6750\u4ea4\u4e92<\/li>\n<li>\u6587\u6863\u7cfb\u7edf\u4f9d\u8d56 Markdown \u6e32\u67d3\u548c\u9759\u6001\u6587\u4ef6\u670d\u52a1<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u5faa\u73af\u4f9d\u8d56<\/p>\n<ul>\n<li>\u9879\u76ee\u7ed3\u6784\u6e05\u6670\uff0c\u672a\u53d1\u73b0\u5faa\u73af\u4f9d\u8d56\u8ff9\u8c61<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<pre style=\"display:none;\"><code class=\"mermaid\">graph LR\nV1[&quot;v1 \u8def\u7531&lt;br\/&gt;src\/router\/v1.py&quot;] --&gt; Schemas[&quot;\u8bf7\u6c42\/\u54cd\u5e94\u6a21\u578b&lt;br\/&gt;src\/schemas\/*.py&quot;]\nV1 --&gt; Service[&quot;\u670d\u52a1\u5c42&lt;br\/&gt;service.*&quot;]\nService --&gt; Jianying[&quot;\u526a\u6620\u63a7\u5236\u5668&lt;br\/&gt;JianyingController&quot;]\nDocs[&quot;\u63a5\u53e3\u6587\u6863&lt;br\/&gt;Markdown \/ OpenAPI&quot;] --&gt; V1<\/code><\/pre>\n<h3>\u6027\u80fd\u8003\u8651<\/h3>\n<ul>\n<li>\n<p>\u8bf7\u6c42\u6279\u91cf\u5316<\/p>\n<ul>\n<li>\u6279\u91cf\u6dfb\u52a0\u89c6\u9891\/\u97f3\u9891\/\u56fe\u7247\/\u5b57\u5e55\u53ef\u51cf\u5c11\u5f80\u8fd4\u6b21\u6570\uff0c\u63d0\u5347\u6574\u4f53\u6548\u7387<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u65f6\u95f4\u7ebf\u8ba1\u7b97<\/p>\n<ul>\n<li>\u4f7f\u7528\u65f6\u95f4\u7ebf\u5de5\u5177\u63d0\u524d\u89c4\u5212\u7d20\u6750\u5206\u5e03\uff0c\u907f\u514d\u8fd0\u884c\u65f6\u52a8\u6001\u8ba1\u7b97\u5e26\u6765\u7684\u5ef6\u8fdf<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u8d44\u6e90\u590d\u7528<\/p>\n<ul>\n<li>\u5408\u7406\u8bbe\u7f6e\u900f\u660e\u5ea6\u4e0e\u7f29\u653e\u6bd4\u4f8b\uff0c\u51cf\u5c11\u4e0d\u5fc5\u8981\u7684\u6e32\u67d3\u5f00\u9500<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u5f02\u6b65\u6e32\u67d3<\/p>\n<ul>\n<li>\u89c6\u9891\u751f\u6210\u91c7\u7528\u5f02\u6b65\u4efb\u52a1\uff0c\u5efa\u8bae\u4f7f\u7528\u67e5\u8be2\u72b6\u6001\u63a5\u53e3\u8f6e\u8be2\u8fdb\u5ea6<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h3>\u6545\u969c\u6392\u9664\u6307\u5357<\/h3>\n<ul>\n<li>\n<p>\u65e0\u6cd5\u8fde\u63a5\u526a\u6620<\/p>\n<ul>\n<li>\u786e\u8ba4\u526a\u6620\u5df2\u5b89\u88c5\u5e76\u53ef\u88ab\u7cfb\u7edf\u8bc6\u522b\uff1b\u68c0\u67e5\u7a97\u53e3\u6fc0\u6d3b\u903b\u8f91\u662f\u5426\u6210\u529f<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u53c2\u6570\u6821\u9a8c\u5931\u8d25<\/p>\n<ul>\n<li>\u68c0\u67e5\u5b57\u6bb5\u7c7b\u578b\u3001\u8303\u56f4\u4e0e\u5fc5\u586b\u9879\uff1b\u53c2\u8003\u6a21\u578b\u5b9a\u4e49\u4fee\u6b63\u8bf7\u6c42<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>API \u5bc6\u94a5\u683c\u5f0f\u9519\u8bef<\/p>\n<ul>\n<li>\u786e\u4fdd apiKey \u4e3a\u5408\u6cd5 UUID \u683c\u5f0f\uff0c\u5426\u5219\u5c06\u89e6\u53d1\u6821\u9a8c\u9519\u8bef<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>\u54cd\u5e94\u5f02\u5e38<\/p>\n<ul>\n<li>\u67e5\u770b\u7edf\u4e00\u54cd\u5e94\u4e2d\u95f4\u4ef6\u65e5\u5fd7\uff0c\u5b9a\u4f4d\u670d\u52a1\u5c42\u5f02\u5e38\u539f\u56e0<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h3>\u5c0f\u7ed3<\/h3>\n<p>\u63a5\u53e3\u8986\u76d6\u4ece\u8349\u7a3f\u521b\u5efa\u3001\u7d20\u6750\u4e0e\u6548\u679c\u7f16\u8f91\u5230\u6e32\u67d3\u4e0e\u8f85\u52a9\u5de5\u5177\u3002\u5b57\u6bb5\u3001\u793a\u4f8b\u4e0e\u9519\u8bef\u7801\u4ee5 OpenAPI \u4e3a\u51c6\uff1b\u96c6\u6210\u65f6\u5efa\u8bae\u5148\u8dd1\u901a create_draft \u518d\u94fe\u5f0f\u8c03\u7528\u5176\u4ed6\u63a5\u53e3\u3002<\/p>\n<p><a href=\"https:\/\/segmentfault.com\/a\/1190000047734509\">https:\/\/segmentfault.com\/a\/1190000047734509<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>API \u63a5\u53e3\u6587\u6863 \u76ee\u5f55 \u7b80\u4ecb \u9879\u76ee\u7ed3\u6784 \u6838\u5fc3\u7ec4\u4ef6 \u67b6\u6784\u6982\u89c8 \u8be6\u7ec6\u7ec4\u4ef6\u5206\u6790 \u53cc\u8bed\u6587\u6863 \u4f9d\u8d56\u5173\u7cfb\u5206\u6790 \u6027\u80fd\u8003\u8651 \u6545 [&hellip;]<\/p>\n","protected":false},"author":4,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[4],"tags":[],"class_list":["post-10021353","post","type-post","status-publish","format-standard","hentry","category-share"],"jetpack_sharing_enabled":true,"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/itmax.cn\/index.php?rest_route=\/wp\/v2\/posts\/10021353","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/itmax.cn\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/itmax.cn\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/itmax.cn\/index.php?rest_route=\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/itmax.cn\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=10021353"}],"version-history":[{"count":0,"href":"https:\/\/itmax.cn\/index.php?rest_route=\/wp\/v2\/posts\/10021353\/revisions"}],"wp:attachment":[{"href":"https:\/\/itmax.cn\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=10021353"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/itmax.cn\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=10021353"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/itmax.cn\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=10021353"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}