From e368607bce8610426d50467005d865cdb99aa19b Mon Sep 17 00:00:00 2001 From: Daxiong Date: Mon, 26 Oct 2026 11:02:36 +0800 Subject: [PATCH] i18n: sync zh/ja/ko translations with upstream/main (2026-10-26) Sync the localized pages that fell behind the cloud catalog sync: - limitations / models: drop the retired meshy/meshy-5 entry - luma uni-1 and uni-1-max: add the exr_export unavailability note - bria image-edit-relight: mark light_direction as required - remove the orphaned meshy-5 localized pages, their nav entries, and add localized redirects - refresh translation hashes for sdks, cloud api-reference and ray-3-2 --- docs.json | 15 +- ja/development/api-development/sdks.mdx | 4 +- ja/development/cloud/api-reference.mdx | 4 +- ja/development/comfy-router/limitations.mdx | 6 +- ja/development/comfy-router/models.mdx | 10 +- .../models/bria/image-edit-relight/code.mdx | 6 +- .../models/luma_2/ray-3-2/code.mdx | 4 +- .../models/luma_2/uni-1-max/code.mdx | 6 +- .../comfy-router/models/luma_2/uni-1/code.mdx | 6 +- .../models/meshy/meshy-5/code.mdx | 431 ------------------ ko/development/api-development/sdks.mdx | 4 +- ko/development/cloud/api-reference.mdx | 4 +- ko/development/comfy-router/limitations.mdx | 6 +- ko/development/comfy-router/models.mdx | 10 +- .../models/bria/image-edit-relight/code.mdx | 6 +- .../models/luma_2/ray-3-2/code.mdx | 4 +- .../models/luma_2/uni-1-max/code.mdx | 6 +- .../comfy-router/models/luma_2/uni-1/code.mdx | 6 +- .../models/meshy/meshy-5/code.mdx | 431 ------------------ zh/development/api-development/sdks.mdx | 4 +- zh/development/cloud/api-reference.mdx | 4 +- zh/development/comfy-router/limitations.mdx | 6 +- zh/development/comfy-router/models.mdx | 10 +- .../models/bria/image-edit-relight/code.mdx | 6 +- .../models/luma_2/ray-3-2/code.mdx | 4 +- .../models/luma_2/uni-1-max/code.mdx | 6 +- .../comfy-router/models/luma_2/uni-1/code.mdx | 6 +- .../models/meshy/meshy-5/code.mdx | 431 ------------------ 28 files changed, 78 insertions(+), 1368 deletions(-) delete mode 100644 ja/development/comfy-router/models/meshy/meshy-5/code.mdx delete mode 100644 ko/development/comfy-router/models/meshy/meshy-5/code.mdx delete mode 100644 zh/development/comfy-router/models/meshy/meshy-5/code.mdx diff --git a/docs.json b/docs.json index b7d31d715a..b675c69242 100644 --- a/docs.json +++ b/docs.json @@ -7707,7 +7707,6 @@ "group": "Meshy", "pages": [ "zh/development/comfy-router/models/meshy/animations/code", - "zh/development/comfy-router/models/meshy/meshy-5/code", "zh/development/comfy-router/models/meshy/meshy-6/code", "zh/development/comfy-router/models/meshy/meshy-7-1/code", "zh/development/comfy-router/models/meshy/meshy-7/code", @@ -11768,7 +11767,6 @@ "group": "Meshy", "pages": [ "ja/development/comfy-router/models/meshy/animations/code", - "ja/development/comfy-router/models/meshy/meshy-5/code", "ja/development/comfy-router/models/meshy/meshy-6/code", "ja/development/comfy-router/models/meshy/meshy-7-1/code", "ja/development/comfy-router/models/meshy/meshy-7/code", @@ -15759,7 +15757,6 @@ "group": "Meshy", "pages": [ "ko/development/comfy-router/models/meshy/animations/code", - "ko/development/comfy-router/models/meshy/meshy-5/code", "ko/development/comfy-router/models/meshy/meshy-6/code", "ko/development/comfy-router/models/meshy/meshy-7-1/code", "ko/development/comfy-router/models/meshy/meshy-7/code", @@ -20129,6 +20126,18 @@ { "source": "/development/comfy-router/models/meshy/meshy-5/code", "destination": "/development/comfy-router/models" + }, + { + "source": "/zh/development/comfy-router/models/meshy/meshy-5/code", + "destination": "/zh/development/comfy-router/models" + }, + { + "source": "/ja/development/comfy-router/models/meshy/meshy-5/code", + "destination": "/ja/development/comfy-router/models" + }, + { + "source": "/ko/development/comfy-router/models/meshy/meshy-5/code", + "destination": "/ko/development/comfy-router/models" } ], "search": { diff --git a/ja/development/api-development/sdks.mdx b/ja/development/api-development/sdks.mdx index 299df75116..b6f364c6d8 100644 --- a/ja/development/api-development/sdks.mdx +++ b/ja/development/api-development/sdks.mdx @@ -3,13 +3,13 @@ title: "Comfy SDK:ComfyUI 向け Python・TypeScript クライアント" description: "Comfy Cloud、デプロイ環境、または自前の ComfyUI に対して Python または TypeScript から ComfyUI ワークフローを実行し、アセット、ジョブ、ライブイベント、冪等なリトライを扱います。" sidebarTitle: "SDK" icon: "code" -translationSourceHash: dbb2e0a8 +translationSourceHash: fd912955 translationFrom: development/api-development/sdks.mdx translationBlockHashes: "_intro": c92c7b51 "Install": da9a0a57 "Quickstart": 02297586 - "Choosing a base URL": 2265e6f6 + "Choosing a base URL": 0e77e81c "Retrying a submit: the idempotency key": 7c83d78f "Watching a job run": 34d74bcc "Tracing an output back to its workflow": b01886a3 diff --git a/ja/development/cloud/api-reference.mdx b/ja/development/cloud/api-reference.mdx index 581b1859e6..4f91838de5 100644 --- a/ja/development/cloud/api-reference.mdx +++ b/ja/development/cloud/api-reference.mdx @@ -2,14 +2,14 @@ title: "Cloud API リファレンス" description: "Comfy Cloud の完全な API リファレンスとコード例" icon: "book-open" -translationSourceHash: 9dfb0617 +translationSourceHash: e15f0e0e translationFrom: development/cloud/api-reference.mdx translationBlockHashes: "_intro": 1729f5d3 "Setup": 311034bb "Object Info": 7b62a397 "Uploading Inputs": 92df17f8 - "Running Workflows": d6ddd0b4 + "Running Workflows": 2c6519c7 "Checking Job Status": d74b4922 "WebSocket for Real-Time Progress": 02c49b4a "Downloading Outputs": 5e1d63d3 diff --git a/ja/development/comfy-router/limitations.mdx b/ja/development/comfy-router/limitations.mdx index e648888164..e9d5106764 100644 --- a/ja/development/comfy-router/limitations.mdx +++ b/ja/development/comfy-router/limitations.mdx @@ -2,7 +2,7 @@ title: "Comfy Router の機能と制限" sidebarTitle: "機能と制限" description: "Comfy Router とパートナープロキシのどちらを選ぶか、長時間実行される呼び出しへの備え、リカバリ・レート制限・アセット保存について説明します。" -translationSourceHash: b40af72c +translationSourceHash: 2526e5db translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 @@ -14,7 +14,7 @@ translationBlockHashes: "Requests are rate limited per caller": 249d4d51 "No progress while a call runs": 75d42d8d "Comfy charges and usage": ed49ddec - "Models without a pre-flight estimate": 7373adf0 + "Models without a pre-flight estimate": 488081d1 "Router does not cover every partner operation": 97d31362 "Model outputs and stored assets": 06c737c1 "Next": be85b789 @@ -123,7 +123,7 @@ Router は、以下のモデルへの呼び出しを実行前に確実に価格 - **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4`, `ideogram/p-image-ideogram` - **kling**: `kling/kling-3.0-turbo`, `kling/kling-image-o1`, `kling/kling-v2-5-turbo`, `kling/kling-v2-6`, `kling/kling-v3`, `kling/kling-v3-omni`, `kling/kling-video-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync`, `kling/videos-video-extend` - **luma**: `luma/photon-1`, `luma/photon-flash-1`, `luma/ray-2`, `luma/ray-flash-2` -- **meshy**: `meshy/animations`, `meshy/meshy-5`, `meshy/meshy-6`, `meshy/meshy-7`, `meshy/meshy-7.1`, `meshy/remesh`, `meshy/rigging` +- **meshy**: `meshy/animations`, `meshy/meshy-6`, `meshy/meshy-7`, `meshy/meshy-7.1`, `meshy/remesh`, `meshy/rigging` - **moonvalley**: `moonvalley/image-to-video`, `moonvalley/text-to-video`, `moonvalley/video-to-video` - **openrouter**: `openrouter/chat-completions` - **pika**: `pika/pika-gpt-image-2`, `pika/pika-nano-banana-2`, `pika/pika-nano-banana-pro` diff --git a/ja/development/comfy-router/models.mdx b/ja/development/comfy-router/models.mdx index dbd466010f..8de7a9a8a5 100644 --- a/ja/development/comfy-router/models.mdx +++ b/ja/development/comfy-router/models.mdx @@ -2,11 +2,11 @@ title: "Comfy Router モデル" sidebarTitle: "すべてのモデル" description: "Comfy Router で利用できるすべてのモデルを、各モデルの入力と出力のモダリティとあわせて、プロバイダー別にまとめています。" -translationSourceHash: f12be9e4 +translationSourceHash: e62265b5 translationFrom: development/comfy-router/models.mdx translationBlockHashes: "_intro": 2584e428 - "Find by output": 380e121d + "Find by output": 9c4c92ac "Anthropic": de8acc20 "Beeble": b52ea340 "Black Forest Labs": 2934e3eb @@ -25,7 +25,7 @@ translationBlockHashes: "LTX": 32595bf9 "Luma": 37a12a19 "Luma 2": 585eb637 - "Meshy": 9292a0a8 + "Meshy": 67e26a17 "MiniMax": 87560ab7 "Moonvalley": 9e63fb77 "OpenAI": c5c4af80 @@ -276,10 +276,9 @@ translationBlockHashes: - [Wan 3.0 Video](/ja/development/comfy-router/models/wan/wan3-0-video/code): `wan/wan3.0-video` - + - [Animations](/ja/development/comfy-router/models/meshy/animations/code): `meshy/animations` -- [Meshy 5](/ja/development/comfy-router/models/meshy/meshy-5/code): `meshy/meshy-5` - [Meshy 6](/ja/development/comfy-router/models/meshy/meshy-6/code): `meshy/meshy-6` - [Meshy 7.1](/ja/development/comfy-router/models/meshy/meshy-7-1/code): `meshy/meshy-7.1` - [Meshy 7](/ja/development/comfy-router/models/meshy/meshy-7/code): `meshy/meshy-7` @@ -560,7 +559,6 @@ translationBlockHashes: | モデル | ID | 入力 | 出力 | | --- | --- | --- | --- | | [Animations](/ja/development/comfy-router/models/meshy/animations/code) | `meshy/animations` | 3D | 3D | -| [Meshy 5](/ja/development/comfy-router/models/meshy/meshy-5/code) | `meshy/meshy-5` | テキスト | 3D | | [Meshy 6](/ja/development/comfy-router/models/meshy/meshy-6/code) | `meshy/meshy-6` | テキスト | 3D | | [Meshy 7.1](/ja/development/comfy-router/models/meshy/meshy-7-1/code) | `meshy/meshy-7.1` | テキスト | 3D | | [Meshy 7](/ja/development/comfy-router/models/meshy/meshy-7/code) | `meshy/meshy-7` | テキスト | 3D | diff --git a/ja/development/comfy-router/models/bria/image-edit-relight/code.mdx b/ja/development/comfy-router/models/bria/image-edit-relight/code.mdx index eb8f4553bd..5b9badd199 100644 --- a/ja/development/comfy-router/models/bria/image-edit-relight/code.mdx +++ b/ja/development/comfy-router/models/bria/image-edit-relight/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で Image Edit Relight を使う" description: "Comfy Router 経由で bria/image-edit-relight を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Image Edit Relight" -translationSourceHash: 63b5bcef +translationSourceHash: 620fcec7 translationFrom: development/comfy-router/models/bria/image-edit-relight/code.mdx translationBlockHashes: "_intro": cc88af3e "Quick start": 4329dd4b - "Schema": fb8fdff1 + "Schema": 8f45e738 "Examples": f04b0762 --- @@ -160,7 +160,7 @@ curl https://api.comfy.org/v2/models/bria/image-edit-relight/requests/$REQUEST_I 編集する画像。対応する入力タイプは、Base64 エンコードされた文字列、または公開アクセス可能な画像ファイルを指す URL です。対応フォーマットは JPEG、JPG、PNG、WEBP です。 - + ライトの方向。"front"、"side"、"bottom"、"top-down" のいずれか。 diff --git a/ja/development/comfy-router/models/luma_2/ray-3-2/code.mdx b/ja/development/comfy-router/models/luma_2/ray-3-2/code.mdx index dcc8b66bca..afe060e5c0 100644 --- a/ja/development/comfy-router/models/luma_2/ray-3-2/code.mdx +++ b/ja/development/comfy-router/models/luma_2/ray-3-2/code.mdx @@ -2,12 +2,12 @@ title: "Ray 3.2 を Comfy Router で使用する" description: "Comfy Router 経由で luma_2/ray-3.2 を呼び出します。エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Ray 3.2" -translationSourceHash: a796913b +translationSourceHash: 86ca3c26 translationFrom: development/comfy-router/models/luma_2/ray-3-2/code.mdx translationBlockHashes: "_intro": 3348ca65 "Quick start": ad992b88 - "Schema": 50c63e36 + "Schema": 0c4fe0bc "Examples": fdb0ab6e --- {/* 生成済みファイル。router-schemas/luma_2/ray-3.2.json から `pnpm code-pages:gen` によって生成されています。 */} diff --git a/ja/development/comfy-router/models/luma_2/uni-1-max/code.mdx b/ja/development/comfy-router/models/luma_2/uni-1-max/code.mdx index 50ec416839..0f14cfcff8 100644 --- a/ja/development/comfy-router/models/luma_2/uni-1-max/code.mdx +++ b/ja/development/comfy-router/models/luma_2/uni-1-max/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で Uni 1 Max を使う" description: "Comfy Router 経由で luma_2/uni-1-max を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Uni 1 Max" -translationSourceHash: 90d7c51e +translationSourceHash: e88275ff translationFrom: development/comfy-router/models/luma_2/uni-1-max/code.mdx translationBlockHashes: "_intro": 86e0cfe7 "Quick start": dfff1d3d - "Schema": 4916d345 + "Schema": d7d29898 "Examples": f813a867 --- @@ -255,7 +255,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - MP4 と併せて EXR ファイルをエクスポートします。hdr が true である必要があります。video_reframe では拒否されます。 + まだ利用できません:Luma が EXR 配信を提供するまで、`exr_export=true` のリクエストは 400 で拒否されます。将来は MP4 と一緒に EXR ファイルをエクスポートします(hdr が true である必要があります)。video_reframe では拒否されます。 diff --git a/ja/development/comfy-router/models/luma_2/uni-1/code.mdx b/ja/development/comfy-router/models/luma_2/uni-1/code.mdx index 09cb926f29..42b3a2687b 100644 --- a/ja/development/comfy-router/models/luma_2/uni-1/code.mdx +++ b/ja/development/comfy-router/models/luma_2/uni-1/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router で Uni 1 を使用する" description: "Comfy Router 経由で luma_2/uni-1 を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Uni 1" -translationSourceHash: 5f33116a +translationSourceHash: 897d09ee translationFrom: development/comfy-router/models/luma_2/uni-1/code.mdx translationBlockHashes: "_intro": a9aaf4ab "Quick start": 9d667b90 - "Schema": 6ccb738a + "Schema": fe7e100f "Examples": f993c215 --- @@ -255,7 +255,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - MP4 と併せて EXR ファイルをエクスポートします。hdr が true である必要があります。video_reframe では拒否されます。 + まだ利用できません:Luma が EXR 配信を提供するまで、`exr_export=true` のリクエストは 400 で拒否されます。将来は MP4 と一緒に EXR ファイルをエクスポートします(hdr が true である必要があります)。video_reframe では拒否されます。 diff --git a/ja/development/comfy-router/models/meshy/meshy-5/code.mdx b/ja/development/comfy-router/models/meshy/meshy-5/code.mdx deleted file mode 100644 index 795185b988..0000000000 --- a/ja/development/comfy-router/models/meshy/meshy-5/code.mdx +++ /dev/null @@ -1,431 +0,0 @@ ---- -title: "Comfy Router で Meshy 5 を使用する" -description: "Comfy Router 経由で meshy/meshy-5 を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。" -sidebarTitle: "Meshy 5" -translationSourceHash: 7f6f26e7 -translationFrom: development/comfy-router/models/meshy/meshy-5/code.mdx -translationBlockHashes: - "_intro": 237f6506 - "Quick start": 7bc21724 - "Schema": 8d7621e1 - "Examples": e2bc6209 ---- - - - -{/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/meshy/meshy-5.json から生成されています。 */} - -import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; - -`meshy/meshy-5` の API リファレンスです。Comfy Router が Meshy から提供しています。 - -**入力:** テキスト · **出力:** 3D - -## クイックスタート - -[お使いの Comfy ワークスペース](https://platform.comfy.org/profile/api-keys?onboarding=router)でキーを作成し、`COMFY_API_KEY` としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(`pip install comfy-sdk` および `npm install @comfyorg/sdk`)を使用しています。cURL のスニペットは同じ呼び出しを raw HTTP 経由で行うものです。 - -**モデル ID:** `meshy/meshy-5` - -**エンドポイント:** `POST https://api.comfy.org/v2/models/meshy/meshy-5` - - - - -```python Python -from comfy_sdk import Comfy - -# 環境変数から COMFY_API_KEY を読み取ります。 -# SDK は自動的に冪等キーを作成し、自動リトライ時に再利用します。 -with Comfy() as client: - result = client.models.run( - "meshy/meshy-5", - { - "art_style": "realistic", - "mode": "preview", - "prompt": "a red cube", - }, - ) - -print(result) -``` - -```typescript TypeScript -import { comfy } from "@comfyorg/sdk"; - -// 環境変数から COMFY_API_KEY を読み取ります。 -// SDK は自動的に冪等キーを作成し、自動リトライ時に再利用します。 -const { data } = await comfy.models.run("meshy/meshy-5", { - art_style: "realistic", - mode: "preview", - prompt: "a red cube", -}); - -console.log(data); -``` - -```bash cURL -curl https://api.comfy.org/v2/models/meshy/meshy-5 \ - -H "X-API-Key: $COMFY_API_KEY" \ - -H "Idempotency-Key: $(uuidgen)" \ - -H "Content-Type: application/json" \ - -d "{\"art_style\": \"realistic\", \"mode\": \"preview\", \"prompt\": \"a red cube\"}" -``` - - - -同じボディを `POST https://api.comfy.org/v2/models/meshy/meshy-5/requests` に送信します。Router は実行が受け付けられ次第 `201` と `request_id` を返し、結果は準備が整った時点で、このプロセスからでも別のプロセスからでも取得できます。[キュー配信](/ja/development/comfy-router/queue)では、ステータス、キャンセル、取得の流れを説明しています。 - - -```python Python -import asyncio -from comfy_sdk import AsyncComfy - -# 環境変数から COMFY_API_KEY を読み取ります。 -# submit() の呼び出しごとに独自の Idempotency-Key を発行し、自動リトライ時に再利用します。 -async def main(): - async with AsyncComfy() as client: - handle = await client.models.submit( - "meshy/meshy-5", - { - "art_style": "realistic", - "mode": "preview", - "prompt": "a red cube", - }, - ) - print("request_id:", handle.request_id) # モデル ID と合わせて、別のプロセスが必要とする情報はこれだけです - - # リクエストが完了するまでポーリングし、サーバーが指定する Retry-After の分だけ待機します。 - async for update in handle.iter_events(): - print(update.status, update.queue_position) - - # プロバイダー自身のペイロードで、models.run() が返すのと同じ値です。 - # 失敗またはキャンセルされたリクエストは、ここで型付きの Router エラーを発生させます。 - result = await handle.get() - - print(result) - -asyncio.run(main()) -``` - -```typescript TypeScript -import { comfy } from "@comfyorg/sdk"; - -// 環境変数から COMFY_API_KEY を読み取ります。 -// submit() の呼び出しごとに独自の Idempotency-Key を発行し、自動リトライ時に再利用します。 -const handle = await comfy.models.submit("meshy/meshy-5", { - art_style: "realistic", - mode: "preview", - prompt: "a red cube", -}); -console.log("requestId:", handle.requestId); // モデル ID と合わせて、別のプロセスが必要とする情報はこれだけです - -// リクエストが完了するまでポーリングし、サーバーが指定する Retry-After の分だけ待機します。 -for await (const update of handle.events()) { - console.log(update.status, update.queuePosition); -} - -// models.run() が返すのと同じ結果です。失敗またはキャンセルされたリクエストは、ここで reject されます。 -const result = await handle.get(); - -console.log(result.data); -``` - -```bash cURL -# 1. 送信。Router は request_id、status_url、response_url、cancel_url を含む 201 を返します。 -curl https://api.comfy.org/v2/models/meshy/meshy-5/requests \ - -H "X-API-Key: $COMFY_API_KEY" \ - -H "Idempotency-Key: $(uuidgen)" \ - -H "Content-Type: application/json" \ - -d "{\"art_style\": \"realistic\", \"mode\": \"preview\", \"prompt\": \"a red cube\"}" - -# 2. ステータスが COMPLETED になるまでポーリングし、各レスポンスが指定する Retry-After 秒だけ待機します。 -REQUEST_ID="" -curl -i https://api.comfy.org/v2/models/meshy/meshy-5/requests/$REQUEST_ID/status \ - -H "X-API-Key: $COMFY_API_KEY" - -# 3. 取得。モデルのネイティブ出力と共に 200、まだ実行中はステータスボディと共に 202 を返します。 -curl https://api.comfy.org/v2/models/meshy/meshy-5/requests/$REQUEST_ID \ - -H "X-API-Key: $COMFY_API_KEY" -``` - - - - -## スキーマ - -### 入力 - -#### `preview` バリアント - - - 実行する Meshy モデル。Comfy Router ルートではパス(`/v2/models/meshy/{model}`)から指定され、省略するか null として送信できます。Router は検証後にパスのモデルをここへ書き込みます。v1 /proxy ルートでは MeshyTextTo3DPreviewRequest を参照してください。これはこの値を MeshyAiModel に制約します。 - - - - オブジェクトの希望するアートスタイルを記述します。 - - 指定可能な値: `realistic`、`sculpture` - - - - 生成されるメッシュのジオメトリ解像度。2k と 4k は、より細かい表面ディテールのために Ultra パスを実行します。2k と 4k には ai_model meshy-7.1 または latest が必要です。 - - 指定可能な値: `standard`、`2k`、`4k` - - - - 非推奨。代わりに pose_mode を使用してください。モデルを A/T ポーズで生成するかどうか。 - - - - プレビュータスクを作成する場合は、このフィールドを "preview" に設定してください。 - - 指定可能な値: `preview` - - - - true の場合、入力コンテンツは有害な可能性のあるコンテンツについてスクリーニングされます。 - - - - 生成されるモデルのポーズモードを指定します。 - - 指定可能な値: `a-pose`、`t-pose`、`` - - - - 3Dモデルがどのようなオブジェクトであるかを記述します。最大800文字。 - - - - remesh フェーズを有効にするかどうかを制御します。false の場合、最高精度の三角形メッシュを返します。Meshy 5 では true、Meshy 6 と 7 では false が既定です。 - - - - モデル生成中の対称性の挙動を制御します。 - - 指定可能な値: `off`、`auto`、`on` - - - - 生成されるモデルのポリゴン数の目標値を指定します。有効範囲は 100 から 300,000 です。 - - 範囲: `100` ~ `300000` - - - - 生成されるモデルのトポロジーを指定します。 - - 指定可能な値: `quad`、`triangle` - - - - 非推奨。代わりに geometry_resolution を使用してください。true は geometry_resolution 2k と同等です。ai_model が meshy-7、meshy-7.1 または latest の場合にのみサポートされます。例外は meshy-7 です。geometry_resolution 2k には meshy-7.1 または latest が必要なため、meshy-7 では ultra_mode の true が Ultra パスを要求する方法となります。 - - -#### `refine` バリアント - - - 実行する Meshy モデル。Comfy Router ルートではパス(`/v2/models/meshy/{model}`)から指定され、省略するか null として送信できます。Router は検証後にパスのモデルをここへ書き込みます。v1 /proxy ルートでは MeshyTextTo3DRefineRequest を参照してください。これはこの値を MeshyAiModel に制約します。 - - - - ベースカラーに加えて PBR マップ(metallic、roughness、normal)を生成します。Sculpture スタイルを使用する場合は enable_pbr を false に設定する必要があることに注意してください。 - - - - リファインタスクを作成する場合は、このフィールドを "refine" に設定してください。 - - 指定可能な値: `refine` - - - - true の場合、入力コンテンツは有害な可能性のあるコンテンツについてスクリーニングされます。 - - - - 対応するプレビュータスクの ID。指定したプレビュータスクのステータスが SUCCEEDED である必要があります。 - - - - テクスチャリング処理をガイドするための 2D 画像を提供します。.jpg、.jpeg、.png 形式、または base64 エンコードされたデータ URI をサポートします。 - - - - テクスチャリング処理をガイドするための追加のテキストプロンプトを提供します。最大800文字。 - - - - 生成されるテクスチャのテクスチャ解像度。2k、4k、8k のいずれかです。4k と 8k には ai_model meshy-6、meshy-7、meshy-7.1 または latest が必要です。 - - 指定可能な値: `2k`、`4k`、`8k` - - -Router が `GET /v2/models/meshy/meshy-5/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用する同一のドキュメントです。 - -### 出力 - - - プレビュータスクの作成に使用された、変更されていない art_style。 - - - - タスクが作成された日時のタイムスタンプ(ミリ秒単位)。 - - 形式: `int64` - - - - タスクが完了した日時のタイムスタンプ(ミリ秒単位)。完了していない場合は 0。 - - 形式: `int64` - - - - タスクの一意の識別子。 - - - - Meshy によって生成されたテクスチャ付き 3Dモデルファイルのダウンロード URL。 - - - - FBX ファイルのダウンロード URL。 - - - - GLB ファイルのダウンロード URL。 - - - - MTL ファイルのダウンロード URL。 - - - - OBJ ファイルのダウンロード URL。 - - - - USDZ ファイルのダウンロード URL。 - - - - 後方互換性のために維持されている非推奨のフィールド。 - - - - 先行するタスクの数。status が PENDING の場合にのみ意味を持ちます。 - - - - タスクの進捗。開始されていない場合は 0、成功した場合は 100。 - - 範囲: `0` から `100` - - - - タスクの作成に使用された、変更されていない prompt。 - - - - タスクが開始された日時のタイムスタンプ(ミリ秒単位)。開始されていない場合は 0。 - - 形式: `int64` - - - - 取り得る値: `SUCCEEDED` - - - - タスクが失敗した場合にエラーメッセージを含むエラーオブジェクト。 - - - - 詳細なエラーメッセージ。 - - - - テクスチャリング処理のガイドに使用されたテクスチャ画像のダウンロード URL。 - - - - refine ステージ中にテクスチャリング処理をガイドするために提供される追加のテキストプロンプト。 - - - - 後方互換性のために維持されている非推奨のフィールド。 - - - - タスクから生成されるテクスチャ URL オブジェクトの配列。 - - - - ベースカラーマップ画像のダウンロード URL。 - - - - メタリックマップ画像のダウンロード URL。 - - - - ノーマルマップ画像のダウンロード URL。 - - - - ラフネスマップ画像のダウンロード URL。 - - - - モデルファイルのサムネイル画像のダウンロード URL。 - - - - Text to 3D タスクの種類。 - - 取り得る値: `text-to-3d-preview`、`text-to-3d-refine` - - - - プレビュービデオのダウンロード URL を返す非推奨のフィールド。 - - -## 例 - -### 入力 - -```json -{ - "art_style": "realistic", - "mode": "preview", - "prompt": "a red cube" -} -``` - -### 出力 - -```json -{ - "art_style": "realistic", - "created_at": 1767225600000, - "finished_at": 1767225719000, - "id": "018f2c7a-4b1e-7c3d-9a05-6e2f8b41d0c9", - "model_urls": { - "fbx": "https://example.invalid/meshy/text-to-3d/model.fbx", - "glb": "https://example.invalid/meshy/text-to-3d/model.glb", - "mtl": "https://example.invalid/meshy/text-to-3d/model.mtl", - "obj": "https://example.invalid/meshy/text-to-3d/model.obj", - "usdz": "https://example.invalid/meshy/text-to-3d/model.usdz" - }, - "progress": 100, - "prompt": "a red cube", - "started_at": 1767225601000, - "status": "SUCCEEDED", - "thumbnail_url": "https://example.invalid/meshy/text-to-3d/thumbnail.png", - "type": "text-to-3d-preview" -} -``` - - diff --git a/ko/development/api-development/sdks.mdx b/ko/development/api-development/sdks.mdx index 8beead1205..aa7cef9182 100644 --- a/ko/development/api-development/sdks.mdx +++ b/ko/development/api-development/sdks.mdx @@ -3,13 +3,13 @@ title: "Comfy SDK: ComfyUI용 Python 및 TypeScript 클라이언트" description: "Python 또는 TypeScript로 Comfy Cloud, 자체 배포 또는 자체 ComfyUI를 대상으로 ComfyUI 워크플로를 실행하고, 에셋, 작업, 라이브 이벤트, 멱등 재시도를 다룹니다." sidebarTitle: "SDK" icon: "code" -translationSourceHash: dbb2e0a8 +translationSourceHash: fd912955 translationFrom: development/api-development/sdks.mdx translationBlockHashes: "_intro": c92c7b51 "Install": da9a0a57 "Quickstart": 02297586 - "Choosing a base URL": 2265e6f6 + "Choosing a base URL": 0e77e81c "Retrying a submit: the idempotency key": 7c83d78f "Watching a job run": 34d74bcc "Tracing an output back to its workflow": b01886a3 diff --git a/ko/development/cloud/api-reference.mdx b/ko/development/cloud/api-reference.mdx index 6fd6da2bcf..e9737ff7d8 100644 --- a/ko/development/cloud/api-reference.mdx +++ b/ko/development/cloud/api-reference.mdx @@ -2,14 +2,14 @@ title: "클라우드 API 참조" description: "Comfy Cloud의 코드 예제와 함께 제공되는 완벽한 API 참조" icon: "book-open" -translationSourceHash: 9dfb0617 +translationSourceHash: e15f0e0e translationFrom: development/cloud/api-reference.mdx translationBlockHashes: "_intro": 1729f5d3 "Setup": 311034bb "Object Info": 7b62a397 "Uploading Inputs": 92df17f8 - "Running Workflows": d6ddd0b4 + "Running Workflows": 2c6519c7 "Checking Job Status": d74b4922 "WebSocket for Real-Time Progress": 02c49b4a "Downloading Outputs": 5e1d63d3 diff --git a/ko/development/comfy-router/limitations.mdx b/ko/development/comfy-router/limitations.mdx index fc6f5cb2bc..631c046b08 100644 --- a/ko/development/comfy-router/limitations.mdx +++ b/ko/development/comfy-router/limitations.mdx @@ -2,7 +2,7 @@ title: "Comfy Router 기능과 한계" sidebarTitle: "기능과 한계" description: "Comfy Router 또는 파트너 프록시 선택, 장시간 실행되는 호출 대비, 복구, 속도 제한 및 자산 저장에 대해 설명합니다." -translationSourceHash: b40af72c +translationSourceHash: 2526e5db translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 @@ -14,7 +14,7 @@ translationBlockHashes: "Requests are rate limited per caller": 249d4d51 "No progress while a call runs": 75d42d8d "Comfy charges and usage": ed49ddec - "Models without a pre-flight estimate": 7373adf0 + "Models without a pre-flight estimate": 488081d1 "Router does not cover every partner operation": 97d31362 "Model outputs and stored assets": 06c737c1 "Next": be85b789 @@ -123,7 +123,7 @@ Router는 아직 아래 모델에 대한 호출 비용을 실행 전에 안정 - **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4`, `ideogram/p-image-ideogram` - **kling**: `kling/kling-3.0-turbo`, `kling/kling-image-o1`, `kling/kling-v2-5-turbo`, `kling/kling-v2-6`, `kling/kling-v3`, `kling/kling-v3-omni`, `kling/kling-video-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync`, `kling/videos-video-extend` - **luma**: `luma/photon-1`, `luma/photon-flash-1`, `luma/ray-2`, `luma/ray-flash-2` -- **meshy**: `meshy/animations`, `meshy/meshy-5`, `meshy/meshy-6`, `meshy/meshy-7`, `meshy/meshy-7.1`, `meshy/remesh`, `meshy/rigging` +- **meshy**: `meshy/animations`, `meshy/meshy-6`, `meshy/meshy-7`, `meshy/meshy-7.1`, `meshy/remesh`, `meshy/rigging` - **moonvalley**: `moonvalley/image-to-video`, `moonvalley/text-to-video`, `moonvalley/video-to-video` - **openrouter**: `openrouter/chat-completions` - **pika**: `pika/pika-gpt-image-2`, `pika/pika-nano-banana-2`, `pika/pika-nano-banana-pro` diff --git a/ko/development/comfy-router/models.mdx b/ko/development/comfy-router/models.mdx index 4aa8f6b233..2a828f3ad3 100644 --- a/ko/development/comfy-router/models.mdx +++ b/ko/development/comfy-router/models.mdx @@ -2,11 +2,11 @@ title: "Comfy Router 모델" sidebarTitle: "모든 모델" description: "Comfy Router에서 사용할 수 있는 모든 모델을 제공자별로 정리하고, 각 모델의 입력 및 출력 모달리티를 함께 표시합니다." -translationSourceHash: f12be9e4 +translationSourceHash: e62265b5 translationFrom: development/comfy-router/models.mdx translationBlockHashes: "_intro": 2584e428 - "Find by output": 380e121d + "Find by output": 9c4c92ac "Anthropic": de8acc20 "Beeble": b52ea340 "Black Forest Labs": 2934e3eb @@ -25,7 +25,7 @@ translationBlockHashes: "LTX": 32595bf9 "Luma": 37a12a19 "Luma 2": 585eb637 - "Meshy": 9292a0a8 + "Meshy": 67e26a17 "MiniMax": 87560ab7 "Moonvalley": 9e63fb77 "OpenAI": c5c4af80 @@ -276,10 +276,9 @@ translationBlockHashes: - [Wan 3.0 Video](/ko/development/comfy-router/models/wan/wan3-0-video/code): `wan/wan3.0-video` - + - [Animations](/ko/development/comfy-router/models/meshy/animations/code): `meshy/animations` -- [Meshy 5](/ko/development/comfy-router/models/meshy/meshy-5/code): `meshy/meshy-5` - [Meshy 6](/ko/development/comfy-router/models/meshy/meshy-6/code): `meshy/meshy-6` - [Meshy 7.1](/ko/development/comfy-router/models/meshy/meshy-7-1/code): `meshy/meshy-7.1` - [Meshy 7](/ko/development/comfy-router/models/meshy/meshy-7/code): `meshy/meshy-7` @@ -560,7 +559,6 @@ translationBlockHashes: | 모델 | ID | 입력 | 출력 | | --- | --- | --- | --- | | [Animations](/ko/development/comfy-router/models/meshy/animations/code) | `meshy/animations` | 3D | 3D | -| [Meshy 5](/ko/development/comfy-router/models/meshy/meshy-5/code) | `meshy/meshy-5` | 텍스트 | 3D | | [Meshy 6](/ko/development/comfy-router/models/meshy/meshy-6/code) | `meshy/meshy-6` | 텍스트 | 3D | | [Meshy 7.1](/ko/development/comfy-router/models/meshy/meshy-7-1/code) | `meshy/meshy-7.1` | 텍스트 | 3D | | [Meshy 7](/ko/development/comfy-router/models/meshy/meshy-7/code) | `meshy/meshy-7` | 텍스트 | 3D | diff --git a/ko/development/comfy-router/models/bria/image-edit-relight/code.mdx b/ko/development/comfy-router/models/bria/image-edit-relight/code.mdx index fdc900317c..8fe311433f 100644 --- a/ko/development/comfy-router/models/bria/image-edit-relight/code.mdx +++ b/ko/development/comfy-router/models/bria/image-edit-relight/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router로 Image Edit Relight 사용하기" description: "Comfy Router를 통해 bria/image-edit-relight 호출하기: 엔드포인트, 요청 형태 그리고 Router가 반환하는 응답." sidebarTitle: "Image Edit Relight" -translationSourceHash: 63b5bcef +translationSourceHash: 620fcec7 translationFrom: development/comfy-router/models/bria/image-edit-relight/code.mdx translationBlockHashes: "_intro": cc88af3e "Quick start": 4329dd4b - "Schema": fb8fdff1 + "Schema": 8f45e738 "Examples": f04b0762 --- @@ -160,7 +160,7 @@ curl https://api.comfy.org/v2/models/bria/image-edit-relight/requests/$REQUEST_I 편집할 이미지입니다. 지원되는 입력 유형은 Base64로 인코딩된 문자열 또는 공개적으로 접근 가능한 이미지 파일을 가리키는 URL입니다. 허용 형식: JPEG, JPG, PNG, WEBP. - + 라이트 방향으로, "front", "side", "bottom", "top-down" 중 하나입니다. diff --git a/ko/development/comfy-router/models/luma_2/ray-3-2/code.mdx b/ko/development/comfy-router/models/luma_2/ray-3-2/code.mdx index c7e96144fd..81edc9e5dd 100644 --- a/ko/development/comfy-router/models/luma_2/ray-3-2/code.mdx +++ b/ko/development/comfy-router/models/luma_2/ray-3-2/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router로 Ray 3.2 사용하기" description: "Comfy Router를 통해 luma_2/ray-3.2를 호출합니다: 엔드포인트, 요청 형태 및 Router가 반환하는 응답." sidebarTitle: "Ray 3.2" -translationSourceHash: a796913b +translationSourceHash: 86ca3c26 translationFrom: development/comfy-router/models/luma_2/ray-3-2/code.mdx translationBlockHashes: "_intro": 3348ca65 "Quick start": ad992b88 - "Schema": 50c63e36 + "Schema": 0c4fe0bc "Examples": fdb0ab6e --- {/* 생성된 파일입니다. `pnpm code-pages:gen`으로 router-schemas/luma_2/ray-3.2.json에서 생성되었습니다. */} diff --git a/ko/development/comfy-router/models/luma_2/uni-1-max/code.mdx b/ko/development/comfy-router/models/luma_2/uni-1-max/code.mdx index b7ee5fd49e..655a7014c3 100644 --- a/ko/development/comfy-router/models/luma_2/uni-1-max/code.mdx +++ b/ko/development/comfy-router/models/luma_2/uni-1-max/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router로 Uni 1 Max 사용하기" description: "Comfy Router를 통해 luma_2/uni-1-max를 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "Uni 1 Max" -translationSourceHash: 90d7c51e +translationSourceHash: e88275ff translationFrom: development/comfy-router/models/luma_2/uni-1-max/code.mdx translationBlockHashes: "_intro": 86e0cfe7 "Quick start": dfff1d3d - "Schema": 4916d345 + "Schema": d7d29898 "Examples": f813a867 --- @@ -255,7 +255,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - MP4와 함께 EXR 파일을 내보냅니다. hdr이 참이어야 합니다. video_reframe에서는 거부됩니다. + 아직 사용할 수 없습니다: Luma가 EXR 제공을 시작할 때까지 `exr_export=true` 요청은 400으로 거부됩니다. 향후 MP4와 함께 EXR 파일을 내보냅니다(hdr가 true여야 함). video_reframe에서는 거부됩니다. diff --git a/ko/development/comfy-router/models/luma_2/uni-1/code.mdx b/ko/development/comfy-router/models/luma_2/uni-1/code.mdx index a298b97d18..b61648585d 100644 --- a/ko/development/comfy-router/models/luma_2/uni-1/code.mdx +++ b/ko/development/comfy-router/models/luma_2/uni-1/code.mdx @@ -2,12 +2,12 @@ title: "Comfy Router에서 Uni 1 사용하기" description: "Comfy Router를 통해 luma_2/uni-1 호출하기: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답." sidebarTitle: "Uni 1" -translationSourceHash: 5f33116a +translationSourceHash: 897d09ee translationFrom: development/comfy-router/models/luma_2/uni-1/code.mdx translationBlockHashes: "_intro": a9aaf4ab "Quick start": 9d667b90 - "Schema": 6ccb738a + "Schema": fe7e100f "Examples": f993c215 --- @@ -255,7 +255,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - MP4와 함께 EXR 파일을 내보냅니다. hdr가 true여야 합니다. video_reframe에서는 거부됩니다. + 아직 사용할 수 없습니다: Luma가 EXR 제공을 시작할 때까지 `exr_export=true` 요청은 400으로 거부됩니다. 향후 MP4와 함께 EXR 파일을 내보냅니다(hdr가 true여야 함). video_reframe에서는 거부됩니다. diff --git a/ko/development/comfy-router/models/meshy/meshy-5/code.mdx b/ko/development/comfy-router/models/meshy/meshy-5/code.mdx deleted file mode 100644 index a576498473..0000000000 --- a/ko/development/comfy-router/models/meshy/meshy-5/code.mdx +++ /dev/null @@ -1,431 +0,0 @@ ---- -title: "Comfy Router로 Meshy 5 사용하기" -description: "Comfy Router를 통해 meshy/meshy-5를 호출하는 방법: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답." -sidebarTitle: "Meshy 5" -translationSourceHash: 7f6f26e7 -translationFrom: development/comfy-router/models/meshy/meshy-5/code.mdx -translationBlockHashes: - "_intro": 237f6506 - "Quick start": 7bc21724 - "Schema": 8d7621e1 - "Examples": e2bc6209 ---- - - - -{/* GENERATED FILE. Generated from router-schemas/meshy/meshy-5.json by `pnpm code-pages:gen`. */} - -import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; - -Meshy가 Comfy Router를 통해 제공하는 `meshy/meshy-5`의 API 레퍼런스입니다. - -**입력:** 텍스트 · **출력:** 3D - -## 빠른 시작 - -[Comfy 워크스페이스](https://platform.comfy.org/profile/api-keys?onboarding=router)에서 키를 생성하고 `COMFY_API_KEY`로 내보내세요. Python 및 TypeScript 스니펫은 Comfy SDK(`pip install comfy-sdk` 및 `npm install @comfyorg/sdk`)를 사용하며, cURL 스니펫은 동일한 호출을 raw HTTP로 수행한 것입니다. - -**모델 ID:** `meshy/meshy-5` - -**엔드포인트:** `POST https://api.comfy.org/v2/models/meshy/meshy-5` - - - - -```python Python -from comfy_sdk import Comfy - -# 환경에서 COMFY_API_KEY를 읽습니다. -# SDK는 자동으로 멱등성 키를 생성하고 자동 재시도에 재사용합니다. -with Comfy() as client: - result = client.models.run( - "meshy/meshy-5", - { - "art_style": "realistic", - "mode": "preview", - "prompt": "a red cube", - }, - ) - -print(result) -``` - -```typescript TypeScript -import { comfy } from "@comfyorg/sdk"; - -// 환경에서 COMFY_API_KEY를 읽습니다. -// SDK는 자동으로 멱등성 키를 생성하고 자동 재시도에 재사용합니다. -const { data } = await comfy.models.run("meshy/meshy-5", { - art_style: "realistic", - mode: "preview", - prompt: "a red cube", -}); - -console.log(data); -``` - -```bash cURL -curl https://api.comfy.org/v2/models/meshy/meshy-5 \ - -H "X-API-Key: $COMFY_API_KEY" \ - -H "Idempotency-Key: $(uuidgen)" \ - -H "Content-Type: application/json" \ - -d "{\"art_style\": \"realistic\", \"mode\": \"preview\", \"prompt\": \"a red cube\"}" -``` - - - -동일한 본문을 `POST https://api.comfy.org/v2/models/meshy/meshy-5/requests`로 보냅니다. Router는 실행이 접수되는 즉시 `201`과 `request_id`를 응답하며, 결과는 준비되는 대로 이 프로세스나 다른 프로세스에서 수집할 수 있습니다. 상태, 취소, 수집 방법은 [대기열 전송](/ko/development/comfy-router/queue)을 참고하세요. - - -```python Python -import asyncio -from comfy_sdk import AsyncComfy - -# 환경에서 COMFY_API_KEY를 읽습니다. -# 각 submit() 호출은 자체 Idempotency-Key를 발급하고 자동 재시도에 재사용합니다. -async def main(): - async with AsyncComfy() as client: - handle = await client.models.submit( - "meshy/meshy-5", - { - "art_style": "realistic", - "mode": "preview", - "prompt": "a red cube", - }, - ) - print("request_id:", handle.request_id) # 모델 ID와 함께라면 다른 프로세스에 필요한 전부입니다 - - # 요청이 완료될 때까지 폴링하며, 서버가 알려주는 Retry-After만큼 대기합니다. - async for update in handle.iter_events(): - print(update.status, update.queue_position) - - # 공급자의 자체 페이로드이며, models.run()이 반환하는 것과 동일한 값입니다. - # 실패했거나 취소된 요청은 여기에서 타입이 지정된 Router 오류를 발생시킵니다. - result = await handle.get() - - print(result) - -asyncio.run(main()) -``` - -```typescript TypeScript -import { comfy } from "@comfyorg/sdk"; - -// 환경에서 COMFY_API_KEY를 읽습니다. -// 각 submit() 호출은 자체 Idempotency-Key를 발급하고 자동 재시도에 재사용합니다. -const handle = await comfy.models.submit("meshy/meshy-5", { - art_style: "realistic", - mode: "preview", - prompt: "a red cube", -}); -console.log("requestId:", handle.requestId); // 모델 ID와 함께라면 다른 프로세스에 필요한 전부입니다 - -// 요청이 완료될 때까지 폴링하며, 서버가 알려주는 Retry-After만큼 대기합니다. -for await (const update of handle.events()) { - console.log(update.status, update.queuePosition); -} - -// models.run()이 반환하는 것과 동일한 결과입니다. 실패했거나 취소된 요청은 여기에서 거부됩니다. -const result = await handle.get(); - -console.log(result.data); -``` - -```bash cURL -# 1. 제출합니다. Router는 request_id, status_url, response_url, cancel_url과 함께 201을 응답합니다. -curl https://api.comfy.org/v2/models/meshy/meshy-5/requests \ - -H "X-API-Key: $COMFY_API_KEY" \ - -H "Idempotency-Key: $(uuidgen)" \ - -H "Content-Type: application/json" \ - -d "{\"art_style\": \"realistic\", \"mode\": \"preview\", \"prompt\": \"a red cube\"}" - -# 2. 상태가 COMPLETED가 될 때까지 폴링하며, 각 응답이 알려주는 Retry-After 초만큼 대기합니다. -REQUEST_ID="" -curl -i https://api.comfy.org/v2/models/meshy/meshy-5/requests/$REQUEST_ID/status \ - -H "X-API-Key: $COMFY_API_KEY" - -# 3. 수집합니다. 모델의 네이티브 출력과 함께 200, 아직 실행 중이면 상태 본문과 함께 202를 반환합니다. -curl https://api.comfy.org/v2/models/meshy/meshy-5/requests/$REQUEST_ID \ - -H "X-API-Key: $COMFY_API_KEY" -``` - - - - -## 스키마 - -### 입력 - -#### `preview` 변형 - - - 실행할 Meshy 모델입니다. Comfy Router 경로에서는 경로(`/v2/models/meshy/{model}`)로 제공되며 생략하거나 null로 보낼 수 있습니다. Router는 검증 이후 경로의 모델을 여기에 기록합니다. v1 /proxy 경로에서는 MeshyTextTo3DPreviewRequest를 참조하세요. 이는 MeshyAiModel로 제한됩니다. - - - - 원하는 객체의 아트 스타일을 설명하세요. - - 가능한 값: `realistic`, `sculpture` - - - - 생성된 메시의 지오메트리 해상도입니다. 2k와 4k는 더 세밀한 표면 디테일을 위해 Ultra 패스를 실행합니다. 2k와 4k는 ai_model이 meshy-7.1 또는 latest여야 합니다. - - 가능한 값: `standard`, `2k`, `4k` - - - - 지원 중단됨. 대신 pose_mode를 사용하세요. 모델을 A/T 포즈로 생성할지 여부입니다. - - - - 미리보기 작업을 생성할 때 이 필드는 "preview"로 설정해야 합니다. - - 가능한 값: `preview` - - - - true이면 입력 콘텐츠에서 잠재적으로 유해한 콘텐츠가 검사됩니다. - - - - 생성된 모델의 포즈 모드를 지정합니다. - - 가능한 값: `a-pose`, `t-pose`, `` - - - - 3D 모델이 어떤 종류의 객체인지 설명합니다. 최대 800자. - - - - 리메시 단계를 활성화할지 여부를 제어합니다. false이면 최고 정밀도의 삼각형 메시를 반환합니다. Meshy 5는 true, Meshy 6 및 7은 false가 기본값입니다. - - - - 모델 생성 중 대칭 동작을 제어합니다. - - 가능한 값: `off`, `auto`, `on` - - - - 생성된 모델의 목표 폴리곤 수를 지정합니다. 유효 범위는 100에서 300,000입니다. - - 범위: `100` ~ `300000` - - - - 생성된 모델의 토폴로지를 지정합니다. - - 가능한 값: `quad`, `triangle` - - - - 지원 중단됨. 대신 geometry_resolution을 사용하세요. true는 geometry_resolution 2k와 동일합니다. ai_model이 meshy-7, meshy-7.1 또는 latest인 경우에만 지원됩니다. 예외는 meshy-7입니다. geometry_resolution 2k는 meshy-7.1 또는 latest가 필요하므로, meshy-7에서는 ultra_mode true가 Ultra 패스를 요청하는 방법입니다. - - -#### `refine` 변형 - - - 실행할 Meshy 모델입니다. Comfy Router 경로에서는 경로(`/v2/models/meshy/{model}`)로 제공되며 생략하거나 null로 보낼 수 있습니다. Router는 검증 이후 경로의 모델을 여기에 기록합니다. v1 /proxy 경로에서는 MeshyTextTo3DRefineRequest를 참조하세요. 이는 MeshyAiModel로 제한됩니다. - - - - 기본 색상에 추가로 PBR 맵(metallic, roughness, normal)을 생성합니다. Sculpture 스타일을 사용할 때는 enable_pbr을 false로 설정해야 합니다. - - - - refine 작업을 생성할 때 이 필드는 "refine"으로 설정해야 합니다. - - 가능한 값: `refine` - - - - true이면 입력 콘텐츠에서 잠재적으로 유해한 콘텐츠가 검사됩니다. - - - - 해당 미리보기 작업 id입니다. 주어진 미리보기 작업의 상태는 SUCCEEDED여야 합니다. - - - - 텍스처링 과정을 안내할 2D 이미지를 제공합니다. .jpg, .jpeg, .png 형식 또는 base64로 인코딩된 data URI를 지원합니다. - - - - 텍스처링 과정을 안내할 추가 텍스트 프롬프트를 제공합니다. 최대 800자. - - - - 생성된 텍스처의 텍스처 해상도입니다. 2k, 4k 또는 8k 중 하나입니다. 4k와 8k는 ai_model이 meshy-6, meshy-7, meshy-7.1 또는 latest여야 합니다. - - 가능한 값: `2k`, `4k`, `8k` - - -`GET /v2/models/meshy/meshy-5/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 이전에 호출을 검증하는 데 사용하는 동일한 문서입니다. - -### 출력 - - - 미리보기 작업을 생성하는 데 사용된 수정되지 않은 art_style입니다. - - - - 작업이 생성된 시점의 타임스탬프(밀리초)입니다. - - 형식: `int64` - - - - 작업이 완료된 시점의 타임스탬프(밀리초)입니다. 완료되지 않은 경우 0입니다. - - 형식: `int64` - - - - 작업의 고유 식별자입니다. - - - - Meshy에서 생성한 텍스처가 적용된 3D 모델 파일의 다운로드 가능한 URL입니다. - - - - FBX 파일의 다운로드 가능한 URL입니다. - - - - GLB 파일의 다운로드 가능한 URL입니다. - - - - MTL 파일의 다운로드 가능한 URL입니다. - - - - OBJ 파일의 다운로드 가능한 URL입니다. - - - - USDZ 파일의 다운로드 가능한 URL입니다. - - - - 이전 버전과의 호환성을 위해 유지되는 지원 중단된 필드입니다. - - - - 선행 작업의 수입니다. 상태가 PENDING일 때만 의미가 있습니다. - - - - 작업의 진행률입니다. 시작되지 않은 경우 0, 성공한 경우 100입니다. - - 범위: `0` ~ `100` - - - - 작업을 생성하는 데 사용된 수정되지 않은 프롬프트입니다. - - - - 작업이 시작된 시점의 타임스탬프(밀리초)입니다. 시작되지 않은 경우 0입니다. - - 형식: `int64` - - - - 가능한 값: `SUCCEEDED` - - - - 작업이 실패한 경우 오류 메시지를 포함하는 오류 객체입니다. - - - - 자세한 오류 메시지입니다. - - - - 텍스처링 과정을 안내하는 데 사용된 텍스처 이미지의 다운로드 가능한 URL입니다. - - - - refine 단계에서 텍스처링 과정을 안내하기 위해 제공된 추가 텍스트 프롬프트입니다. - - - - 이전 버전과의 호환성을 위해 유지되는 지원 중단된 필드입니다. - - - - 작업에서 생성된 텍스처 URL 객체의 배열입니다. - - - - 베이스 색상 맵 이미지의 다운로드 가능한 URL입니다. - - - - 메탈릭 맵 이미지의 다운로드 가능한 URL입니다. - - - - 노멀 맵 이미지의 다운로드 가능한 URL입니다. - - - - 러프니스 맵 이미지의 다운로드 가능한 URL입니다. - - - - 모델 파일의 썸네일 이미지의 다운로드 가능한 URL입니다. - - - - 텍스트 기반 3D 생성 작업의 유형입니다. - - 가능한 값: `text-to-3d-preview`, `text-to-3d-refine` - - - - 미리보기 비디오의 다운로드 가능한 URL을 반환하는 지원 중단된 필드입니다. - - -## 예시 - -### 입력 - -```json -{ - "art_style": "realistic", - "mode": "preview", - "prompt": "a red cube" -} -``` - -### 출력 - -```json -{ - "art_style": "realistic", - "created_at": 1767225600000, - "finished_at": 1767225719000, - "id": "018f2c7a-4b1e-7c3d-9a05-6e2f8b41d0c9", - "model_urls": { - "fbx": "https://example.invalid/meshy/text-to-3d/model.fbx", - "glb": "https://example.invalid/meshy/text-to-3d/model.glb", - "mtl": "https://example.invalid/meshy/text-to-3d/model.mtl", - "obj": "https://example.invalid/meshy/text-to-3d/model.obj", - "usdz": "https://example.invalid/meshy/text-to-3d/model.usdz" - }, - "progress": 100, - "prompt": "a red cube", - "started_at": 1767225601000, - "status": "SUCCEEDED", - "thumbnail_url": "https://example.invalid/meshy/text-to-3d/thumbnail.png", - "type": "text-to-3d-preview" -} -``` - - diff --git a/zh/development/api-development/sdks.mdx b/zh/development/api-development/sdks.mdx index dffa890068..2963decbf7 100644 --- a/zh/development/api-development/sdks.mdx +++ b/zh/development/api-development/sdks.mdx @@ -3,13 +3,13 @@ title: "Comfy SDK:ComfyUI 的 Python 与 TypeScript 客户端" description: "用 Python 或 TypeScript 对 Comfy Cloud、自建部署或自有 ComfyUI 运行 ComfyUI 工作流,并处理资产、任务、实时事件和幂等重试。" sidebarTitle: "SDK" icon: "code" -translationSourceHash: dbb2e0a8 +translationSourceHash: fd912955 translationFrom: development/api-development/sdks.mdx translationBlockHashes: "_intro": c92c7b51 "Install": da9a0a57 "Quickstart": 02297586 - "Choosing a base URL": 2265e6f6 + "Choosing a base URL": 0e77e81c "Retrying a submit: the idempotency key": 7c83d78f "Watching a job run": 34d74bcc "Tracing an output back to its workflow": b01886a3 diff --git a/zh/development/cloud/api-reference.mdx b/zh/development/cloud/api-reference.mdx index c2908985e9..a476624d10 100644 --- a/zh/development/cloud/api-reference.mdx +++ b/zh/development/cloud/api-reference.mdx @@ -2,14 +2,14 @@ title: "Cloud API 参考" description: "Comfy Cloud 的完整 API 参考及代码示例" icon: "book-open" -translationSourceHash: 9dfb0617 +translationSourceHash: e15f0e0e translationFrom: development/cloud/api-reference.mdx translationBlockHashes: "_intro": 1729f5d3 "Setup": 311034bb "Object Info": 7b62a397 "Uploading Inputs": 92df17f8 - "Running Workflows": d6ddd0b4 + "Running Workflows": 2c6519c7 "Checking Job Status": d74b4922 "WebSocket for Real-Time Progress": 02c49b4a "Downloading Outputs": 5e1d63d3 diff --git a/zh/development/comfy-router/limitations.mdx b/zh/development/comfy-router/limitations.mdx index b4ce5edbc4..b8a961bf7c 100644 --- a/zh/development/comfy-router/limitations.mdx +++ b/zh/development/comfy-router/limitations.mdx @@ -2,7 +2,7 @@ title: "Comfy Router 的能力与限制" sidebarTitle: "能力与限制" description: "选择 Comfy Router 还是合作伙伴代理,为长时间运行的调用做好规划,并了解恢复、速率限制与资产存储。" -translationSourceHash: b40af72c +translationSourceHash: 2526e5db translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 @@ -14,7 +14,7 @@ translationBlockHashes: "Requests are rate limited per caller": 249d4d51 "No progress while a call runs": 75d42d8d "Comfy charges and usage": ed49ddec - "Models without a pre-flight estimate": 7373adf0 + "Models without a pre-flight estimate": 488081d1 "Router does not cover every partner operation": 97d31362 "Model outputs and stored assets": 06c737c1 "Next": be85b789 @@ -123,7 +123,7 @@ Router 目前还无法在运行前可靠地为对以下模型的调用定价, - **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4`, `ideogram/p-image-ideogram` - **kling**: `kling/kling-3.0-turbo`, `kling/kling-image-o1`, `kling/kling-v2-5-turbo`, `kling/kling-v2-6`, `kling/kling-v3`, `kling/kling-v3-omni`, `kling/kling-video-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync`, `kling/videos-video-extend` - **luma**: `luma/photon-1`, `luma/photon-flash-1`, `luma/ray-2`, `luma/ray-flash-2` -- **meshy**: `meshy/animations`, `meshy/meshy-5`, `meshy/meshy-6`, `meshy/meshy-7`, `meshy/meshy-7.1`, `meshy/remesh`, `meshy/rigging` +- **meshy**: `meshy/animations`, `meshy/meshy-6`, `meshy/meshy-7`, `meshy/meshy-7.1`, `meshy/remesh`, `meshy/rigging` - **moonvalley**: `moonvalley/image-to-video`, `moonvalley/text-to-video`, `moonvalley/video-to-video` - **openrouter**: `openrouter/chat-completions` - **pika**: `pika/pika-gpt-image-2`, `pika/pika-nano-banana-2`, `pika/pika-nano-banana-pro` diff --git a/zh/development/comfy-router/models.mdx b/zh/development/comfy-router/models.mdx index 74348b012f..05cf194c16 100644 --- a/zh/development/comfy-router/models.mdx +++ b/zh/development/comfy-router/models.mdx @@ -2,11 +2,11 @@ title: "Comfy Router 模型" sidebarTitle: "所有模型" description: "Comfy Router 提供的全部模型,按提供方分组,并列出每个模型的输入和输出模态。" -translationSourceHash: f12be9e4 +translationSourceHash: e62265b5 translationFrom: development/comfy-router/models.mdx translationBlockHashes: "_intro": 2584e428 - "Find by output": 380e121d + "Find by output": 9c4c92ac "Anthropic": de8acc20 "Beeble": b52ea340 "Black Forest Labs": 2934e3eb @@ -25,7 +25,7 @@ translationBlockHashes: "LTX": 32595bf9 "Luma": 37a12a19 "Luma 2": 585eb637 - "Meshy": 9292a0a8 + "Meshy": 67e26a17 "MiniMax": 87560ab7 "Moonvalley": 9e63fb77 "OpenAI": c5c4af80 @@ -276,10 +276,9 @@ translationBlockHashes: - [Wan 3.0 Video](/zh/development/comfy-router/models/wan/wan3-0-video/code):`wan/wan3.0-video` - + - [Animations](/zh/development/comfy-router/models/meshy/animations/code):`meshy/animations` -- [Meshy 5](/zh/development/comfy-router/models/meshy/meshy-5/code):`meshy/meshy-5` - [Meshy 6](/zh/development/comfy-router/models/meshy/meshy-6/code):`meshy/meshy-6` - [Meshy 7.1](/zh/development/comfy-router/models/meshy/meshy-7-1/code):`meshy/meshy-7.1` - [Meshy 7](/zh/development/comfy-router/models/meshy/meshy-7/code):`meshy/meshy-7` @@ -560,7 +559,6 @@ translationBlockHashes: | 模型 | ID | 输入 | 输出 | | --- | --- | --- | --- | | [Animations](/zh/development/comfy-router/models/meshy/animations/code) | `meshy/animations` | 3D | 3D | -| [Meshy 5](/zh/development/comfy-router/models/meshy/meshy-5/code) | `meshy/meshy-5` | 文本 | 3D | | [Meshy 6](/zh/development/comfy-router/models/meshy/meshy-6/code) | `meshy/meshy-6` | 文本 | 3D | | [Meshy 7.1](/zh/development/comfy-router/models/meshy/meshy-7-1/code) | `meshy/meshy-7.1` | 文本 | 3D | | [Meshy 7](/zh/development/comfy-router/models/meshy/meshy-7/code) | `meshy/meshy-7` | 文本 | 3D | diff --git a/zh/development/comfy-router/models/bria/image-edit-relight/code.mdx b/zh/development/comfy-router/models/bria/image-edit-relight/code.mdx index c15d997c7c..1ab8329fc1 100644 --- a/zh/development/comfy-router/models/bria/image-edit-relight/code.mdx +++ b/zh/development/comfy-router/models/bria/image-edit-relight/code.mdx @@ -2,12 +2,12 @@ title: "将 Image Edit Relight 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 bria/image-edit-relight:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Image Edit Relight" -translationSourceHash: 63b5bcef +translationSourceHash: 620fcec7 translationFrom: development/comfy-router/models/bria/image-edit-relight/code.mdx translationBlockHashes: "_intro": cc88af3e "Quick start": 4329dd4b - "Schema": fb8fdff1 + "Schema": 8f45e738 "Examples": f04b0762 --- @@ -160,7 +160,7 @@ curl https://api.comfy.org/v2/models/bria/image-edit-relight/requests/$REQUEST_I 要编辑的图像。支持的输入类型为 Base64 编码字符串,或指向可公开访问图像文件的 URL。接受的格式为 JPEG、JPG、PNG、WEBP。 - + 光照方向,取值为 "front"、"side"、"bottom" 或 "top-down" 之一。 diff --git a/zh/development/comfy-router/models/luma_2/ray-3-2/code.mdx b/zh/development/comfy-router/models/luma_2/ray-3-2/code.mdx index f89f6148bd..bca37e1618 100644 --- a/zh/development/comfy-router/models/luma_2/ray-3-2/code.mdx +++ b/zh/development/comfy-router/models/luma_2/ray-3-2/code.mdx @@ -2,12 +2,12 @@ title: "搭配 Comfy Router 使用 Ray 3.2" description: "通过 Comfy Router 调用 luma_2/ray-3.2:endpoint、请求结构以及 Router 返回的响应。" sidebarTitle: "Ray 3.2" -translationSourceHash: a796913b +translationSourceHash: 86ca3c26 translationFrom: development/comfy-router/models/luma_2/ray-3-2/code.mdx translationBlockHashes: "_intro": 3348ca65 "Quick start": ad992b88 - "Schema": 50c63e36 + "Schema": 0c4fe0bc "Examples": fdb0ab6e --- {/* 生成文件。由 `pnpm code-pages:gen` 从 router-schemas/luma_2/ray-3.2.json 生成。 */} diff --git a/zh/development/comfy-router/models/luma_2/uni-1-max/code.mdx b/zh/development/comfy-router/models/luma_2/uni-1-max/code.mdx index 7474460314..b328f893fb 100644 --- a/zh/development/comfy-router/models/luma_2/uni-1-max/code.mdx +++ b/zh/development/comfy-router/models/luma_2/uni-1-max/code.mdx @@ -2,12 +2,12 @@ title: "搭配 Comfy Router 使用 Uni 1 Max" description: "通过 Comfy Router 调用 luma_2/uni-1-max:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Uni 1 Max" -translationSourceHash: 90d7c51e +translationSourceHash: e88275ff translationFrom: development/comfy-router/models/luma_2/uni-1-max/code.mdx translationBlockHashes: "_intro": 86e0cfe7 "Quick start": dfff1d3d - "Schema": 4916d345 + "Schema": d7d29898 "Examples": f813a867 --- @@ -255,7 +255,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 随 MP4 一并导出 EXR 文件。要求 hdr 为 true。在 video_reframe 中会被拒绝。 + 暂不可用:在 Luma 提供 EXR 交付之前,带 `exr_export=true` 的请求会以 400 拒绝。将来会在 MP4 之外同时导出 EXR 文件(需要 hdr 为 true)。video_reframe 下会被拒绝。 diff --git a/zh/development/comfy-router/models/luma_2/uni-1/code.mdx b/zh/development/comfy-router/models/luma_2/uni-1/code.mdx index 64cd355e54..4b8d878cbc 100644 --- a/zh/development/comfy-router/models/luma_2/uni-1/code.mdx +++ b/zh/development/comfy-router/models/luma_2/uni-1/code.mdx @@ -2,12 +2,12 @@ title: "将 Uni 1 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 luma_2/uni-1:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Uni 1" -translationSourceHash: 5f33116a +translationSourceHash: 897d09ee translationFrom: development/comfy-router/models/luma_2/uni-1/code.mdx translationBlockHashes: "_intro": a9aaf4ab "Quick start": 9d667b90 - "Schema": 6ccb738a + "Schema": fe7e100f "Examples": f993c215 --- @@ -255,7 +255,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 随 MP4 一并导出 EXR 文件。要求 hdr 为 true。在 video_reframe 中会被拒绝。 + 暂不可用:在 Luma 提供 EXR 交付之前,带 `exr_export=true` 的请求会以 400 拒绝。将来会在 MP4 之外同时导出 EXR 文件(需要 hdr 为 true)。video_reframe 下会被拒绝。 diff --git a/zh/development/comfy-router/models/meshy/meshy-5/code.mdx b/zh/development/comfy-router/models/meshy/meshy-5/code.mdx deleted file mode 100644 index e3a59fa9a9..0000000000 --- a/zh/development/comfy-router/models/meshy/meshy-5/code.mdx +++ /dev/null @@ -1,431 +0,0 @@ ---- -title: "将 Meshy 5 与 Comfy Router 配合使用" -description: "通过 Comfy Router 调用 meshy/meshy-5:端点、请求结构以及 Router 返回的响应。" -sidebarTitle: "Meshy 5" -translationSourceHash: 7f6f26e7 -translationFrom: development/comfy-router/models/meshy/meshy-5/code.mdx -translationBlockHashes: - "_intro": 237f6506 - "Quick start": 7bc21724 - "Schema": 8d7621e1 - "Examples": e2bc6209 ---- - - - -{/* GENERATED FILE. Generated from router-schemas/meshy/meshy-5.json by `pnpm code-pages:gen`. */} - -import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; - -`meshy/meshy-5` 的 API 参考,由 Comfy Router 从 Meshy 提供。 - -**输入:** 文本 · **输出:** 3D - -## 快速开始 - -在[你的 Comfy 工作区](https://platform.comfy.org/profile/api-keys?onboarding=router)中创建密钥,并将其导出为 `COMFY_API_KEY`。Python 和 TypeScript 片段使用 Comfy SDK(`pip install comfy-sdk` 和 `npm install @comfyorg/sdk`);cURL 片段则是通过原始 HTTP 发起的同一调用。 - -**模型 ID:** `meshy/meshy-5` - -**端点:** `POST https://api.comfy.org/v2/models/meshy/meshy-5` - - - - -```python Python -from comfy_sdk import Comfy - -# 从环境中读取 COMFY_API_KEY。 -# SDK 会自动创建幂等键,并在自动重试时复用。 -with Comfy() as client: - result = client.models.run( - "meshy/meshy-5", - { - "art_style": "realistic", - "mode": "preview", - "prompt": "a red cube", - }, - ) - -print(result) -``` - -```typescript TypeScript -import { comfy } from "@comfyorg/sdk"; - -// 从环境中读取 COMFY_API_KEY。 -// SDK 会自动创建幂等键,并在自动重试时复用。 -const { data } = await comfy.models.run("meshy/meshy-5", { - art_style: "realistic", - mode: "preview", - prompt: "a red cube", -}); - -console.log(data); -``` - -```bash cURL -curl https://api.comfy.org/v2/models/meshy/meshy-5 \ - -H "X-API-Key: $COMFY_API_KEY" \ - -H "Idempotency-Key: $(uuidgen)" \ - -H "Content-Type: application/json" \ - -d "{\"art_style\": \"realistic\", \"mode\": \"preview\", \"prompt\": \"a red cube\"}" -``` - - - -将相同的请求体发送到 `POST https://api.comfy.org/v2/models/meshy/meshy-5/requests`。运行被受理后,Router 会立即返回 `201` 和 `request_id`;结果就绪后,即可从本进程或其他进程收集。[队列投递](/zh/development/comfy-router/queue) 介绍了状态、取消与收集的完整流程。 - - -```python Python -import asyncio -from comfy_sdk import AsyncComfy - -# 从环境中读取 COMFY_API_KEY。 -# 每次 submit() 调用都会生成自己的 Idempotency-Key,并在自动重试时复用。 -async def main(): - async with AsyncComfy() as client: - handle = await client.models.submit( - "meshy/meshy-5", - { - "art_style": "realistic", - "mode": "preview", - "prompt": "a red cube", - }, - ) - print("request_id:", handle.request_id) # 再加上模型 ID,就是另一个进程所需的全部信息 - - # 轮询直到请求完成,按服务器指定的 Retry-After 等待。 - async for update in handle.iter_events(): - print(update.status, update.queue_position) - - # 提供商自己的载荷,与 models.run() 返回的值相同。 - # 失败或已取消的请求会在此处抛出类型化的 Router 错误。 - result = await handle.get() - - print(result) - -asyncio.run(main()) -``` - -```typescript TypeScript -import { comfy } from "@comfyorg/sdk"; - -// 从环境中读取 COMFY_API_KEY。 -// 每次 submit() 调用都会生成自己的 Idempotency-Key,并在自动重试时复用。 -const handle = await comfy.models.submit("meshy/meshy-5", { - art_style: "realistic", - mode: "preview", - prompt: "a red cube", -}); -console.log("requestId:", handle.requestId); // 再加上模型 ID,就是另一个进程所需的全部信息 - -// 轮询直到请求完成,按服务器指定的 Retry-After 等待。 -for await (const update of handle.events()) { - console.log(update.status, update.queuePosition); -} - -// 与 models.run() 返回的结果相同。失败或已取消的请求会在此处被拒绝。 -const result = await handle.get(); - -console.log(result.data); -``` - -```bash cURL -# 1. 提交。Router 返回 201,并附带 request_id、status_url、response_url 和 cancel_url。 -curl https://api.comfy.org/v2/models/meshy/meshy-5/requests \ - -H "X-API-Key: $COMFY_API_KEY" \ - -H "Idempotency-Key: $(uuidgen)" \ - -H "Content-Type: application/json" \ - -d "{\"art_style\": \"realistic\", \"mode\": \"preview\", \"prompt\": \"a red cube\"}" - -# 2. 轮询直到状态为 COMPLETED,按每个响应指定的 Retry-After 秒数等待。 -REQUEST_ID="" -curl -i https://api.comfy.org/v2/models/meshy/meshy-5/requests/$REQUEST_ID/status \ - -H "X-API-Key: $COMFY_API_KEY" - -# 3. 收集。返回 200 和模型的原始输出;仍在运行时返回 202 和状态响应体。 -curl https://api.comfy.org/v2/models/meshy/meshy-5/requests/$REQUEST_ID \ - -H "X-API-Key: $COMFY_API_KEY" -``` - - - - -## Schema - -### 输入 - -#### `preview` 变体 - - - 要运行的 Meshy 模型。在 Comfy Router 路由上,该值由路径(`/v2/models/meshy/{model}`)提供,可以省略或发送为 null;Router 会在验证之后将路径中的模型写入此处。在 v1 /proxy 路由上,请参见 MeshyTextTo3DPreviewRequest,它将此值约束为 MeshyAiModel。 - - - - 描述你希望该物体呈现的艺术风格。 - - 可选值:`realistic`、`sculpture` - - - - 已生成网格的几何分辨率。2k 和 4k 会运行 Ultra 通道,以获得更精细的表面细节。2k 和 4k 要求 ai_model 为 meshy-7.1 或 latest。 - - 可选值:`standard`、`2k`、`4k` - - - - 弃用。请改用 pose_mode。是否以 A/T 姿势生成模型。 - - - - 创建预览任务时,此字段应设为 "preview"。 - - 可选值:`preview` - - - - 当为 true 时,输入内容会被筛查,以识别可能有害的内容。 - - - - 指定已生成模型的姿势模式。 - - 可选值:`a-pose`、`t-pose`、`` - - - - 描述该 3D 模型是什么类型的物体。最多 800 个字符。 - - - - 控制是否启用重网格(remesh)阶段。为 false 时,返回最高精度的三角网格。Meshy 5 默认为 true,Meshy 6 和 7 默认为 false。 - - - - 控制模型生成过程中的对称行为。 - - 可选值:`off`、`auto`、`on` - - - - 指定已生成模型的目标多边形数量。有效范围为 100 到 300,000。 - - 范围:`100` 到 `300000` - - - - 指定已生成模型的拓扑结构。 - - 可选值:`quad`、`triangle` - - - - 弃用。请改用 geometry_resolution;true 等效于 geometry_resolution 2k。仅在 ai_model 为 meshy-7、meshy-7.1 或 latest 时受支持。meshy-7 是例外:geometry_resolution 2k 要求 meshy-7.1 或 latest,因此在 meshy-7 上,将 ultra_mode 设为 true 才是请求 Ultra 通道的方式。 - - -#### `refine` 变体 - - - 要运行的 Meshy 模型。在 Comfy Router 路由上,该值由路径(`/v2/models/meshy/{model}`)提供,可以省略或发送为 null;Router 会在验证之后将路径中的模型写入此处。在 v1 /proxy 路由上,请参见 MeshyTextTo3DRefineRequest,它将此值约束为 MeshyAiModel。 - - - - 在基础颜色之外,额外生成 PBR 贴图(金属度、粗糙度、法线)。注意,使用 Sculpture 风格时,enable_pbr 应设为 false。 - - - - 创建 refine 任务时,此字段应设为 "refine"。 - - 可选值:`refine` - - - - 当为 true 时,输入内容会被筛查,以识别可能有害的内容。 - - - - 对应的预览任务 ID。指定的预览任务状态必须为 SUCCEEDED。 - - - - 提供一张 2D 图像来引导贴图生成过程。支持 .jpg、.jpeg、.png 格式,或 base64 编码的 data URI。 - - - - 提供一个额外的文本提示词来引导贴图生成过程。最多 800 个字符。 - - - - 已生成纹理的纹理分辨率。可取 2k、4k 或 8k 之一。4k 和 8k 要求 ai_model 为 meshy-6、meshy-7、meshy-7.1 或 latest。 - - 可选值:`2k`、`4k`、`8k` - - -本文档根据 Router 在 `GET /v2/models/meshy/meshy-5/openapi.json` 提供的 schema 生成,Router 在请求到达提供商之前,正是依据同一份文档对调用进行验证。 - -### 输出 - - - 用于创建预览任务的未经修改的 art_style。 - - - - 任务创建时的时间戳,单位为毫秒。 - - 格式:`int64` - - - - 任务完成时的时间戳,单位为毫秒。未完成时为 0。 - - 格式:`int64` - - - - 任务的唯一标识符。 - - - - Meshy 生成的带纹理 3D 模型文件的可下载 URL。 - - - - FBX 文件的可下载 URL。 - - - - GLB 文件的可下载 URL。 - - - - MTL 文件的可下载 URL。 - - - - OBJ 文件的可下载 URL。 - - - - USDZ 文件的可下载 URL。 - - - - 为向后兼容而保留的弃用字段。 - - - - 前置任务的数量。仅在 status 为 PENDING 时有意义。 - - - - 任务的进度。未开始时为 0,成功时为 100。 - - 范围:`0` 到 `100` - - - - 用于创建任务的未经修改的提示词。 - - - - 任务开始时的时间戳,单位为毫秒。未开始时为 0。 - - 格式:`int64` - - - - 可能的值:`SUCCEEDED` - - - - 错误对象,在任务失败时包含报错信息。 - - - - 详细的报错信息。 - - - - 用于指导纹理贴图过程的纹理图像的可下载 URL。 - - - - 在精修阶段为指导纹理贴图过程而提供的额外文本提示词。 - - - - 为向后兼容而保留的弃用字段。 - - - - 由该任务生成的纹理 URL 对象数组。 - - - - 基础颜色贴图图像的可下载 URL。 - - - - 金属度贴图图像的可下载 URL。 - - - - 法线贴图图像的可下载 URL。 - - - - 粗糙度贴图图像的可下载 URL。 - - - - 模型文件缩略图图像的可下载 URL。 - - - - Text to 3D 任务的类型。 - - 可能的值:`text-to-3d-preview`、`text-to-3d-refine` - - - - 返回预览视频可下载 URL 的弃用字段。 - - -## 示例 - -### 输入 - -```json -{ - "art_style": "realistic", - "mode": "preview", - "prompt": "a red cube" -} -``` - -### 输出 - -```json -{ - "art_style": "realistic", - "created_at": 1767225600000, - "finished_at": 1767225719000, - "id": "018f2c7a-4b1e-7c3d-9a05-6e2f8b41d0c9", - "model_urls": { - "fbx": "https://example.invalid/meshy/text-to-3d/model.fbx", - "glb": "https://example.invalid/meshy/text-to-3d/model.glb", - "mtl": "https://example.invalid/meshy/text-to-3d/model.mtl", - "obj": "https://example.invalid/meshy/text-to-3d/model.obj", - "usdz": "https://example.invalid/meshy/text-to-3d/model.usdz" - }, - "progress": 100, - "prompt": "a red cube", - "started_at": 1767225601000, - "status": "SUCCEEDED", - "thumbnail_url": "https://example.invalid/meshy/text-to-3d/thumbnail.png", - "type": "text-to-3d-preview" -} -``` - -