diff --git a/ja/development/api-development/sdks.mdx b/ja/development/api-development/sdks.mdx index 299df75116..93d8654ba8 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 @@ -110,7 +110,7 @@ await job.getOutputs("9")[0].toFile("out.png"); ## ベースURLの選択 -| 接続先 | Base URL | APIキー | +| 接続先 | ベースURL | APIキー | |---|---|---| | **Comfy Cloud** | `https://cloud.comfy.org` (デフォルト) | 必須 | | **Comfy API デプロイ** | `https://.run.comfy.app` | 必須 | @@ -123,7 +123,7 @@ export COMFY_BASE_URL="https://.run.comfy.app" # Comfy API デプ export COMFY_BASE_URL="http://127.0.0.1:8189" # セルフホストプロキシ ``` -この変数はクライアントが構築されるたびに読み取られ、`http(s)` URLである必要があります。未設定または空白の場合はComfy Cloudを意味します。したがって、クライアント自体はどこでも同じです: +この変数はクライアントが構築されるたびに読み取られ、`http(s)` URLである必要があります。未設定または空白の場合はComfy Cloudを意味します。つまり、クライアント自体はどこでも同じです: ```python Python @@ -136,28 +136,28 @@ const client = new Comfy({ apiKey: "comfyui-..." }); - 初期ビルドからアップグレードしますか? `Comfy("", "")`は、`COMFY_BASE_URL`を設定した`Comfy(api_key="")`になりました。`api_key`はキーワード専用引数なので、以前の位置引数での呼び出しは、URLをキーとして静かに読み取るのではなく、`TypeError`を発生させます。 + 以前のビルドからアップグレードする場合: `Comfy("", "")` は、`COMFY_BASE_URL` を設定した上で `Comfy(api_key="")` を使用する形になりました。`api_key` はキーワード専用引数なので、以前の位置引数による呼び出しは、URLをキーとして黙って読み取るのではなく `TypeError` を発生させます。 ### Comfy Cloud -そのまま動作します。[APIキー](/ja/development/api-development/getting-an-api-key)を作成し、クライアントに渡します。 +設定なしですぐに動作します。[APIキー](/ja/development/api-development/getting-an-api-key)を作成し、クライアントに渡してください。 - APIアクセスには有料のComfy Cloudサブスクリプションが必要です。無料プランには含まれません。同時に実行できるジョブ数はプランによって異なります。[同時実行の制限](/ja/development/deploy/cloud-usage#同時実行の制限)をご覧ください。 + APIアクセスには有料のComfy Cloudサブスクリプションが必要です。無料プランには含まれていません。同時に実行できるジョブ数はプランによって異なります。[同時実行の制限](/ja/development/deploy/cloud-usage#同時実行の制限)をご覧ください。 ### Comfy API デプロイ -[開発者プラットフォーム](https://platform.comfy.org)を通じてデプロイしたワークフローには、専用のエンドポイントが割り当てられます。`COMFY_BASE_URL`をそのエンドポイントに指定し、Comfy Cloudとまったく同じようにAPIキーを使用します。このガイドのすべてが同じように機能します。ただし、[ジョブのラベルとジョブ一覧](#ジョブにラベルを付けて後で見つける)は Comfy Cloud ではまだサポートされていません。 +[開発者プラットフォーム](https://platform.comfy.org)を通じてデプロイしたワークフローには、専用のエンドポイントが割り当てられます。`COMFY_BASE_URL` をそのエンドポイントに指定し、Comfy Cloud とまったく同じようにAPIキーを使用します。このガイドのすべてが同じように機能します。ただし、[ジョブのラベルとジョブ一覧](#ジョブにラベルを付けて後で見つける)は Comfy Cloud ではまだサポートされていません。 -Comfy APIデプロイは、そのBuildに含まれるモデルとカスタムノードを使用して複数のワークフローを実行できます。各ジョブについて、`get_workflow()`は`format: "api"`を持ち、実行されたグラフを`.graph`プロパティに含むワークフローレスポンスを返します。 +Comfy API デプロイは、そのBuildに含まれるモデルとカスタムノードを使用して複数のワークフローを実行できます。各ジョブについて、`get_workflow()` は `format: "api"` を持ち、実行されたグラフを `.graph` プロパティに含むワークフローレスポンスを返します。 ### ご自身のComfyUI -セルフホスト環境では、v2 API は ComfyUI と一緒に動作する小規模なオープンソースサービス [comfy-api-proxy](https://github.com/Comfy-Org/comfy-api-proxy) によって提供されます。インストールして実行し、`COMFY_BASE_URL="http://127.0.0.1:8189"`を設定します: +セルフホストの ComfyUI では、v2 API は ComfyUI と並行して動作する小規模なオープンソースサービス [comfy-api-proxy](https://github.com/Comfy-Org/comfy-api-proxy) によって提供されます。インストールして実行し、`COMFY_BASE_URL="http://127.0.0.1:8189"` を設定します: ```bash pip install comfy-api-proxy @@ -165,7 +165,7 @@ comfy-api-proxy export COMFY_BASE_URL="http://127.0.0.1:8189" ``` -設定と認証については、[セルフホスト ComfyUI 用 API プロキシ](/ja/development/comfyui-server/api-proxy)を参照してください。 +設定と認証の詳細については、[セルフホスト ComfyUI 用 API プロキシ](/ja/development/comfyui-server/api-proxy)を参照してください。 ## 送信のリトライ: 冪等キー 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 08f0099f7c..96838dfc79 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: d97521f9 translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 @@ -13,9 +13,9 @@ translationBlockHashes: "Request bodies are capped": 675b77c8 "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 - "Router does not cover every partner operation": 97d31362 + "Comfy charges and usage": 7f5ccda7 + "Models without a pre-flight estimate": 495bdb2b + "Router does not cover every partner operation": 786c0fb2 "Model outputs and stored assets": 06c737c1 "Next": be85b789 --- @@ -47,11 +47,11 @@ Router はパートナーモデルを、1回の同期 HTTP 呼び出し、また 同期ルートは、モデルの実行中も接続を開いたまま保持します。非同期プロバイダーの場合、Router はジョブを送信し、内部的にポーリングします。代替となるのはキューによる配信(送信し、`request_id` を取得し、ポーリングし、収集する)です。詳しくは[キュー配信](/ja/development/comfy-router/queue)を参照してください。これは認証情報の背後にあるワークスペースにスコープされるため、Comfy ワークスペースで作成したキーが必要です。ワークスペースを持たないレガシーキー、bring-your-own-key リクエスト、またはキューで実行できないモデルは、送信ルートで `not_enabled` とともに `403` を返します。どちらのモードもコールバックや Webhook は提供しません。 -リクエストを十分な時間開いたままにできない場合は、キューに投入してください。プロバイダー自身の送信とポーリングの制御が必要な場合は、[パートナープロキシ](#routerはすべてのパートナー操作をカバーしていない)を使用してください。 +リクエストを十分な時間開いたままにできない場合は、キューに投入してください。プロバイダー自身の送信とポーリングの制御が必要な場合は、[パートナープロキシ](#routerはすべてのパートナー操作をカバーしているわけではない)を使用してください。 現在、4 つのモデルが同期専用であり、キューに送信すると `403` / `not_enabled` で拒否されます。`elevenlabs/eleven_sfx_v2`、`elevenlabs/eleven_v3`、`elevenlabs/eleven_v4`、`elevenlabs/eleven_v4_turbo` です。これらは JSON の結果ドキュメントではなく生のオーディオバイト列を返すため、キューによる配信にはそれを保存する場所がありません。同期ルートで実行してください。同期ルートはこれらのバイト列を通常どおり返します。 -LTX v1 のテキストから動画へ、および画像から動画への操作も同じ理由で生のビデオバイト列を返すため、キューによる配信ではそれらを保存できません。ただし、これらに到達できるのは `/proxy/ltx/v1/…` の[パートナープロキシ](#routerはすべてのパートナー操作をカバーしていない)経由のみであり、Router のモデル id からは到達できません。すべての `ltx/*` カタログモデルは、キューに投入可能な v2 の送信とポーリングの操作に解決されるためです。 +LTX v1 のテキストから動画へ、および画像から動画への操作も同じ理由で生のビデオバイト列を返すため、キューによる配信ではそれらを保存できません。ただし、これらに到達できるのは `/proxy/ltx/v1/…` の[パートナープロキシ](#routerはすべてのパートナー操作をカバーしているわけではない)経由のみであり、Router のモデル id からは到達できません。すべての `ltx/*` カタログモデルは、キューに投入可能な v2 の送信とポーリングの操作に解決されるためです。 ## サーバーのデッドラインで呼び出しが打ち切られます @@ -102,9 +102,9 @@ Router は最終レスポンスのみを返し、ストリーミングされる レスポンスにはプロバイダーの使用量またはコストのフィールドが含まれる場合があります。これらは Comfy の一律の課金を表すものではありません。`X-Comfy-Credits-Used` はオプションです。ヘッダーが不足している場合は、コストが報告されなかったことを意味し、実行が無料だったことを意味するものではありません。リプレイされたレスポンス(`Idempotent-Replayed: true`)に対して再度課金されることはありませんが、元の実行の金額が再掲される場合があるため、1 つの `Idempotency-Key` のリトライをまたいでこのヘッダーを合算しないでください。残高、使用量、請求書については Comfy プラットフォームを使用してください。 -カタログは価格ではなく、`billing.charges_on_policy_rejection` を含む請求に関する事実を提供します。`yes`、`no`、`unknown` を明示的に処理してください。詳細は [billing](/ja/development/comfy-router/billing#モデル課金に関する事実) を参照してください。 +カタログは価格ではなく、`billing.charges_on_policy_rejection` を含む請求に関する事実を提供します。`yes`、`no`、`unknown` を明示的に処理してください。`yes` の場合、同期の `content_policy_violation` エラーに `X-Comfy-Credits-Used` が含まれることがあります。プロバイダーがモデルの生成済みの出力を拒否し、Comfy がその拒否された生成に対して使用量を記録した場合には含まれ、その量が記載されます。入力側の拒否と同一キーのリプレイには含まれません。ヘッダーのない拒否は報告されていないのであり、無料ではありません。詳細は [billing](/ja/development/comfy-router/billing#モデル課金に関する事実) を参照してください。 -実行前に価格を確認するには、`POST /v2/models/{provider}/{model}/estimate` を呼び出すか、キュー中の送信の `201` にある `estimate` オブジェクトを読み取ってください。estimate の展開中は、このルートは `error_type: not_enabled` とともに `403` を返し、送信には `estimate` が含まれません。それぞれは Comfy がその実行に対して請求するレートカードに基づいて価格が決まりますが、その金額は見積もりであり最終的な請求額ではなく、ワークスペースの使用量と請求の記録に確定した請求額が最終となります。また、価格を固定するものでもありません。独自のプロバイダーキーでの実行は、`/estimate` がその実行の金額を返したとしても Comfy からは請求されません。また、`unknown` の estimate には金額が含まれておらず、それは無料を意味するものではありません。`X-Comfy-Credits-Used` は、実行に対する事後的な丸められた数値のままですが、領収書ではありません。`exact`、`estimated`、`unknown` の読み取り方については、[実行前のコスト見積もり](/ja/development/comfy-router/reference#事前のコスト見積もり) を参照してください。実行前に価格を算出できないモデルは、[事前見積もりがないモデル](#事前見積もりのないモデル) に一覧されています。 +実行前に価格を確認するには、`POST /v2/models/{provider}/{model}/estimate` を呼び出すか、キュー中の送信の `201` にある `estimate` オブジェクトを読み取ってください。estimate の展開中は、このルートは `error_type: not_enabled` とともに `403` を返し、送信には `estimate` が含まれません。それぞれは Comfy がその実行に対して請求するレートカードに基づいて価格が決まります(ベンダーが報告するコストを請求されるモデルは、代わりにベンダーの公開価格表から見積もられます)が、その金額は見積もりであり最終的な請求額ではなく、ワークスペースの使用量と請求の記録に確定した請求額が最終となります。また、価格を固定するものでもありません。独自のプロバイダーキーでの実行は、`/estimate` がその実行の金額を返したとしても Comfy からは請求されません。また、`unknown` の estimate には金額が含まれておらず、それは無料を意味するものではありません。`X-Comfy-Credits-Used` は、実行に対する事後的な丸められた数値のままですが、領収書ではありません。`exact`、`estimated`、`unknown` の読み取り方については、[実行前のコスト見積もり](/ja/development/comfy-router/reference#事前のコスト見積もり) を参照してください。実行前に価格を算出できないモデルは、[事前見積もりがないモデル](#事前見積もりのないモデル) に一覧されています。 ## 事前見積もりのないモデル @@ -114,36 +114,40 @@ Router は、以下のモデルへの呼び出しを実行前に確実に価格 {/* BEGIN GENERATED: models without a pre-flight estimate. Do not hand-edit; regenerate with -update-quote-coverage-docs. */} -- **bfl**: `bfl/erase-v1`, `bfl/flux-2-max`, `bfl/flux-2-pro`, `bfl/flux-3-image`, `bfl/flux-3-video`, `bfl/flux-kontext-max`, `bfl/flux-kontext-pro`, `bfl/flux-pro-1.0-expand`, `bfl/flux-pro-1.0-fill`, `bfl/flux-pro-1.1`, `bfl/flux-pro-1.1-ultra`, `bfl/video-edit-v1`, `bfl/video-upscale-v1`, `bfl/vto-v1` +- **bfl**: `bfl/erase-v1`, `bfl/video-edit-v1`, `bfl/video-upscale-v1`, `bfl/vto-v1` - **byteplus**: `byteplus/seed-audio-1.0`, `byteplus/seed-audio-1.0-multilingual` -- **elevenlabs**: `elevenlabs/eleven_sfx_v2` - **fal**: `fal/crystal-upscaler`, `fal/crystal-video-upscaler`, `fal/fal-gpt-image-2`, `fal/fal-gpt-image-2.5-flare`, `fal/fal-gpt-image-2.5-sunburst`, `fal/fal-nano-banana-2`, `fal/fal-nano-banana-pro`, `fal/fal-seedance-2.0`, `fal/fal-seedance-2.5`, `fal/flux-3-max`, `fal/patina` - **freepik**: `freepik/ai-image-upscaler-precision-v2`, `freepik/ai-skin-enhancer-creative`, `freepik/ai-skin-enhancer-faithful`, `freepik/ai-skin-enhancer-flexible` - **heygen**: `heygen/starfish` - **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` +- **luma**: `luma/photon-1`, `luma/photon-flash-1` - **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` +- **openai**: `openai/gpt-image-1.5` - **openrouter**: `openrouter/chat-completions` - **pika**: `pika/pika-gpt-image-2`, `pika/pika-nano-banana-2`, `pika/pika-nano-banana-pro` -- **recraft**: `recraft/recraftv2`, `recraft/recraftv3`, `recraft/recraftv4`, `recraft/recraftv4_1`, `recraft/recraftv4_1_pro`, `recraft/recraftv4_1_pro_vector`, `recraft/recraftv4_1_utility`, `recraft/recraftv4_1_utility_pro`, `recraft/recraftv4_1_utility_pro_vector`, `recraft/recraftv4_1_utility_vector`, `recraft/recraftv4_1_vector`, `recraft/recraftv4_pro`, `recraft/recraftv4_styles`, `recraft/recraftv4_styles_pro`, `recraft/recraftv4_styles_pro_vector`, `recraft/recraftv4_styles_vector` - **runware**: `runware/runware-gpt-image-2`, `runware/runware-gpt-image-2.5-flare`, `runware/runware-gpt-image-2.5-sunburst`, `runware/runware-nano-banana-2`, `runware/runware-nano-banana-pro`, `runware/runware-seedance-2.0`, `runware/runware-seedance-2.5` -- **runway**: `runway/gen4_image` - **synclabs**: `synclabs/sync-3` - **veed**: `veed/clean-audio`, `veed/clean-audio-video`, `veed/fabric-1.0`, `veed/lipsync-2.0`, `veed/video-background-removal`, `veed/video-background-removal-fast`, `veed/video-background-removal-green-screen` -- **wavespeed**: `wavespeed/flashvsr`, `wavespeed/seedvr2`, `wavespeed/ultimate-image-upscaler`, `wavespeed/wavespeed-gpt-image-2`, `wavespeed/wavespeed-gpt-image-2.5-flare`, `wavespeed/wavespeed-gpt-image-2.5-sunburst` -- **xai**: `xai/grok-imagine-image`, `xai/grok-imagine-image-2.0`, `xai/grok-imagine-image-pro`, `xai/grok-imagine-image-quality`, `xai/grok-imagine-video`, `xai/grok-imagine-video-1.5`, `xai/grok-imagine-video-1.5-lite`, `xai/grok-imagine-video-1.5-preview` +- **wavespeed**: `wavespeed/wavespeed-gpt-image-2`, `wavespeed/wavespeed-gpt-image-2.5-flare`, `wavespeed/wavespeed-gpt-image-2.5-sunburst` {/* END GENERATED: models without a pre-flight estimate */} -## Routerはすべてのパートナー操作をカバーしていない +`openai/gpt-image-2`、`openai/gpt-image-2.5-flare`、`openai/gpt-image-2.5-sunburst` での編集にも事前見積もりはありません。これらのモデルへの編集呼び出し、または入力画像を伴う生成呼び出しは `source: unknown` を返します。これらへのテキストのみの生成呼び出しは見積もりの対象となるため、上記のリストには含まれていません。 -Routerはモデルを実行します。ファイルのアップロード、アカウントの読み取り、アセット管理、ストリーミング、プロバイダーのジョブ制御には、`/proxy/…` 配下のパートナープロキシルートが必要になる場合があります。これらはRouterの外部にあり、そのコントラクトには記述されていません。Router自体のサーフェスは [Comfy Router specification](/router-openapi.yaml) です。サポートはプロバイダーによって異なります。 +## Routerはすべてのパートナー操作をカバーしているわけではない -### Krea 3の参照画像は先にアップロードする必要があります +Routerはモデルを実行します。ファイルのアップロード、アカウントの読み取り、アセット管理、ストリーミング、プロバイダーのジョブ制御には、`/proxy/…` 配下のパートナープロキシルートが必要になる場合があります。これらはRouterの外部にあり、Routerのコントラクトには記述されていません。Router自体のサーフェスは [Comfy Router specification](/router-openapi.yaml) です。サポートはプロバイダーによって異なります。 -`krea/krea-3` は任意の画像リンクを受け付けません。`image_urls` の各エントリは、`POST /proxy/krea/assets` が返す `image_url`(`https://app-uploads.krea.ai/...` 形式のURL)である必要があります。Routerがチェックするのは、リンクが `https` URLとしてパースでき、ホストが厳密に `app-uploads.krea.ai` であること(他のホストや明示的なポートは不可)だけです。それ以外のリンクは、自分でホストしている公開 `https` URLであっても、モデルの実行前に `400` `invalid_input` で拒否されます。このチェックを通過しても実際のアップロードではないリンク(期限切れ、削除済み、入力ミス)はそのまま通ってしまい、Routerは画像のサイズを読み取れずに `400` ではなく `5xx` エラーを返します。そのため、`image_url` は必ずアップロードが返したとおりに渡してください。 +### Krea 3の参照画像:先にアップロードするか、公開https URLを使用する + +`krea/krea-3` の `image_urls` では、`POST /proxy/krea/assets` が返す `image_url`(`https://app-uploads.krea.ai/...` 形式のURL)は常に受け付けられます。他のリンクが受け付けられるかどうかは環境によって異なり、api.comfy.org では現在受け付けられます。 + +- **他のリンクが受け付けられる場合**、公開された `https` の画像URLであればどれでも使用できます。Routerはモデルの実行前に各画像のサイズを読み取ります。ホストが公開されておらず到達できない、または存在しないリンク、`408` と `429` 以外の `4xx` を返すリンク、画像ではないリンクは、そのホスト名を示す `400` `invalid_input` で拒否されます。一時的なDNS、TLS、接続の失敗、タイムアウト、またはオリジンからの `408` や `429` は `502` エラーになります。実際のアップロードではない `app-uploads.krea.ai` のリンクは、他の到達不能な参照と同様に `400` で拒否されます。サーバーの起動直後、どのルールが適用されるかをまだ学習していない間は、`app-uploads.krea.ai` のリンクではない公開 `https` URLが、再試行しても安全な `503` で失敗することがあります。 +- **他のリンクが受け付けられない場合**、すべてのエントリはアップロードの `image_url` でなければなりません。Routerは、リンクが `https` URLとしてパースでき、ホストが厳密に `app-uploads.krea.ai` であること(他のホストや明示的なポートは不可)だけをチェックします。それ以外のリンクは、自分でホストしている公開 `https` URLであっても、モデルの実行前に `400` `invalid_input` で拒否されます。このチェックを通過しても実際のアップロードではないリンク(期限切れ、削除済み、入力ミス)はそのまま通ってしまい、Routerは画像のサイズを読み取れずに `400` ではなく `5xx` エラーを返します。 + +アップロードはどの環境でも機能するため、移植性のある選択肢です。`image_url` は必ずアップロードが返したとおりに渡してください。 1. 各参照画像を `multipart/form-data` としてアップロードし、画像はフォームフィールド `file` に入れます(JPEG、PNG、WebP、最大75 MB)。認証はRouterの場合と同じく、`X-API-Key` または `Authorization: Bearer` を使用します。 diff --git a/ja/development/comfy-router/litellm.mdx b/ja/development/comfy-router/litellm.mdx index 543301c2ef..8e91bb3b2c 100644 --- a/ja/development/comfy-router/litellm.mdx +++ b/ja/development/comfy-router/litellm.mdx @@ -2,12 +2,12 @@ title: "LiteLLMでComfy Routerを使用する" sidebarTitle: "LiteLLM" description: "Comfy RouterをパススルーエンドポイントとしてLiteLLM Proxyの背後に配置し、x-litellm-response-costヘッダーから各実行の正確なUSDコストを記録します。料金表を維持する必要はありません。" -translationSourceHash: e35cd883 +translationSourceHash: 8183ff58 translationFrom: development/comfy-router/litellm.mdx translationBlockHashes: "_intro": 1ddb0d0a "Configure the pass-through": 380c3ae3 - "How spend is recorded": f852c18c + "How spend is recorded": 699ed64b "Queued delivery": 46044c93 "Notes": 50e3cf6b --- @@ -102,11 +102,11 @@ X-Litellm-Total-Tokens: 0 - Comfy クレジットではなく、自分のプロバイダーキーに請求される実行 - Router の、実行ごとのクレジット価格を報告するモデルのリストにまだ載っていないモデル。そのリストは保守的で、一部のプロバイダーはまったく載っていません - Comfy の請求に到達しなかった課金 -- エラーレスポンス +- エラーレスポンス。`billing.charges_on_policy_rejection` が `yes` であるモデルからの同期的な `content_policy_violation` は、拒否された生成の価格とともに `X-Comfy-Credits-Used` を持つことがありますが、`x-litellm-response-cost` を持つことはありません。エラーは LiteLLM が計上すべき結果ではないためです また、Router が同じ `Idempotency-Key`(プロキシ経由では `x-pass-Idempotency-Key` として送信)を使ったリトライのために保存済みの結果を再生する場合にも存在しません。そのリトライは再度課金されないため、再生はその実行の正確なコストを二度目に報告しません。同じ理由で、キュー中の実行では、その実行の価格が記録された後の最初の結果コレクションだけがこのヘッダーを持ちます。同じ結果をもう一度収集しても `X-Comfy-Credits-Used` は返りますが、`x-litellm-response-cost` は返りません。 -ヘッダーが存在しない場合、LiteLLM はエンドポイントの `cost_per_request` にフォールバックします。これは上記のすべてのケースに当てはまります。したがって、エラーレスポンス、自分のプロバイダーキーに請求される実行、冪等な再生は、Comfy がそれらのクレジットを請求していなくても、あなたの見積もり額で記録されます。典型的な実行の妥当な見積もりを `0` ではなく設定してください。そうすれば、コストを報告しない実行が支出レポートで無料として表示されません。また、それらの行によって LiteLLM の合計が Comfy の請求額を上回ることを想定してください。価格が付けられ、本当にコストがかからなかった実行は `x-litellm-response-cost: 0` を報告し、LiteLLM はこれをゼロとして記録します。 +ヘッダーが存在しない場合、LiteLLM はエンドポイントの `cost_per_request` にフォールバックします。これは上記のすべてのケースに当てはまります。したがって、エラーレスポンス、自分のプロバイダーキーに請求される実行、冪等な再生は、あなたの見積もり額で記録されます。これらのほとんどはあなたのクレジットに請求されていませんが、すべてではありません。`X-Comfy-Credits-Used` を伴うコンテンツポリシーによる拒否には価格が付けられているため、そのコストはそのヘッダーから読み取ってください。また、Router があなたに返せなかった生成など、一部のその他の失敗は、コストを報告せずに請求されることがあります。照合はワークスペースの使用記録に対して行ってください。`0` ではなく、典型的な実行の妥当な見積もりを設定してください。そうすれば、コストを報告しない実行が支出レポートで無料として表示されません。また、それらの行によって LiteLLM の合計が Comfy の請求額を上回ることを想定してください。価格が付けられ、本当にコストがかからなかった実行は `x-litellm-response-cost: 0` を報告し、LiteLLM はこれをゼロとして記録します。 ## キュー配信 diff --git a/ja/development/comfy-router/models.mdx b/ja/development/comfy-router/models.mdx index 4baac8dd47..b7c6462e15 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: 3c934831 translationFrom: development/comfy-router/models.mdx translationBlockHashes: "_intro": 2584e428 - "Find by output": 380e121d + "Find by output": 9b1b4039 "Anthropic": de8acc20 "Beeble": b52ea340 "Black Forest Labs": 2934e3eb @@ -23,12 +23,12 @@ translationBlockHashes: "Kling": 3002befa "Krea": 16b83e5e "LTX": 32595bf9 - "Luma": 37a12a19 + "Luma": 8cd2a7ce "Luma 2": 585eb637 - "Meshy": 9292a0a8 + "Meshy": 67e26a17 "MiniMax": 87560ab7 "Moonvalley": 9e63fb77 - "OpenAI": c5c4af80 + "OpenAI": a5c1e692 "Openrouter": a4f6806b "Pika": f2b1d797 "Pruna": 903d76ee @@ -53,7 +53,7 @@ translationBlockHashes: ## 出力から探す - + - [SwitchX](/ja/development/comfy-router/models/beeble/switchx/code): `beeble/switchx` - [FLUX 3 Video](/ja/development/comfy-router/models/black-forest-labs/flux-3-video/code): `bfl/flux-3-video` @@ -89,8 +89,6 @@ translationBlockHashes: - [LTX 2.5 Fast](/ja/development/comfy-router/models/ltx/ltx-2-5-fast/code): `ltx/ltx-2-5-fast` - [LTX 2.5 Pro](/ja/development/comfy-router/models/ltx/ltx-2-5-pro/code): `ltx/ltx-2-5-pro` - [Ray 3.2](/ja/development/comfy-router/models/luma_2/ray-3-2/code): `luma_2/ray-3.2` -- [Ray 2](/ja/development/comfy-router/models/luma/ray-2/code): `luma/ray-2` -- [Ray Flash 2](/ja/development/comfy-router/models/luma/ray-flash-2/code): `luma/ray-flash-2` - [MiniMax H3](/ja/development/comfy-router/models/minimax/minimax-h3/code): `minimax/minimax-h3` - [Image To Video](/ja/development/comfy-router/models/moonvalley/image-to-video/code): `moonvalley/image-to-video` - [Text To Video](/ja/development/comfy-router/models/moonvalley/text-to-video/code): `moonvalley/text-to-video` @@ -106,8 +104,7 @@ translationBlockHashes: - [Lipsync 2.0](/ja/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` - [Video Background Removal Fast](/ja/development/comfy-router/models/veed/video-background-removal-fast/code): `veed/video-background-removal-fast` - [Video Background Removal Green Screen](/ja/development/comfy-router/models/veed/video-background-removal-green-screen/code): `veed/video-background-removal-green-screen` -- [Video Background Removal](/ja/development/comfy-router/models/veed/video-background-removal/code): `veed/video-background-removal` -- [Veo 3.1 Fast Generate 001](/ja/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code): `veo/veo-3.1-fast-generate-001` +- [Video Background Removal](/ja/development/comfy-router/models/veed/video-background-removal/code): `veed/video-background-removal`- [Veo 3.1 Fast Generate 001](/ja/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code): `veo/veo-3.1-fast-generate-001` - [Veo 3.1 Generate 001](/ja/development/comfy-router/models/veo/veo-3-1-generate-001/code): `veo/veo-3.1-generate-001` - [Veo 3.1 Lite Generate 001](/ja/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code): `veo/veo-3.1-lite-generate-001` - [HappyHorse 1.0 I2V](/ja/development/comfy-router/models/wan/happyhorse-1-0-i2v/code): `wan/happyhorse-1.0-i2v` @@ -135,7 +132,7 @@ translationBlockHashes: - [Grok Imagine Video](/ja/development/comfy-router/models/xai/grok-imagine-video/code): `xai/grok-imagine-video` - + - [SwitchX](/ja/development/comfy-router/models/beeble/switchx/code): `beeble/switchx` - [Erase V1](/ja/development/comfy-router/models/black-forest-labs/erase-v1/code): `bfl/erase-v1` @@ -161,8 +158,7 @@ translationBlockHashes: - [Image Edit Remove Background Guided](/ja/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` - [Image Edit Remove Background](/ja/development/comfy-router/models/bria/image-edit-remove-background/code): `bria/image-edit-remove-background` - [Image Edit Replace Background](/ja/development/comfy-router/models/bria/image-edit-replace-background/code): `bria/image-edit-replace-background` -- [Image Edit Replace Object By Text](/ja/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text` -- [Image Edit Reseason](/ja/development/comfy-router/models/bria/image-edit-reseason/code): `bria/image-edit-reseason` +- [Image Edit Replace Object By Text](/ja/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text`- [Image Edit Reseason](/ja/development/comfy-router/models/bria/image-edit-reseason/code): `bria/image-edit-reseason` - [Image Edit Restore](/ja/development/comfy-router/models/bria/image-edit-restore/code): `bria/image-edit-restore` - [Image](/ja/development/comfy-router/models/bria/image/code): `bria/image` - [Seedream 4.0 250828](/ja/development/comfy-router/models/byteplus/seedream-4-0-250828/code): `byteplus/seedream-4-0-250828` @@ -198,7 +194,6 @@ translationBlockHashes: - [Photon 1](/ja/development/comfy-router/models/luma/photon-1/code): `luma/photon-1` - [Photon Flash 1](/ja/development/comfy-router/models/luma/photon-flash-1/code): `luma/photon-flash-1` - [GPT Image 1.5](/ja/development/comfy-router/models/openai/gpt-image-1-5/code): `openai/gpt-image-1.5` -- [GPT Image 1](/ja/development/comfy-router/models/openai/gpt-image-1/code): `openai/gpt-image-1` - [GPT Image 2.5 Flare](/ja/development/comfy-router/models/openai/gpt-image-2-5-flare/code): `openai/gpt-image-2.5-flare` - [GPT Image 2.5 Sunburst](/ja/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code): `openai/gpt-image-2.5-sunburst` - [GPT Image 2](/ja/development/comfy-router/models/openai/gpt-image-2/code): `openai/gpt-image-2` @@ -214,8 +209,7 @@ translationBlockHashes: - [Recraft V4.1 Utility](/ja/development/comfy-router/models/recraft/recraftv4-1-utility/code): `recraft/recraftv4_1_utility` - [Recraft V4.1 Vector](/ja/development/comfy-router/models/recraft/recraftv4-1-vector/code): `recraft/recraftv4_1_vector` - [Recraft V4.1](/ja/development/comfy-router/models/recraft/recraftv4-1/code): `recraft/recraftv4_1` -- [Recraft V4 Pro](/ja/development/comfy-router/models/recraft/recraftv4-pro/code): `recraft/recraftv4_pro` -- [Recraft V4 Styles Pro Vector](/ja/development/comfy-router/models/recraft/recraftv4-styles-pro-vector/code): `recraft/recraftv4_styles_pro_vector` +- [Recraft V4 Pro](/ja/development/comfy-router/models/recraft/recraftv4-pro/code): `recraft/recraftv4_pro`- [Recraft V4 Styles Pro Vector](/ja/development/comfy-router/models/recraft/recraftv4-styles-pro-vector/code): `recraft/recraftv4_styles_pro_vector` - [Recraft V4 Styles Pro](/ja/development/comfy-router/models/recraft/recraftv4-styles-pro/code): `recraft/recraftv4_styles_pro` - [Recraft V4 Styles Vector](/ja/development/comfy-router/models/recraft/recraftv4-styles-vector/code): `recraft/recraftv4_styles_vector` - [Recraft V4 Styles](/ja/development/comfy-router/models/recraft/recraftv4-styles/code): `recraft/recraftv4_styles` @@ -269,14 +263,13 @@ translationBlockHashes: - [Wan 2.5 T2V Preview](/ja/development/comfy-router/models/wan/wan2-5-t2v-preview/code): `wan/wan2.5-t2v-preview` - [Wan 2.6 I2V](/ja/development/comfy-router/models/wan/wan2-6-i2v/code): `wan/wan2.6-i2v` - [Wan 2.6 R2V](/ja/development/comfy-router/models/wan/wan2-6-r2v/code): `wan/wan2.6-r2v` -- [Wan 2.6 T2V](/ja/development/comfy-router/models/wan/wan2-6-t2v/code): `wan/wan2.6-t2v` -- [Wan 2.7 I2V](/ja/development/comfy-router/models/wan/wan2-7-i2v/code): `wan/wan2.7-i2v` +- [Wan 2.6 T2V](/ja/development/comfy-router/models/wan/wan2-6-t2v/code): `wan/wan2.6-t2v`- [Wan 2.7 I2V](/ja/development/comfy-router/models/wan/wan2-7-i2v/code): `wan/wan2.7-i2v` - [Wan 2.7 T2V](/ja/development/comfy-router/models/wan/wan2-7-t2v/code): `wan/wan2.7-t2v` - [Wan 3.0 Video Prime](/ja/development/comfy-router/models/wan/wan3-0-video-prime/code): `wan/wan3.0-video-prime` - [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 6](/ja/development/comfy-router/models/meshy/meshy-6/code): `meshy/meshy-6` @@ -290,7 +283,7 @@ translationBlockHashes: - [Hunyuan 3D Uv](/ja/development/comfy-router/models/tencent/hunyuan-3d-uv/code): `tencent/hunyuan-3d-uv` - + - [Claude Fable 5.1](/ja/development/comfy-router/models/anthropic/claude-fable-5-1/code): `anthropic/claude-fable-5-1` - [Claude Fable 5](/ja/development/comfy-router/models/anthropic/claude-fable-5/code): `anthropic/claude-fable-5` @@ -319,7 +312,6 @@ translationBlockHashes: - [Nano Banana 2](/ja/development/comfy-router/models/google/nano-banana-2/code): `vertexai/gemini-3.1-flash-image` - [Nano Banana Pro](/ja/development/comfy-router/models/google/nano-banana-pro/code): `vertexai/gemini-3-pro-image` - [GPT 4.1 Mini](/ja/development/comfy-router/models/openai/gpt-4-1-mini/code): `openai/gpt-4.1-mini` -- [GPT 4.1 Nano](/ja/development/comfy-router/models/openai/gpt-4-1-nano/code): `openai/gpt-4.1-nano` - [GPT 4.1](/ja/development/comfy-router/models/openai/gpt-4-1/code): `openai/gpt-4.1` - [GPT 4o](/ja/development/comfy-router/models/openai/gpt-4o/code): `openai/gpt-4o` - [GPT 5.5 Pro](/ja/development/comfy-router/models/openai/gpt-5-5-pro/code): `openai/gpt-5.5-pro` @@ -332,11 +324,7 @@ translationBlockHashes: - [GPT 5](/ja/development/comfy-router/models/openai/gpt-5/code): `openai/gpt-5` - [GPT 6 Astra](/ja/development/comfy-router/models/openai/gpt-6-astra/code): `openai/gpt-6-astra` - [GPT 6 Luna](/ja/development/comfy-router/models/openai/gpt-6-luna/code): `openai/gpt-6-luna` -- [GPT 6 Sol](/ja/development/comfy-router/models/openai/gpt-6-sol/code): `openai/gpt-6-sol` -- [o1-pro](/ja/development/comfy-router/models/openai/o1-pro/code): `openai/o1-pro` -- [o1](/ja/development/comfy-router/models/openai/o1/code): `openai/o1` -- [o3](/ja/development/comfy-router/models/openai/o3/code): `openai/o3` -- [o4-mini](/ja/development/comfy-router/models/openai/o4-mini/code): `openai/o4-mini` +- [GPT 6 Sol](/ja/development/comfy-router/models/openai/gpt-6-sol/code): `openai/gpt-6-sol`- [o3](/ja/development/comfy-router/models/openai/o3/code): `openai/o3` - [Chat Completions](/ja/development/comfy-router/models/openrouter/chat-completions/code): `openrouter/chat-completions` @@ -543,8 +531,6 @@ translationBlockHashes: | --- | --- | --- | --- | | [Photon 1](/ja/development/comfy-router/models/luma/photon-1/code) | `luma/photon-1` | テキスト | 画像 | | [Photon Flash 1](/ja/development/comfy-router/models/luma/photon-flash-1/code) | `luma/photon-flash-1` | テキスト | 画像 | -| [Ray 2](/ja/development/comfy-router/models/luma/ray-2/code) | `luma/ray-2` | テキスト, 画像 | ビデオ | -| [Ray Flash 2](/ja/development/comfy-router/models/luma/ray-flash-2/code) | `luma/ray-flash-2` | テキスト, 画像 | ビデオ | ## Luma 2 @@ -584,7 +570,6 @@ translationBlockHashes: | モデル | ID | 入力 | 出力 | | --- | --- | --- | --- | | [GPT 4.1 Mini](/ja/development/comfy-router/models/openai/gpt-4-1-mini/code) | `openai/gpt-4.1-mini` | テキスト, 画像 | テキスト | -| [GPT 4.1 Nano](/ja/development/comfy-router/models/openai/gpt-4-1-nano/code) | `openai/gpt-4.1-nano` | テキスト, 画像 | テキスト | | [GPT 4.1](/ja/development/comfy-router/models/openai/gpt-4-1/code) | `openai/gpt-4.1` | テキスト, 画像 | テキスト | | [GPT 4o](/ja/development/comfy-router/models/openai/gpt-4o/code) | `openai/gpt-4o` | テキスト, 画像 | テキスト | | [GPT 5.5 Pro](/ja/development/comfy-router/models/openai/gpt-5-5-pro/code) | `openai/gpt-5.5-pro` | テキスト, 画像 | テキスト | @@ -599,14 +584,10 @@ translationBlockHashes: | [GPT 6 Luna](/ja/development/comfy-router/models/openai/gpt-6-luna/code) | `openai/gpt-6-luna` | テキスト, 画像 | テキスト | | [GPT 6 Sol](/ja/development/comfy-router/models/openai/gpt-6-sol/code) | `openai/gpt-6-sol` | テキスト, 画像 | テキスト | | [GPT Image 1.5](/ja/development/comfy-router/models/openai/gpt-image-1-5/code) | `openai/gpt-image-1.5` | テキスト, 画像 | 画像 | -| [GPT Image 1](/ja/development/comfy-router/models/openai/gpt-image-1/code) | `openai/gpt-image-1` | テキスト, 画像 | 画像 | | [GPT Image 2.5 Flare](/ja/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | `openai/gpt-image-2.5-flare` | テキスト, 画像 | 画像 | | [GPT Image 2.5 Sunburst](/ja/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | `openai/gpt-image-2.5-sunburst` | テキスト, 画像 | 画像 | | [GPT Image 2](/ja/development/comfy-router/models/openai/gpt-image-2/code) | `openai/gpt-image-2` | テキスト, 画像 | 画像 | -| [o1-pro](/ja/development/comfy-router/models/openai/o1-pro/code) | `openai/o1-pro` | テキスト, 画像 | テキスト | -| [o1](/ja/development/comfy-router/models/openai/o1/code) | `openai/o1` | テキスト, 画像 | テキスト | | [o3](/ja/development/comfy-router/models/openai/o3/code) | `openai/o3` | テキスト, 画像 | テキスト | -| [o4-mini](/ja/development/comfy-router/models/openai/o4-mini/code) | `openai/o4-mini` | テキスト, 画像 | テキスト | ## Openrouter diff --git a/ja/development/comfy-router/models/black-forest-labs/flux-video-upscale/code.mdx b/ja/development/comfy-router/models/black-forest-labs/flux-video-upscale/code.mdx index bf2dfa22eb..7a24e45dfb 100644 --- a/ja/development/comfy-router/models/black-forest-labs/flux-video-upscale/code.mdx +++ b/ja/development/comfy-router/models/black-forest-labs/flux-video-upscale/code.mdx @@ -2,16 +2,17 @@ title: "FLUX Video Upscale を Comfy Router で使用する" description: "Comfy Router 経由で HTTP 上で FLUX Video Upscale を使ってビデオをアップスケーリングするための Python、TypeScript、cURL スニペット、およびリクエストフィールドと結果の形状" sidebarTitle: "FLUX Video Upscale" -translationSourceHash: 0b09f0ee +translationSourceHash: 37a8dde1 translationFrom: development/comfy-router/models/black-forest-labs/flux-video-upscale/code.mdx translationBlockHashes: "_intro": cf804f5f "Quick start": b745a238 - "Schema": 4675f835 + "Schema": c0dca73f "Examples": d1ffa3d6 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -170,7 +171,7 @@ curl https://api.comfy.org/v2/models/bfl/video-upscale-v1/requests/$REQUEST_ID \ - アップスケールするビデオ。HTTP(S) URL または base64 エンコードされた MP4 のいずれかです。ソース映像は最大 20 秒、50MB までです。 + アップスケールするビデオ。HTTP(S) URL または base64 エンコードされた MP4 のいずれかです。ソース映像は最大 20 秒、50MB、1 フレームあたり 2560x1440(3.7 メガピクセル)までです。より大きなソースは送信前にダウンスケールしてください。 @@ -184,7 +185,7 @@ curl https://api.comfy.org/v2/models/bfl/video-upscale-v1/requests/$REQUEST_ID \ - ソース解像度に対する出力のスケール。出力はソースのアスペクト比を保持し、1 フレームあたり約 14.4 メガピクセルに制限されるため、非常に大きなソースでは要求した係数より小さくスケールされます。 + ソース解像度に対する出力のスケール。出力はソースのアスペクト比を保持し、1 フレームあたり約 14.4 メガピクセルに制限されるため、非常に大きなソースでは要求した係数より小さくスケールされます。解像度のオプションはありません。2K (2560x1440) や 4K (3840x2160) を目標にするには、目標の高さをソースの高さで割ってください。720p のソースは 2 で 2K、3 で 4K に達します。1080p のソースは 2 で 4K に達しますが、1.33 が必要な 2K には到達できません。 範囲: `1.5` から `3` @@ -201,7 +202,7 @@ curl https://api.comfy.org/v2/models/bfl/video-upscale-v1/requests/$REQUEST_ID \ フォーマット: `uri` -プロバイダーにリクエストが到達する前に呼び出しを検証する対象となるドキュメントと同じ、Router が `GET /v2/models/bfl/video-upscale-v1/openapi.json` で提供するスキーマから生成されています。 +Router が `GET /v2/models/bfl/video-upscale-v1/openapi.json` で提供するスキーマから生成されています。これは、プロバイダーにリクエストが到達する前に Router が呼び出しを検証する対象となる同じドキュメントです。 ### 出力 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..3ce1701cee 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,17 +2,18 @@ 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 --- + {/* 生成済みファイル。`router-schemas/bria/image-edit-relight.json` から `pnpm code-pages:gen` によって生成されました。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -160,7 +161,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" のいずれか。 @@ -205,7 +206,7 @@ Router が `GET /v2/models/bria/image-edit-relight/openapi.json` で提供する - プロンプトの洗練されたバージョン。Bria が洗練を行わなかった COMPLETED の生成では null になります。キーが省略されるのではなく null を保持した状態で存在するため Nullable です。bria/image-edit-gen-fill で実際に確認されています。 + プロンプトを洗練したバージョン。Bria が洗練を行わなかった COMPLETED の生成では null になります。キーは省略されるのではなく null を保持した状態で存在するため Nullable です。bria/image-edit-gen-fill で実際に確認されています。 diff --git a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx index 235bad36b1..2e1eb23bb3 100644 --- a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx +++ b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx @@ -2,19 +2,17 @@ title: "Dreamina Seedance 2.0 260128 を Comfy Router で使用する" description: "Comfy Router 経由で byteplus/dreamina-seedance-2-0-260128 を呼び出します。endpoint、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Dreamina Seedance 2.0 260128" -translationSourceHash: 98890ddf +translationSourceHash: 9604ca27 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx translationBlockHashes: "_intro": 54eac94b "Quick start": ca074ca5 "Serving providers": 74eb2a7c - "Schema": 5c27d10f + "Schema": 6c5da06a "Examples": 641c458b --- - - {/* 生成済みファイル。router-schemas/byteplus/dreamina-seedance-2-0-260128.json から `pnpm code-pages:gen` によって生成されます。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -376,6 +374,20 @@ false: 生成済みビデオの最後のフレーム画像を返しません。 生成されたビデオのコンテナ形式(mp4 または mov)です。BytePlus がこれを `content` の中にネストして返す場合に含まれます。Seedance モデルでは `content` のトップレベルの兄弟フィールドとして返すことの方が多く、その場合はトップレベルの `output_format` フィールドを参照してください。Router は存在する方のフィールドを読み取ります。 + + BytePlus 自身の出力ビデオのダウンロード URL で、再ホストされた `video_url` と並べてそのまま返されます。Comfy がサーバー側でオプトインしたワークスペースがポーリングした Seedance 2.x タスクにのみ存在し(リクエストパラメータはありません)、それ以外では存在しません。ワークスペースに解決されない資格情報(ワークスペースに紐付かないレガシー API キーなど)の場合や、BytePlus が生成から 24 時間後に URL を削除した後も同様です。これはオブジェクトストレージの署名付き URL であり、ベアラ認証情報でもあります。保持している誰でも失効までこのビデオをダウンロードできるため、シークレットとして扱ってください。失効時刻は `upstream_expires_at` で、Seedance 2.5 では BytePlus がダウンロードを 100 回までに制限しており、そのうち 1 回は Router 自身の再ホストが消費します。 + + + + BytePlus 自身のラストフレームのダウンロード URL で、再ホストされた `last_frame_url` と並べてそのまま返されます。条件は `upstream_video_url` と同じです。オプトインしたワークスペースのみ、Seedance 2.x のみで、BytePlus が削除すると存在せず、`upstream_expires_at` までベアラ認証情報です。 + + + + 上流 URL が使えなくなる RFC 3339 時刻です。URL 自体が持つ最も早い署名時刻に有効期間を加えたもので、`updated_at` がある場合はタスクの `updated_at` に 24 時間を加えた時刻(BytePlus が文書化している URL の寿命)を超えません。ない場合はタスクの `updated_at` に 24 時間を加えた時刻です。`upstream_video_url` または `upstream_last_frame_url` がある場合にのみ存在し、どちらも時刻を示さない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 + + 形式:`date-time` + + 出力ビデオのダウンロード URL です。Router はビデオを Comfy ストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL です。発行時に 24 時間で署名され、23 時間のメモから再生されるため、後からポーリングすると残り 1 時間しかない URL が返されることがあります。再ホストを実行できなかった場合、このフィールドには BytePlus 自身の URL がそのまま残ります。BytePlus はタスクの 24 時間後にその URL をクリアし、一部のモデルではダウンロード回数が 100 回に制限されます。いずれにせよリンクは失効するため、URL を保存するのではなくビデオをダウンロードしてください。 diff --git a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx index a76e21550a..2a713cce25 100644 --- a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx +++ b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx @@ -2,17 +2,16 @@ title: "Comfy Router で Dreamina Seedance 2.0 Fast 260128 を使用する" description: "Comfy Router 経由で byteplus/dreamina-seedance-2-0-fast-260128 を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Dreamina Seedance 2.0 Fast 260128" -translationSourceHash: acad6428 +translationSourceHash: b02c6ed1 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx translationBlockHashes: "_intro": e4deed0d "Quick start": f5201dd4 - "Schema": a00368da + "Schema": e03c503a "Examples": 7714eccd --- - {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/byteplus/dreamina-seedance-2-0-fast-260128.json から生成されました。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -181,7 +180,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128/ ### 入力 - この生成タスクの結果を受け取るコールバック通知アドレス + 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックは一切送信されません。結果は代わりにタスクステータスのルートをポーリングして取得してください。 形式: `uri` @@ -191,19 +190,19 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128/ - 入力オーディオオブジェクト。オーディオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単体では使用できず、少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力に対応しています。 + 入力オーディオオブジェクト。オーディオ入力は Seedance 2.5、2.0、2.0 fast、2.0 mini のみがサポートします。Seedance 2.0、2.0 fast、2.0 mini はオーディオのみで使用することはできません。少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力もサポートします。 - オーディオ URL、Base64 エンコード、またはアセット ID。 -オーディオ URL: オーディオの公開 URL(wav、mp3)。 + オーディオURL、Base64 エンコード、またはアセット ID。 +オーディオURL: オーディオの公開 URL(wav、mp3)。 Base64: 形式 data:audio/\;base64,\ アセット ID: 形式 asset://\ Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。唯一のコンテンツ項目である必要があります。 -最終ビデオは Draft タスクの prompt、入力アセット、duration、ratio、seed、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。resolution はデフォルトで 1080p となり、1080p のみをサポートします。 +最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。解像度はデフォルトで 1080p になり、1080p のみをサポートします。 @@ -215,15 +214,15 @@ Base64: 形式 data:audio/\;base64,\ - 画像から動画を生成するための画像コンテンツ(type が "image_url" の場合) -画像 URL: 画像 URL にアクセスできることを確認してください。 -Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります + 画像から動画への生成用の画像コンテンツ(type が "image_url" の場合) +画像URL: 画像URLにアクセス可能であることを確認してください。 +Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ アセット ID: 形式 asset://\ コンテンツ項目の役割/位置。 -画像の場合: first_frame、last_frame、または reference_image。 +画像の場合: first_frame、last_frame、reference_image。 ビデオの場合: reference_video(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 オーディオの場合: reference_audio(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 @@ -231,30 +230,22 @@ Base64 エンコードされたコンテンツ: 形式は data:image/\;b - モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータが含まれます。 + モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータを含みます。 テキストプロンプト(必須): 中国語および英語の文字を使用して生成するビデオの説明。 パラメータ(任意): テキストプロンプトの後に --[parameters] を追加してビデオの仕様を制御します: -- --resolution (--rs): 480p、720p、1080p(デフォルト: 720p) -- --ratio (--rt): 21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(デフォルト: 16:9 または adaptive) -- --duration (--dur): 3~12 秒(デフォルト: 5) -- --framepersecond (--fps): 24(デフォルト: 24) -- --watermark (--wm): true/false(デフォルト: false) -- --seed (--seed): -1~2^32-1(デフォルト: -1) -- --camerafixed (--cf): true/false(デフォルト: false) +- --resolution(--rs): 480p、720p、1080p(デフォルト: 720p) +- --ratio(--rt): 21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(デフォルト: 16:9 または adaptive) +- --duration(--dur): 3〜12 秒(デフォルト: 5) +- --framepersecond(--fps): 24(デフォルト: 24) +- --watermark(--wm): true/false(デフォルト: false) +- --seed(--seed): -1 から 2^32-1(デフォルト: -1) +- --camerafixed(--cf): true/false(デフォルト: false) 例: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -Comfy 側のガードレールであり、BytePlus の制約ではありません。BytePlus は -テキスト長の制限を公開しておらず、テスト(2026-09-17)では 40,000 文字を受け付けました。 -これは文字数をカウントし、バイト数ではないため、マルチバイトのプロンプトは -転送時にこのサイズの数倍になる可能性があります。これはこの 1 つのフィールドを制限するものであり、 -リクエストではありません: `content` は配列であり、ドキュメント全体を制限するのは -リクエストごとのボディ制限です。これを適用するのは Comfy Router(/v2/models/byteplus/\{model})であり、 -v1 /proxy への直接呼び出しでは代わりに BytePlus 自身のバリデータが応答します。実際のトラフィックより -はるかに高く設定されているため、本物のプロンプトを判定することはありません。呼び出し元がより多くを -必要とする場合は引き上げてください。 +Comfy 側のガードレールであり、BytePlus の制約ではありません。BytePlus はテキスト長の制限を公表しておらず、テスト(2026-09-17)では 40,000 文字を受け付けました。これはバイト数ではなく文字数を数えるため、マルチバイトのプロンプトは通信時にこのサイズの数倍になる可能性があります。これはこの 1 つのフィールドを制限するものであり、リクエストを制限するものではありません。`content` は配列であり、ドキュメント全体を制限するのはリクエストごとのボディ制限です。これを強制するのは Comfy Router(/v2/models/byteplus/\{model})です。直接 v1 /proxy を呼び出した場合は、代わりに BytePlus 独自のバリデータが応答します。実際のトラフィックよりはるかに大きく設定されているため、正当なプロンプトが拒否されることはありません。呼び出し元がより多くを必要とする場合は引き上げてください。 @@ -264,120 +255,137 @@ v1 /proxy への直接呼び出しでは代わりに BytePlus 自身のバリデ - 入力ビデオオブジェクト。ビデオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。 + 入力ビデオオブジェクト。ビデオ入力は Seedance 2.5、2.0、2.0 fast、2.0 mini のみがサポートします。 - ビデオ URL またはアセット ID。 -ビデオ URL: ビデオの公開 URL(mp4、mov)。 + ビデオURLまたはアセット ID。 +ビデオURL: ビデオの公開 URL(mp4、mov)。 アセット ID: 形式 asset://\ - Seedance 2.5 のみ。480p の Draft ビデオを生成します。resolution は 480p である必要があります。 -返されたタスク ID を `draft_task` コンテンツ項目に渡して、最終的な 1080p ビデオをレンダリングします。Draft タスク ID は 7 日間有効です。 + Seedance 2.5 のみ。480p の Draft ビデオを生成します。解像度は 480p である必要があります。 +最終的な 1080p ビデオをレンダリングするには、返されたタスク ID を `draft_task` コンテンツ項目で渡します。Draft タスク ID は 7 日間有効です。 ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動。ビデオ編集タスクは -1 のみをサポート)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。 - 範囲: `2` ~ `30` + 範囲: `2` から `30` タスクのタイムアウトしきい値(秒)。デフォルト 172800(48 時間)。範囲: [3600, 259200]。 - 範囲: `3600` ~ `259200` + 範囲: `3600` から `259200` Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されたビデオに映像と同期したオーディオが含まれるかどうか。 true: モデルは同期したオーディオ付きのビデオを出力します。 false: モデルは無音のビデオを出力します。 -対応しているモデルでは、生成されたオーディオトラックは映像とは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーが通常は受け入れる入力でも断続的に発生することがあります。その場合は `false` を送って無音のビデオを生成してください。これはオーディオが拒否されたモダリティである場合にのみ有効で、同期 Router レスポンスはそれを `refusal_subject: output_audio` として示します(キューに入れたリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を作り直してください。 +対応しているモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外は受け入れる入力に対しても断続的に発生することがあります。その場合はサイレントビデオにするために `false` を送信してください。これが有効なのは拒否されたモダリティがオーディオだった場合のみで、同期 Router レスポンスでは `refusal_subject: output_audio` として示されます(キューのリクエストではまだ識別されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を再作成してください。 + + - 呼び出すモデルの ID。サポートされているモデル: seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini、dreamina-seedance-2-5-260628。POST /proxy/byteplus/api/v3/contents/generations/tasks への直接 v1 呼び出しでは必ずこれを指定する必要があります。プロキシは他の値や省略された値を 400 で拒否します。これがこのスキーマの `required` リストに含まれていないのは、Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントからこれを補完するためであり、Router の呼び出し元は省略します。 + 呼び出すモデルの ID。サポートされるモデル: seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini、dreamina-seedance-2-5-260628。POST /proxy/byteplus/api/v3/contents/generations/tasks への直接の v1 呼び出しでは必ず指定する必要があります。プロキシはそれ以外の値や省略された値を 400 で拒否します。このスキーマの `required` リストに含まれていないのは、Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントからこれを埋めるためで、Router の呼び出し元は省略します。 - Seedance 2.5 のみ。出力ビデオのコンテナ形式。mp4: 汎用コンテナ(H.264/AAC、yuv420p)で、幅広い互換性とより小さなファイルサイズを実現します。 -mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)で、高い色精度を持ち、ポストプロダクションに適しています。ファイルサイズは大きくなります。 + Seedance 2.5 のみ。出力ビデオのコンテナ形式。 +mp4: 汎用コンテナ(H.264/AAC、yuv420p)で、幅広い互換性とより小さなファイルサイズ。 +mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)で、色精度が高くポストプロダクションに適しています。ファイルサイズは大きくなります。 - 指定可能な値: `mp4`, `mov` + 指定可能な値: `mp4`、`mov` - 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast、2.0 mini、1.5 pro のデフォルト: adaptive。 -Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive` のみ(またはフィールドの省略)が受け付けられます。具体的な比率を指定すると、ディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードでも具体的な比率を受け付けます。 + 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast & 2.0 mini、1.5 pro のデフォルト: adaptive。 +Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive` のみ(またはフィールドの省略)が受け入れられます。具体的な比率を指定すると、ディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードでも具体的な比率を受け入れます。 - 指定可能な値: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` + 指定可能な値: `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` - ビデオの解像度。Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro & pro-fast のデフォルト: 1080p。 -注: Seedance 2.0、2.0 fast、2.0 mini は 1080p をサポートしていません。Seedance 2.5 は 480p、720p、1080p をサポートしています。 + ビデオの解像度。Seedance 2.5、2.0、2.0 fast & 2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro & pro-fast のデフォルト: 1080p。 +注: Seedance 2.0、2.0 fast & 2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p をサポートします。 - 指定可能な値: `480p`, `720p`, `1080p`, `4k` + 指定可能な値: `480p`、`720p`、`1080p`、`4k` - 生成されるビデオの最終フレーム画像を返すかどうか。 -true: 生成されるビデオの最終フレーム画像を返します。このパラメータを true に設定すると、ビデオ生成タスクの情報を照会する API を呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、そのピクセル幅と高さは生成されるビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成されたビデオの最終フレームを次のビデオタスクの先頭フレームとして使用することで、複数の連続したビデオをすばやく生成できます。 -false: 生成されるビデオの最終フレーム画像を返しません。 + 生成されたビデオの最終フレーム画像を返すかどうか。 +true: 生成されたビデオの最終フレーム画像を返します。このパラメーターを true に設定すると、ビデオ生成タスクの情報のクエリを呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメーターを使用すると、複数の連続したビデオを生成できます。先に生成されたビデオの最終フレームを次のビデオタスクの先頭フレームとして使用し、複数の連続したビデオをすばやく生成できます。 +false: 生成されたビデオの最終フレーム画像を返しません。 - ランダム性を制御するためのシード整数。範囲: [-1, 2^32-1]。-1 はランダムシードを使用します。 + ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 はランダムシードを使用します。 - 範囲: `-1` ~ `4294967295` + 範囲: `-1` から `4294967295` - 処理に使用するサービスのティア。Seedance 2.5、2.0 & 2.0 fast は flex(オフライン推論)をサポートしていません。 + 処理のサービスティア。Seedance 2.5、2.0 & 2.0 fast は flex(オフライン推論)をサポートしません。 - 指定可能な値: `default`, `flex` + 指定可能な値: `default`、`flex` - 生成されるビデオにウォーターマークが含まれるかどうか。 + 生成されたビデオにウォーターマークが含まれるかどうか。 -`GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。 +`GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用する同じドキュメントです。 ### 出力 - ビデオ生成タスクの完了後の出力です。出力ビデオのダウンロード URL と、BytePlus が返す場合はその最終フレームのダウンロード URL を含みます。`video_url` と `last_frame_url` はどちらも Comfy ストレージに再ホストされます。ここにある他のフィールドはすべて BytePlus 自身のものです。Null 許容: BytePlus はタスクの24時間後に URL をクリアするため、その後でポーリングした成功ドキュメントでは `content` が存在しないか null になることがあります。 + ビデオ生成タスクの完了後の出力です。出力ビデオのダウンロードURLと、BytePlus が返す場合はその最終フレームのダウンロードURLを含みます。`video_url` と `last_frame_url` はいずれも Comfy のストレージに再ホストされ、ここにある他のフィールドはすべて BytePlus 自身のものです。null 許容: BytePlus はタスクの24時間後にURLをクリアするため、その後ポーリングした成功ドキュメントでは `content` が存在しないか null になっていることがあります。 - 生成されたビデオの最終フレームのダウンロード URL で、リクエストで `return_last_frame` を設定したときに返されます。この URL から画像形式を推測しないでください。BytePlus はリクエスト側で最終フレームを PNG として規定していますが、Router は渡されたバイト列をそのまま再ホストし、上流の Content-Type またはコンテンツスニッフィングから型を判定します。`image/jpeg` はその両方が失敗したときの最後の手段のフォールバックにすぎません。Router は最終フレームを Comfy ストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効な Comfy 署名付き URL になります。発行時に24時間で署名され、23時間のメモから再生されるため、後でポーリングすると残り1時間しかないものが返ることがあります。再ホストを実行できなかった場合、このフィールドには BytePlus 自身の URL がそのまま入り、BytePlus はタスクの24時間後にそれをクリアします。いずれにしてもリンクは失効するため、URL を保存するのではなくフレームをダウンロードしてください。 + 生成されたビデオの最終フレームのダウンロードURLで、リクエストで `return_last_frame` を設定した場合に返されます。このURLから画像形式を推測しないでください。BytePlus はリクエスト側で最終フレームを PNG として記載していますが、Router は渡されたバイト列をそのまま再ホストし、アップストリームの Content-Type またはコンテンツスニッフィングによって形式を判定します。`image/jpeg` はその両方が失敗した場合の最後の手段のフォールバックにすぎません。Router は最終フレームを Comfy のストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効な Comfy 署名付きURLになります。発行時に24時間で署名され、23時間のメモから再送されるため、後でポーリングすると残り1時間しかないURLが返ることがあります。再ホストを実行できなかった場合は、代わりに BytePlus 自身のURLがこのフィールドに残りますが、これは BytePlus がタスクの24時間後にクリアします。いずれの場合もリンクは期限切れになるため、URLを保存するのではなくフレームをダウンロードしてください。 - 生成されたビデオのコンテナ形式 (mp4 または mov) で、BytePlus が `content` の中に入れ子にして返す場合のものです。Seedance モデルでは `content` のトップレベルの兄弟として返すことのほうが多く、その場合はトップレベルの `output_format` フィールドを参照してください。Router はどちらか存在する方を読み取ります。 + 生成されたビデオのコンテナ形式(mp4 または mov)で、BytePlus が `content` の中に入れて返す場合に存在します。Seedance モデルでは `content` のトップレベルの兄弟フィールドとして返すことの方が一般的です。トップレベルの `output_format` フィールドを参照してください。Router はどちらか存在する方を読み取ります。 + + + + アップストリームのURLが機能しなくなる RFC 3339 時刻です。最も早い署名時刻にURL自体が持つ有効期間を加えたもので、`updated_at` が存在する場合はタスクの `updated_at` に24時間(BytePlus のドキュメントに記載されたURLの寿命)を加えた時刻より遅くなることはなく、存在しない場合はタスクの `updated_at` に24時間を加えた時刻になります。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースからも時刻が得られない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 + + 形式: `date-time` + + + + 最終フレームに対する BytePlus 自身のダウンロードURLで、再ホストされた `last_frame_url` の隣に、`upstream_video_url` と同じ条件でバイト単位でそのまま返されます。オプトインしたワークスペースのみ、Seedance 2.x のみが対象で、BytePlus がクリアした後は存在せず、`upstream_expires_at` まではベアラー資格情報として扱われます。 + + + + 出力ビデオに対する BytePlus 自身のダウンロードURLで、再ホストされた `video_url` の隣にバイト単位でそのまま返されます。Comfy がサーバー側でオプトインしたワークスペースがポーリングした Seedance 2.x のタスクにのみ存在し(リクエストパラメーターはありません)、それ以外のすべての場合(ワークスペースに解決されない資格情報、たとえばワークスペースにスコープされていないレガシー APIキーなど)には存在しません。また、生成から24時間後に BytePlus がURLをクリアすると存在しなくなります。これは署名付きオブジェクトストレージのURLであるためベアラー資格情報であり、それを保持する誰もが有効期限までビデオをダウンロードできます。そのため秘密情報と同様に扱ってください。`upstream_expires_at` に期限切れとなり、Seedance 2.5 では BytePlus がダウンロード回数を100回に制限しており、そのうち1回は Router 自身の再ホストで消費されます。 - 出力ビデオのダウンロード URL。Router はビデオを Comfy ストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効な Comfy 署名付き URL になります。発行時に24時間で署名され、23時間のメモから再生されるため、後でポーリングすると残り1時間しかないものが返ることがあります。再ホストを実行できなかった場合、このフィールドには BytePlus 自身の URL がそのまま入り、BytePlus はタスクの24時間後にそれをクリアし、一部のモデルではダウンロード回数が100回に制限されます。いずれにしてもリンクは失効するため、URL を保存するのではなくビデオをダウンロードしてください。 + 出力ビデオのダウンロードURLです。Router はビデオを Comfy のストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効な Comfy 署名付きURLになります。発行時に24時間で署名され、23時間のメモから再送されるため、後でポーリングすると残り1時間しかないURLが返ることがあります。再ホストを実行できなかった場合は、代わりに BytePlus 自身のURLがこのフィールドに残りますが、これは BytePlus がタスクの24時間後にクリアし、一部のモデルではダウンロード回数が100回に制限されます。いずれの場合もリンクは期限切れになるため、URLを保存するのではなくビデオをダウンロードしてください。 - タスクが作成された時刻。値は UNIX タイムスタンプ (秒) です。 + タスクが作成された時刻です。値は秒単位の UNIX タイムスタンプです。 - 生成されたビデオの再生時間 (秒)。BytePlus がこの点で一貫していないため、整数ではなく数値として宣言されています。ビデオタスクでは秒単位の整数が返されることが確認されており、同系列の BytePlus の他のサーフェスでは小数の再生時間が報告されるため、クライアントは整数値だと仮定してはいけません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + 生成されたビデオの再生時間(秒)です。BytePlus がこの点で一貫していないため、整数ではなく数値として宣言されています。ビデオタスクでは整数の秒を返すことが観測されており、同じ BytePlus の他のサーフェスでは小数の再生時間が報告されるため、クライアントは値が整数であると仮定してはいけません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 - エラー情報。タスクが成功した場合は null が返されます。タスクが失敗した場合はエラー情報が返されます。 + エラー情報です。タスクが成功した場合は null が返されます。タスクが失敗した場合は、エラー情報が返されます。 - 上流の ModelArk エラーコード。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーには、InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake のように、ドット区切りの理由が付くことがあります。これは enum ではなくオープンな文字列です。他のコードは検証やプロバイダーの失敗を表します。Router は HTTP 400 のエラーエンベロープと HTTP 200 の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 + アップストリームの ModelArk エラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を識別します。ファミリーには、InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake のように、ドットで区切られた理由が付くことがあります。これは列挙型ではなくオープンな文字列であり、他のコードは検証やプロバイダーの障害を表します。Router は HTTP 400 のエラーエンベロープと HTTP 200 の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの障害を上書きすることはありません。 @@ -393,15 +401,15 @@ false: 生成されるビデオの最終フレーム画像を返しません。 - 生成されたビデオのコンテナ形式 (mp4 または mov) で、`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここで返します。BytePlus 自身のフィールドで、そのまま転送されます。 + 生成されたビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここでこの値を返します。BytePlus 独自のフィールドで、変更されずにそのまま転送されます。 - 生成されたビデオの解像度 (例: `1080p`)。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + 生成されたビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 - タスクで実際に使用された生成シード。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + タスクで実際に使用された生成シード。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 形式: `int64` @@ -413,7 +421,7 @@ false: 生成されるビデオの最終フレーム画像を返しません。 - タスクが最後に更新された時刻。値は UNIX タイムスタンプ (秒) です。 + タスクが最後に更新された時間。値は秒単位の UNIX タイムスタンプです。 @@ -421,11 +429,11 @@ false: 生成されるビデオの最終フレーム画像を返しません。 - モデルが生成したトークン数 + モデルによって生成されたトークン数 - ビデオ生成モデルでは入力トークン数は計算されず、デフォルトで 0 になります。したがって、total_tokens = completion_tokens です。 + ビデオ生成モデルでは入力トークン数は計算されず、0 がデフォルトになります。そのため、total_tokens = completion_tokens となります。 ## 例 diff --git a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx index caafd86dbf..5eed7243ed 100644 --- a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx +++ b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx @@ -2,17 +2,16 @@ title: "Comfy Router で Dreamina Seedance 2.0 Mini を使用する" description: "Comfy Router 経由で byteplus/dreamina-seedance-2-0-mini を呼び出す方法: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Dreamina Seedance 2.0 Mini" -translationSourceHash: 69d38df7 +translationSourceHash: 28c5c053 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx translationBlockHashes: "_intro": 45ff5bfd "Quick start": b0374f7d - "Schema": 2279819f + "Schema": 3c26a330 "Examples": db01067e --- - {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/byteplus/dreamina-seedance-2-0-mini.json から生成されました。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -181,7 +180,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-mini/request ### 入力 - この生成タスクの結果を受け取るコールバック通知先アドレス + 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。結果の取得にはタスクステータスのルートをポーリングしてください。 形式: `uri` @@ -191,23 +190,23 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-mini/request - 入力オーディオオブジェクト。オーディオ入力は Seedance 2.5、2.0、2.0 fast、2.0 mini のみがサポートします。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単体では使用できず、少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力に対応します。 + 入力オーディオオブジェクト。オーディオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単体では使用できず、少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力に対応しています。 - オーディオ URL、Base64 エンコード、またはアセット ID。 -オーディオ URL: オーディオ(wav、mp3)の公開 URL。 + オーディオ URL、Base64 エンコーディング、またはアセット ID。 +オーディオ URL: オーディオ (wav、mp3) の公開 URL。 Base64: 形式 data:audio/\;base64,\ アセット ID: 形式 asset://\ - Seedance 2.5 のみ。最終ビデオとしてレンダリングするドラフトタスク。唯一のコンテンツ項目である必要があります。 -最終ビデオはドラフトタスクの prompt、入力アセット、duration、ratio、seed、generate_audio、omni_reference_task_type を再利用するため、これらを再送信しないでください。resolution のデフォルトは 1080p で、1080p のみをサポートします。 + Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。唯一のコンテンツ項目である必要があります。 +最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。解像度はデフォルトで 1080p となり、1080p のみをサポートします。 - `draft` を true に設定してドラフトビデオを作成したときに返されるタスク ID。 + `draft` を true に設定して Draft ビデオを作成したときに返されたタスク ID。 @@ -215,7 +214,7 @@ Base64: 形式 data:audio/\;base64,\ - 画像から動画への生成用の画像コンテンツ(type が "image_url" の場合) + 画像から動画への生成に使用する画像コンテンツ (type が "image_url" の場合) 画像 URL: 画像 URL にアクセスできることを確認してください。 Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります アセット ID: 形式 asset://\ @@ -224,160 +223,176 @@ Base64 エンコードされたコンテンツ: 形式は data:image/\;b コンテンツ項目の役割/位置。 画像の場合: first_frame、last_frame、または reference_image。 -ビデオの場合: reference_video(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 -オーディオの場合: reference_audio(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 +ビデオの場合: reference_video (Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 +オーディオの場合: reference_audio (Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 指定可能な値: `first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` - モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータが含まれます。 + モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータを含みます。 -テキストプロンプト(必須): 中国語および英語の文字を使用して記述する、生成するビデオの説明。 +テキストプロンプト (必須): 中国語と英語の文字を使用して、生成するビデオを記述します。 -パラメータ(任意): テキストプロンプトの後に --[parameters] を追加してビデオの仕様を制御します。 -- --resolution (--rs): 480p、720p、1080p(デフォルト: 720p) -- --ratio (--rt): 21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(デフォルト: 16:9 または adaptive) -- --duration (--dur): 3〜12 秒(デフォルト: 5) -- --framepersecond (--fps): 24(デフォルト: 24) -- --watermark (--wm): true/false(デフォルト: false) -- --seed (--seed): -1 〜 2^32-1(デフォルト: -1) -- --camerafixed (--cf): true/false(デフォルト: false) +パラメータ (任意): テキストプロンプトの後に --[parameters] を追加して、ビデオの仕様を制御します: +- --resolution (--rs): 480p、720p、1080p (デフォルト: 720p) +- --ratio (--rt): 21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive (デフォルト: 16:9 または adaptive) +- --duration (--dur): 3〜12 秒 (デフォルト: 5) +- --framepersecond (--fps): 24 (デフォルト: 24) +- --watermark (--wm): true/false (デフォルト: false) +- --seed (--seed): -1 〜 2^32-1 (デフォルト: -1) +- --camerafixed (--cf): true/false (デフォルト: false) 例: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" Comfy 側のガードレールであり、BytePlus の制約ではありません。BytePlus は -テキスト長の制限を公表しておらず、テストでは 40,000 文字を受け付けました(2026-09-17)。 -これはバイト数ではなく文字数をカウントするため、マルチバイトのプロンプトは -ワイヤー上ではこのサイズの数倍になる可能性があります。これはこの 1 つのフィールドを制限するものであり、 -リクエスト全体を制限するものではありません。`content` は配列であり、ドキュメント全体を -制限するのはリクエスト本体ごとの上限です。これを適用するのは Comfy Router(/v2/models/byteplus/\{model})であり、 -直接の v1 /proxy 呼び出しでは代わりに BytePlus 自身のバリデータが応答します。実際のトラフィックより -はるかに高く設定されているため、正当なプロンプトがこれによって判定されることはありません。 -呼び出し元がより多くを必要とする場合は引き上げてください。 +テキスト長の上限を公開しておらず、テスト (2026-09-17) では 40,000 文字を +受け付けました。これはバイト数ではなく文字数を数えるため、マルチバイトの +プロンプトは通信時にこのサイズの数倍になる可能性があります。これはこの 1 つの +フィールドのみを制限するもので、リクエスト全体を制限するものではありません: +`content` は配列であり、ドキュメント全体を制限するのはリクエストごとの +ボディ上限です。これを適用するのは Comfy Router (/v2/models/byteplus/\{model}) +であり、v1 /proxy を直接呼び出した場合は BytePlus 自身のバリデータが代わりに +応答します。実際のトラフィックよりはるかに高く設定されているため、正当な +プロンプトがこれによって判断されることはありません。呼び出し元がより多くを +必要とする場合は引き上げてください。 - 入力コンテンツの種類 + 入力コンテンツのタイプ 指定可能な値: `text`、`image_url`、`video_url`、`audio_url`、`draft_task` - 入力ビデオオブジェクト。ビデオ入力は Seedance 2.5、2.0、2.0 fast、2.0 mini のみがサポートします。 + 入力ビデオオブジェクト。ビデオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。 ビデオ URL またはアセット ID。 -ビデオ URL: ビデオ(mp4、mov)の公開 URL。 +ビデオ URL: ビデオ (mp4、mov) の公開 URL。 アセット ID: 形式 asset://\ - Seedance 2.5 のみ。480p のドラフトビデオを生成します。resolution は 480p である必要があります。 -返されたタスク ID を `draft_task` コンテンツ項目で渡すと、最終的な 1080p ビデオをレンダリングします。ドラフトタスク ID は 7 日間有効です。 + Seedance 2.5 のみ。480p の Draft ビデオを生成します。解像度は 480p である必要があります。 +返されたタスク ID を `draft_task` コンテンツ項目に渡して、最終的な 1080p ビデオをレンダリングします。Draft タスク ID は 7 日間有効です。 - ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動。ビデオ編集タスクは -1 のみをサポート)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。 + ビデオの再生時間 (秒)。Seedance 2.5: [4,30] または -1 (自動。ビデオ編集タスクは -1 のみをサポート)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1 (自動)。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。 範囲: `2` 〜 `30` - タスクのタイムアウトしきい値(秒)。デフォルトは 172800(48 時間)。範囲: [3600, 259200]。 + タスクのタイムアウトしきい値 (秒)。デフォルト 172800 (48 時間)。範囲: [3600, 259200]。 範囲: `3600` 〜 `259200` Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されたビデオに映像と同期したオーディオを含めるかどうか。 -true: モデルは同期したオーディオ付きのビデオを出力します。 -false: モデルは無音のビデオを出力します。 -対応しているモデルでは、生成されたオーディオトラックは映像とは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーが通常は受け入れる入力でも断続的に発生することがあります。その場合は `false` を送って無音のビデオを生成してください。これはオーディオが拒否されたモダリティである場合にのみ有効で、同期 Router レスポンスはそれを `refusal_subject: output_audio` として示します(キューに入れたリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を作り直してください。 +true: モデルは同期されたオーディオ付きのビデオを出力します。 +false: モデルは無音のビデオを出力します。対応しているモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否が発生した場合は `content_policy_violation` として報告され、実行ごとにオーディオが異なるため、プロバイダーがそれ以外は受け入れる入力に対しても断続的に発生することがあります。その場合はサイレントビデオにするため `false` を送信してください。これが有効なのは拒否されたモダリティがオーディオだった場合のみで、同期 Router レスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を再作成してください。 - 呼び出すモデルの ID。サポートされるモデル: seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini、dreamina-seedance-2-5-260628。POST /proxy/byteplus/api/v3/contents/generations/tasks への直接の v1 呼び出しでは必ずこれを指定する必要があります。プロキシは他の値や省略された値を 400 で拒否します。これがこのスキーマの `required` リストに含まれていないのは、Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントからこれを設定するためであり、Router の呼び出し元は省略します。 + 呼び出すモデルの ID。サポートされているモデル: seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini、dreamina-seedance-2-5-260628。POST /proxy/byteplus/api/v3/contents/generations/tasks への直接の v1 呼び出しでは必ず指定する必要があります。プロキシはそれ以外の値や、省略された値を 400 で拒否します。このスキーマの `required` リストに含まれていないのは、Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントからこれを埋めるためであり、Router の呼び出し元は省略します。 - Seedance 2.5 のみ。出力ビデオのコンテナ形式。mp4: 汎用コンテナ(H.264/AAC、yuv420p)。幅広い互換性があり、ファイルサイズも小さくなります。 + Seedance 2.5 のみ。出力ビデオのコンテナ形式。 +mp4: 汎用コンテナ(H.264/AAC、yuv420p)。幅広い互換性があり、ファイルサイズも小さくなります。 mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)。色精度が高く、ポストプロダクションに適していますが、ファイルサイズは大きくなります。 - 指定可能な値: `mp4`, `mov` + 指定可能な値: `mp4`、`mov` - 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast、2.0 mini、1.5 pro のデフォルト: adaptive。 -Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive` のみ(またはこのフィールドの省略)が受け付けられます。具体的な比率を指定すると、ディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードでも具体的な比率を受け付けます。 + 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast & 2.0 mini、1.5 pro のデフォルト: adaptive。 +Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive`(またはフィールドの省略)のみが受け入れられます。具体的な比率はディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードでも具体的な比率を受け入れます。 - 指定可能な値: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` + 指定可能な値: `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` - ビデオの解像度。Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro と pro-fast のデフォルト: 1080p。 -注: Seedance 2.0、2.0 fast、2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p をサポートします。 + ビデオの解像度。Seedance 2.5、2.0、2.0 fast & 2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro & pro-fast のデフォルト: 1080p。 +注: Seedance 2.0、2.0 fast & 2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、1080p をサポートします。 - 指定可能な値: `480p`, `720p`, `1080p`, `4k` + 指定可能な値: `480p`、`720p`、`1080p`、`4k` 生成されたビデオの最終フレーム画像を返すかどうか。 -true: 生成されたビデオの最終フレーム画像を返します。このパラメータを true に設定した後、ビデオ生成タスクに関する情報の照会を呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。つまり、先に生成されたビデオの最終フレームを次のビデオタスクの先頭フレームとして使用し、複数の連続したビデオをすばやく生成できます。 +true: 生成されたビデオの最終フレーム画像を返します。このパラメータを true に設定すると、ビデオ生成タスクの情報を取得する API を呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。つまり、先に生成したビデオの最終フレームを次のビデオタスクの先頭フレームとして使用でき、複数の連続したビデオを素早く生成できます。 false: 生成されたビデオの最終フレーム画像を返しません。 - ランダム性を制御するためのシード整数。範囲: [-1, 2^32-1]。-1 はランダムなシードを使用します。 + ランダム性を制御するためのシード整数。範囲: [-1, 2^32-1]。-1 はランダムシードを使用します。 範囲: `-1` から `4294967295` - 処理用のサービステア。Seedance 2.5、2.0 と 2.0 fast は flex(オフライン推論)をサポートしません。 + 処理のサービスティア。Seedance 2.5、2.0 & 2.0 fast は flex(オフライン推論)をサポートしません。 - 指定可能な値: `default`, `flex` + 指定可能な値: `default`、`flex` - 生成されたビデオにウォーターマークが含まれるかどうか。 + 生成されたビデオにウォーターマークを含めるかどうか。 -Router が `GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるものと同じドキュメントです。 +`GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるものと同じドキュメントです。 ### 出力 - ビデオ生成タスクが完了した後の出力。出力ビデオのダウンロード URL と、BytePlus が返す場合はその最終フレームのダウンロード URL を含みます。`video_url` と `last_frame_url` はどちらも Comfy のストレージに再ホストされます。ここにある他のすべてのフィールドは BytePlus 独自のものです。Null 許容: BytePlus はタスクの 24 時間後に URL をクリアするため、その後でポーリングした成功済みのドキュメントでは `content` が存在しないか null になっている可能性があります。 + ビデオ生成タスクが完了した後の出力です。出力ビデオのダウンロードURLと、BytePlusが返す場合はその最終フレームのダウンロードURLを含みます。`video_url` と `last_frame_url` はいずれもComfyのストレージに再ホストされます。ここにある他のフィールドはすべてBytePlus自身のものです。Nullable: BytePlusはタスクの24時間後にURLをクリアするため、その後でポーリングした成功済みのドキュメントでは `content` が存在しない、またはnullである場合があります。 - 生成済みビデオの最終フレームのダウンロード URL。リクエストで `return_last_frame` を設定した場合に返されます。この URL から画像形式を推測しないでください。BytePlus はリクエスト側で最終フレームを PNG と記載していますが、Router は渡されたバイト列をそのまま再ホストし、上流の Content-Type またはコンテンツスニッフィングから型を判定します。`image/jpeg` はその両方が失敗したときの最後のフォールバックにすぎません。Router は最終フレームを Comfy ストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL になります。発行時に 24 時間の署名が付き、23 時間のメモから再生されるため、後でポーリングすると残り 1 時間しかない URL が返ることがあります。再ホストを実行できなかった場合、このフィールドは BytePlus 独自の URL を保持し、BytePlus はタスクの 24 時間後にそれをクリアします。いずれの場合もリンクは期限切れになるため、URL を保存するのではなくフレームをダウンロードしてください。 + 生成されたビデオの最終フレームのダウンロードURLで、リクエストで `return_last_frame` を設定した場合に返されます。このURLから画像形式を推測しないでください。BytePlusはリクエスト側では最終フレームをPNGとして記載していますが、Routerは提供されたバイト列をそのまま再ホストし、上流のContent-Typeまたはコンテンツスニッフィングから型を判定します。`image/jpeg` はそのどちらも失敗した場合の最後のフォールバックにすぎません。Routerは最終フレームをComfyのストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効なComfy署名付きURLになります。発行時に24時間で署名され、23時間のメモから再送されるため、後でのポーリングでは残り1時間程度のものが返ることがあります。再ホストを実行できなかった場合、このフィールドは代わりにBytePlus自身のURLを保持し、BytePlusはタスクの24時間後にそれをクリアします。いずれの場合もリンクは失効するため、URLを保存するのではなくフレームをダウンロードしてください。 - 生成済みビデオのコンテナ形式(mp4 または mov)。BytePlus がこれを `content` の中に入れ子にして返す場合に含まれます。Seedance モデルはこれを `content` のトップレベルの兄弟フィールドとして返すことのほうが多く(トップレベルの `output_format` フィールドを参照)、Router は存在するほうを読み取ります。 + 生成されたビデオのコンテナ形式(mp4またはmov)で、BytePlusが `content` の中にネストして返す場合のものです。Seedanceモデルではこれを `content` のトップレベルの兄弟フィールドとして返すことのほうが多く、トップレベルの `output_format` フィールドを参照してください。Routerはどちらか存在する方を読み取ります。 + + + + 上流のURLが機能しなくなるRFC 3339時刻です。URL自体が持つ最も早い署名時刻に有効期間を加えたもので、`updated_at` が存在する場合はタスクの `updated_at` に24時間を加えた時刻(BytePlusがドキュメント化しているURLの寿命)より遅くなることはなく、存在しない場合はタスクの `updated_at` に24時間を加えた時刻となります。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の有効期間とは無関係です。 + + 形式: `date-time` + + + + 最終フレームに対するBytePlus自身のダウンロードURLで、再ホストされた `last_frame_url` と同じ条件でそのままの形で返されます。つまりオプトインしたワークスペースのみ、Seedance 2.xのみ、BytePlusがクリアした後は存在せず、`upstream_expires_at` まではベアラー資格情報として扱われます。 + + + + 出力ビデオに対するBytePlus自身のダウンロードURLで、再ホストされた `video_url` と同じ条件でそのままの形で返されます。Comfyがサーバー側でオプトインしたワークスペースによってポーリングされたSeedance 2.xのタスクでのみ存在します(リクエストパラメータはありません)。それ以外では存在せず、ワークスペースに解決されない資格情報(特定のワークスペースにスコープされていないレガシーAPIキーなど)の場合も存在せず、BytePlusが生成の24時間後にURLをクリアした後も存在しません。これは署名付きのオブジェクトストレージURLであり、したがってベアラー資格情報です。保持している誰もが失効までビデオをダウンロードできるため、シークレットとして扱ってください。`upstream_expires_at` に失効し、Seedance 2.5ではBytePlusがダウンロード回数を100回に制限しており、そのうち1回はRouter自身の再ホストで消費されます。 - 出力ビデオのダウンロード URL。Router はビデオを Comfy ストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL になります。発行時に 24 時間の署名が付き、23 時間のメモから再生されるため、後でポーリングすると残り 1 時間しかない URL が返ることがあります。再ホストを実行できなかった場合、このフィールドは BytePlus 独自の URL を保持し、BytePlus はタスクの 24 時間後にそれをクリアし、一部のモデルではダウンロード回数が 100 回に制限されます。いずれの場合もリンクは期限切れになるため、URL を保存するのではなくビデオをダウンロードしてください。 + 出力ビデオのダウンロードURLです。RouterはビデオをComfyのストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効なComfy署名付きURLになります。発行時に24時間で署名され、23時間のメモから再送されるため、後でのポーリングでは残り1時間程度のものが返ることがあります。再ホストを実行できなかった場合、このフィールドは代わりにBytePlus自身のURLを保持し、BytePlusはタスクの24時間後にそれをクリアし、一部のモデルではダウンロード回数を100回に制限します。いずれの場合もリンクは失効するため、URLを保存するのではなくビデオをダウンロードしてください。 - タスクが作成された時刻。値は UNIX タイムスタンプ(秒)です。 + タスクが作成された時刻です。値は秒単位のUNIXタイムスタンプです。 - 生成済みビデオの再生時間(秒)。BytePlus がこれについて一貫していないため、整数ではなく数値として宣言されています。ビデオタスクが整数の秒を返すこともあれば、BytePlus の関連サーフェスが小数の再生時間を報告することも確認されているため、クライアントは整数値を前提にしてはいけません。BytePlus 独自のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + 生成されたビデオの再生時間(秒)です。BytePlusがこの点で一貫していないため、整数ではなくnumberとして宣言されています。ビデオタスクが整数秒を返すこともあれば、同じBytePlusの別のサーフェスが小数の再生時間を報告することも観測されているため、クライアントは値が整数であると仮定してはいけません。BytePlus自身のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 - エラー情報。タスクが成功した場合は null が返されます。タスクが失敗した場合はエラー情報が返されます。 + エラー情報です。タスクが成功した場合はnullが返されます。タスクが失敗した場合はエラー情報が返されます。 - 上流の ModelArk エラーコード。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーにはドット区切りの理由が付くことがあり、例えば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などがあります。これは enum ではなくオープンな文字列です。他のコードは検証エラーやプロバイダー側の障害を表します。Router は HTTP 400 のエラーエンベロープと HTTP 200 の失敗タスク応答の両方でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 + 上流のModelArkエラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーには、InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake のようにドット区切りの理由が付くことがあります。これはenumではなくオープンな文字列です。他のコードは検証やプロバイダーの失敗を表します。RouterはHTTP 400のエラーエンベロープとHTTP 200の失敗タスク応答においてポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 @@ -385,7 +400,7 @@ Router が `GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json` で - ビデオ生成タスクの ID + The ID of the video generation task → ビデオ生成タスクの ID @@ -393,15 +408,15 @@ Router が `GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json` で - 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリが返すのはこちらです。BytePlus 独自のフィールドで、そのまま転送されます。 + 生成されたビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここで返します。BytePlus 独自のフィールドで、変更されずにそのまま転送されます。 - 生成済みビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + 生成されたビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 - タスクで実際に使用された生成シード。BytePlus 独自のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + タスクで実際に使用された生成シード。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 形式: `int64` @@ -409,11 +424,11 @@ Router が `GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json` で タスクの状態 - 取り得る値: `queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` + 指定可能な値: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` - タスクが最後に更新された時刻。値は UNIX タイムスタンプ(秒)です。 + タスクが最後に更新された時間。値は UNIX タイムスタンプ(秒)です。 @@ -421,11 +436,11 @@ Router が `GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json` で - モデルが生成したトークン数 + モデルによって生成されたトークン数 - ビデオ生成モデルでは、入力トークン数は計算されず、デフォルトは 0 です。したがって、total_tokens = completion_tokens となります。 + ビデオ生成モデルでは、入力トークン数は計算されず、デフォルトで 0 になります。そのため、total_tokens = completion_tokens となります。 ## 例 diff --git a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx index 28a20f0458..c26b6156cd 100644 --- a/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx +++ b/ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx @@ -2,18 +2,17 @@ title: "Dreamina Seedance 2.5 260628 を Comfy Router で使用する" description: "Comfy Router 経由で byteplus/dreamina-seedance-2-5-260628 を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンス。" sidebarTitle: "Dreamina Seedance 2.5 260628" -translationSourceHash: 9a342bd4 +translationSourceHash: 07fd9c64 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx translationBlockHashes: "_intro": 4b5f4cec "Quick start": a2bb8c28 "Serving providers": 197dd61a - "Schema": 0467a987 + "Schema": 0a76af44 "Examples": 5465695b --- - {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-5-260628.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -194,7 +193,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque ### 入力 - この生成タスクの結果を受け取るコールバック通知先アドレス + 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。代わりに、結果を取得するにはタスクステータスルートをポーリングしてください。 形式: `uri` @@ -204,19 +203,19 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque - 入力オーディオオブジェクト。オーディオ入力は Seedance 2.5、2.0、2.0 fast、2.0 mini のみがサポートします。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単独では使用できません。少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力もサポートします。 + 入力オーディオオブジェクト。オーディオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオのみでは使用できません。画像またはビデオを少なくとも 1 つ含める必要があります。Seedance 2.5 はオーディオのみの入力に対応しています。 - オーディオ URL、Base64 エンコード、またはアセット ID。 + オーディオ URL、Base64 エンコーディング、またはアセット ID。 オーディオ URL: オーディオの公開 URL(wav、mp3)。 -Base64: 形式 data:audio/\;base64,\ -アセット ID: 形式 asset://\ +Base64: 形式は data:audio/\;base64,\ +アセット ID: 形式は asset://\ - Seedance 2.5 専用。最終ビデオとしてレンダリングする Draft タスク。唯一のコンテンツ項目である必要があります。 -最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。resolution のデフォルトは 1080p で、1080p のみをサポートします。 + Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。唯一のコンテンツ項目である必要があります。 +最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。resolution はデフォルトで 1080p になり、1080p のみをサポートします。 @@ -228,10 +227,10 @@ Base64: 形式 data:audio/\;base64,\ - 画像から動画への生成用の画像コンテンツ(type が "image_url" の場合) + 画像から動画への生成に使用する画像コンテンツ(type が "image_url" の場合) 画像 URL: 画像 URL にアクセスできることを確認してください。 -Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります -アセット ID: 形式 asset://\ +Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります。 +アセット ID: 形式は asset://\ @@ -240,54 +239,56 @@ Base64 エンコードされたコンテンツ: 形式は data:image/\;b ビデオの場合: reference_video(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 オーディオの場合: reference_audio(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 - 指定可能な値: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` + 指定可能な値: `first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` - モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータを含みます。 + モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータが含まれます。 -テキストプロンプト(必須): 中国語および英語の文字を使用して生成するビデオを説明します。 +テキストプロンプト(必須): 中国語および英語の文字を使用した、生成するビデオの説明。 -パラメータ(任意): テキストプロンプトの後に --[parameters] を追加すると、ビデオの仕様を制御できます: -- --resolution (--rs): 480p、720p、1080p(デフォルト: 720p) -- --ratio (--rt): 21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(デフォルト: 16:9 または adaptive) -- --duration (--dur): 3~12 秒(デフォルト: 5) -- --framepersecond (--fps): 24(デフォルト: 24) -- --watermark (--wm): true/false(デフォルト: false) -- --seed (--seed): -1 ~ 2^32-1(デフォルト: -1) -- --camerafixed (--cf): true/false(デフォルト: false) +パラメータ(任意): テキストプロンプトの後に --[parameters] を追加して、ビデオの仕様を制御します: +- --resolution(--rs): 480p、720p、1080p(デフォルト: 720p) +- --ratio(--rt): 21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(デフォルト: 16:9 または adaptive) +- --duration(--dur): 3~12 秒(デフォルト: 5) +- --framepersecond(--fps): 24(デフォルト: 24) +- --watermark(--wm): true/false(デフォルト: false) +- --seed(--seed): -1~2^32-1(デフォルト: -1) +- --camerafixed(--cf): true/false(デフォルト: false) 例: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -Comfy 側のガードレールであり、BytePlus の制約ではありません。BytePlus は -テキスト長の制限を公開しておらず、テストでは 40,000 文字を受け付けました(2026-09-17)。 -これはバイト数ではなく文字数をカウントするため、マルチバイトのプロンプトは -転送時にこの数倍のサイズになる可能性があります。これはこの 1 つのフィールドを制限するもので、 -リクエスト全体を制限するものではありません: `content` は配列であり、 -ドキュメント全体を制限するのはリクエストごとのボディ制限です。これを強制するのは -Comfy Router(/v2/models/byteplus/\{model})であり、v1 の /proxy を直接呼び出す場合は -代わりに BytePlus 自身のバリデータが応答します。実際のトラフィックよりはるかに高く設定されているため、 -本物のプロンプトが判定されることはありません。呼び出し元がさらに必要とする場合は引き上げてください。 +これは BytePlus 側の制約ではなく、Comfy 側のガードレールです。BytePlus は +テキスト長の上限を公開しておらず、テスト(2026-09-17)では 40,000 文字を +受け付けました。これはバイト数ではなく文字数を数えるため、マルチバイトの +プロンプトではワイヤー上のサイズがこの数倍になることがあります。これは +この 1 つのフィールドを制限するもので、リクエスト全体を制限するものでは +ありません。`content` は配列であり、ドキュメント全体を制限するのは +リクエストごとのボディ上限です。これを適用するのは Comfy Router +(/v2/models/byteplus/\{model})です。v1 /proxy を直接呼び出した場合は、 +代わりに BytePlus 自身のバリデータが応答します。実際のトラフィックをはるかに +上回る値に設定されているため、正当なプロンプトがこれで判定されることは +ありません。呼び出し元がより多くを必要とする場合は引き上げてください。 入力コンテンツのタイプ - 指定可能な値: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` + 指定可能な値: `text`、`image_url`、`video_url`、`audio_url`、`draft_task` - 入力ビデオオブジェクト。ビデオ入力は Seedance 2.5、2.0、2.0 fast、2.0 mini のみがサポートします。 + 入力ビデオオブジェクト。ビデオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。 ビデオ URL またはアセット ID。 ビデオ URL: ビデオの公開 URL(mp4、mov)。 -アセット ID: 形式 asset://\ +アセット ID: 形式は asset://\ - Seedance 2.5 専用。480p の Draft ビデオを生成します。resolution は 480p である必要があります。 + Seedance 2.5 のみ。480p の Draft ビデオを生成します。resolution は 480p である必要があります。 返されたタスク ID を `draft_task` コンテンツ項目で渡すと、最終的な 1080p ビデオがレンダリングされます。Draft タスク ID は 7 日間有効です。 @@ -298,99 +299,113 @@ Comfy Router(/v2/models/byteplus/\{model})であり、v1 の /proxy を直 - タスクのタイムアウトしきい値(秒)。デフォルト 172800(48 時間)。範囲: [3600, 259200]。 + タスクのタイムアウトしきい値(秒)。デフォルトは 172800(48 時間)。範囲: [3600, 259200]。 範囲: `3600` ~ `259200` - Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされます。生成されたビデオに映像と同期したオーディオが含まれるかどうか。 + Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されたビデオに映像と同期したオーディオを含めるかどうか。 true: モデルは同期したオーディオ付きのビデオを出力します。 -false: モデルは無音のビデオを出力します。 -対応しているモデルでは、生成されたオーディオトラックは映像とは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーが通常は受け入れる入力でも断続的に発生することがあります。その場合は `false` を送って無音のビデオを生成してください。これはオーディオが拒否されたモダリティである場合にのみ有効で、同期 Router レスポンスはそれを `refusal_subject: output_audio` として示します(キューに入れたリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を作り直してください。 +false: モデルは無音のビデオを出力します。サポートされているモデルでは、生成されるオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外は受け入れる入力に対しても断続的に発生することがあります。その場合はサイレントビデオにするために `false` を送信してください。これが有効なのは拒否されたモダリティがオーディオだった場合のみで、同期 Router レスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに Draft を `false` で再作成してください。 - 呼び出すモデルの ID。サポートされるモデル: seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini、dreamina-seedance-2-5-260628。POST /proxy/byteplus/api/v3/contents/generations/tasks への v1 の直接呼び出しでは必ずこれを指定する必要があります。プロキシは他の値、および省略された値を 400 で拒否します。このスキーマの `required` リストに含まれていないのは、Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントからこれを設定するためで、Router の呼び出し元は省略します。 + 呼び出すモデルの ID。サポートされているモデル: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini, dreamina-seedance-2-5-260628。POST /proxy/byteplus/api/v3/contents/generations/tasks への直接の v1 呼び出しでは必ず指定する必要があります。プロキシはそれ以外の値や省略された値を 400 で拒否します。このスキーマの `required` リストに含まれていないのは、Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントからこの値を設定するためで、Router の呼び出し元はこれを省略します。 - Seedance 2.5 専用。出力ビデオのコンテナ形式。mp4: 汎用コンテナ(H.264/AAC、yuv420p)。幅広い互換性があり、ファイルサイズはより小さくなります。 -mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)。色精度が高く、ポストプロダクションに適しています。ファイルサイズはより大きくなります。 + Seedance 2.5 のみ。出力ビデオのコンテナ形式。 +mp4: 汎用コンテナ(H.264/AAC、yuv420p)。幅広い互換性があり、ファイルサイズも小さくなります。 +mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)。色精度が高くポストプロダクションに適していますが、ファイルサイズは大きくなります。 - 指定可能な値: `mp4`、`mov` + 指定可能な値: `mp4`, `mov` - 生成されたビデオのアスペクト比。Seedance 2.0、2.0 fast、2.0 mini、1.5 pro のデフォルト: adaptive。 -Seedance 2.5 の先頭フレーム / 先頭・末尾フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive` のみ(またはフィールドの省略)が受け付けられます。具体的な比率を指定した場合は、ディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードで具体的な比率を受け付けます。 + 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast、2.0 mini、1.5 pro のデフォルト: adaptive。 +Seedance 2.5 の最初のフレーム / 最初と最後のフレームからの生成: 出力は最初のフレームのアスペクト比に従うため、`adaptive`(またはフィールドの省略)のみが受け入れられます。具体的な比率を指定すると、ディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードでも具体的な比率を受け入れます。 - 指定可能な値: `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` + 指定可能な値: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - ビデオの解像度。Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro と pro-fast のデフォルト: 1080p。 -注意: Seedance 2.0、2.0 fast、2.0 mini は 1080p をサポートしていません。Seedance 2.5 は 480p、720p、1080p をサポートします。 + ビデオの解像度。Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro、pro-fast のデフォルト: 1080p。 +注: Seedance 2.0、2.0 fast、2.0 mini は 1080p をサポートしていません。Seedance 2.5 は 480p、720p、1080p をサポートしています。 - 指定可能な値: `480p`、`720p`、`1080p`、`4k` + 指定可能な値: `480p`, `720p`, `1080p`, `4k` - 生成されたビデオの最終フレーム画像を返すかどうか。 -true: 生成されたビデオの最終フレーム画像を返します。このパラメーターを true に設定すると、ビデオ生成タスクの情報の照会を呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメーターを使用すると、複数の連続したビデオを生成できます。前回生成したビデオの最終フレームを次のビデオタスクの先頭フレームとして使用することで、複数の連続したビデオをすばやく生成できます。 -false: 生成されたビデオの最終フレーム画像を返しません。 + 生成されたビデオの最後のフレーム画像を返すかどうか。 +true: 生成されたビデオの最後のフレーム画像を返します。このパラメータを true に設定した後、「動画生成タスクの情報を取得する」を呼び出すことで最後のフレーム画像を取得できます。最後のフレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最後のフレームが次のビデオタスクの最初のフレームとして使用されるため、複数の連続したビデオを素早く生成できます。 +false: 生成されたビデオの最後のフレーム画像を返しません。 - ランダム性を制御するためのシード整数。範囲: [-1, 2^32-1]。-1 の場合はランダムなシードが使用されます。 + ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 はランダムなシードを使用します。 - 範囲: `-1` ~ `4294967295` + 範囲: `-1` から `4294967295` - 処理用のサービステア。Seedance 2.5、2.0 と 2.0 fast は flex(オフライン推論)をサポートしていません。 + 処理のサービスティア。Seedance 2.5、2.0、2.0 fast は flex(オフライン推論)をサポートしていません。 - 指定可能な値: `default`、`flex` + 指定可能な値: `default`, `flex` - 生成されたビデオにウォーターマークが含まれるかどうか。 + 生成されたビデオにウォーターマークを含めるかどうか。 -Router が `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する対象となる同一のドキュメントです。 +`GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しの検証に使用するのと同じドキュメントです。 ### 出力 - ビデオ生成タスクの完了後の出力です。出力ビデオのダウンロード URL と、BytePlus が返す場合はその最終フレームのダウンロード URL を含みます。`video_url` と `last_frame_url` はどちらも Comfy ストレージに再ホストされ、ここにあるその他のフィールドはすべて BytePlus 独自のものです。Null 許容: BytePlus はタスクの 24 時間後に URL をクリアするため、その後でポーリングした succeeded ドキュメントは `content` が存在しないか null である可能性があります。 + ビデオ生成タスクの完了後の出力です。出力ビデオのダウンロードURLと、BytePlusが返した場合はその最終フレームのダウンロードURLを含みます。`video_url` と `last_frame_url` はどちらもComfyのストレージに再ホストされ、ここにある他のすべてのフィールドはBytePlus自身のものです。Nullable:BytePlusはタスクの24時間後にURLを消去するため、その後ポーリングされた成功済みドキュメントでは `content` が存在しないかnullになることがあります。 - 生成ビデオの最終フレームのダウンロード URL で、リクエストで `return_last_frame` を設定した場合に返されます。この URL から画像形式を推測しないでください。BytePlus はリクエスト側では最終フレームを PNG と記載していますが、Router は配信されたバイト列をそのまま再ホストし、上流の Content-Type またはコンテンツスニッフィングに基づいて型を判定します。`image/jpeg` はその両方が失敗したときの最後のフォールバックにすぎません。Router は最終フレームを Comfy ストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL になります。発行時に 24 時間で署名され、23 時間のメモから再生されるため、後でポーリングすると残り 1 時間しかない URL が返ることがあります。再ホストを実行できなかった場合、このフィールドは BytePlus 独自の URL を保持し、BytePlus はタスクの 24 時間後にそれをクリアします。いずれにせよリンクは失効するため、URL を保存するのではなくフレームをダウンロードしてください。 + 生成されたビデオの最終フレームのダウンロードURLで、リクエストで `return_last_frame` を設定した場合に返されます。このURLから画像形式を推測しないでください。BytePlusはリクエスト側で最終フレームをPNGと記述しており、Routerは提供されたバイト列をそのまま再ホストし、上流のContent-Typeまたはコンテンツスニッフィングから型を判定します。`image/jpeg` は両方とも失敗した場合の最後のフォールバックにすぎません。Routerは最終フレームをComfyのストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効なComfy署名付きURLになります。発行時に24時間で署名され、23時間のメモから再生されるため、後でのポーリングでは残り1時間しかないものが返ることがあります。再ホストを実行できなかった場合、このフィールドはBytePlus自身のURLのままとなり、BytePlusはタスクの24時間後にそれを消去します。いずれの場合もリンクは期限切れになるため、URLを保存するのではなくフレームをダウンロードしてください。 - 生成ビデオのコンテナ形式(mp4 または mov)で、BytePlus が `content` の中にネストして返す場合のものです。Seedance モデルでは `content` のトップレベルの兄弟として返すことがより一般的です。トップレベルの `output_format` フィールドを参照してください。Router はどちらか存在する方を読み取ります。 + 生成されたビデオのコンテナ形式(mp4 または mov)で、BytePlusが `content` の中にネストして返す場合に含まれます。Seedanceモデルはこれを `content` のトップレベルの兄弟として返すことが多く、トップレベルの `output_format` フィールドを参照してください。Routerはどちらか存在する方を読み取ります。 + + + + 上流のURLが機能しなくなるRFC 3339時刻です。URL自体が持つ最も早い署名時刻に有効期間を加えたもので、`updated_at` が存在する場合はタスクの `updated_at` に24時間(BytePlusが文書化しているURLの寿命)を加えた時刻より遅くなることはなく、存在しない場合はタスクの `updated_at` に24時間を加えたものです。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 + + 形式: `date-time` + + + + 最終フレームに関するBytePlus自身のダウンロードURLで、再ホストされた `last_frame_url` の隣に、`upstream_video_url` と同じ条件でそのままのバイト列で返されます。オプトインしたワークスペースのみ、Seedance 2.xのみが対象で、BytePlusが消去すると存在しなくなり、`upstream_expires_at` まではベアラ認証情報です。 + + + + 出力ビデオに関するBytePlus自身のダウンロードURLで、再ホストされた `video_url` の隣にそのままのバイト列で返されます。Comfyがサーバー側でオプトインしたワークスペースによってポーリングされたSeedance 2.xタスクにのみ存在し(リクエストパラメータはありません)、それ以外のすべての場合(ワークスペースに解決されない認証情報、たとえばワークスペースにスコープされていないレガシーAPIキーなど)には存在しません。また、生成の24時間後にBytePlusがURLを消去すると存在しなくなります。これは署名付きオブジェクトストレージのURLであり、したがってベアラ認証情報です。所持している誰でも期限が切れるまでビデオをダウンロードできるため、シークレットとして扱ってください。`upstream_expires_at` で期限切れとなり、Seedance 2.5ではBytePlusがダウンロード回数を100回に制限しており、そのうち1回はRouter自身の再ホストが消費します。 - 出力ビデオのダウンロード URL です。Router はビデオを Comfy ストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL になります。発行時に 24 時間で署名され、23 時間のメモから再生されるため、後でポーリングすると残り 1 時間しかない URL が返ることがあります。再ホストを実行できなかった場合、このフィールドは BytePlus 独自の URL を保持し、BytePlus はタスクの 24 時間後にそれをクリアし、一部のモデルではダウンロード回数を 100 回に制限します。いずれにせよリンクは失効するため、URL を保存するのではなくビデオをダウンロードしてください。 + 出力ビデオのダウンロードURLです。RouterはビデオをComfyのストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効なComfy署名付きURLになります。発行時に24時間で署名され、23時間のメモから再生されるため、後でのポーリングでは残り1時間しかないものが返ることがあります。再ホストを実行できなかった場合、このフィールドはBytePlus自身のURLのままとなり、BytePlusはタスクの24時間後にそれを消去し、一部のモデルではダウンロード回数を100回に制限します。いずれの場合もリンクは期限切れになるため、URLを保存するのではなくビデオをダウンロードしてください。 - タスクが作成された時間です。値は秒単位の UNIX タイムスタンプです。 + タスクが作成された時刻です。値はUNIXタイムスタンプ(秒)です。 - 生成ビデオの再生時間(秒)です。BytePlus がこれについて一貫していないため、整数ではなく数値として宣言されています。ビデオタスクでは整数秒が返されることが観測されており、同系列の BytePlus の他のサーフェスでは小数の再生時間が報告されているため、クライアントは整数値を前提にしてはなりません。BytePlus 独自のフィールドで、succeeded のビデオタスクで返され、そのまま転送されます。 + 生成されたビデオの再生時間(秒)です。整数ではなく数値として宣言されているのは、BytePlusがこの点で一貫していないためです。ビデオタスクが整数秒を返す一方、同じBytePlusの他のサーフェスでは小数の再生時間が報告されることが観測されており、クライアントは整数値を前提にしてはいけません。BytePlus自身のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 - エラー情報です。タスクが成功した場合は null が返されます。タスクが失敗した場合はエラー情報が返されます。 + エラー情報です。タスクが成功した場合はnullが返されます。タスクが失敗した場合はエラー情報が返されます。 - 上流の ModelArk エラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーには、InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake のようにドット区切りの理由が付く場合があります。これは enum ではなくオープンな文字列です。その他のコードは検証およびプロバイダーの失敗を表します。Router は HTTP 400 のエラーエンベロープと HTTP 200 の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 + 上流のModelArkエラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーにはドット区切りの理由が付くことがあり、たとえば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などがあります。これはオープンな文字列であり、列挙型ではありません。他のコードは検証およびプロバイダーの失敗を表します。RouterはHTTP 400のエラーエンベロープとHTTP 200の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 @@ -398,23 +413,23 @@ Router が `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json` - ビデオ生成タスクの ID + The ID of the video generation task - タスクで使用されたモデルの名前とバージョン + タスクで使用されるモデルの名前とバージョン - 生成ビデオのコンテナ形式(mp4 または mov)で、`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここでこれを返します。BytePlus 独自のフィールドで、そのまま転送されます。 + 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。ここが Seedance のビデオタスククエリでこれが返される場所です。BytePlus 独自のフィールドで、そのまま転送されます。 - 生成ビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドで、succeeded のビデオタスクで返され、そのまま転送されます。 + 生成済みビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 - タスクで実際に使用された生成シード。BytePlus 独自のフィールドで、succeeded のビデオタスクで返され、そのまま転送されます。 + タスクで実際に使用された生成シード。BytePlus 独自のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 形式: `int64` @@ -426,7 +441,7 @@ Router が `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json` - タスクが最後に更新された時間です。値は秒単位の UNIX タイムスタンプです。 + タスクが最後に更新された時刻。値は秒単位の UNIX タイムスタンプです。 @@ -438,7 +453,7 @@ Router が `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json` - ビデオ生成モデルでは、入力トークン数は計算されず 0 がデフォルトです。したがって、total_tokens = completion_tokens となります。 + ビデオ生成モデルでは、入力トークン数は計算されず、デフォルトで 0 になります。そのため、total_tokens = completion_tokens となります。 ## 例 diff --git a/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx b/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx index fa9e5a7ffa..43eadea527 100644 --- a/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx +++ b/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx @@ -2,17 +2,16 @@ title: "Comfy Router で Seedance 1.0 Pro 250528 を使用する" description: "Comfy Router 経由で byteplus/seedance-1-0-pro-250528 を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Seedance 1.0 Pro 250528" -translationSourceHash: 084b73ac +translationSourceHash: 450bbe6e translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx translationBlockHashes: "_intro": e1a3501d "Quick start": c762675f - "Schema": af62a34c + "Schema": fc979e05 "Examples": 815d621e --- - {/* 生成済みファイル。`pnpm code-pages:gen` によって router-schemas/byteplus/seedance-1-0-pro-250528.json から生成されました。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -181,7 +180,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528/requests/$ ### 入力 - この生成タスクの結果を受け取るコールバック通知先アドレス + 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。代わりにタスクステータスのルートをポーリングして結果を取得してください。 形式: `uri` @@ -191,19 +190,19 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528/requests/$ - 入力オーディオオブジェクト。オーディオ入力に対応するのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単体では使用できず、少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力に対応します。 + 入力オーディオオブジェクト。オーディオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単体では使用できません。少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力に対応しています。 - オーディオの URL、Base64 エンコード、またはアセット ID。 + オーディオ URL、Base64 エンコード、またはアセット ID。 オーディオ URL: オーディオの公開 URL(wav、mp3)。 -Base64: 形式は data:audio/\;base64,\ -アセット ID: 形式は asset://\ +Base64: 形式 data:audio/\;base64,\ +アセット ID: 形式 asset://\ Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。唯一のコンテンツ項目である必要があります。 -最終ビデオは Draft タスクの prompt、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用するため、これらを再度送信しないでください。resolution はデフォルトで 1080p になり、1080p のみをサポートします。 +最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。resolution はデフォルトで 1080p になり、1080p のみをサポートします。 @@ -216,162 +215,176 @@ Base64: 形式は data:audio/\;base64,\ 画像から動画への生成に使用する画像コンテンツ(type が "image_url" の場合) -画像 URL: 画像 URL にアクセスできることを確認してください。 +画像URL: 画像 URL にアクセス可能であることを確認してください。 Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります -アセット ID: 形式は asset://\ +アセット ID: 形式 asset://\ - コンテンツ項目の役割 / 位置。 -画像の場合: first_frame、last_frame、または reference_image。 + コンテンツ項目の役割/位置。 +画像の場合: first_frame、last_frame、reference_image。 ビデオの場合: reference_video(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 オーディオの場合: reference_audio(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 - 指定可能な値: `first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` + 可能な値: `first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータを含みます。 -テキストプロンプト(必須): 中国語および英語の文字を使用して生成するビデオを説明します。 +テキストプロンプト(必須): 中国語および英語の文字で記述する、生成するビデオの説明。 パラメータ(任意): テキストプロンプトの後に --[parameters] を追加すると、ビデオの仕様を制御できます: -- --resolution(--rs): 480p、720p、1080p(デフォルト: 720p) -- --ratio(--rt): 21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(デフォルト: 16:9 または adaptive) -- --duration(--dur): 3~12 秒(デフォルト: 5) -- --framepersecond(--fps): 24(デフォルト: 24) -- --watermark(--wm): true/false(デフォルト: false) -- --seed(--seed): -1 ~ 2^32-1(デフォルト: -1) -- --camerafixed(--cf): true/false(デフォルト: false) +- --resolution (--rs): 480p、720p、1080p(デフォルト: 720p) +- --ratio (--rt): 21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(デフォルト: 16:9 または adaptive) +- --duration (--dur): 3〜12 秒(デフォルト: 5) +- --framepersecond (--fps): 24(デフォルト: 24) +- --watermark (--wm): true/false(デフォルト: false) +- --seed (--seed): -1〜2^32-1(デフォルト: -1) +- --camerafixed (--cf): true/false(デフォルト: false) 例: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" Comfy 側のガードレールであり、BytePlus の制約ではありません。BytePlus は -テキスト長の上限を公表しておらず、テストでは 40,000 文字を受け付けました(2026-09-17)。 -これはバイト数ではなく文字数をカウントするため、マルチバイトのプロンプトでは -転送時のサイズがこの数倍になることがあります。これはこの 1 つのフィールドを制限するもので、 -リクエスト全体を制限するものではありません: `content` は配列であり、ドキュメント全体を -制限するのはリクエストごとのボディ上限です。これを適用するのは Comfy Router -(/v2/models/byteplus/\{model})であり、v1 /proxy を直接呼び出した場合は BytePlus 自身の -バリデータが代わりに応答します。実際のトラフィックよりはるかに高く設定されているため、 -正当なプロンプトを判定の対象にすることはありません。呼び出し元がより多くを必要とする場合は -引き上げてください。 +テキスト長の制限を公開しておらず、テスト(2026-09-17)では 40,000 文字を +受け付けました。バイト数ではなく文字数をカウントするため、マルチバイトの +プロンプトは通信時にこのサイズの数倍になる可能性があります。これはこの 1 つの +フィールドを制限するものであり、リクエスト全体を制限するものではありません。 +`content` は配列であり、リクエスト全体のボディ制限がドキュメント全体を +制限します。これを適用するのは Comfy Router(/v2/models/byteplus/\{model})です。 +v1 /proxy を直接呼び出した場合は、代わりに BytePlus 自身のバリデータが +応答します。実際のトラフィックよりはるかに高く設定されているため、正当な +プロンプトがこの制限で判定されることはありません。呼び出し元がより多くを +必要とする場合は値を引き上げてください。 入力コンテンツの種類 - 指定可能な値: `text`、`image_url`、`video_url`、`audio_url`、`draft_task` + 可能な値: `text`、`image_url`、`video_url`、`audio_url`、`draft_task` - 入力ビデオオブジェクト。ビデオ入力に対応するのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。 + 入力ビデオオブジェクト。ビデオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。 ビデオ URL またはアセット ID。 ビデオ URL: ビデオの公開 URL(mp4、mov)。 -アセット ID: 形式は asset://\ +アセット ID: 形式 asset://\ Seedance 2.5 のみ。480p の Draft ビデオを生成します。resolution は 480p である必要があります。 -最終的な 1080p ビデオをレンダリングするには、返されたタスク ID を `draft_task` コンテンツ項目で渡します。Draft タスク ID は 7 日間有効です。 +返されたタスク ID を `draft_task` コンテンツ項目で渡すと、最終的な 1080p ビデオがレンダリングされます。Draft タスク ID は 7 日間有効です。 ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動。ビデオ編集タスクは -1 のみをサポート)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。 - 範囲: `2` ~ `30` + 範囲: `2` から `30` タスクのタイムアウトしきい値(秒)。デフォルト 172800(48 時間)。範囲: [3600, 259200]。 - 範囲: `3600` ~ `259200` + 範囲: `3600` から `259200` - Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされます。生成されるビデオに映像と同期したオーディオを含めるかどうか。 -true: モデルは同期したオーディオ付きのビデオを出力します。 -false: モデルは無音のビデオを出力します。 -対応しているモデルでは、生成されたオーディオトラックは映像とは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーが通常は受け入れる入力でも断続的に発生することがあります。その場合は `false` を送って無音のビデオを生成してください。これはオーディオが拒否されたモダリティである場合にのみ有効で、同期 Router レスポンスはそれを `refusal_subject: output_audio` として示します(キューに入れたリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を作り直してください。 + Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されるビデオに映像と同期したオーディオを含めるかどうか。 +true: モデルは同期オーディオ付きのビデオを出力します。 +false: モデルは無音のビデオを出力します。対応しているモデルでは、生成されるオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外は受け入れる入力であっても断続的に発生することがあります。そのような場合はサイレントビデオにするため `false` を送信してください。これが有効なのは、拒否されたモダリティがオーディオであった場合のみで、同期 Router レスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは自身の Draft タスクから `generate_audio` を継承するため、代わりに `false` を指定して Draft を再作成してください。 - 呼び出すモデルの ID。サポートされるモデル: seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini、dreamina-seedance-2-5-260628。POST /proxy/byteplus/api/v3/contents/generations/tasks への v1 直接呼び出しでは必ずこれを指定する必要があり、プロキシは他の値や省略された場合は 400 で拒否します。このスキーマの `required` リストに含まれていないのは、Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントからこれを補うためであり、Router の呼び出し元は省略します。 + 呼び出すモデルの ID。サポートされているモデル: seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini、dreamina-seedance-2-5-260628。POST /proxy/byteplus/api/v3/contents/generations/tasks への直接の v1 呼び出しでは必ず指定する必要があります。プロキシはそれ以外の値や省略された値を 400 で拒否します。Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントからこの値を設定するため、このスキーマの `required` リストには含まれていません。そのため Router の呼び出し元は省略します。 Seedance 2.5 のみ。出力ビデオのコンテナ形式。 -mp4: 汎用コンテナ(H.264/AAC、yuv420p)。幅広い互換性を持ち、ファイルサイズが小さくなります。 -mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)。高い色精度を持ち、ポストプロダクションに適しています。ファイルサイズは大きくなります。 +mp4: 汎用コンテナ(H.264/AAC、yuv420p)。幅広い互換性があり、ファイルサイズも小さくなります。 +mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)。色精度が高く、ポストプロダクションに適していますが、ファイルサイズは大きくなります。 - 指定可能な値: `mp4`, `mov` + 指定可能な値: `mp4`、`mov` 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast、2.0 mini、1.5 pro のデフォルト: adaptive。 -Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive`(またはフィールドの省略)のみ受け付けます。具体的な比率を指定すると、ディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードで具体的な比率を受け付けます。 +Seedance 2.5 の最初のフレーム / 最初と最後のフレームからの生成: 出力は最初のフレームのアスペクト比に従うため、`adaptive` のみ(またはフィールドの省略)が受け付けられます。具体的な比率を指定すると、ディスパッチ前に 400 で拒否されます。Seedance 2.0 ではこれらのモードでも具体的な比率を指定できます。 - 指定可能な値: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` + 指定可能な値: `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` - ビデオ解像度。Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro & pro-fast のデフォルト: 1080p。 + ビデオの解像度。Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro、pro-fast のデフォルト: 1080p。 注: Seedance 2.0、2.0 fast、2.0 mini は 1080p をサポートしていません。Seedance 2.5 は 480p、720p、1080p をサポートしています。 - 指定可能な値: `480p`, `720p`, `1080p`, `4k` + 指定可能な値: `480p`、`720p`、`1080p`、`4k` 生成されたビデオの最終フレーム画像を返すかどうか。 -true: 生成されたビデオの最終フレーム画像を返します。このパラメータを true に設定すると、ビデオ生成タスクの情報のクエリを呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、そのピクセル幅と高さは生成されたビデオと一致し、透かしは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最終フレームを次のビデオタスクの先頭フレームとして使用することで、複数の連続したビデオをすばやく生成できます。 +true: 生成されたビデオの最終フレーム画像を返します。このパラメータを true に設定すると、ビデオ生成タスクの情報を照会する API を呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最終フレームが次のビデオタスクの最初のフレームとして使用されるため、複数の連続したビデオを素早く生成できます。 false: 生成されたビデオの最終フレーム画像を返しません。 - ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 はランダムシードを使用します。 + ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 を指定するとランダムなシードが使用されます。 範囲: `-1` から `4294967295` - 処理のサービス階層。Seedance 2.5、2.0 & 2.0 fast は flex(オフライン推論)をサポートしていません。 + 処理のサービスティア。Seedance 2.5、2.0、2.0 fast は flex(オフライン推論)をサポートしていません。 - 指定可能な値: `default`, `flex` + 指定可能な値: `default`、`flex` - 生成されたビデオに透かしを含めるかどうか。 + 生成されたビデオにウォーターマークが含まれるかどうか。 -Router が `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用する同一のドキュメントです。 +`GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するものと同じドキュメントです。 ### 出力 - ビデオ生成タスク完了後の出力です。出力ビデオのダウンロード URL と、BytePlus が返す場合はその最終フレームのダウンロード URL を含みます。`video_url` と `last_frame_url` はどちらも Comfy ストレージへ再ホストされ、ここにあるその他のフィールドはすべて BytePlus 自身のものです。Nullable - BytePlus はタスクの 24 時間後に URL をクリアするため、その後でポーリングされた succeeded ドキュメントは `content` が欠落しているか null である可能性があります。 + ビデオ生成タスク完了後の出力です。出力ビデオのダウンロード URL を含み、BytePlus が返す場合はその最終フレームのダウンロード URL も含みます。`video_url` と `last_frame_url` はどちらも Comfy のストレージへ再ホストされており、ここにある他のすべてのフィールドは BytePlus 自身のものです。null 許容: BytePlus はタスクの 24 時間後に URL をクリアするため、その後にポーリングした成功済みドキュメントでは `content` が存在しないか null になることがあります。 - 生成されたビデオの最終フレームのダウンロード URL です。リクエストで `return_last_frame` を設定した場合に返されます。この URL から画像フォーマットを推測しないでください。BytePlus はリクエスト側で最終フレームを PNG として文書化しており、Router は提供されたバイト列をそのまま再ホストし、上流の Content-Type またはコンテンツスニッフから型を決定します。`image/jpeg` は両方とも失敗した場合の最後の手段のフォールバックにすぎません。Router は最終フレームを Comfy ストレージへ再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL になります。発行時に 24 時間で署名され、23 時間のメモから再生されるため、後でポーリングすると残り 1 時間しかないものが返されることがあります。再ホストを実行できなかった場合、このフィールドは代わりに BytePlus 自身の URL を保持し、BytePlus はタスクの 24 時間後にそれをクリアします。いずれにせよリンクは期限切れになるため、URL を保存するのではなくフレームをダウンロードしてください。 + 生成されたビデオの最終フレームのダウンロード URL で、リクエストで `return_last_frame` を設定した場合に返されます。この URL から画像形式を推測しないでください。BytePlus はリクエスト側で最終フレームを PNG としてドキュメント化しており、Router は配信されたバイト列をそのまま再ホストし、上流の Content-Type またはコンテンツスニッフィングから型を判定します。`image/jpeg` はその両方が失敗したときの最後のフォールバックにすぎません。Router は最終フレームを Comfy のストレージへ再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL になります。発行時に 24 時間で署名され、23 時間のメモから再生されるため、後でポーリングすると残り 1 時間しかない URL が返ることがあります。再ホストを実行できなかった場合は、代わりに BytePlus 自身の URL がこのフィールドに残りますが、BytePlus はタスクの 24 時間後にそれをクリアします。いずれの場合もリンクは失効するため、URL を保存するのではなくフレームをダウンロードしてください。 - 生成されたビデオのコンテナフォーマット (mp4 または mov) です。BytePlus が `content` 内にネストして返す場合に含まれます。Seedance モデルはこれを `content` のトップレベルの兄弟として返すことの方が多く、トップレベルの `output_format` フィールドを参照してください。Router は存在する方のいずれかを読み取ります。 + BytePlus が `content` の中にネストして返す場合の、生成されたビデオのコンテナ形式(mp4 または mov)です。Seedance モデルではこれを `content` のトップレベルの兄弟として返すことのほうが多く、その場合はトップレベルの `output_format` フィールドを参照してください。Router はどちらか存在する方を読み取ります。 + + + + 上流の URL が機能しなくなる RFC 3339 の時刻です。URL 自体が持つ最も早い署名時刻に有効期間を加えたもので、`updated_at` が存在する場合はタスクの `updated_at` に 24 時間(BytePlus がドキュメント化している URL の寿命)を加えた時刻を超えることはなく、存在しない場合はタスクの `updated_at` に 24 時間を加えた時刻になります。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースも時刻を返さない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 + + 形式: `date-time` + + + + 最終フレームの BytePlus 自身のダウンロード URL で、再ホストされた `last_frame_url` の隣にそのままのバイト列で返されます。条件は `upstream_video_url` と同じです。オプトインしたワークスペースのみ、Seedance 2.x のみで、BytePlus がクリアすると存在しなくなり、`upstream_expires_at` まではベアラー資格情報として扱われます。 + + + + 出力ビデオの BytePlus 自身のダウンロード URL で、再ホストされた `video_url` の隣にそのままのバイト列で返されます。Comfy がサーバー側でオプトインしたワークスペースによってポーリングされた Seedance 2.x のタスクでのみ存在し(リクエストパラメーターはありません)、それ以外のすべてのケースでは存在しません。ワークスペースに解決されない資格情報(ワークスペースにスコープされていないレガシー APIキーなど)も含みます。また、生成から 24 時間後に BytePlus が URL をクリアすると存在しなくなります。これは署名付きオブジェクトストレージの URL であり、したがってベアラー資格情報です。これを保持する誰もが失効までビデオをダウンロードできるため、シークレットと同様に扱ってください。`upstream_expires_at` に失効し、Seedance 2.5 では BytePlus がダウンロード回数を 100 回に制限しており、そのうち 1 回は Router 自身の再ホストで消費されます。 - 出力ビデオのダウンロード URL です。Router はビデオを Comfy ストレージへ再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL になります。発行時に 24 時間で署名され、23 時間のメモから再生されるため、後でポーリングすると残り 1 時間しかないものが返されることがあります。再ホストを実行できなかった場合、このフィールドは代わりに BytePlus 自身の URL を保持し、BytePlus はタスクの 24 時間後にそれをクリアし、一部のモデルでは 100 ダウンロードに制限しています。いずれにせよリンクは期限切れになるため、URL を保存するのではなくビデオをダウンロードしてください。 + 出力ビデオのダウンロード URL です。Router はビデオを Comfy のストレージへ再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL になります。発行時に 24 時間で署名され、23 時間のメモから再生されるため、後でポーリングすると残り 1 時間しかない URL が返ることがあります。再ホストを実行できなかった場合は、代わりに BytePlus 自身の URL がこのフィールドに残りますが、BytePlus はタスクの 24 時間後にそれをクリアし、一部のモデルではダウンロード回数が 100 回に制限されます。いずれの場合もリンクは失効するため、URL を保存するのではなくビデオをダウンロードしてください。 - タスクが作成された時間です。値は秒単位の UNIX タイムスタンプです。 + タスクが作成された時刻です。値は秒単位の UNIX タイムスタンプです。 - 生成されたビデオの再生時間 (秒) です。整数ではなく数値として宣言されているのは、BytePlus がこれについて一貫していないためです。ビデオタスクでは整数秒を返すことが観測されており、兄弟の BytePlus サーフェスでは小数の再生時間を報告しているため、クライアントは整数値を前提にしてはなりません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + 生成されたビデオの再生時間(秒)です。BytePlus がこの点で一貫していないため、整数ではなく数値として宣言されています。ビデオタスクが整数秒を返すこともあれば、同じ BytePlus の別のサーフェスが小数の再生時間を報告することも観測されているため、クライアントは整数値だと仮定してはいけません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 @@ -379,7 +392,7 @@ Router が `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` で提 - 上流の ModelArk エラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を識別します。ファミリーには、InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake のようにドット区切りの理由が付くことがあります。これは列挙型ではなくオープンな文字列で、その他のコードは検証やプロバイダーの失敗を表します。Router は HTTP 400 エラーエンベロープおよび HTTP 200 の失敗タスク応答でポリシーファミリーを認識し、トランスポートの失敗を上書きすることはありません。 + 上流の ModelArk エラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を識別します。ファミリーにはドット区切りの理由が付くことがあり、たとえば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などがあります。これは列挙型ではなくオープンな文字列で、他のコードは検証やプロバイダーの障害を表します。Router は HTTP 400 のエラーエンベロープと HTTP 200 の失敗タスク応答でポリシーファミリーを認識しますが、トランスポート層の障害を上書きすることはありません。 @@ -388,34 +401,35 @@ Router が `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` で提 ビデオ生成タスクの ID + - + タスクで使用されたモデルの名前とバージョン - 生成されたビデオのコンテナフォーマット (mp4 または mov) で、`content` の兄弟としてトップレベルで返されます。ここが Seedance ビデオタスククエリがそれを返す場所です。BytePlus 自身のフィールドで、そのまま転送されます。 + 生成済みビデオのコンテナ形式(`mp4` または `mov`)。`content` の兄弟としてトップレベルで返されます。ここが Seedance ビデオタスククエリで返される位置です。BytePlus 独自のフィールドで、変更されずにそのまま転送されます。 - 生成されたビデオの解像度です。例えば `1080p` です。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + 生成済みビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 - タスクに実際に使用された生成シードです。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + タスクで実際に使用された生成シード。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。 - フォーマット: `int64` + 形式: `int64` タスクの状態 - 可能な値: `queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` + 取り得る値: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` - タスクが最後に更新された時間です。値は秒単位の UNIX タイムスタンプです。 + タスクが最後に更新された時刻。値は UNIX タイムスタンプ(秒単位)です。 @@ -427,7 +441,7 @@ Router が `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` で提 - ビデオ生成モデルでは、入力トークン数は計算されず、デフォルトで 0 になります。したがって、total_tokens = completion_tokens です。 + ビデオ生成モデルでは、入力トークン数は計算されず、デフォルトで 0 になります。そのため、total_tokens = completion_tokens となります。 ## 例 diff --git a/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx b/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx index 414aab9405..a308a23c0c 100644 --- a/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx +++ b/ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx @@ -2,17 +2,16 @@ title: "Seedance 1.0 Pro Fast 251015 を Comfy Router で使用する" description: "Comfy Router 経由で byteplus/seedance-1-0-pro-fast-251015 を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンスについて解説します。" sidebarTitle: "Seedance 1.0 Pro Fast 251015" -translationSourceHash: 600f57b4 +translationSourceHash: 43683424 translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx translationBlockHashes: "_intro": 451ffa4b "Quick start": ec2a21ac - "Schema": 1df5b053 + "Schema": a882b2d8 "Examples": 1469ab97 --- - {/* GENERATED FILE. Generated from router-schemas/byteplus/seedance-1-0-pro-fast-251015.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -181,7 +180,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-fast-251015/reque ### 入力 - この生成タスクの結果を受け取るコールバック通知先 + 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。代わりに、結果を取得するにはタスクステータスのルートをポーリングしてください。 形式: `uri` @@ -191,23 +190,23 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-fast-251015/reque - 入力オーディオオブジェクト。オーディオ入力は Seedance 2.5、2.0、2.0 fast、2.0 mini のみがサポートします。Seedance 2.0、2.0 fast、2.0 mini はオーディオ単体では使用できず、少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力に対応します。 + 入力オーディオオブジェクト。オーディオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。Seedance 2.0、2.0 fast、2.0 mini はオーディオのみでは使用できず、少なくとも 1 つの画像またはビデオを含める必要があります。Seedance 2.5 はオーディオのみの入力に対応しています。 オーディオ URL、Base64 エンコード、またはアセット ID。 -オーディオ URL: オーディオの公開 URL(wav、mp3)。 -Base64: 形式 data:audio/\;base64,\ -アセット ID: 形式 asset://\ +オーディオ URL: オーディオの公開 URL (wav、mp3)。 +Base64: 形式は data:audio/\;base64,\ +アセット ID: 形式は asset://\ - Seedance 2.5 のみ。最終ビデオとしてレンダリングするドラフトタスク。これは唯一のコンテンツ項目である必要があります。 -最終ビデオはドラフトタスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。解像度のデフォルトは 1080p で、1080p のみをサポートします。 + Seedance 2.5 のみ。最終ビデオとしてレンダリングするドラフトタスク。唯一のコンテンツ項目である必要があります。 +最終ビデオはドラフトタスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。resolution のデフォルトは 1080p で、1080p のみに対応します。 - `draft` を true に設定してドラフトビデオを作成したときに返されるタスク ID。 + ドラフトビデオを `draft` を true に設定して作成したときに返されるタスク ID。 @@ -215,17 +214,17 @@ Base64: 形式 data:audio/\;base64,\ - 画像から動画への生成用の画像コンテンツ(type が "image_url" の場合) -画像URL: 画像URLにアクセスできることを確認してください。 -Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります -アセット ID: 形式 asset://\ + 画像から動画への生成用の画像コンテンツ (type が "image_url" の場合) +画像 URL: 画像 URL にアクセスできることを確認してください。 +Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります。 +アセット ID: 形式は asset://\ コンテンツ項目の役割/位置。 画像の場合: first_frame、last_frame、または reference_image。 -ビデオの場合: reference_video(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 -オーディオの場合: reference_audio(Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 +ビデオの場合: reference_video (Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 +オーディオの場合: reference_audio (Seedance 2.5、2.0、2.0 fast、2.0 mini のみ)。 取り得る値: `first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` @@ -233,152 +232,167 @@ Base64 エンコードされたコンテンツ: 形式は data:image/\;b モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータを含みます。 -テキストプロンプト(必須): 中国語および英語の文字を使用して生成するビデオの説明。 +テキストプロンプト (必須): 中国語および英語の文字を使用した、生成するビデオの説明。 -パラメータ(任意): テキストプロンプトの後に --[parameters] を追加してビデオの仕様を制御します: -- --resolution (--rs): 480p、720p、1080p(デフォルト: 720p) -- --ratio (--rt): 21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(デフォルト: 16:9 または adaptive) -- --duration (--dur): 3〜12 秒(デフォルト: 5) -- --framepersecond (--fps): 24(デフォルト: 24) -- --watermark (--wm): true/false(デフォルト: false) -- --seed (--seed): -1 ~ 2^32-1(デフォルト: -1) -- --camerafixed (--cf): true/false(デフォルト: false) +パラメータ (任意): テキストプロンプトの後に --[parameters] を追加してビデオの仕様を制御します: +- --resolution (--rs): 480p、720p、1080p (デフォルト: 720p) +- --ratio (--rt): 21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive (デフォルト: 16:9 または adaptive) +- --duration (--dur): 3〜12 秒 (デフォルト: 5) +- --framepersecond (--fps): 24 (デフォルト: 24) +- --watermark (--wm): true/false (デフォルト: false) +- --seed (--seed): -1 〜 2^32-1 (デフォルト: -1) +- --camerafixed (--cf): true/false (デフォルト: false) 例: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -Comfy 側のガードレールであり、BytePlus の制約ではありません。BytePlus は -テキスト長の制限を公表しておらず、テストでは 40,000 文字を受け付けました(2026-09-17)。 -これはバイト数ではなく文字数をカウントするため、マルチバイトのプロンプトでは -転送時のサイズがこの数倍になることがあります。これはこの 1 つのフィールドを制限するもので、 -リクエストを制限するものではありません。`content` は配列であり、ドキュメント全体を -制限するのはリクエストごとのボディ制限です。これを適用するのは Comfy Router -(/v2/models/byteplus/\{model})です。v1 /proxy を直接呼び出す場合は、代わりに -BytePlus 自身のバリデータが応答します。実際のトラフィックよりはるかに高く設定されているため、 -正当なプロンプトを判定することはありません。呼び出し元がより多くを必要とする場合は -引き上げてください。 +これは BytePlus の制約ではなく、Comfy 側のガードレールです。BytePlus は +テキスト長の制限を公開しておらず、テスト (2026-09-17) では 40,000 文字を +受け付けました。文字数 (バイト数ではない) でカウントするため、マルチバイトの +プロンプトはワイヤ上ではこのサイズの数倍になることがあります。これはこの +1 つのフィールドを制限するものであり、リクエスト全体を制限するものではありません: +`content` は配列であり、ドキュメント全体を制限するのはリクエストごとの +ボディ制限です。これを適用するのは Comfy Router (/v2/models/byteplus/\{model}) +のサーフェスです。v1 /proxy を直接呼び出した場合は、代わりに BytePlus 自身の +バリデータが応答します。実際のトラフィックよりはるかに高く設定されているため、 +正当なプロンプトがこれによって判定されることはありません。呼び出し元がさらに +必要とする場合は引き上げてください。 - 入力コンテンツの種類 + 入力コンテンツのタイプ 取り得る値: `text`、`image_url`、`video_url`、`audio_url`、`draft_task` - 入力ビデオオブジェクト。ビデオ入力は Seedance 2.5、2.0、2.0 fast、2.0 mini のみがサポートします。 + 入力ビデオオブジェクト。ビデオ入力に対応しているのは Seedance 2.5、2.0、2.0 fast、2.0 mini のみです。 ビデオ URL またはアセット ID。 -ビデオ URL: ビデオの公開 URL(mp4、mov)。 -アセット ID: 形式 asset://\ +ビデオ URL: ビデオの公開 URL (mp4、mov)。 +アセット ID: 形式は asset://\ - Seedance 2.5 のみ。480p のドラフトビデオを生成します。解像度は 480p である必要があります。 -返されたタスク ID を `draft_task` コンテンツ項目で渡すと、最終的な 1080p ビデオをレンダリングします。ドラフトタスク ID は 7 日間有効です。 + Seedance 2.5 のみ。480p のドラフトビデオを生成します。resolution は 480p である必要があります。 +返されたタスク ID を `draft_task` コンテンツ項目で渡すと、最終的な 1080p ビデオがレンダリングされます。ドラフトタスク ID は 7 日間有効です。 - ビデオの再生時間(秒)。Seedance 2.5: [4,30] または -1(自動。ビデオ編集タスクは -1 のみをサポート)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。 + ビデオの再生時間 (秒)。Seedance 2.5: [4,30] または -1 (自動。ビデオ編集タスクは -1 のみ対応)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1 (自動)。Seedance 1.5 pro: [4,12] または -1。Seedance 1.0: [2,12]。 - 範囲: `2` ~ `30` + 範囲: `2` 〜 `30` - タスクのタイムアウトしきい値(秒)。デフォルト 172800(48 時間)。範囲: [3600, 259200]。 + タスクのタイムアウトしきい値 (秒)。デフォルトは 172800 (48 時間)。範囲: [3600, 259200]。 - 範囲: `3600` ~ `259200` + 範囲: `3600` 〜 `259200` - Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされます。生成されるビデオに映像と同期したオーディオが含まれるかどうか。 + Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro でサポートされています。生成されたビデオに映像と同期したオーディオを含めるかどうか。 true: モデルは同期したオーディオ付きのビデオを出力します。 -false: モデルは無音のビデオを出力します。 -対応しているモデルでは、生成されたオーディオトラックは映像とは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーが通常は受け入れる入力でも断続的に発生することがあります。その場合は `false` を送って無音のビデオを生成してください。これはオーディオが拒否されたモダリティである場合にのみ有効で、同期 Router レスポンスはそれを `refusal_subject: output_audio` として示します(キューに入れたリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` で Draft を作り直してください。 +false: モデルは無音のビデオを出力します。対応しているモデルでは、生成されたオーディオトラックはビデオとは別にプロバイダーによってコンテンツチェックされます。そこで拒否された場合は `content_policy_violation` として報告され、オーディオは実行ごとに異なるため、プロバイダーがそれ以外は受け入れる入力に対しても断続的に発生することがあります。その場合はサイレントビデオにするため `false` を送信してください。これが有効なのは拒否されたモダリティがオーディオだった場合のみで、同期の Router レスポンスでは `refusal_subject: output_audio` として示されます(キュー中のリクエストではまだ特定されません)。Seedance 2.5 の最終レンダーは Draft タスクから `generate_audio` を継承するため、代わりに `false` を指定して Draft を作り直してください。 - 呼び出すモデルの ID。サポートされるモデル: seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini、dreamina-seedance-2-5-260628。POST /proxy/byteplus/api/v3/contents/generations/tasks への直接の v1 呼び出しでは必ずこれを指定する必要があります。プロキシは他の値を拒否し、省略された場合も 400 を返します。このスキーマの `required` リストに含まれていないのは、Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントからこれを設定するためであり、Router の呼び出し元は省略します。 + 呼び出すモデルの ID。サポートされるモデル: seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini、dreamina-seedance-2-5-260628。POST /proxy/byteplus/api/v3/contents/generations/tasks への直接の v1 呼び出しでは、これを必ず指定する必要があります。プロキシはそれ以外の値や省略された値を 400 で拒否します。Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントから設定するため、このスキーマの `required` リストには含まれていません。そのため Router の呼び出し元は省略します。 - Seedance 2.5 のみ。出力ビデオのコンテナ形式。mp4: 汎用コンテナ(H.264/AAC、yuv420p)。幅広い互換性を持ち、ファイルサイズを小さくできます。 -mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)。高い色精度を持ち、ポストプロダクションに適しています。ファイルサイズは大きくなります。 + Seedance 2.5 のみ。出力ビデオのコンテナ形式です。 +mp4: 汎用コンテナ(H.264/AAC、yuv420p)。幅広い互換性があり、ファイルサイズも小さくなります。 +mov: プロフェッショナル向けコンテナ(H.264 High 4:4:4 Predictive/PCM、yuv444p)。色精度が高く、ポストプロダクションに適していますが、ファイルサイズは大きくなります。 指定可能な値: `mp4`, `mov` - 生成されるビデオのアスペクト比。Seedance 2.0、2.0 fast、2.0 mini、1.5 pro のデフォルト: adaptive。 -Seedance 2.5 の先頭フレーム / 先頭・最終フレーム生成: 出力は先頭フレームのアスペクト比に従うため、`adaptive` のみ(またはフィールドの省略)が受け付けられます。具体的な比率を指定すると、ディスパッチ前に 400 で拒否されます。Seedance 2.0 では、これらのモードでも具体的な比率を指定できます。 + 生成されるビデオの比率。Seedance 2.0、2.0 fast & 2.0 mini、1.5 pro のデフォルト: adaptive。 +Seedance 2.5 の最初のフレーム / 最初と最後のフレームからの生成: 出力は最初のフレームの比率に従うため、`adaptive`(またはこのフィールドの省略)のみが受け付けられます。具体的な比率を指定すると、ディスパッチ前に 400 で拒否されます。Seedance 2.0 はこれらのモードでも具体的な比率を受け付けます。 指定可能な値: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - ビデオの解像度。Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro および pro-fast のデフォルト: 1080p。 -注: Seedance 2.0、2.0 fast、2.0 mini は 1080p をサポートしていません。Seedance 2.5 は 480p、720p、1080p をサポートしています。 + ビデオの解像度。Seedance 2.5、2.0、2.0 fast & 2.0 mini、1.5 pro、1.0 lite のデフォルト: 720p。Seedance 1.0 pro & pro-fast のデフォルト: 1080p。 +注: Seedance 2.0、2.0 fast & 2.0 mini は 1080p をサポートしていません。Seedance 2.5 は 480p、720p、1080p をサポートしています。 指定可能な値: `480p`, `720p`, `1080p`, `4k` - 生成されるビデオの最後のフレーム画像を返すかどうか。 -true: 生成されるビデオの最後のフレーム画像を返します。このパラメータを true に設定すると、ビデオ生成タスクの情報を照会する API を呼び出すことで最後のフレーム画像を取得できます。最後のフレーム画像は PNG 形式で、そのピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最後のフレームを次のビデオタスクの先頭フレームとして使用することで、複数の連続したビデオを素早く生成できます。 -false: 生成されるビデオの最後のフレーム画像を返しません。 + 生成されたビデオの最終フレーム画像を返すかどうか。 +true: 生成されたビデオの最終フレーム画像を返します。このパラメータを true に設定した後、ビデオ生成タスクの情報を取得する API を呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最終フレームを次のビデオタスクの最初のフレームとして使用することで、複数の連続したビデオを素早く生成できます。 +false: 生成されたビデオの最終フレーム画像を返しません。 - ランダム性を制御するためのシード整数。範囲: [-1, 2^32-1]。-1 はランダムなシードを使用します。 + ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 はランダムシードを使用します。 範囲: `-1` から `4294967295` - 処理のサービスティア。Seedance 2.5、2.0 および 2.0 fast は flex(オフライン推論)をサポートしていません。 + 処理のサービスティア。Seedance 2.5、2.0 & 2.0 fast は flex(オフライン推論)をサポートしていません。 指定可能な値: `default`, `flex` - 生成されるビデオにウォーターマークを含めるかどうか。 + 生成されたビデオにウォーターマークを含めるかどうか。 -Router が `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json` で提供しているスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。 +Router が `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しの検証に使用するものと同じドキュメントです。 ### 出力 - ビデオ生成タスク完了後の出力です。出力ビデオのダウンロード URL と、BytePlus が返す場合はその最後のフレームのダウンロード URL を含みます。`video_url` と `last_frame_url` はどちらも Comfy のストレージに再ホストされます。ここにあるその他のフィールドはすべて BytePlus 自身のものです。Nullable: BytePlus はタスクの 24 時間後に URL をクリアするため、その後でポーリングした succeeded ドキュメントでは `content` が存在しないか null である可能性があります。 + ビデオ生成タスクが完了した後の出力です。出力ビデオのダウンロードURLと、BytePlusが返した場合はその最終フレームのダウンロードURLを含みます。`video_url` と `last_frame_url` はどちらもComfyのストレージに再ホストされ、ここにある他のフィールドはすべてBytePlus自身のものです。Nullable: BytePlusはタスクの24時間後にURLをクリアするため、その後でポーリングした成功済みドキュメントでは `content` が存在しないかnullになることがあります。 - 生成済みビデオの最後のフレームのダウンロード URL。リクエストで `return_last_frame` を設定した場合に返されます。この URL から画像フォーマットを推測しないでください。BytePlus はリクエスト側では最後のフレームを PNG としてドキュメント化しており、Router は渡されたバイト列をそのまま再ホストし、上流の Content-Type またはコンテンツスニッフィングから型を判定します。`image/jpeg` はその両方が失敗した場合の最後の手段のフォールバックにすぎません。Router は最後のフレームを Comfy のストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL になります。発行時に 24 時間で署名され、23 時間のメモから再生されるため、後でポーリングすると残り 1 時間しかない URL が返ることがあります。再ホストを実行できなかった場合、このフィールドは代わりに BytePlus 自身の URL を保持し、BytePlus はタスクの 24 時間後にそれをクリアします。いずれの場合もリンクは期限切れになるため、URL を保存するのではなくフレームをダウンロードしてください。 + 生成されたビデオの最終フレームのダウンロードURLで、リクエストで `return_last_frame` を設定した場合に返されます。このURLから画像形式を推測しないでください。BytePlusはリクエスト側で最終フレームをPNGとして文書化していますが、Routerは提供されたバイト列をそのまま再ホストし、上流のContent-Typeまたはコンテンツスニッフから型を判定します。`image/jpeg` は両方とも失敗した場合の最後のフォールバックにすぎません。Routerは最終フレームをComfyのストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効なComfy署名付きURLになります。発行時に24時間で署名され、23時間のメモから再生されるため、後でポーリングすると残り1時間しかないものが返ることがあります。再ホストを実行できなかった場合、このフィールドはBytePlus自身のURLのままになり、BytePlusはタスクの24時間後にそれをクリアします。いずれの場合もリンクは失効するため、URLを保存するのではなくフレームをダウンロードしてください。 - 生成済みビデオのコンテナフォーマット(mp4 または mov)。BytePlus が `content` の中にネストして返す場合のものです。Seedance モデルはより一般的には `content` のトップレベルの兄弟として返します。トップレベルの `output_format` フィールドを参照してください。Router は存在する方のフィールドを読み取ります。 + 生成されたビデオのコンテナ形式(mp4またはmov)で、BytePlusが `content` の中にネストして返す場合の値です。Seedanceモデルでは、これを `content` のトップレベルの兄弟として返すことのほうが一般的です。トップレベルの `output_format` フィールドを参照してください。Routerはどちらか存在する方を読み取ります。 + + + + 上流URLが機能しなくなるRFC 3339時刻です。URL自体が持つ最も早い署名時刻に有効期間を加えた時刻で、`updated_at` が存在する場合はタスクの `updated_at` に24時間(BytePlusが文書化しているURLの寿命)を加えた時刻より遅くなることはなく、`updated_at` が存在しない場合はタスクの `updated_at` に24時間を加えた時刻になります。`upstream_video_url` または `upstream_last_frame_url` が存在する場合にのみ存在し、どちらのソースも時刻を提供しない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 + + Format: `date-time` + + + + 最終フレームのBytePlus自身のダウンロードURLで、再ホストされた `last_frame_url` の隣に、`upstream_video_url` と同じ条件でそのままのバイト列で返されます。オプトインしたワークスペースのみ、Seedance 2.xのみ、BytePlusがクリアした後は存在せず、`upstream_expires_at` まではベアラ認証情報です。 + + + + 出力ビデオのBytePlus自身のダウンロードURLで、再ホストされた `video_url` の隣にそのままのバイト列で返されます。Comfyがサーバー側でオプトインしたワークスペースがポーリングしたSeedance 2.xタスクに対してのみ存在します(リクエストパラメータはありません)。それ以外のすべての場合、たとえばワークスペースに解決されない認証情報(特定のワークスペースにスコープされていないレガシーAPIキーなど)では存在せず、生成から24時間後にBytePlusがURLをクリアすると存在しなくなります。これは署名付きオブジェクトストレージのURLであるためベアラ認証情報であり、それを保持する誰もが失効までビデオをダウンロードできます。秘密情報として扱ってください。`upstream_expires_at` に失効し、Seedance 2.5ではBytePlusがダウンロード回数を100回に制限しており、そのうち1回はRouter自身の再ホストで消費されます。 - 出力ビデオのダウンロード URL。Router はビデオを Comfy のストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL になります。発行時に 24 時間で署名され、23 時間のメモから再生されるため、後でポーリングすると残り 1 時間しかない URL が返ることがあります。再ホストを実行できなかった場合、このフィールドは代わりに BytePlus 自身の URL を保持し、BytePlus はタスクの 24 時間後にそれをクリアし、一部のモデルでは 100 ダウンロードに制限します。いずれの場合もリンクは期限切れになるため、URL を保存するのではなくビデオをダウンロードしてください。 + 出力ビデオのダウンロードURLです。RouterはビデオをComfyのストレージに再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効なComfy署名付きURLになります。発行時に24時間で署名され、23時間のメモから再生されるため、後でポーリングすると残り1時間しかないものが返ることがあります。再ホストを実行できなかった場合、このフィールドはBytePlus自身のURLのままになり、BytePlusはタスクの24時間後にそれをクリアし、一部のモデルではダウンロード回数を100回に制限します。いずれの場合もリンクは失効するため、URLを保存するのではなくビデオをダウンロードしてください。 - タスクが作成された時間。値は UNIX タイムスタンプ(秒)です。 + タスクが作成された時刻です。値はUNIXタイムスタンプ(秒)です。 - 生成済みビデオの再生時間(秒)。整数ではなく数値として宣言されています。これは BytePlus が一貫していないためです。ビデオタスクが整数秒を返す一方で、姉妹の BytePlus サーフェスでは小数の再生時間が報告されることが観測されているため、クライアントは整数値を仮定してはなりません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + 生成されたビデオの再生時間(秒)です。BytePlusが一貫していないため、整数ではなく数値として宣言されています。ビデオタスクが整数秒を返す一方で、同系統のBytePlusの他のサーフェスは小数の再生時間を報告することが観測されているため、クライアントは整数値を前提にしてはいけません。BytePlus自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 - エラー情報。タスクが成功した場合は null が返されます。タスクが失敗した場合はエラー情報が返されます。 + エラー情報です。タスクが成功した場合はnullが返されます。タスクが失敗した場合はエラー情報が返されます。 - 上流の ModelArk エラーコード。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を識別します。ファミリーにはドット区切りの理由が付くことがあり、例えば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などです。これは列挙型ではなくオープンな文字列です。その他のコードは検証およびプロバイダーの失敗を表します。Router は HTTP 400 のエラーエンベロープおよび HTTP 200 の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。 + 上流のModelArkエラーコードです。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示します。ファミリーにはドット区切りの理由が付くことがあり、例えば InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake などです。これは列挙型ではなくオープンな文字列です。他のコードは検証とプロバイダーの障害を表します。RouterはHTTP 400のエラーエンベロープとHTTP 200の失敗タスク応答の中のポリシーファミリーを認識しますが、トランスポートの障害を上書きすることはありません。 @@ -386,7 +400,7 @@ Router が `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json` - ビデオ生成タスクの ID + ビデオ生成タスクのID @@ -394,27 +408,27 @@ Router が `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json` - 生成済みビデオのコンテナフォーマット(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここでこれを返します。BytePlus 自身のフィールドで、そのまま転送されます。 + 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリではここで返されます。BytePlus 独自のフィールドで、変更されずに転送されます。 - 生成済みビデオの解像度。例えば `1080p` です。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + 生成済みビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 - タスクで実際に使用された生成シード。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。 + タスクで実際に使用された生成シード。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。 - フォーマット: `int64` + 形式: `int64` タスクの状態 - 取り得る値: `queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` + 取りうる値: `queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` - タスクが最後に更新された時間。値は UNIX タイムスタンプ(秒)です。 + タスクが最後に更新された時間。値は秒単位の UNIX タイムスタンプです。 @@ -426,7 +440,7 @@ Router が `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json` - ビデオ生成モデルでは、入力トークン数は計算されず、デフォルトで 0 になります。したがって、total_tokens = completion_tokens です。 + ビデオ生成モデルでは、入力トークン数は計算されず 0 がデフォルトです。したがって、total_tokens = completion_tokens です。 ## 例 diff --git a/ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx b/ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx index c0c47d2b81..fa09ddc9bd 100644 --- a/ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx +++ b/ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx @@ -2,17 +2,16 @@ title: "Comfy Router で Seedance 1.5 Pro 251215 を使用する" description: "Comfy Router 経由で byteplus/seedance-1-5-pro-251215 を呼び出す: エンドポイント、リクエストの形状、Router が返すレスポンス。" sidebarTitle: "Seedance 1.5 Pro 251215" -translationSourceHash: 13f3fe20 +translationSourceHash: 1d016721 translationFrom: development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx translationBlockHashes: "_intro": 5f93a1f1 "Quick start": 71aafccf - "Schema": 6d6d6ec1 + "Schema": 35f3b5dc "Examples": 7e73ac5c --- - {/* GENERATED FILE. Generated from router-schemas/byteplus/seedance-1-5-pro-251215.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -361,6 +360,20 @@ Router が `GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json` で提 生成されたビデオのコンテナフォーマット(mp4 または mov)で、BytePlus がそれを `content` の中にネストする場合に返されます。Seedance モデルはより一般的には `content` のトップレベルの兄弟としてこれを返します(トップレベルの `output_format` フィールドを参照)。Router は存在する方のいずれかを読み取ります。 + + BytePlus 自身の出力ビデオのダウンロード URL で、再ホストされた `video_url` と並べてそのまま返されます。Comfy がサーバー側でオプトインしたワークスペースがポーリングした Seedance 2.x タスクにのみ存在し(リクエストパラメータはありません)、それ以外では存在しません。ワークスペースに解決されない資格情報(ワークスペースに紐付かないレガシー API キーなど)の場合や、BytePlus が生成から 24 時間後に URL を削除した後も同様です。これはオブジェクトストレージの署名付き URL であり、ベアラ認証情報でもあります。保持している誰でも失効までこのビデオをダウンロードできるため、シークレットとして扱ってください。失効時刻は `upstream_expires_at` で、Seedance 2.5 では BytePlus がダウンロードを 100 回までに制限しており、そのうち 1 回は Router 自身の再ホストが消費します。 + + + + BytePlus 自身のラストフレームのダウンロード URL で、再ホストされた `last_frame_url` と並べてそのまま返されます。条件は `upstream_video_url` と同じです。オプトインしたワークスペースのみ、Seedance 2.x のみで、BytePlus が削除すると存在せず、`upstream_expires_at` までベアラ認証情報です。 + + + + 上流 URL が使えなくなる RFC 3339 時刻です。URL 自体が持つ最も早い署名時刻に有効期間を加えたもので、`updated_at` がある場合はタスクの `updated_at` に 24 時間を加えた時刻(BytePlus が文書化している URL の寿命)を超えません。ない場合はタスクの `updated_at` に 24 時間を加えた時刻です。`upstream_video_url` または `upstream_last_frame_url` がある場合にのみ存在し、どちらも時刻を示さない場合は省略されます。再ホストされた `video_url` / `last_frame_url` の寿命とは無関係です。 + + 形式:`date-time` + + 出力ビデオのダウンロード URL。Router はビデオを Comfy ストレージに再ホストしてこのフィールドを書き換えるため、通常は最大 24 時間有効な Comfy 署名付き URL になります。発行時に 24 時間分署名され、23 時間のメモから再生されるため、後のポーリングでは残り 1 時間しかないものを返すことがあります。再ホストを実行できなかった場合、このフィールドは代わりに BytePlus 自身の URL を保持し、BytePlus はタスクの 24 時間後にそれをクリアし、一部のモデルではダウンロード回数を 100 回に制限しています。いずれの場合もリンクは失効するため、URL を保存するのではなくビデオをダウンロードしてください。 diff --git a/ja/development/comfy-router/models/krea/krea-3/code.mdx b/ja/development/comfy-router/models/krea/krea-3/code.mdx index 2c0d396cd2..3df99febc9 100644 --- a/ja/development/comfy-router/models/krea/krea-3/code.mdx +++ b/ja/development/comfy-router/models/krea/krea-3/code.mdx @@ -2,15 +2,16 @@ title: "Comfy Router で Krea 3 を使用する" description: "Comfy Router 経由で krea/krea-3 を呼び出します。エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Krea 3" -translationSourceHash: a539ac5a +translationSourceHash: bf8b60e8 translationFrom: development/comfy-router/models/krea/krea-3/code.mdx translationBlockHashes: "_intro": ac71b80c "Quick start": d6a4d54e - "Schema": 9c44fce0 + "Schema": 672a9195 "Examples": 276619d9 --- + {/* 生成済みファイル。router-schemas/krea/krea-3.json から `pnpm code-pages:gen` で生成済み。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -155,7 +156,7 @@ curl https://api.comfy.org/v2/models/krea/krea-3/requests/$REQUEST_ID \ - 入力画像の URL。最大8件。各 URL は、画像を POST /proxy/krea/assets にアップロードして返される image_url である必要があります(multipart フォームのフィールド `file`)。ホスト app-uploads.krea.ai 上の https URL ではないリンクは、自身の https URL であっても 400 で拒否され、app-uploads.krea.ai のリンクでも実際のアップロードではない場合は 5xx エラーで失敗します。テキストから画像への生成では省略します。 + 入力画像の URL。最大8件です。画像を POST /proxy/krea/assets にアップロードして返される image_url は常に受け付けられます(multipart フォームのフィールド `file`)。他のパブリックな https URL が受け付けられるかどうかは環境によって異なります。受け付けられない環境では、ホスト app-uploads.krea.ai 上の https URL ではないリンクは 400 で拒否されます。受け付けられる環境では、パブリックな https の画像 URL はすべて受け付けられ、形式が不正な URL や https ではない URL は 400 で拒否されます。その場合、形式が正しい https URL については、呼び出し側が修正できる参照はそのホスト名を示して 400 で拒否されます。取得前のチェックでホストが名前解決できない、または公開から到達できない場合、許可された回数を超えてリダイレクトする場合、https ではない URL や公開から到達できないホストへリダイレクトする場合、408 と 429 以外の 4xx を返す場合、画像ではない場合、読み取れない形式の画像である場合、画像サイズヘッダーが最初の 2 MiB 以内にない場合、宣言された長さのないレスポンスや chunked エンコーディングのレスポンスが画像サイズヘッダーより前に終了する場合です。それ以外の取得失敗は POST /proxy/krea で 502 エラーになります(Comfy Router は 500 internal_error で応答します)。一時的な DNS、TLS、接続の失敗、タイムアウト、配信元の 408、429、5xx などの非 200 ステータス、またはチェックを通過したものの取得時に接続すると名前解決できない、もしくは公開から到達できないホストの場合です。他の URL が受け付けられない環境では、実際のアップロードではない app-uploads.krea.ai のリンクは 5xx エラーで失敗します。受け付けられる環境では、他の到達できない参照と同様に 400 で拒否されます。サーバーがどちらに該当するかをまだ判別できていない間は、app-uploads.krea.ai のリンクではないホストを持つ https URL は、パブリックかどうかに関わらず、再試行しても安全な 503 エラーで失敗します。テキストから画像への生成では省略します。 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..5ed8471f85 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,14 +2,15 @@ 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` によって生成されています。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -166,9 +167,9 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ ### 入力 - 出力のアスペクト比。ray-3.2 ビデオモデルは 9:16、3:4、1:1、4:3、16:9、21:9 のサブセットをサポートします。 + 出力のアスペクト比。ray-3.2 のビデオモデルは、9:16、3:4、1:1、4:3、16:9、21:9 のサブセットをサポートします。 - 指定可能な値: `3:1`, `2:1`, `21:9`, `16:9`, `3:2`, `4:3`, `1:1`, `3:4`, `2:3`, `9:16`, `1:2`, `1:3` + 可能な値: `3:1`、`2:1`、`21:9`、`16:9`、`3:2`、`4:3`、`1:1`、`3:4`、`2:3`、`9:16`、`1:2`、`1:3` @@ -176,15 +177,15 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - Base64 でエンコードされた画像またはビデオデータ + Base64 エンコードされた画像またはビデオデータ - ソースとして再利用する、以前に完了した生成の UUID。ray-3.2 の video_edit / video_reframe で使用されます。 + ソースとして再利用する、以前の完了済み生成の UUID。ray-3.2 の video_edit / video_reframe で使用されます。 - MIME タイプ。data と一緒に必須です(ビデオソースの場合は url も必須。例: video_edit / video_reframe では video/mp4)。 + MIME タイプ。data を使用する場合は必須です(ビデオソースでは url を使用する場合も必須です。例: video_edit / video_reframe の video/mp4)。 @@ -192,13 +193,13 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 使用するモデル。画像生成には uni-1 / uni-1-max、ビデオの生成、編集、リフレーミングには ray-3.2 を使用します。 + 使用するモデル。画像生成には uni-1 / uni-1-max、ビデオ生成、編集、リフレーミングには ray-3.2 を使用します。 出力画像形式 - 指定可能な値: `png`, `jpeg` + 可能な値: `png`、`jpeg` @@ -206,19 +207,19 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 画像またはビデオへの参照。スタイル/コンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のうち 1 つだけを指定してください。 + 画像またはビデオへの参照。スタイル/コンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のいずれか 1 つだけを指定してください。 - Base64 でエンコードされた画像またはビデオデータ + Base64 エンコードされた画像またはビデオデータ - ソースとして再利用する、以前に完了した生成の UUID。ray-3.2 の video_edit / video_reframe で使用されます。 + ソースとして再利用する、以前の完了済み生成の UUID。ray-3.2 の video_edit / video_reframe で使用されます。 - MIME タイプ。data と一緒に必須です(ビデオソースの場合は url も必須。例: video_edit / video_reframe では video/mp4)。 + MIME タイプ。data を使用する場合は必須です(ビデオソースでは url を使用する場合も必須です。例: video_edit / video_reframe の video/mp4)。 @@ -228,39 +229,39 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ スタイルプリセット - 指定可能な値: `auto`, `manga` + 可能な値: `auto`、`manga` 実行する生成の種類。image/image_edit は uni-1 / uni-1-max モデルによって生成され、video/video_edit/video_reframe は ray-3.2 モデルによって生成されます。 - 指定可能な値: `image`, `image_edit`, `video`, `video_edit`, `video_reframe` + 可能な値: `image`、`image_edit`、`video`、`video_edit`、`video_reframe` - ray-3.2 のビデオ出力設定。ここでは検証と課金に影響するフィールドのみをモデル化しています。追加のフィールド(編集コントロール、source_position)は Luma にそのまま転送されます。 + ray-3.2 のビデオ出力設定。ここでは検証と課金に影響するフィールドのみをモデル化しています。追加のフィールド(編集コントロール、source_position)はそのまま Luma に転送されます。 - ray-3.2 の video / video_edit のクリップ再生時間。デフォルトは 5s です。HDR 生成(type video)は 5s に制限されます。 + ray-3.2 の video / video_edit におけるクリップの再生時間。デフォルトは 5s です。HDR 生成(type video)は 5s に制限されます。 - 指定可能な値: `5s`, `10s` + 可能な値: `5s`、`10s` - 画像またはビデオへの参照。スタイル/コンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のうち 1 つだけを指定してください。 + 画像またはビデオへの参照。スタイル/コンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のいずれか 1 つだけを指定してください。 - Base64 でエンコードされた画像またはビデオデータ + Base64 エンコードされた画像またはビデオデータ - ソースとして再利用する、以前に完了した生成の UUID。ray-3.2 の video_edit / video_reframe で使用されます。 + ソースとして再利用する、以前の完了済み生成の UUID。ray-3.2 の video_edit / video_reframe で使用されます。 - MIME タイプ。data と一緒に必須です(ビデオソースの場合は url も必須。例: video_edit / video_reframe では video/mp4)。 + MIME タイプ。data を使用する場合は必須です(ビデオソースでは url を使用する場合も必須です。例: video_edit / video_reframe の video/mp4)。 @@ -268,7 +269,7 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - まだ利用できません:Luma が EXR 配信を提供するまで、`exr_export=true` のリクエストは 400 で拒否されます。将来は MP4 と一緒に EXR ファイルをエクスポートします(hdr が true である必要があります)。video_reframe では拒否されます。 + まだ利用できません: Luma が EXR 配信を提供するまで、exr_export=true のリクエストは 400 で拒否されます。MP4 とともに EXR ファイルをエクスポートします(hdr true が必要)。video_reframe では拒否されます。 @@ -280,19 +281,19 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - ガイドフレーム画像(1–64)。start_frame/end_frame とは同時に使用できません。指定した再生時間で課金されます。keyframes リクエストが単一キーフレームの延長として扱われることはありません。 + ガイドフレーム画像(1–64)。start_frame/end_frame とは同時に使用できません。課金はリクエストされた再生時間に基づきます。keyframes リクエストが単一キーフレームの延長になることはありません。 - Base64 でエンコードされた画像またはビデオデータ + Base64 エンコードされた画像またはビデオデータ - ソースとして再利用する、以前に完了した生成の UUID。ray-3.2 の video_edit / video_reframe で使用されます。 + ソースとして再利用する、以前の完了済み生成の UUID。ray-3.2 の video_edit / video_reframe で使用されます。 - MIME タイプ。data と一緒に必須です(ビデオソースの場合は url も必須。例: video_edit / video_reframe では video/mp4)。 + MIME タイプ。data を使用する場合は必須です(ビデオソースでは url を使用する場合も必須です。例: video_edit / video_reframe の video/mp4)。 @@ -304,17 +305,17 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - ray-3.2 ビデオの出力解像度。デフォルトは 720p です。360p はドラフトティアです。HDR には 720p または 1080p が必要です。 + ray-3.2 の video の出力解像度。デフォルトは 720p です。360p はドラフトティアです。HDR には 720p または 1080p が必要です。 - 指定可能な値: `360p`, `540p`, `720p`, `1080p` + 可能な値: `360p`、`540p`、`720p`、`1080p` - 画像またはビデオへの参照。スタイル/コンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のうち 1 つだけを指定してください。 + 画像またはビデオへの参照。スタイル/コンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のいずれか 1 つだけを指定してください。 - Base64 でエンコードされた画像またはビデオデータ + Base64 エンコードされた画像またはビデオデータ @@ -322,7 +323,7 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - MIME タイプ。data と併用する場合は必須です(ビデオソースの場合は url とも併用します。例えば video_edit / video_reframe では video/mp4)。 + MIME タイプ。data と併用が必須です(ビデオソースの場合は url とも併用します。例: video_edit / video_reframe での video/mp4)。 @@ -330,10 +331,10 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - ウェブ検索グラウンディングを有効にします + 検索グラウンディングを有効にします -`GET /v2/models/luma_2/ray-3.2/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するドキュメントと同じものです。 +`GET /v2/models/luma_2/ray-3.2/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使うのと同じドキュメントです。 ### 出力 @@ -344,15 +345,15 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ プログラムで処理するための機械可読な失敗コード - 指定可能な値: `content_moderated`, `generation_failed`, `budget_exhausted`, `output_not_found` + 指定可能な値: `content_moderated`、`generation_failed`、`budget_exhausted`、`output_not_found` - 人間が読める失敗の説明。失敗した生成時のみ設定されます。成功時は `null` です。 + 人間が読める形式の失敗の説明。FAILED の生成時のみ設定されます。成功した生成では `null` になります。 - 生成 ID + 生成の識別子 @@ -374,13 +375,13 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ 生成の現在の状態 - 指定可能な値: `queued`, `processing`, `completed`, `failed` + 指定可能な値: `queued`、`processing`、`completed`、`failed` - 実行する生成の種類。image/image_edit は uni-1 / uni-1-max モデルによって生成され、video/video_edit/video_reframe は ray-3.2 モデルによって生成されます。 + 実行する生成の種類。image/image_edit は uni-1 / uni-1-max モデルで生成され、video/video_edit/video_reframe は ray-3.2 モデルで生成されます。 - 指定可能な値: `image`, `image_edit`, `video`, `video_edit`, `video_reframe` + 指定可能な値: `image`、`image_edit`、`video`、`video_edit`、`video_reframe` ## 例 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..b3ec0be369 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,17 +2,16 @@ 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 --- - {/* GENERATED FILE. Generated from router-schemas/luma_2/uni-1-max.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -155,15 +154,15 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ 出力のアスペクト比。ray-3.2 ビデオモデルは 9:16、3:4、1:1、4:3、16:9、21:9 のサブセットをサポートします。 - 取り得る値: `3:1`、`2:1`、`21:9`、`16:9`、`3:2`、`4:3`、`1:1`、`3:4`、`2:3`、`9:16`、`1:2`、`1:3` + 使用可能な値: `3:1`, `2:1`, `21:9`, `16:9`, `3:2`, `4:3`, `1:1`, `3:4`, `2:3`, `9:16`, `1:2`, `1:3` - スタイルやコンテンツのガイダンス用の参照画像。type 'image' では最大 9 枚、type 'image_edit' では最大 8 枚です。 + スタイル/コンテンツのガイダンス用の参照画像。type 'image' では最大 9 枚、type 'image_edit' では最大 8 枚です。 - Base64 エンコードされた画像またはビデオのデータ + Base64 でエンコードされた画像またはビデオのデータ @@ -171,7 +170,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - MIME タイプ。data と併せて必須です(ビデオソースの場合は url とも併用します。例: video_edit / video_reframe での video/mp4)。 + MIME タイプ。data と共に必須です(ビデオソースでは url と共に必須。例: video_edit / video_reframe の video/mp4)。 @@ -179,13 +178,13 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 使用するモデル。画像生成には uni-1 / uni-1-max、ビデオ生成、編集、リフレームには ray-3.2 を使用します。 + 使用するモデル。画像生成には uni-1 / uni-1-max、ビデオ生成、編集、リフレーミングには ray-3.2 を使用します。 - 出力画像フォーマット + 出力画像形式 - 取り得る値: `png`、`jpeg` + 使用可能な値: `png`, `jpeg` @@ -193,11 +192,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 画像またはビデオへの参照。スタイルやコンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のうちちょうど 1 つを指定してください。 + 画像またはビデオへの参照。スタイル/コンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のいずれか 1 つを必ず指定してください。 - Base64 エンコードされた画像またはビデオのデータ + Base64 でエンコードされた画像またはビデオのデータ @@ -205,7 +204,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - MIME タイプ。data と併せて必須です(ビデオソースの場合は url とも併用します。例: video_edit / video_reframe での video/mp4)。 + MIME タイプ。data と共に必須です(ビデオソースでは url と共に必須。例: video_edit / video_reframe の video/mp4)。 @@ -215,31 +214,31 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ スタイルプリセット - 取り得る値: `auto`、`manga` + 使用可能な値: `auto`, `manga` 実行する生成の種類。image/image_edit は uni-1 / uni-1-max モデルによって生成され、video/video_edit/video_reframe は ray-3.2 モデルによって生成されます。 - 取り得る値: `image`、`image_edit`、`video`、`video_edit`、`video_reframe` + 使用可能な値: `image`, `image_edit`, `video`, `video_edit`, `video_reframe` - ray-3.2 のビデオ出力設定。ここでは検証と課金に影響するフィールドのみをモデル化しています。その他のフィールド(編集コントロール、source_position)は Luma にそのまま転送されます。 + ray-3.2 のビデオ出力設定。ここでは検証と課金に影響するフィールドのみをモデル化しています。追加のフィールド(編集コントロール、source_position)は Luma にそのまま転送されます。 - ray-3.2 の video / video_edit におけるクリップの再生時間。デフォルトは 5s です。HDR 生成(type video)は 5s に制限されています。 + ray-3.2 の video / video_edit のクリップ再生時間。デフォルトは 5s です。HDR 生成(type が video)は 5s に制限されています。 - 取り得る値: `5s`、`10s` + 使用可能な値: `5s`, `10s` - 画像またはビデオへの参照。スタイルやコンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のうちちょうど 1 つを指定してください。 + 画像またはビデオへの参照。スタイル/コンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のいずれか 1 つを必ず指定してください。 - Base64 エンコードされた画像またはビデオのデータ + Base64 でエンコードされた画像またはビデオのデータ @@ -247,7 +246,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - MIME タイプ。data と併せて必須です(ビデオソースの場合は url とも併用します。例: video_edit / video_reframe での video/mp4)。 + MIME タイプ。data と共に必須です(ビデオソースでは url と共に必須。例: video_edit / video_reframe の video/mp4)。 @@ -255,7 +254,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - MP4 と併せて EXR ファイルをエクスポートします。hdr が true である必要があります。video_reframe では拒否されます。 + まだ利用できません: exr_export=true を含むリクエストは、Luma が EXR 配信を提供するまで 400 で拒否されます。MP4 と一緒に EXR ファイルをエクスポートします(hdr true が必要)。video_reframe では拒否されます。 @@ -263,15 +262,15 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - `keyframes` に対する出力フレーム位置。同じ長さである必要があります。5s では 0〜120、10s では 0〜240 です。そのまま転送されます。 + `keyframes` の出力フレーム位置。同じ長さで、5s の場合は 0–120、10s の場合は 0–240 です。そのまま転送されます。 - ガイドフレーム画像(1〜64 枚)。start_frame/end_frame とは同時に使用できません。請求はリクエストした再生時間に基づきます。keyframes のリクエストが単一キーフレームの延長として扱われることはありません。 + ガイドフレーム画像(1–64)。start_frame/end_frame とは同時に指定できません。請求はリクエストされた再生時間に基づきます。keyframes リクエストが単一キーフレームの延長になることはありません。 - Base64 エンコードされた画像またはビデオのデータ + Base64 でエンコードされた画像またはビデオのデータ @@ -279,7 +278,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - MIME タイプ。data と併せて必須です(ビデオソースの場合は url とも併用します。例: video_edit / video_reframe での video/mp4)。 + MIME タイプ。data と共に必須です(ビデオソースでは url と共に必須。例: video_edit / video_reframe の video/mp4)。 @@ -287,29 +286,29 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 生成されたクリップをループします。作成時のみ(type video)。 + 生成されたクリップをループします。作成時のみ(type が video)。 - ray-3.2 ビデオの出力解像度。デフォルトは 720p です。360p はドラフト階層です。HDR には 720p または 1080p が必要です。 + ray-3.2 ビデオの出力解像度。デフォルトは 720p です。360p はドラフトティアです。HDR には 720p または 1080p が必要です。 - 取り得る値: `360p`、`540p`、`720p`、`1080p` + 使用可能な値: `360p`, `540p`, `720p`, `1080p` - 画像またはビデオへの参照。スタイルやコンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のうちちょうど 1 つを指定してください。 + 画像またはビデオへの参照。スタイル/コンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のいずれか 1 つを必ず指定してください。 - Base64 エンコードされた画像またはビデオのデータ + Base64エンコードされた画像またはビデオデータ - ソースとして再利用する、以前に完了した生成の UUID です。ray-3.2 の video_edit / video_reframe で使用されます。 + 以前に完了した生成の UUID。ソースとして再利用します。ray-3.2 の video_edit / video_reframe で使用されます。 - MIME タイプ。data と一緒に必須です(ビデオソースの場合は url と一緒にも必須です。例: video_edit / video_reframe では video/mp4)。 + MIME タイプ。data と一緒に必須です(ビデオソースの場合は url とも一緒に必須です。例: video_edit / video_reframe の video/mp4)。 @@ -317,10 +316,10 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - Web検索のグラウンディングを有効にします + ウェブ検索のグラウンディングを有効にします -`GET /v2/models/luma_2/uni-1-max/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用される同じドキュメントです。 +Router が `GET /v2/models/luma_2/uni-1-max/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するのと同じドキュメントです。 ### 出力 @@ -329,17 +328,17 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - プログラムで処理するための機械可読な失敗コード + プログラムによる処理向けの機械可読な失敗コード - 指定可能な値: `content_moderated`, `generation_failed`, `budget_exhausted`, `output_not_found` + 取り得る値: `content_moderated`, `generation_failed`, `budget_exhausted`, `output_not_found` - 人間が読める失敗の説明。FAILED の生成時のみ設定されます。成功時は `null` です。 + 人間が読める失敗の説明。生成が FAILED の場合にのみ設定され、成功時は `null` です。 - 生成 ID + 生成の識別子 @@ -347,7 +346,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 生成済み出力のエントリ + 生成済みの出力エントリ @@ -355,19 +354,19 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 署名付き URL(有効期限 1 時間) + Presigned URL(有効期限 1 時間) 生成の現在の状態 - 指定可能な値: `queued`, `processing`, `completed`, `failed` + 取り得る値: `queued`, `processing`, `completed`, `failed` 実行する生成の種類。image/image_edit は uni-1 / uni-1-max モデルによって生成され、video/video_edit/video_reframe は ray-3.2 モデルによって生成されます。 - 指定可能な値: `image`, `image_edit`, `video`, `video_edit`, `video_reframe` + 取り得る値: `image`, `image_edit`, `video`, `video_edit`, `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..ab08ccc0e0 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,17 +2,16 @@ 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 --- - {/* GENERATED FILE. Generated from router-schemas/luma_2/uni-1.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -155,37 +154,37 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ 出力のアスペクト比。ray-3.2 のビデオモデルは 9:16、3:4、1:1、4:3、16:9、21:9 のサブセットをサポートします。 - 指定可能な値: `3:1`, `2:1`, `21:9`, `16:9`, `3:2`, `4:3`, `1:1`, `3:4`, `2:3`, `9:16`, `1:2`, `1:3` + 指定可能な値: `3:1`、`2:1`、`21:9`、`16:9`、`3:2`、`4:3`、`1:1`、`3:4`、`2:3`、`9:16`、`1:2`、`1:3` - スタイル/コンテンツのガイダンス用の参照画像。type が 'image' の場合は最大 9 枚、type が 'image_edit' の場合は最大 8 枚です。 + スタイルやコンテンツのガイダンス用の参照画像。type 'image' では最大 9 枚、type 'image_edit' では最大 8 枚です。 - Base64 エンコードされた画像またはビデオデータ + Base64 エンコードされた画像またはビデオのデータ - ソースとして再利用する、以前に完了した生成の UUID。ray-3.2 の video_edit / video_reframe で使用されます。 + ソースとして再利用する、過去の完了済み生成の UUID。ray-3.2 の video_edit / video_reframe で使用されます。 - MIME タイプ。data と併用する場合は必須です(ビデオソースの場合は url と併用する場合も必須。例: video_edit / video_reframe での video/mp4)。 + MIME タイプ。data と併せて必須です(ビデオソースの場合は url とも併用します。例: video_edit / video_reframe での video/mp4)。 - 一般に公開されている画像またはビデオの URL + 公開アクセス可能な画像またはビデオの URL - 使用するモデル。画像生成には uni-1 / uni-1-max、ビデオの生成、編集、リフレーミングには ray-3.2 を使用します。 + 使用するモデル。画像生成には uni-1 / uni-1-max、ビデオ生成、編集、リフレームには ray-3.2 を使用します。 - 出力画像のフォーマット + 出力画像フォーマット - 指定可能な値: `png`, `jpeg` + 指定可能な値: `png`、`jpeg` @@ -193,35 +192,35 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 画像またはビデオへの参照。スタイル/コンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のいずれか 1 つだけを指定してください。 + 画像またはビデオへの参照。スタイルやコンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のいずれか 1 つだけを指定してください。 - Base64 エンコードされた画像またはビデオデータ + Base64 エンコードされた画像またはビデオのデータ - ソースとして再利用する、以前に完了した生成の UUID。ray-3.2 の video_edit / video_reframe で使用されます。 + ソースとして再利用する、過去の完了済み生成の UUID。ray-3.2 の video_edit / video_reframe で使用されます。 - MIME タイプ。data と併用する場合は必須です(ビデオソースの場合は url と併用する場合も必須。例: video_edit / video_reframe での video/mp4)。 + MIME タイプ。data と併せて必須です(ビデオソースの場合は url とも併用します。例: video_edit / video_reframe での video/mp4)。 - 一般に公開されている画像またはビデオの URL + 公開アクセス可能な画像またはビデオの URL スタイルプリセット - 指定可能な値: `auto`, `manga` + 指定可能な値: `auto`、`manga` - 実行する生成の種類。image/image_edit は uni-1 / uni-1-max モデルで生成され、video/video_edit/video_reframe は ray-3.2 モデルで生成されます。 + 実行する生成の種類。image/image_edit は uni-1 / uni-1-max モデルによって生成され、video/video_edit/video_reframe は ray-3.2 モデルによって生成されます。 - 指定可能な値: `image`, `image_edit`, `video`, `video_edit`, `video_reframe` + 指定可能な値: `image`、`image_edit`、`video`、`video_edit`、`video_reframe` @@ -229,33 +228,33 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - ray-3.2 の video / video_edit におけるクリップの再生時間。デフォルトは 5s です。HDR 生成(type が video)は 5s に制限されています。 + ray-3.2 の video / video_edit におけるクリップの再生時間。デフォルトは 5s です。HDR 生成(type video)は 5s に制限されています。 - 指定可能な値: `5s`, `10s` + 指定可能な値: `5s`、`10s` - 画像またはビデオへの参照。スタイル/コンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のいずれか 1 つだけを指定してください。 + 画像またはビデオへの参照。スタイルやコンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のいずれか 1 つだけを指定してください。 - Base64 エンコードされた画像またはビデオデータ + Base64 エンコードされた画像またはビデオのデータ - ソースとして再利用する、以前に完了した生成の UUID。ray-3.2 の video_edit / video_reframe で使用されます。 + ソースとして再利用する、過去の完了済み生成の UUID。ray-3.2 の video_edit / video_reframe で使用されます。 - MIME タイプ。data と併用する場合は必須です(ビデオソースの場合は url と併用する場合も必須。例: video_edit / video_reframe での video/mp4)。 + MIME タイプ。data と併せて必須です(ビデオソースの場合は url とも併用します。例: video_edit / video_reframe での video/mp4)。 - 一般に公開されている画像またはビデオの URL + 公開アクセス可能な画像またはビデオの URL - MP4 と併せて EXR ファイルをエクスポートします。hdr が true である必要があります。video_reframe では拒否されます。 + 現時点では利用不可: exr_export=true を含むリクエストは、Luma が EXR 配信を提供開始するまで 400 で拒否されます。MP4 と併せて EXR ファイルをエクスポートします(hdr が true である必要があります)。video_reframe では拒否されます。 @@ -263,41 +262,41 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - `keyframes` の出力フレーム位置。同じ長さである必要があります。5s の場合は 0–120、10s の場合は 0–240 です。そのまま転送されます。 + `keyframes` の出力フレーム位置。`keyframes` と同じ長さで、5s では 0〜120、10s では 0〜240 です。そのまま転送されます。 - ガイドフレーム画像(1–64)。start_frame/end_frame とは同時に指定できません。課金は指定した再生時間に基づきます。keyframes のリクエストが単一キーフレームの延長として扱われることはありません。 + ガイドフレーム画像(1〜64 枚)。start_frame/end_frame とは同時に使用できません。指定した再生時間で課金され、keyframes リクエストが単一キーフレームの延長として扱われることはありません。 - Base64 エンコードされた画像またはビデオデータ + Base64 エンコードされた画像またはビデオのデータ - ソースとして再利用する、以前に完了した生成の UUID。ray-3.2 の video_edit / video_reframe で使用されます。 + ソースとして再利用する、過去の完了済み生成の UUID。ray-3.2 の video_edit / video_reframe で使用されます。 - MIME タイプ。data と併用する場合は必須です(ビデオソースの場合は url と併用する場合も必須。例: video_edit / video_reframe での video/mp4)。 + MIME タイプ。data と併せて必須です(ビデオソースの場合は url とも併用します。例: video_edit / video_reframe での video/mp4)。 - 一般に公開されている画像またはビデオの URL + 公開アクセス可能な画像またはビデオの URL - 生成されたクリップをループします。作成時のみ(type が video)。 + 生成されたクリップをループします。作成時のみ指定可能です(type video)。 - ray-3.2 のビデオの出力解像度。デフォルトは 720p です。360p はドラフト用のティアです。HDR には 720p または 1080p が必要です。 + ray-3.2 の video における出力解像度。デフォルトは 720p です。360p はドラフト用のティアです。HDR には 720p または 1080p が必要です。 - 指定可能な値: `360p`, `540p`, `720p`, `1080p` + 指定可能な値: `360p`、`540p`、`720p`、`1080p` - 画像またはビデオへの参照。スタイル/コンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のいずれか 1 つだけを指定してください。 + 画像またはビデオへの参照。スタイルやコンテンツのガイダンス、ガイド付き生成、video-edit/video-reframe のソース、ガイドキーフレームに使用されます。generation_id、url、data のいずれか 1 つだけを指定してください。 @@ -305,22 +304,22 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - ソースとして再利用する、以前に完了した生成の UUID です。ray-3.2 の video_edit / video_reframe で使用されます。 + ソースとして再利用する、以前に完了した生成の UUID。ray-3.2 の video_edit / video_reframe で使用されます。 - MIME タイプ。data と併せて必須です(ビデオソースでは url も必要です。例: video_edit / video_reframe における video/mp4)。 + MIME タイプ。data との指定が必須です(ビデオソースの場合は url とも併用します。例: video_edit / video_reframe における video/mp4)。 - 一般公開されている画像またはビデオの URL + 公開アクセス可能な画像またはビデオの URL - Web 検索のグラウンディングを有効にします + 検索グラウンディングを有効にする -Router が `GET /v2/models/luma_2/uni-1/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しの検証に使用するドキュメントと同じものです。 +Router が `GET /v2/models/luma_2/uni-1/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する対象となる同一のドキュメントです。 ### 出力 @@ -335,7 +334,7 @@ Router が `GET /v2/models/luma_2/uni-1/openapi.json` で提供するスキー - 人間が読める形式の失敗の説明。FAILED の生成時のみ設定されます。成功した生成では `null` になります。 + 人が読める形式の失敗の説明。FAILED の生成時のみ設定されます。成功時は `null` です。 @@ -365,7 +364,7 @@ Router が `GET /v2/models/luma_2/uni-1/openapi.json` で提供するスキー - 実行する生成の種類。image/image_edit は uni-1 / uni-1-max モデルによって生成され、video/video_edit/video_reframe は ray-3.2 モデルによって生成されます。 + 実行する生成の種類。image/image_edit は uni-1 / uni-1-max モデルで生成され、video/video_edit/video_reframe は ray-3.2 モデルで生成されます。 指定可能な値: `image`、`image_edit`、`video`、`video_edit`、`video_reframe` diff --git a/ja/development/comfy-router/models/veed/fabric-1-0/code.mdx b/ja/development/comfy-router/models/veed/fabric-1-0/code.mdx index 6d0141b497..565246d486 100644 --- a/ja/development/comfy-router/models/veed/fabric-1-0/code.mdx +++ b/ja/development/comfy-router/models/veed/fabric-1-0/code.mdx @@ -2,14 +2,15 @@ title: "Comfy Router で Fabric 1.0 を使用する" description: "Comfy Router 経由で veed/fabric-1.0 を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Fabric 1.0" -translationSourceHash: 8e2360a2 +translationSourceHash: 0d5557e0 translationFrom: development/comfy-router/models/veed/fabric-1-0/code.mdx translationBlockHashes: "_intro": c0f6ceff "Quick start": 2856fd42 - "Schema": 9ea03528 + "Schema": 17071210 "Examples": 952acc85 --- + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/veed/fabric-1.0.json から生成されています。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -154,7 +155,7 @@ curl https://api.comfy.org/v2/models/veed/fabric-1.0/requests/$REQUEST_ID \ ### 入力 - リップシンクの対象となる音声トラックの公開 http(s) URL。ビデオの長さはオーディオと同じになります。 + リップシンクの対象となる音声トラックの公開 http(s) URL。ビデオの長さはオーディオと同じになります。オーディオが 1 回の呼び出しあたりの入力上限より長い場合、400 で拒否されます。 diff --git a/ja/development/comfy-router/models/veed/lipsync-2-0/code.mdx b/ja/development/comfy-router/models/veed/lipsync-2-0/code.mdx index 286679a13e..86f741e996 100644 --- a/ja/development/comfy-router/models/veed/lipsync-2-0/code.mdx +++ b/ja/development/comfy-router/models/veed/lipsync-2-0/code.mdx @@ -2,14 +2,15 @@ title: "Comfy Router で Lipsync 2.0 を使用する" description: "Comfy Router 経由で veed/lipsync-2.0 を呼び出します。エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。" sidebarTitle: "Lipsync 2.0" -translationSourceHash: 3d623f70 +translationSourceHash: 55607886 translationFrom: development/comfy-router/models/veed/lipsync-2-0/code.mdx translationBlockHashes: "_intro": 1fd676f1 "Quick start": 05550229 - "Schema": a26c8117 + "Schema": 24733e29 "Examples": 01527a02 --- + {/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/veed/lipsync-2.0.json から生成されます。 */} import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx"; @@ -150,7 +151,7 @@ curl https://api.comfy.org/v2/models/veed/lipsync-2.0/requests/$REQUEST_ID \ ### 入力 - ビデオにリップシンクさせる新しいオーディオトラックの公開 http(s) URL。 + ビデオにリップシンクさせる新しいオーディオトラックの公開 http(s) URL。オーディオが呼び出しごとの入力上限を超える場合は 400 で拒否されます。 diff --git a/ja/development/comfy-router/reference.mdx b/ja/development/comfy-router/reference.mdx index f5eb2d8754..029df57d63 100644 --- a/ja/development/comfy-router/reference.mdx +++ b/ja/development/comfy-router/reference.mdx @@ -2,17 +2,17 @@ title: "Comfy Router API リファレンス" description: "Comfy API 契約から生成済みの、Comfy Router のすべてのエンドポイント、パラメータ、レスポンスボディ、エラーバケット。" sidebarTitle: "API リファレンス" -translationSourceHash: 1b971d1c +translationSourceHash: 9a5e0219 translationFrom: development/comfy-router/reference.mdx translationBlockHashes: "_intro": 3f6e5d23 - "Endpoints": fbcaaf0e - "Error buckets": 36170340 + "Endpoints": 222fd740 + "Error buckets": 02a09cb4 "Response headers": 403c8bf5 - "Pre-flight cost estimates": 3ecabac6 - "Result assets": 65fc939b + "Pre-flight cost estimates": 862a49f8 + "Result assets": 18fe6dad "Per-model input and output schemas": 61c6bde8 - "Schemas": 77cfa4db + "Schemas": 0c65163b --- @@ -26,7 +26,6 @@ translationBlockHashes: - {/* 生成済みファイル: 手動で編集しないでください。 @@ -1022,6 +1021,8 @@ Router が実行前にまだ価格を算出できないモデルは、[事前見 その他のモデルは、プロバイダーのアセット参照またはインラインバイトを返します。プロバイダーの URL はプロバイダーの有効期限に従います。これは上記の有効期間よりはるかに短い場合があり、Router の契約では規定されていません。 +**BytePlus の元 URL(Seedance 2.x、オプトイン)。** Comfy がサーバー側でオプトインしたワークスペースでは、Seedance 2.x の結果に、コピーされた URL に加えて BytePlus 自身の URL が `content.upstream_video_url` と `content.upstream_last_frame_url` に入り、`content.upstream_expires_at` も付きます。リクエストパラメータはなく、既定でオプトインされているワークスペースはありません。これらの URL は生成から 24 時間で失効し、BytePlus が削除すると存在しなくなります。Seedance 2.5 では BytePlus が各 URL のダウンロードを 100 回までに制限しており、Router 自身のコピーもその 1 回を使います。各 URL は対象オブジェクトのベアラ認証情報であり、保持している誰でも失効までそのアセットをダウンロードできます。 + コピーはアセットごとのベストエフォートです。1 つのコピーが失敗した場合、そのエントリはプロバイダーの参照を保持します。レスポンスには Comfy とプロバイダーの両方の URL が含まれる可能性があり、アセットごとの明示的なコピーステータスフィールドはありません。生成は引き続き成功し、課金されます。1 つの正常に再ホストされたアセットから、すべての URL の有効期間を推測しないでください。 結果が Comfy ホストかどうかは、完了した呼び出しが後でその `Idempotency-Key` レコードから再生できるかどうかも決定します。上記の `Idempotency-Key` パラメーターは、再生できない場合に再試行が何で応答されるかを説明しています。 @@ -1034,6 +1035,24 @@ Router が実行前にまだ価格を算出できないモデルは、[事前見 ## スキーマ +### RouterBilledWorkspace + +拒否された呼び出しが課金されるはずだったウォレットです。`RouterErrorResponse.billed_workspace` に現れます。「どのウォレットが空なのか」に答えるものであり、呼び出し元の UI が現在選択しているワークスペースとは限りません。チームメンバーが個人の資格情報を使っている場合、資金のあるチームを開いていても、ここには個人のウォレットが示されます。`denied_reason` と同時にのみ存在します。 + +**フィールド** + + + Cloud ワークスペースの ID です。レガシー経路では存在しません。 + + + + `personal` または `team` です。オープンな文字列であり、それ以外の値は `personal` として扱ってください。 + + + + 呼び出しが Cloud ワークスペースではなく、呼び出し元のワークスペース以前の Metronome 顧客に課金される場合は `legacy` です。その顧客にはワークスペース ID がありません。Cloud ワークスペースの場合は存在しません。 + + ### RouterChargesOnPolicyRejection このモデルでコンテンツポリシーによる拒否が課金されるかどうか。不明な値は課金される可能性があるものとして扱ってください。 @@ -1146,6 +1165,20 @@ Router が実行前にまだ価格を算出できないモデルは、[事前見 **フィールド** + + パートナーノードの支出が拒否されたときの課金側のポリシー分岐です。`no_funds` は課金対象のウォレットが空であること、`unspecified` は資金の読み取りで理由が示されないまま呼び出しが拒否されたことを意味します。`error_type` が `insufficient_credits` で、デプロイがウォレット情報を報告する場合にのみ存在し、それ以外では存在しません。表示用のテキストではなく機械可読なコードです。表示には `detail` を使い、分岐はこのフィールドで行ってください。 + + + + 拒否された呼び出しが課金されるはずだったウォレットで、`RouterErrorResponse.billed_workspace` に現れます。「どのウォレットが空なのか」に答えるものであり、呼び出し元の UI が現在選択しているワークスペースとは限りません。チームメンバーが個人の資格情報を使っている場合、資金のあるチームを開いていても、ここには個人のウォレットが示されます。`denied_reason` と同時にのみ存在します。 + + Type: [`RouterBilledWorkspace`](#routerbilledworkspace) + + + + 拒否されたリクエストがどの資格情報で認証されたか(`personal_api_key`、`team_api_key`、`personal_session`、`team_session`)。「もう一方のウォレットに課金するには、どの資格情報に切り替えればよいか」に答えるものです。権限ではなく、何も付与しません。`denied_reason` と同時にのみ存在します。 + + コンテンツポリシーを理由にこのモデルが拒否した呼び出しでも、呼び出し元に課金されるかどうか。プロバイダーによって異なり、その違いは呼び出し時には見えず、同じ呼び出しでエラーと課金の両方を見たユーザーには知りようがありません。そのため、プロバイダーごとの伝聞に任せるのではなく、モデルごとに、呼び出しの前に明示されます。 diff --git a/ja/tutorials/video/minimax/minimax-h3-fastvideo.mdx b/ja/tutorials/video/minimax/minimax-h3-fastvideo.mdx index fb12ea7d43..e255f58449 100644 --- a/ja/tutorials/video/minimax/minimax-h3-fastvideo.mdx +++ b/ja/tutorials/video/minimax/minimax-h3-fastvideo.mdx @@ -2,7 +2,7 @@ title: "FastVideo FastH3:ComfyUI ワークフロー例" description: "FastVideo FastH3 は ComfyUI で 8 サンプリングステップで同期オーディオ付きの MiniMax H3 動画を生成します。テキストから動画と先頭・末尾フレームのワークフローに対応。" sidebarTitle: "FastVideo FastH3" -translationSourceHash: 7cbe9703 +translationSourceHash: cb542dfa translationFrom: tutorials/video/minimax/minimax-h3-fastvideo.mdx translationBlockHashes: "_intro": 096c332e @@ -10,7 +10,7 @@ translationBlockHashes: "FastH3 Text to Video": 1c4cb909 "FastH3 Image to Video": ec7d82bf "Model downloads": b88037db - "Workflow structure notes": 0542b184 + "Workflow structure notes": 8f5d2153 --- [FastVideo FastH3](https://huggingface.co/FastVideo/FastVideo-FastH3-8-Step-V2) は、FastVideo チームが MiniMax H3 を DMD2 で蒸留したチェックポイントで、ベースモデルの完全なスケジュールの代わりに **8 サンプリングステップ**でネイティブ同期オーディオ付きの動画を生成します。H3 のテキストエンコーダー、動画 VAE、オーディオ VAE をそのまま使うため、出力設定はベースモデルと同じままで、サンプリングだけが大幅に短縮されます。 @@ -133,11 +133,11 @@ ComfyUI/ ## ワークフロー構造のメモ -両方の FastH3 ワークフローは、ベースの H3 構成と以下のノードを共有し、蒸留固有の設定が加わっています: +両方の FastH3 ワークフローは、ベースの H3 構成と以下のノードを共有しており、蒸留固有の設定が加わっています: -- **BlockSparseAttention**: Video Sparse Attention(VSA)を `keep_percent` 10、スケジュールの 20% から実行し、品質を保ちながら注意計算のコストを削減します -- **MiniMaxH3SigmaShift**: 蒸留スケジュールに合わせた H3 シグマシフト(動画 10、オーディオ 3)を適用します -- **ComfyMathExpression**: 長さの入力を、24fps の 17k+5 グリッド上の有効なフレーム `length` に変換します -- **サンプラー**: `res_multistep` サンプラー、`simple` スケジューラ、8 ステップ +- **BlockSparseAttention**: Video Sparse Attention(VSA)を `keep_percent` 10、スケジュールの 20% から実行し、品質を保ちながらアテンション計算のコストを削減します +- **MiniMaxH3SigmaShift**: 蒸留スケジュールに合わせた H3 シグマシフト(ビデオ 10、オーディオ 3)を適用します +- **ComfyMathExpression**: 再生時間の入力を、24fps の 17k+5 グリッド上の有効なフレーム `length` に変換します +- **サンプラー**: `res_multistep` サンプラーと `simple` スケジューラで 8 ステップ -FastH3 のウェイトには `to_gate_compress` ゲート層があり、VSA の粗いブランチはこれを読みます。ベース H3 のチェックポイントにはありません。比較するには **Model Sparse Attention** ノードの `method` を `sol-attn` にし、シードを固定します。`sol-attn` は対応ウェイトを必要とせず、任意の H3 チェックポイントで設定した `tau` のまま動作します。 +FastH3 のウェイトには `to_gate_compress` ゲート層があり、VSA は粗いブランチのためにこれを読みます。ベース H3 のチェックポイントにはありません。方法を比較するには、**Model Sparse Attention** ノードの `method` を `sol-attn` に設定し、同じシードを保ちます。`sol-attn` は対応するウェイトを必要とせず、設定した `tau` で任意の H3 チェックポイント上で動作します。 diff --git a/ja/tutorials/video/minimax/minimax-h3-prompt-guide.mdx b/ja/tutorials/video/minimax/minimax-h3-prompt-guide.mdx index d34f9acff9..cca3170a85 100644 --- a/ja/tutorials/video/minimax/minimax-h3-prompt-guide.mdx +++ b/ja/tutorials/video/minimax/minimax-h3-prompt-guide.mdx @@ -2,12 +2,12 @@ title: "ComfyUI MiniMax H3 プロンプトガイド: 公式ガイド、ヒント、プロンプト埋め込み" description: "ComfyUI でより良い MiniMax H3 プロンプトを書く方法: MiniMax の公式プロンプト作成ガイド、一般的なプロンプトのコツ、セリフと話者のルール、スタイル埋め込み。" sidebarTitle: "プロンプトガイド" -translationSourceHash: 0d858ae8 +translationSourceHash: 0f1ded35 translationFrom: tutorials/video/minimax/minimax-h3-prompt-guide.mdx translationBlockHashes: "_intro": da22cc9d "Official guides": 3d762c67 - "General tips": 91822299 + "General tips": fab4ad35 "Shots and cuts": 8184dae6 "Dialogue and speakers": 4985438e "Prompt embeddings": 9c899169 @@ -26,7 +26,7 @@ H3 は 1 つのマルチモーダルプロンプトにショット、カメラ ## 一般的なヒント -I2VA は先頭に固定の画像位置合わせ行、空行、本文フィールド。FL2VA/L2VA は各モードの位置合わせ行; T2VA はフィールドから直接: +I2VA は固定の画像位置合わせ行、空行、続いて本文フィールドで始まります。FL2VA/L2VA はそれぞれ独自の位置合わせ行を使用し、T2VA はフィールドから直接始まります: ```text integrated_multimodal_description: [Shot 1] ... @@ -34,19 +34,19 @@ overall_soundscape: ... non_diegetic_music: ... ``` -プロンプトは**英語**; 台詞/歌詞は ``; 画面文字は原文のまま。 +プロンプトは**英語**で記述します。台詞/歌詞は `` タグ内に、画面文字は元の言語のまま原文どおりに書きます。 -1. **シーン優先**: 全体のあと `integrated_multimodal_description` の `[Shot 1]` 内ショット -2. **1 ブロック**: ショット、カメラ、オーディオ -3. **解像度**: 16:9 ネイティブ **1344×768**; **32** 倍数 -4. **長さ**: `length` は 24fps フレーム(既定 **124** ≈ 5s)、**17k+5** にスナップ -5. **画面文字**: 英語二重引用符、原文(例 `A red neon sign reading "营业中"`); 台詞は `` -6. **R2V オーディオマーカー**: `fully_copy`、`partially_copy`、`reference`、`weak_reference`(公式 ref 表参照) -7. **オーディオフィールド**: `overall_soundscape` は環境/SFX/非言語(1–4 文; 真の無音のみ `N/A`)。台詞とダイジェティック音楽はショット内。`non_diegetic_music` はスコアのみ(1–3 文; 無ければ `N/A`) -8. **ネガティブなし**: `BasicGuider` は `cfg` 1 でネガティブ分岐なし。禁止リストは逆効果; 出すべきものを書くか R2V 保持フィールドを使用 -9. **参照シート(R2V)**: 1 画像に複数パネル; 独自の ``(`` 内だけに書かない)を付け、ショットでパネル指定(例: `` の正面全身) +1. **シーンを先に**: まず全体のシーンを書き、次に `integrated_multimodal_description` の `[Shot 1]` 内にタイミング付きのショットを書きます +2. **1 つのブロック**: ショット、カメラ、オーディオをまとめて記述します +3. **解像度**: 16:9 でネイティブ **1344×768**、**32** の倍数 +4. **長さ**: `length` は 24fps のフレーム数(既定 **124** ≈ 5 秒)で、**17k+5** にスナップされます +5. **画面文字**: 文字列ごとに英語の二重引用符で囲み、原文のまま記述します(例: `A red neon sign reading "营业中"`)。発話行は引用符ではなく `` を使用します +6. **R2V オーディオマーカー**: 保持分析では、クリップの使われ方に合わせて各オーディオ参照を `fully_copy`、`partially_copy`、`reference`、`weak_reference` のいずれかでマークします(公式リファレンスガイドの表を参照) +7. **オーディオフィールド**: `overall_soundscape` は環境音/SFX/非言語音(1〜4 文、本当に無音の場合のみ `N/A`)。台詞とダイジェティック音楽はショット内に残します。`non_diegetic_music` はスコアのみ(1〜3 文、ない場合は `N/A`)。不要な発話が現れる場合は、両方のフィールドを明示的に埋めてください +8. **ネガティブなし**: `BasicGuider` は `cfg` 1 で動作し、ネガティブ分岐がありません。禁止リストは不要な概念を追加してしまいます。表示したい内容を記述してください(または R2V の保持フィールド `fully_preserved`、`partially_preserved` などを使用します) +9. **参照シート(R2V)**: 1 枚の画像に複数のパネルを入れることができます。シート自体に専用の `` を付け(`` の中だけに書かない)、パネルを説明し、ショットからパネルを指定します(例: `` の正面全身)。パネルには明確なラベルを付けます -ワークフロー固有のタグは各ワークフローページへ。 +ワークフロー固有のタグとコントロールは、各ワークフローページに記載されています。 ## ショットとカット diff --git a/ko/development/api-development/sdks.mdx b/ko/development/api-development/sdks.mdx index 8beead1205..6c862ddb06 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 @@ -114,9 +114,9 @@ await job.getOutputs("9")[0].toFile("out.png"); |---|---|---| | **Comfy Cloud** | `https://cloud.comfy.org` (기본값) | 필수 | | **Comfy API 배포** | `https://.run.comfy.app` | 필수 | -| **자체 ComfyUI** | `http://127.0.0.1:8189` (로컬 프록시) | 기본적으로 없음. 선택적 정적 Bearer 토큰 | +| **자체 ComfyUI** | `http://127.0.0.1:8189` (로컬 프록시) | 기본적으로 없음. 선택적으로 정적 Bearer 토큰 사용 가능 | -기본 URL은 생성자 인자가 아닌 `COMFY_BASE_URL` 환경 변수에서 가져옵니다: +기본 URL은 생성자 인수가 아니라 `COMFY_BASE_URL` 환경 변수에서 가져옵니다: ```bash export COMFY_BASE_URL="https://.run.comfy.app" # Comfy API 배포 @@ -136,12 +136,12 @@ const client = new Comfy({ apiKey: "comfyui-..." }); - 초기 빌드에서 업그레이드하시나요? `Comfy("", "")`는 이제 `COMFY_BASE_URL`을 설정한 상태의 `Comfy(api_key="")`입니다. `api_key`는 키워드 전용이므로, 이전의 위치 기반 호출은 URL을 키로 조용히 읽어들이는 대신 `TypeError`를 발생시킵니다. + 초기 빌드에서 업그레이드하는 중인가요? `Comfy("", "")`는 이제 `COMFY_BASE_URL`을 설정한 상태의 `Comfy(api_key="")`입니다. `api_key`는 키워드 인수 전용이므로, 이전의 위치 인수 호출은 URL을 키로 조용히 읽어들이는 대신 `TypeError`를 발생시킵니다. ### Comfy Cloud -즉시 사용할 수 있습니다. [API 키](/ko/development/api-development/getting-an-api-key)를 생성하여 클라이언트에 전달하세요. +별도 설정 없이 바로 작동합니다. [API 키](/ko/development/api-development/getting-an-api-key)를 생성하여 클라이언트에 전달하세요. API 액세스에는 유료 Comfy Cloud 구독이 필요합니다. 무료 티어에는 포함되지 않습니다. 동시에 실행할 수 있는 작업 수는 티어에 따라 다릅니다. [동시성 제한](/ko/development/deploy/cloud-usage#동시성-제한)을 참조하세요. @@ -151,13 +151,13 @@ const client = new Comfy({ apiKey: "comfyui-..." }); ### Comfy API 배포 -[개발자 플랫폼](https://platform.comfy.org)을 통해 배포한 워크플로에는 자체 엔드포인트가 제공됩니다. `COMFY_BASE_URL`을 해당 엔드포인트로 지정하고 Comfy Cloud와 동일하게 API 키를 사용하세요. 이 가이드의 모든 내용이 동일하게 작동합니다. 단, [작업 레이블과 작업 목록](#작업에-레이블을-붙이고-나중에-찾기)은 Comfy Cloud에서 아직 지원되지 않습니다. +[개발자 플랫폼](https://platform.comfy.org)을 통해 배포한 워크플로에는 자체 엔드포인트가 생깁니다. `COMFY_BASE_URL`을 해당 엔드포인트로 지정하고 Comfy Cloud와 동일하게 API 키를 사용하세요. 이 가이드의 모든 내용이 동일하게 작동합니다. 단, [작업 레이블과 작업 목록](#작업에-레이블을-붙이고-나중에-찾기)은 Comfy Cloud에서 아직 지원하지 않습니다. Comfy API 배포는 Build에 포함된 모델과 커스텀 노드를 사용하여 여러 워크플로를 실행할 수 있습니다. 각 작업에 대해 `get_workflow()`는 `format: "api"`를 가지며 실행된 그래프를 `.graph` 속성에 담은 워크플로 응답을 반환합니다. ### 자체 ComfyUI -자체 호스팅 ComfyUI에서는 함께 실행되는 작은 오픈소스 서비스인 [comfy-api-proxy](https://github.com/Comfy-Org/comfy-api-proxy)가 v2 API를 제공합니다. 설치하고 실행한 다음 `COMFY_BASE_URL="http://127.0.0.1:8189"`를 설정하세요: +자체 호스팅 ComfyUI에서는 ComfyUI와 함께 실행되는 작은 오픈소스 서비스인 [comfy-api-proxy](https://github.com/Comfy-Org/comfy-api-proxy)가 v2 API를 제공합니다. 설치하고 실행한 다음 `COMFY_BASE_URL="http://127.0.0.1:8189"`를 설정하세요: ```bash pip install comfy-api-proxy @@ -165,7 +165,7 @@ comfy-api-proxy export COMFY_BASE_URL="http://127.0.0.1:8189" ``` -설정과 인증은 [자체 호스팅 ComfyUI용 API 프록시](/ko/development/comfyui-server/api-proxy)를 참고하세요. +설정 및 인증 세부 정보는 [자체 호스팅 ComfyUI용 API 프록시](/ko/development/comfyui-server/api-proxy)를 참고하세요. ## 제출 재시도: 멱등성 키 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 c1344131f1..326cc3a681 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: d97521f9 translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 @@ -13,9 +13,9 @@ translationBlockHashes: "Request bodies are capped": 675b77c8 "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 - "Router does not cover every partner operation": 97d31362 + "Comfy charges and usage": 7f5ccda7 + "Models without a pre-flight estimate": 495bdb2b + "Router does not cover every partner operation": 786c0fb2 "Model outputs and stored assets": 06c737c1 "Next": be85b789 --- @@ -102,9 +102,9 @@ Router는 최종 응답만 반환하며, 스트리밍되는 토큰, 서버 전 응답에는 공급자 사용량 또는 비용 필드가 포함될 수 있습니다. 이는 보편적인 Comfy 요금을 나타내지 않습니다. `X-Comfy-Credits-Used`는 선택 사항입니다. 헤더가 누락되었다는 것은 비용이 보고되지 않았음을 뜻할 뿐, 실행이 무료였다는 뜻은 아닙니다. 재생된 응답(`Idempotent-Replayed: true`)에는 다시 요금이 부과되지 않지만 원본 실행의 수치를 다시 기재할 수 있으므로, 하나의 `Idempotency-Key`에 대한 재시도 전체에 걸쳐 이 헤더를 합산해서는 안 됩니다. 잔액, 사용량, 청구서는 Comfy 플랫폼을 사용하세요. -카탈로그는 가격이 아니라 `billing.charges_on_policy_rejection`을 포함한 청구 관련 사실 정보를 제공합니다. `yes`, `no`, `unknown`을 명시적으로 처리하세요. 자세한 내용은 [billing](/ko/development/comfy-router/billing#모델-청구-정보)을 참조하세요. +카탈로그는 가격이 아니라 `billing.charges_on_policy_rejection`을 포함한 청구 관련 사실 정보를 제공합니다. `yes`, `no`, `unknown`을 명시적으로 처리하세요. 값이 `yes`이면 동기식 `content_policy_violation` 오류에 `X-Comfy-Credits-Used`가 포함될 수 있습니다. 공급자가 모델의 생성된 출력을 거부했고 Comfy가 그 거부된 생성에 대한 사용량을 기록한 경우에는 이 헤더가 포함되어 해당 수량을 담습니다. 입력 측 거부와 동일 키 재생에는 이 헤더가 포함되지 않으며, 헤더가 없는 거부는 보고되지 않은 것이지 무료인 것이 아닙니다. 자세한 내용은 [billing](/ko/development/comfy-router/billing#모델-청구-정보)을 참조하세요. -실행 전에 가격을 확인하려면 `POST /v2/models/{provider}/{model}/estimate`를 호출하거나, 대기 중인 제출의 `201` 응답에서 `estimate` 객체를 읽으세요. 추정 기능이 단계적으로 출시되는 동안 이 경로는 `error_type: not_enabled`와 함께 `403`을 반환하고, 제출 응답에서는 `estimate`가 생략됩니다. 각 추정치는 Comfy가 해당 실행에 청구하는 요율표를 기준으로 산정되지만, 그 수치는 추정치일 뿐 최종 청구 금액이 아니며, 워크스페이스의 사용량 및 청구 기록에 정산된 금액이 최종입니다. 이는 가격 고정도 아닙니다. 자체 공급자 키로 실행한 경우에는 `/estimate`가 그 실행의 수치를 반환하더라도 Comfy가 요금을 청구하지 않으며, `unknown` 추정치에는 수치가 없는데 이는 무료라는 뜻이 아닙니다. `X-Comfy-Credits-Used`는 실행에 대한 반올림된 사후 수치일 뿐 영수증이 아닙니다. `exact`, `estimated`, `unknown`을 읽는 방법은 [실행 전 비용 추정](/ko/development/comfy-router/reference#실행-전-비용-추정)을 참조하세요. 실행 전에 가격을 산정할 수 없는 모델은 [사전 추정치가 없는 모델](#사전-견적이-없는-모델)에 나열되어 있습니다. +실행 전에 가격을 확인하려면 `POST /v2/models/{provider}/{model}/estimate`를 호출하거나, 대기 중인 제출의 `201` 응답에서 `estimate` 객체를 읽으세요. 추정 기능이 단계적으로 출시되는 동안 이 경로는 `error_type: not_enabled`와 함께 `403`을 반환하고, 제출 응답에서는 `estimate`가 생략됩니다. 각 추정치는 Comfy가 해당 실행에 청구하는 요율표를 기준으로 산정되지만(공급업체가 보고하는 비용으로 청구되는 모델은 대신 공급업체의 공개 가격표를 기준으로 추정됩니다), 그 수치는 추정치일 뿐 최종 청구 금액이 아니며, 워크스페이스의 사용량 및 청구 기록에 정산된 금액이 최종입니다. 이는 가격 고정도 아닙니다. 자체 공급자 키로 실행한 경우에는 `/estimate`가 그 실행의 수치를 반환하더라도 Comfy가 요금을 청구하지 않으며, `unknown` 추정치에는 수치가 없는데 이는 무료라는 뜻이 아닙니다. `X-Comfy-Credits-Used`는 실행에 대한 반올림된 사후 수치일 뿐 영수증이 아닙니다. `exact`, `estimated`, `unknown`을 읽는 방법은 [실행 전 비용 추정](/ko/development/comfy-router/reference#실행-전-비용-추정)을 참조하세요. 실행 전에 가격을 산정할 수 없는 모델은 [실행 전 추정치가 없는 모델](#사전-견적이-없는-모델)에 나열되어 있습니다. ## 사전 견적이 없는 모델 @@ -114,36 +114,40 @@ Router는 아직 아래 모델에 대한 호출 비용을 실행 전에 안정 {/* BEGIN GENERATED: models without a pre-flight estimate. Do not hand-edit; regenerate with -update-quote-coverage-docs. */} -- **bfl**: `bfl/erase-v1`, `bfl/flux-2-max`, `bfl/flux-2-pro`, `bfl/flux-3-image`, `bfl/flux-3-video`, `bfl/flux-kontext-max`, `bfl/flux-kontext-pro`, `bfl/flux-pro-1.0-expand`, `bfl/flux-pro-1.0-fill`, `bfl/flux-pro-1.1`, `bfl/flux-pro-1.1-ultra`, `bfl/video-edit-v1`, `bfl/video-upscale-v1`, `bfl/vto-v1` +- **bfl**: `bfl/erase-v1`, `bfl/video-edit-v1`, `bfl/video-upscale-v1`, `bfl/vto-v1` - **byteplus**: `byteplus/seed-audio-1.0`, `byteplus/seed-audio-1.0-multilingual` -- **elevenlabs**: `elevenlabs/eleven_sfx_v2` - **fal**: `fal/crystal-upscaler`, `fal/crystal-video-upscaler`, `fal/fal-gpt-image-2`, `fal/fal-gpt-image-2.5-flare`, `fal/fal-gpt-image-2.5-sunburst`, `fal/fal-nano-banana-2`, `fal/fal-nano-banana-pro`, `fal/fal-seedance-2.0`, `fal/fal-seedance-2.5`, `fal/flux-3-max`, `fal/patina` - **freepik**: `freepik/ai-image-upscaler-precision-v2`, `freepik/ai-skin-enhancer-creative`, `freepik/ai-skin-enhancer-faithful`, `freepik/ai-skin-enhancer-flexible` - **heygen**: `heygen/starfish` - **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` +- **luma**: `luma/photon-1`, `luma/photon-flash-1` - **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` +- **openai**: `openai/gpt-image-1.5` - **openrouter**: `openrouter/chat-completions` - **pika**: `pika/pika-gpt-image-2`, `pika/pika-nano-banana-2`, `pika/pika-nano-banana-pro` -- **recraft**: `recraft/recraftv2`, `recraft/recraftv3`, `recraft/recraftv4`, `recraft/recraftv4_1`, `recraft/recraftv4_1_pro`, `recraft/recraftv4_1_pro_vector`, `recraft/recraftv4_1_utility`, `recraft/recraftv4_1_utility_pro`, `recraft/recraftv4_1_utility_pro_vector`, `recraft/recraftv4_1_utility_vector`, `recraft/recraftv4_1_vector`, `recraft/recraftv4_pro`, `recraft/recraftv4_styles`, `recraft/recraftv4_styles_pro`, `recraft/recraftv4_styles_pro_vector`, `recraft/recraftv4_styles_vector` - **runware**: `runware/runware-gpt-image-2`, `runware/runware-gpt-image-2.5-flare`, `runware/runware-gpt-image-2.5-sunburst`, `runware/runware-nano-banana-2`, `runware/runware-nano-banana-pro`, `runware/runware-seedance-2.0`, `runware/runware-seedance-2.5` -- **runway**: `runway/gen4_image` - **synclabs**: `synclabs/sync-3` - **veed**: `veed/clean-audio`, `veed/clean-audio-video`, `veed/fabric-1.0`, `veed/lipsync-2.0`, `veed/video-background-removal`, `veed/video-background-removal-fast`, `veed/video-background-removal-green-screen` -- **wavespeed**: `wavespeed/flashvsr`, `wavespeed/seedvr2`, `wavespeed/ultimate-image-upscaler`, `wavespeed/wavespeed-gpt-image-2`, `wavespeed/wavespeed-gpt-image-2.5-flare`, `wavespeed/wavespeed-gpt-image-2.5-sunburst` -- **xai**: `xai/grok-imagine-image`, `xai/grok-imagine-image-2.0`, `xai/grok-imagine-image-pro`, `xai/grok-imagine-image-quality`, `xai/grok-imagine-video`, `xai/grok-imagine-video-1.5`, `xai/grok-imagine-video-1.5-lite`, `xai/grok-imagine-video-1.5-preview` +- **wavespeed**: `wavespeed/wavespeed-gpt-image-2`, `wavespeed/wavespeed-gpt-image-2.5-flare`, `wavespeed/wavespeed-gpt-image-2.5-sunburst` {/* END GENERATED: models without a pre-flight estimate */} +`openai/gpt-image-2`, `openai/gpt-image-2.5-flare`, `openai/gpt-image-2.5-sunburst`에 대한 편집 호출 역시 사전 견적이 없습니다. 이 모델 중 하나에 대한 편집 호출이나 입력 이미지를 함께 전달하는 생성 호출은 `source: unknown`으로 응답합니다. 이 모델들에 대한 텍스트 전용 생성 호출은 견적이 산정되므로 위 목록에 포함되지 않았습니다. + ## Router는 모든 파트너 작업을 다루지 않습니다 Router는 모델을 실행합니다. 파일 업로드, 계정 읽기, 에셋 관리, 스트리밍, 공급자 작업 제어에는 Router 외부에 있고 그 계약에서 설명되지 않는 `/proxy/…` 아래의 파트너 프록시 라우트가 필요할 수 있습니다. Router 자체의 표면은 [Comfy Router 명세](/router-openapi.yaml)입니다. 지원 여부는 공급자마다 다릅니다. -### Krea 3 참조 이미지는 먼저 업로드해야 합니다 +### Krea 3 참조 이미지: 먼저 업로드하거나 공개 https URL 사용 + +`krea/krea-3`의 `image_urls`에서 `POST /proxy/krea/assets`가 반환한 `image_url`(`https://app-uploads.krea.ai/...` URL)은 항상 허용됩니다. 다른 링크의 허용 여부는 환경에 따라 다릅니다. api.comfy.org에서는 현재 허용됩니다. + +- **다른 링크가 허용되는 환경에서는** 모든 공개 `https` 이미지 URL이 작동합니다. Router는 모델이 실행되기 전에 각 이미지의 크기를 읽습니다. 호스트에 공개적으로 접근할 수 없거나 호스트가 존재하지 않는 링크, `408` 또는 `429`가 아닌 `4xx`로 응답하는 링크, 이미지가 아닌 링크는 해당 호스트를 명시하며 `400` `invalid_input`으로 거부됩니다. 일시적인 DNS, TLS 또는 연결 실패, 시간 초과, 오리진의 `408` 또는 `429`는 `502` 오류로 실패합니다. 실제 업로드가 아닌 `app-uploads.krea.ai` 링크는 다른 접근 불가 참조와 마찬가지로 `400`으로 거부됩니다. 서버가 시작된 직후, 어떤 규칙이 적용되는지 아직 파악하지 못한 상태에서는 `app-uploads.krea.ai` 링크가 아닌 공개 `https` URL이 `503`으로 실패할 수 있으며, 이 경우 재시도해도 안전합니다. +- **다른 링크가 허용되지 않는 환경에서는** 모든 항목이 업로드의 `image_url`이어야 합니다. Router는 링크가 호스트가 정확히 `app-uploads.krea.ai`인 `https` URL로 파싱되는지만 확인합니다(다른 호스트도, 명시적 포트도 허용되지 않음). 직접 호스팅한 공개 `https` URL을 포함해 그 밖의 링크는 모델이 실행되기 전에 `400` `invalid_input`으로 거부됩니다. 이 검사를 통과했지만 실제 업로드가 아닌 링크(만료됨, 삭제됨 또는 잘못 입력됨)는 여전히 통과하며, 그러면 Router가 이미지 크기를 읽지 못해 `400`이 아닌 `5xx` 오류로 응답합니다. -`krea/krea-3`는 임의의 이미지 링크를 허용하지 않습니다. `image_urls`의 모든 항목은 `POST /proxy/krea/assets`가 반환한 `image_url`이어야 하며, 이는 `https://app-uploads.krea.ai/...` URL입니다. Router는 링크가 호스트가 정확히 `app-uploads.krea.ai`인 `https` URL로 파싱되는지만 확인합니다(다른 호스트도, 명시적 포트도 허용되지 않음). 직접 호스팅한 공개 `https` URL을 포함해 그 밖의 링크는 모델이 실행되기 전에 `400` `invalid_input`으로 거부됩니다. 이 검사를 통과했지만 실제 업로드가 아닌 링크(만료됨, 삭제됨 또는 잘못 입력됨)는 여전히 통과하며, 그러면 Router가 이미지 크기를 읽지 못해 `400`이 아닌 `5xx` 오류로 응답합니다. 따라서 항상 업로드가 반환한 그대로의 `image_url`을 전달하세요. +업로드는 모든 환경에서 작동하므로 이식 가능한 선택입니다. 항상 업로드가 반환한 그대로의 `image_url`을 전달하세요. 1. 각 참조 이미지를 `multipart/form-data`로 업로드하고, 이미지는 폼 필드 `file`에 담습니다(JPEG, PNG 또는 WebP, 최대 75 MB). Router와 동일한 방식으로 `X-API-Key` 또는 `Authorization: Bearer`를 사용해 인증합니다. diff --git a/ko/development/comfy-router/litellm.mdx b/ko/development/comfy-router/litellm.mdx index 1849017000..94fd42667a 100644 --- a/ko/development/comfy-router/litellm.mdx +++ b/ko/development/comfy-router/litellm.mdx @@ -2,12 +2,12 @@ title: "LiteLLM과 함께 Comfy Router 사용하기" sidebarTitle: "LiteLLM" description: "Comfy Router를 패스스루 엔드포인트로 LiteLLM Proxy 뒤에 두고, x-litellm-response-cost 헤더에서 각 실행의 정확한 USD 비용을 기록합니다. 유지 관리할 가격표가 필요 없습니다." -translationSourceHash: e35cd883 +translationSourceHash: 8183ff58 translationFrom: development/comfy-router/litellm.mdx translationBlockHashes: "_intro": 1ddb0d0a "Configure the pass-through": 380c3ae3 - "How spend is recorded": f852c18c + "How spend is recorded": 699ed64b "Queued delivery": 46044c93 "Notes": 50e3cf6b --- @@ -102,11 +102,11 @@ X-Litellm-Total-Tokens: 0 - Comfy 크레딧이 아니라 자신의 공급자 키로 청구되는 실행 - 아직 Router의 실행별 크레딧 가격을 보고하는 모델 목록에 없는 모델. 이 목록은 보수적이며, 일부 공급자는 아예 포함되지 않습니다 - Comfy 청구에 도달하지 못한 청구 -- 오류 응답 +- 오류 응답. `billing.charges_on_policy_rejection`이 `yes`인 모델에서 동기 `content_policy_violation`이 발생하면 거부된 생성의 가격과 함께 `X-Comfy-Credits-Used`가 포함될 수 있지만, `x-litellm-response-cost`는 절대 포함되지 않습니다. 오류는 LiteLLM이 기록해야 할 결과가 아니기 때문입니다 또한 Router가 동일한 `Idempotency-Key`(프록시를 통해 `x-pass-Idempotency-Key`로 전송됨)로 재시도할 때 저장된 결과를 재생하는 경우에도 존재하지 않습니다. 해당 재시도에는 다시 요금이 부과되지 않으므로, 재생은 실행의 정확한 비용을 두 번째로 보고하지 않습니다. 같은 이유로, 대기 중인 실행의 결과 수집 중에서는 실행 가격이 기록된 이후의 첫 번째 수집만 이 헤더를 포함합니다. 동일한 결과를 다시 수집해도 여전히 `X-Comfy-Credits-Used`는 반환되지만 `x-litellm-response-cost`는 반환되지 않습니다. -헤더가 없으면 LiteLLM은 엔드포인트의 `cost_per_request`로 대체합니다. 이는 위의 모든 경우에 적용됩니다. 따라서 오류 응답, 자신의 공급자 키로 청구되는 실행, 멱등 재생은 Comfy가 해당 실행에 크레딧을 청구하지 않았음에도 여러분의 추정치로 기록됩니다. 비용을 보고하지 않는 실행이 지출 보고서에서 무료로 보이지 않도록 이 값을 `0` 대신 일반적인 실행에 대한 합리적인 추정치로 설정하고, 해당 행들이 LiteLLM의 합계를 Comfy 청구서보다 높게 밀어 올릴 수 있음을 예상하세요. 가격이 책정되었지만 실제로 비용이 전혀 발생하지 않은 실행은 `x-litellm-response-cost: 0`을 보고하며, LiteLLM은 이를 0으로 기록합니다. +헤더가 없으면 LiteLLM은 엔드포인트의 `cost_per_request`로 대체합니다. 이는 위의 모든 경우에 적용됩니다. 따라서 오류 응답, 자신의 공급자 키로 청구되는 실행, 멱등 재생은 여러분의 추정치로 기록됩니다. 그중 대부분은 여러분의 크레딧으로 청구되지 않았지만 전부는 아닙니다. `X-Comfy-Credits-Used`가 포함된 콘텐츠 정책 거부는 가격이 책정된 것이므로 해당 헤더에서 비용을 읽어야 하며, Router가 여러분에게 돌려주지 못한 생성과 같은 몇몇 다른 실패는 비용을 보고하지 않은 채로 청구될 수 있습니다. 워크스페이스의 사용 기록과 대조해 확인하세요. 비용을 보고하지 않는 실행이 지출 보고서에서 무료로 보이지 않도록 이 값을 `0` 대신 일반적인 실행에 대한 합리적인 추정치로 설정하고, 해당 행들이 LiteLLM의 합계를 Comfy 청구서보다 높게 밀어 올릴 수 있음을 예상하세요. 가격이 책정되었지만 실제로 비용이 전혀 발생하지 않은 실행은 `x-litellm-response-cost: 0`을 보고하며, LiteLLM은 이를 0으로 기록합니다. ## 대기 중 전달 diff --git a/ko/development/comfy-router/models.mdx b/ko/development/comfy-router/models.mdx index 472b20d1f4..e8cfee24ce 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: 3c934831 translationFrom: development/comfy-router/models.mdx translationBlockHashes: "_intro": 2584e428 - "Find by output": 380e121d + "Find by output": 9b1b4039 "Anthropic": de8acc20 "Beeble": b52ea340 "Black Forest Labs": 2934e3eb @@ -23,12 +23,12 @@ translationBlockHashes: "Kling": 3002befa "Krea": 16b83e5e "LTX": 32595bf9 - "Luma": 37a12a19 + "Luma": 8cd2a7ce "Luma 2": 585eb637 - "Meshy": 9292a0a8 + "Meshy": 67e26a17 "MiniMax": 87560ab7 "Moonvalley": 9e63fb77 - "OpenAI": c5c4af80 + "OpenAI": a5c1e692 "Openrouter": a4f6806b "Pika": f2b1d797 "Pruna": 903d76ee @@ -53,7 +53,7 @@ translationBlockHashes: ## 출력으로 찾기 - + - [SwitchX](/ko/development/comfy-router/models/beeble/switchx/code): `beeble/switchx` - [FLUX 3 Video](/ko/development/comfy-router/models/black-forest-labs/flux-3-video/code): `bfl/flux-3-video` @@ -89,8 +89,6 @@ translationBlockHashes: - [LTX 2.5 Fast](/ko/development/comfy-router/models/ltx/ltx-2-5-fast/code): `ltx/ltx-2-5-fast` - [LTX 2.5 Pro](/ko/development/comfy-router/models/ltx/ltx-2-5-pro/code): `ltx/ltx-2-5-pro` - [Ray 3.2](/ko/development/comfy-router/models/luma_2/ray-3-2/code): `luma_2/ray-3.2` -- [Ray 2](/ko/development/comfy-router/models/luma/ray-2/code): `luma/ray-2` -- [Ray Flash 2](/ko/development/comfy-router/models/luma/ray-flash-2/code): `luma/ray-flash-2` - [MiniMax H3](/ko/development/comfy-router/models/minimax/minimax-h3/code): `minimax/minimax-h3` - [Image To Video](/ko/development/comfy-router/models/moonvalley/image-to-video/code): `moonvalley/image-to-video` - [Text To Video](/ko/development/comfy-router/models/moonvalley/text-to-video/code): `moonvalley/text-to-video` @@ -106,8 +104,7 @@ translationBlockHashes: - [Lipsync 2.0](/ko/development/comfy-router/models/veed/lipsync-2-0/code): `veed/lipsync-2.0` - [Video Background Removal Fast](/ko/development/comfy-router/models/veed/video-background-removal-fast/code): `veed/video-background-removal-fast` - [Video Background Removal Green Screen](/ko/development/comfy-router/models/veed/video-background-removal-green-screen/code): `veed/video-background-removal-green-screen` -- [Video Background Removal](/ko/development/comfy-router/models/veed/video-background-removal/code): `veed/video-background-removal` -- [Veo 3.1 Fast Generate 001](/ko/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code): `veo/veo-3.1-fast-generate-001` +- [Video Background Removal](/ko/development/comfy-router/models/veed/video-background-removal/code): `veed/video-background-removal`- [Veo 3.1 Fast Generate 001](/ko/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code): `veo/veo-3.1-fast-generate-001` - [Veo 3.1 Generate 001](/ko/development/comfy-router/models/veo/veo-3-1-generate-001/code): `veo/veo-3.1-generate-001` - [Veo 3.1 Lite Generate 001](/ko/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code): `veo/veo-3.1-lite-generate-001` - [HappyHorse 1.0 I2V](/ko/development/comfy-router/models/wan/happyhorse-1-0-i2v/code): `wan/happyhorse-1.0-i2v` @@ -135,7 +132,7 @@ translationBlockHashes: - [Grok Imagine Video](/ko/development/comfy-router/models/xai/grok-imagine-video/code): `xai/grok-imagine-video` - + - [SwitchX](/ko/development/comfy-router/models/beeble/switchx/code): `beeble/switchx` - [Erase V1](/ko/development/comfy-router/models/black-forest-labs/erase-v1/code): `bfl/erase-v1` @@ -160,9 +157,7 @@ translationBlockHashes: - [Image Edit Relight](/ko/development/comfy-router/models/bria/image-edit-relight/code): `bria/image-edit-relight` - [Image Edit Remove Background Guided](/ko/development/comfy-router/models/bria/image-edit-remove-background-guided/code): `bria/image-edit-remove-background-guided` - [Image Edit Remove Background](/ko/development/comfy-router/models/bria/image-edit-remove-background/code): `bria/image-edit-remove-background` -- [Image Edit Replace Background](/ko/development/comfy-router/models/bria/image-edit-replace-background/code): `bria/image-edit-replace-background` -- [Image Edit Replace Object By Text](/ko/development/comfy-router/models/bria/image-edit-replace-object-by-text/code): `bria/image-edit-replace-object-by-text` -- [Image Edit Reseason](/ko/development/comfy-router/models/bria/image-edit-reseason/code): `bria/image-edit-reseason` +- [Image Edit Replace Background](/ko/development/comfy-router/models/bria/image-edit-replace-background/code): `bria/image-edit-replace-background`- [Image Edit Reseason](/ko/development/comfy-router/models/bria/image-edit-reseason/code): `bria/image-edit-reseason` - [Image Edit Restore](/ko/development/comfy-router/models/bria/image-edit-restore/code): `bria/image-edit-restore` - [Image](/ko/development/comfy-router/models/bria/image/code): `bria/image` - [Seedream 4.0 250828](/ko/development/comfy-router/models/byteplus/seedream-4-0-250828/code): `byteplus/seedream-4-0-250828` @@ -198,7 +193,6 @@ translationBlockHashes: - [Photon 1](/ko/development/comfy-router/models/luma/photon-1/code): `luma/photon-1` - [Photon Flash 1](/ko/development/comfy-router/models/luma/photon-flash-1/code): `luma/photon-flash-1` - [GPT Image 1.5](/ko/development/comfy-router/models/openai/gpt-image-1-5/code): `openai/gpt-image-1.5` -- [GPT Image 1](/ko/development/comfy-router/models/openai/gpt-image-1/code): `openai/gpt-image-1` - [GPT Image 2.5 Flare](/ko/development/comfy-router/models/openai/gpt-image-2-5-flare/code): `openai/gpt-image-2.5-flare` - [GPT Image 2.5 Sunburst](/ko/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code): `openai/gpt-image-2.5-sunburst` - [GPT Image 2](/ko/development/comfy-router/models/openai/gpt-image-2/code): `openai/gpt-image-2` @@ -214,8 +208,7 @@ translationBlockHashes: - [Recraft V4.1 Utility](/ko/development/comfy-router/models/recraft/recraftv4-1-utility/code): `recraft/recraftv4_1_utility` - [Recraft V4.1 Vector](/ko/development/comfy-router/models/recraft/recraftv4-1-vector/code): `recraft/recraftv4_1_vector` - [Recraft V4.1](/ko/development/comfy-router/models/recraft/recraftv4-1/code): `recraft/recraftv4_1` -- [Recraft V4 Pro](/ko/development/comfy-router/models/recraft/recraftv4-pro/code): `recraft/recraftv4_pro` -- [Recraft V4 Styles Pro Vector](/ko/development/comfy-router/models/recraft/recraftv4-styles-pro-vector/code): `recraft/recraftv4_styles_pro_vector` +- [Recraft V4 Pro](/ko/development/comfy-router/models/recraft/recraftv4-pro/code): `recraft/recraftv4_pro`- [Recraft V4 Styles Pro Vector](/ko/development/comfy-router/models/recraft/recraftv4-styles-pro-vector/code): `recraft/recraftv4_styles_pro_vector` - [Recraft V4 Styles Pro](/ko/development/comfy-router/models/recraft/recraftv4-styles-pro/code): `recraft/recraftv4_styles_pro` - [Recraft V4 Styles Vector](/ko/development/comfy-router/models/recraft/recraftv4-styles-vector/code): `recraft/recraftv4_styles_vector` - [Recraft V4 Styles](/ko/development/comfy-router/models/recraft/recraftv4-styles/code): `recraft/recraftv4_styles` @@ -269,14 +262,13 @@ translationBlockHashes: - [Wan 2.5 T2V Preview](/ko/development/comfy-router/models/wan/wan2-5-t2v-preview/code): `wan/wan2.5-t2v-preview` - [Wan 2.6 I2V](/ko/development/comfy-router/models/wan/wan2-6-i2v/code): `wan/wan2.6-i2v` - [Wan 2.6 R2V](/ko/development/comfy-router/models/wan/wan2-6-r2v/code): `wan/wan2.6-r2v` -- [Wan 2.6 T2V](/ko/development/comfy-router/models/wan/wan2-6-t2v/code): `wan/wan2.6-t2v` -- [Wan 2.7 I2V](/ko/development/comfy-router/models/wan/wan2-7-i2v/code): `wan/wan2.7-i2v` +- [Wan 2.6 T2V](/ko/development/comfy-router/models/wan/wan2-6-t2v/code): `wan/wan2.6-t2v`- [Wan 2.7 I2V](/ko/development/comfy-router/models/wan/wan2-7-i2v/code): `wan/wan2.7-i2v` - [Wan 2.7 T2V](/ko/development/comfy-router/models/wan/wan2-7-t2v/code): `wan/wan2.7-t2v` - [Wan 3.0 Video Prime](/ko/development/comfy-router/models/wan/wan3-0-video-prime/code): `wan/wan3.0-video-prime` - [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 6](/ko/development/comfy-router/models/meshy/meshy-6/code): `meshy/meshy-6` @@ -290,7 +282,7 @@ translationBlockHashes: - [Hunyuan 3D Uv](/ko/development/comfy-router/models/tencent/hunyuan-3d-uv/code): `tencent/hunyuan-3d-uv` - + - [Claude Fable 5.1](/ko/development/comfy-router/models/anthropic/claude-fable-5-1/code): `anthropic/claude-fable-5-1` - [Claude Fable 5](/ko/development/comfy-router/models/anthropic/claude-fable-5/code): `anthropic/claude-fable-5` @@ -319,7 +311,6 @@ translationBlockHashes: - [Nano Banana 2](/ko/development/comfy-router/models/google/nano-banana-2/code): `vertexai/gemini-3.1-flash-image` - [Nano Banana Pro](/ko/development/comfy-router/models/google/nano-banana-pro/code): `vertexai/gemini-3-pro-image` - [GPT 4.1 Mini](/ko/development/comfy-router/models/openai/gpt-4-1-mini/code): `openai/gpt-4.1-mini` -- [GPT 4.1 Nano](/ko/development/comfy-router/models/openai/gpt-4-1-nano/code): `openai/gpt-4.1-nano` - [GPT 4.1](/ko/development/comfy-router/models/openai/gpt-4-1/code): `openai/gpt-4.1` - [GPT 4o](/ko/development/comfy-router/models/openai/gpt-4o/code): `openai/gpt-4o` - [GPT 5.5 Pro](/ko/development/comfy-router/models/openai/gpt-5-5-pro/code): `openai/gpt-5.5-pro` @@ -332,11 +323,7 @@ translationBlockHashes: - [GPT 5](/ko/development/comfy-router/models/openai/gpt-5/code): `openai/gpt-5` - [GPT 6 Astra](/ko/development/comfy-router/models/openai/gpt-6-astra/code): `openai/gpt-6-astra` - [GPT 6 Luna](/ko/development/comfy-router/models/openai/gpt-6-luna/code): `openai/gpt-6-luna` -- [GPT 6 Sol](/ko/development/comfy-router/models/openai/gpt-6-sol/code): `openai/gpt-6-sol` -- [o1-pro](/ko/development/comfy-router/models/openai/o1-pro/code): `openai/o1-pro` -- [o1](/ko/development/comfy-router/models/openai/o1/code): `openai/o1` -- [o3](/ko/development/comfy-router/models/openai/o3/code): `openai/o3` -- [o4-mini](/ko/development/comfy-router/models/openai/o4-mini/code): `openai/o4-mini` +- [GPT 6 Sol](/ko/development/comfy-router/models/openai/gpt-6-sol/code): `openai/gpt-6-sol`- [o3](/ko/development/comfy-router/models/openai/o3/code): `openai/o3` - [Chat Completions](/ko/development/comfy-router/models/openrouter/chat-completions/code): `openrouter/chat-completions` @@ -543,8 +530,6 @@ translationBlockHashes: | --- | --- | --- | --- | | [Photon 1](/ko/development/comfy-router/models/luma/photon-1/code) | `luma/photon-1` | 텍스트 | 이미지 | | [Photon Flash 1](/ko/development/comfy-router/models/luma/photon-flash-1/code) | `luma/photon-flash-1` | 텍스트 | 이미지 | -| [Ray 2](/ko/development/comfy-router/models/luma/ray-2/code) | `luma/ray-2` | 텍스트, 이미지 | 비디오 | -| [Ray Flash 2](/ko/development/comfy-router/models/luma/ray-flash-2/code) | `luma/ray-flash-2` | 텍스트, 이미지 | 비디오 | ## Luma 2 @@ -584,7 +569,6 @@ translationBlockHashes: | 모델 | ID | 입력 | 출력 | | --- | --- | --- | --- | | [GPT 4.1 Mini](/ko/development/comfy-router/models/openai/gpt-4-1-mini/code) | `openai/gpt-4.1-mini` | 텍스트, 이미지 | 텍스트 | -| [GPT 4.1 Nano](/ko/development/comfy-router/models/openai/gpt-4-1-nano/code) | `openai/gpt-4.1-nano` | 텍스트, 이미지 | 텍스트 | | [GPT 4.1](/ko/development/comfy-router/models/openai/gpt-4-1/code) | `openai/gpt-4.1` | 텍스트, 이미지 | 텍스트 | | [GPT 4o](/ko/development/comfy-router/models/openai/gpt-4o/code) | `openai/gpt-4o` | 텍스트, 이미지 | 텍스트 | | [GPT 5.5 Pro](/ko/development/comfy-router/models/openai/gpt-5-5-pro/code) | `openai/gpt-5.5-pro` | 텍스트, 이미지 | 텍스트 | @@ -599,14 +583,10 @@ translationBlockHashes: | [GPT 6 Luna](/ko/development/comfy-router/models/openai/gpt-6-luna/code) | `openai/gpt-6-luna` | 텍스트, 이미지 | 텍스트 | | [GPT 6 Sol](/ko/development/comfy-router/models/openai/gpt-6-sol/code) | `openai/gpt-6-sol` | 텍스트, 이미지 | 텍스트 | | [GPT Image 1.5](/ko/development/comfy-router/models/openai/gpt-image-1-5/code) | `openai/gpt-image-1.5` | 텍스트, 이미지 | 이미지 | -| [GPT Image 1](/ko/development/comfy-router/models/openai/gpt-image-1/code) | `openai/gpt-image-1` | 텍스트, 이미지 | 이미지 | | [GPT Image 2.5 Flare](/ko/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | `openai/gpt-image-2.5-flare` | 텍스트, 이미지 | 이미지 | | [GPT Image 2.5 Sunburst](/ko/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | `openai/gpt-image-2.5-sunburst` | 텍스트, 이미지 | 이미지 | | [GPT Image 2](/ko/development/comfy-router/models/openai/gpt-image-2/code) | `openai/gpt-image-2` | 텍스트, 이미지 | 이미지 | -| [o1-pro](/ko/development/comfy-router/models/openai/o1-pro/code) | `openai/o1-pro` | 텍스트, 이미지 | 텍스트 | -| [o1](/ko/development/comfy-router/models/openai/o1/code) | `openai/o1` | 텍스트, 이미지 | 텍스트 | | [o3](/ko/development/comfy-router/models/openai/o3/code) | `openai/o3` | 텍스트, 이미지 | 텍스트 | -| [o4-mini](/ko/development/comfy-router/models/openai/o4-mini/code) | `openai/o4-mini` | 텍스트, 이미지 | 텍스트 | ## Openrouter diff --git a/ko/development/comfy-router/models/black-forest-labs/flux-video-upscale/code.mdx b/ko/development/comfy-router/models/black-forest-labs/flux-video-upscale/code.mdx index 6e7238a789..3febd1ac13 100644 --- a/ko/development/comfy-router/models/black-forest-labs/flux-video-upscale/code.mdx +++ b/ko/development/comfy-router/models/black-forest-labs/flux-video-upscale/code.mdx @@ -2,16 +2,17 @@ title: "Comfy Router로 FLUX Video Upscale 사용하기" description: "Comfy Router를 통해 HTTP로 FLUX Video Upscale을 사용해 비디오를 업스케일링하는 Python, TypeScript, cURL 스니펫과 요청 필드 및 결과 형태" sidebarTitle: "FLUX Video Upscale" -translationSourceHash: 0b09f0ee +translationSourceHash: 37a8dde1 translationFrom: development/comfy-router/models/black-forest-labs/flux-video-upscale/code.mdx translationBlockHashes: "_intro": cf804f5f "Quick start": b745a238 - "Schema": 4675f835 + "Schema": c0dca73f "Examples": d1ffa3d6 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -170,7 +171,7 @@ curl https://api.comfy.org/v2/models/bfl/video-upscale-v1/requests/$REQUEST_ID \ - 업스케일할 비디오로, HTTP(S) URL 또는 base64로 인코딩된 MP4입니다. 소스 영상은 최대 20초, 50MB까지입니다. + 업스케일할 비디오로, HTTP(S) URL 또는 base64로 인코딩된 MP4입니다. 소스 영상은 최대 20초, 50MB, 프레임당 2560x1440(3.7메가픽셀)까지입니다. 소스가 이보다 크면 제출하기 전에 축소하세요. @@ -184,7 +185,7 @@ curl https://api.comfy.org/v2/models/bfl/video-upscale-v1/requests/$REQUEST_ID \ - 소스 해상도 대비 출력 배율입니다. 출력은 소스의 가로세로 비율을 유지하며 프레임당 약 14.4메가픽셀로 제한되므로, 소스가 매우 큰 경우에는 요청한 배율보다 작게 확대됩니다. + 소스 해상도 대비 출력 배율입니다. 출력은 소스의 가로세로 비율을 유지하며 프레임당 약 14.4메가픽셀로 제한되므로, 소스가 매우 큰 경우에는 요청한 배율보다 작게 확대됩니다. 해상도를 지정하는 옵션은 없습니다. 2K(2560x1440) 또는 4K(3840x2160)를 목표로 하려면 목표 높이를 소스 높이로 나누세요. 720p 소스는 배율 2에서 2K, 배율 3에서 4K에 도달합니다. 1080p 소스는 배율 2에서 4K에 도달하지만 2K에는 도달할 수 없으며, 2K에는 1.33이 필요합니다. 범위: `1.5`부터 `3`까지 @@ -234,7 +235,7 @@ Router가 `GET /v2/models/bfl/video-upscale-v1/openapi.json`에서 제공하는 - 공급자가 보고한 생성 재생 시간(초)입니다. + 공급자가 보고한 생성 소요 시간(초)입니다. 형식: `double` 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..4ebc20234c 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,17 +2,18 @@ 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 --- + {/* 생성된 파일입니다. `pnpm code-pages:gen`으로 router-schemas/bria/image-edit-relight.json에서 생성되었습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -160,7 +161,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/byteplus/dreamina-seedance-2-0-260128/code.mdx b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx index 1a406b5c67..286aea484b 100644 --- a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx +++ b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx @@ -2,19 +2,17 @@ title: "Comfy Router로 Dreamina Seedance 2.0 260128 사용하기" description: "Comfy Router를 통해 byteplus/dreamina-seedance-2-0-260128을 호출합니다. endpoint, 요청 형태, 그리고 Router가 반환하는 응답을 다룹니다." sidebarTitle: "Dreamina Seedance 2.0 260128" -translationSourceHash: 98890ddf +translationSourceHash: 9604ca27 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx translationBlockHashes: "_intro": 54eac94b "Quick start": ca074ca5 "Serving providers": 74eb2a7c - "Schema": 5c27d10f + "Schema": 6c5da06a "Examples": 641c458b --- - - {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-0-260128.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -196,29 +194,29 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128/reque ### 입력 - 이 생성 작업 결과에 대한 콜백 알림 주소 + 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 절대 전송되지 않습니다. 대신 작업 상태 라우트를 폴링하여 결과를 확인하세요. 형식: `uri` - 모델이 비디오를 생성하기 위한 입력 콘텐츠 + 모델이 비디오를 생성하기 위한 입력 콘텐츠입니다. - 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오 전용 입력을 지원합니다. + 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오만으로 된 입력을 지원합니다. - 오디오 URL, Base64 인코딩 또는 에셋 ID. -오디오 URL: 오디오의 공개 URL (wav, mp3). -Base64: 형식 data:audio/\;base64,\ -에셋 ID: 형식 asset://\ + 오디오 URL, Base64 인코딩 또는 에셋 ID입니다. +오디오 URL: 오디오의 공개 URL(wav, mp3)입니다. +Base64: 형식은 data:audio/\;base64,\입니다 +에셋 ID: 형식은 asset://\입니다 Seedance 2.5 전용입니다. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. -최종 비디오는 Draft 작업의 prompt, 입력 에셋, duration, ratio, seed, generate_audio 및 omni_reference_task_type을 재사용하므로 이를 다시 전송하지 마세요. resolution은 기본값이 1080p이며 1080p만 지원합니다. +최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 전송하지 마세요. 해상도는 기본값이 1080p이며 1080p만 지원합니다. @@ -230,27 +228,27 @@ Base64: 형식 data:audio/\;base64,\ - 이미지 기반 비디오 생성을 위한 이미지 콘텐츠 (type이 "image_url"인 경우) + 이미지 기반 비디오 생성을 위한 이미지 콘텐츠입니다(type이 "image_url"인 경우). 이미지 URL: 이미지 URL에 접근할 수 있는지 확인하세요. Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여야 합니다. -에셋 ID: 형식 asset://\ +에셋 ID: 형식은 asset://\입니다. 콘텐츠 항목의 역할/위치입니다. -이미지의 경우: first_frame, last_frame 또는 reference_image. -비디오의 경우: reference_video (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). -오디오의 경우: reference_audio (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). +이미지의 경우: first_frame, last_frame 또는 reference_image입니다. +비디오의 경우: reference_video (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용)입니다. +오디오의 경우: reference_audio (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용)입니다. 가능한 값: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` - 모델을 위한 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. + 모델에 대한 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. -텍스트 프롬프트 (필수): 중국어 및 영어 문자를 사용하여 생성할 비디오를 설명합니다. +텍스트 프롬프트 (필수): 중국어 및 영어 문자를 사용하여 생성할 비디오에 대한 설명입니다. -파라미터 (선택 사항): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어합니다: +파라미터 (선택 사항): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어할 수 있습니다: - --resolution (--rs): 480p, 720p, 1080p (기본값: 720p) - --ratio (--rt): 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, 9:21, adaptive (기본값: 16:9 또는 adaptive) - --duration (--dur): 3-12초 (기본값: 5) @@ -261,11 +259,11 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 예: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -BytePlus의 제약이 아니라 Comfy 측 가드레일입니다. BytePlus는 텍스트 길이 제한을 공개하지 않았으며, 테스트(2026-09-17)에서 40,000자를 허용했습니다. 바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 몇 배가 될 수 있습니다. 이 제한은 이 필드 하나만 제한하며 요청 전체를 제한하지는 않습니다: `content`는 배열이고, 요청당 본문 제한이 전체 문서를 제한합니다. 이를 시행하는 표면은 Comfy Router(/v2/models/byteplus/\{model})입니다. 직접 v1 /proxy 호출에서는 대신 BytePlus 자체 검증기가 응답합니다. 실제 트래픽보다 훨씬 높게 설정되어 실제 프롬프트를 판정하는 일이 없도록 합니다. 호출자가 더 필요로 하면 이 값을 높이세요. +Comfy 측 가드레일이며 BytePlus의 제약이 아닙니다. BytePlus는 텍스트 길이 제한을 공개하지 않았으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. 바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 몇 배가 될 수 있습니다. 이 제한은 요청 전체가 아니라 이 단일 필드에만 적용됩니다: `content`는 배열이고, 요청당 본문 제한이 전체 문서의 크기를 제한합니다. 이를 강제하는 표면은 Comfy Router(/v2/models/byteplus/\{model})이며, v1 /proxy를 직접 호출할 경우에는 BytePlus 자체 검증기가 대신 응답합니다. 실제 트래픽보다 훨씬 높게 설정되어 있으므로 실제 프롬프트를 판정하는 일은 없습니다. 호출자에게 더 많은 길이가 필요하면 값을 높이세요. - 입력 콘텐츠의 유형 + 입력 콘텐츠의 유형입니다. 가능한 값: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` @@ -275,56 +273,55 @@ BytePlus의 제약이 아니라 Comfy 측 가드레일입니다. BytePlus는 텍 - 비디오 URL 또는 에셋 ID. -비디오 URL: 비디오의 공개 URL (mp4, mov). -에셋 ID: 형식 asset://\ + 비디오 URL 또는 에셋 ID입니다. +비디오 URL: 비디오의 공개 URL(mp4, mov)입니다. +에셋 ID: 형식은 asset://\입니다. - Seedance 2.5 전용입니다. 480p Draft 비디오를 생성하며 resolution은 480p여야 합니다. -반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 1080p 비디오를 렌더링하세요. Draft 작업 ID는 7일 동안 유효합니다. + Seedance 2.5 전용입니다. 480p Draft 비디오를 생성하며, 해상도는 480p여야 합니다. +최종 1080p 비디오를 렌더링하려면 반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하세요. Draft 작업 ID는 7일 동안 유효합니다. - 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1 (자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1 (자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. + 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1(자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1(자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. 범위: `2` ~ `30` - 작업 타임아웃 임계값(초)입니다. 기본값 172800 (48시간). 범위: [3600, 259200]. + 작업 타임아웃 임계값(초)입니다. 기본값 172800(48시간). 범위: [3600, 259200]. 범위: `3600` ~ `259200` - Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 시각과 동기화된 오디오가 포함되는지 여부입니다. + Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 시각 요소와 동기화된 오디오가 포함되는지 여부입니다. true: 모델이 동기화된 오디오가 포함된 비디오를 출력합니다. -false: 모델이 무음 비디오를 출력합니다. -이를 지원하는 모델에서는 생성된 오디오 트랙이 비디오와 별도로 제공자에 의해 콘텐츠 검사를 받습니다. 여기서 거부되면 `content_policy_violation`으로 보고되며, 오디오는 실행마다 달라지므로 제공자가 평소 허용하는 입력에서도 간헐적으로 발생할 수 있습니다. 그런 경우 `false`를 보내 무음 비디오를 생성하세요. 이는 오디오가 거부된 모달리티일 때만 도움이 되며, 동기 Router 응답은 이를 `refusal_subject: output_audio`로 표시합니다(대기열에 넣은 요청은 아직 이를 식별하지 않습니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 생성하세요. +false: 모델이 무음 비디오를 출력합니다.이를 지원하는 모델에서는 생성된 오디오 트랙을 공급자가 비디오와 별도로 콘텐츠 검사합니다. 여기서 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지기 때문에 공급자가 평소에는 허용하는 입력에 대해서도 간헐적으로 발생할 수 있습니다. 그런 경우 무음 비디오를 원한다면 `false`를 보내세요. 이는 오디오가 거부된 모달리티였을 때만 도움이 되며, 동기 Router 응답에서는 `refusal_subject: output_audio`로 명시됩니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 Draft를 `false`로 다시 생성하세요. - 호출할 모델의 ID입니다. 지원 모델: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini 및 dreamina-seedance-2-5-260628. POST /proxy/byteplus/api/v3/contents/generations/tasks에 대한 직접 v1 호출은 반드시 이를 제공해야 하며, 프록시는 다른 값이나 누락된 값을 400으로 거부합니다. 이 스키마의 `required` 목록에 포함되지 않은 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이 값을 채우므로 Router 호출자는 이를 생략하기 때문입니다. + 호출할 모델의 ID입니다. 지원 모델: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini 및 dreamina-seedance-2-5-260628. POST /proxy/byteplus/api/v3/contents/generations/tasks에 대한 직접 v1 호출은 반드시 이 값을 제공해야 합니다. 프록시는 다른 값이나 누락된 값에 대해 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이 값을 채우기 때문이며, 따라서 Router 호출자는 이를 생략합니다. Seedance 2.5 전용입니다. 출력 비디오의 컨테이너 형식입니다. -mp4: 범용 컨테이너(H.264/AAC, yuv420p)로 호환성이 넓고 파일 크기가 더 작습니다. -mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색상 정밀도가 높아 후반 작업에 적합하지만 파일 크기가 더 큽니다. +mp4: 호환성이 넓고 파일 크기가 더 작은 범용 컨테이너(H.264/AAC, yuv420p)입니다. +mov: 색상 정밀도가 높아 후반 작업에 적합한 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)이며, 파일 크기가 더 큽니다. 가능한 값: `mp4`, `mov` - 생성되는 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast 및 2.0 mini, 1.5 pro 기본값: adaptive. -Seedance 2.5의 첫 프레임 / 첫-마지막 프레임 생성: 출력이 첫 프레임의 화면 비율을 따르므로 `adaptive`만(또는 필드를 생략하는 경우만) 허용되며, 구체적인 비율을 지정하면 전송 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. + 생성된 비디오의 비율입니다. Seedance 2.0, 2.0 fast 및 2.0 mini, 1.5 pro 기본값: adaptive. +Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 종횡비를 따르므로 `adaptive`(또는 필드 생략)만 허용되며, 구체적인 비율은 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. + 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro 및 pro-fast 기본값: 1080p. 참고: Seedance 2.0, 2.0 fast 및 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. 가능한 값: `480p`, `720p`, `1080p`, `4k` @@ -343,7 +340,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 처리에 사용할 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. + 처리를 위한 서비스 등급입니다. Seedance 2.5, 2.0 및 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. 가능한 값: `default`, `flex` @@ -352,32 +349,46 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 생성된 비디오에 워터마크가 포함되는지 여부입니다. -Router가 `GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에게 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. +`GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 - 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체 필드입니다. null일 수 있습니다. BytePlus는 작업 24시간 후 URL을 삭제하므로, 그 이후에 폴링된 성공 문서는 `content`가 없거나 null일 수 있습니다. + 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅되며, 여기에 있는 다른 모든 필드는 BytePlus 자체의 필드입니다. null 허용: BytePlus는 작업 후 24시간이 지나면 URL을 지우므로, 그 이후에 폴링된 성공 문서는 `content`가 없거나 null일 수 있습니다. - 생성된 비디오의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정한 경우 반환됩니다. 이 URL로 이미지 형식을 추론하지 마세요. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하지만, Router는 전달받은 바이트를 그대로 재호스팅하고 업스트림 Content-Type 또는 콘텐츠 스니핑으로 형식을 판별하며, `image/jpeg`는 둘 다 실패했을 때의 최후 대체값일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지로 재호스팅하고 이 필드를 다시 작성하므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급될 때 24시간으로 서명되고 23시간짜리 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 안 되는 URL이 반환될 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 24시간 후 이를 삭제합니다. 어느 쪽이든 링크는 만료되므로, URL을 저장하지 말고 프레임을 다운로드하세요. + 생성된 비디오의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정한 경우 반환됩니다. 이 URL에서 이미지 형식을 추론하지 마세요. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하고, Router는 전달받은 바이트를 그대로 재호스팅하며 업스트림 Content-Type 또는 콘텐츠 스니핑으로 형식을 지정합니다. `image/jpeg`는 둘 다 실패했을 때의 최후 폴백일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지로 재호스팅하고 이 필드를 다시 씁니다. 따라서 보통은 최대 24시간 동안 유효한 Comfy 서명 URL이며, 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로 나중에 폴링하면 남은 유효 시간이 한 시간도 되지 않을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체의 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이 URL을 지웁니다. 어느 경우든 링크가 만료되므로 URL을 저장하지 말고 프레임을 다운로드하세요. - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 `content` 안에 중첩해 반환하는 경우입니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 흔하며, 최상위 `output_format` 필드를 참고하세요. Router는 두 위치 중 존재하는 쪽을 읽습니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환한 경우에 해당합니다. Seedance 모델은 보통 `content`의 최상위 형제 필드로 이를 반환하며(최상위 `output_format` 필드 참조), Router는 둘 중 존재하는 값을 읽습니다. + + + + 업스트림 URL이 동작을 멈추는 RFC 3339 시각입니다. URL 자체가 지닌 가장 이른 서명 시각에 유효 기간을 더한 값이며, `updated_at`이 존재할 경우 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦을 수 없고, 그렇지 않으면 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 어느 소스도 시각을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. + + 형식: `date-time` + + + + 마지막 프레임에 대한 BytePlus 자체의 다운로드 URL로, 재호스팅된 `last_frame_url` 옆에 그대로 반환되며 `upstream_video_url`과 동일한 조건을 따릅니다. 즉 옵트인한 워크스페이스에만, Seedance 2.x에만 해당하고, BytePlus가 지우면 사라지며, `upstream_expires_at`까지는 베어러 자격 증명입니다. + + + + 출력 비디오에 대한 BytePlus 자체의 다운로드 URL로, 재호스팅된 `video_url` 옆에 그대로 반환됩니다. 서버 측에서 Comfy가 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에서만 제공되며(요청 파라미터는 없습니다), 그 외의 모든 경우에는 제공되지 않습니다. 워크스페이스로 해석되지 않는 자격 증명(예: 특정 워크스페이스에 한정되지 않은 레거시 API 키)도 마찬가지이며, BytePlus가 생성 후 24시간이 지나 URL을 지우면 사라집니다. 이는 미리 서명된 오브젝트 스토리지 URL이므로 베어러 자격 증명입니다. 이를 보유한 사람은 만료 전까지 비디오를 다운로드할 수 있으므로 비밀 정보처럼 다루세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드 횟수를 100회로 제한하는데 그중 한 번은 Router 자체의 재호스팅이 사용합니다. - 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 재호스팅하고 이 필드를 다시 작성하므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급될 때 24시간으로 서명되고 23시간짜리 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 안 되는 URL이 반환될 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 24시간 후 이를 삭제하고 일부 모델에서는 다운로드를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로, URL을 저장하지 말고 비디오를 다운로드하세요. + 출력 비디오에 대한 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 재호스팅하고 이 필드를 다시 씁니다. 따라서 보통은 최대 24시간 동안 유효한 Comfy 서명 URL이며, 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로 나중에 폴링하면 남은 유효 시간이 한 시간도 되지 않을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체의 URL을 유지하며, BytePlus는 작업 후 24시간이 지나 이 URL을 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 경우든 링크가 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. - 작업이 생성된 시간입니다. 값은 초 단위 UNIX 타임스탬프입니다. + 작업이 생성된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다. - 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 일관성이 없어 정수가 아닌 숫자로 선언되었습니다. 비디오 작업은 정수 초를 반환하는 것이 관찰되었지만, 인접한 다른 BytePlus 인터페이스는 소수 재생 시간을 보고하므로 클라이언트는 정수값을 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이를 일관되게 다루지 않기 때문에 정수가 아닌 숫자로 선언됩니다. 비디오 작업에서는 정수 초를 반환한 사례가 관찰되었고, 인접한 BytePlus 표면에서는 소수 재생 시간을 보고하므로 클라이언트는 값이 정수라고 가정해서는 안 됩니다. BytePlus 자체의 필드이며, 성공한 비디오 작업에서 반환되어 변경 없이 전달됩니다. @@ -385,7 +396,7 @@ Router가 `GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json`에 - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 하나의 계열에 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake처럼 점으로 구분된 사유가 붙을 수 있습니다. 이것은 enum이 아닌 개방형 문자열이며, 다른 코드들은 검증 및 공급자 실패를 설명합니다. Router는 HTTP 400 오류 응답 본문과 HTTP 200 실패 작업 응답에서 정책 계열을 인식하며, 전송 실패를 덮어쓰지 않습니다. + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 한 패밀리에 점으로 구분된 사유가 붙을 수 있으며, 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake 등이 있습니다. 이는 열거형이 아닌 개방형 문자열입니다. 다른 코드들은 검증 및 공급자 실패를 설명합니다. Router는 전송 계층 실패를 덮어쓰지 않으면서 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 패밀리를 인식합니다. @@ -397,35 +408,35 @@ Router가 `GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json`에 - 작업에서 사용한 모델의 이름과 버전 + 작업에서 사용된 모델의 이름과 버전 - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, `content`의 형제 필드로서 최상위에 반환됩니다. Seedance 비디오 작업 조회가 이 위치에 반환합니다. BytePlus 자체 필드로, 변경 없이 전달됩니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)입니다. `content`의 형제로 최상위 레벨에 반환됩니다. Seedance 비디오 작업 쿼리에서 이 위치에 반환됩니다. BytePlus의 자체 필드이며 변경되지 않고 전달됩니다. - 생성된 비디오의 해상도로, 예를 들어 `1080p`입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 비디오의 해상도입니다. 예: `1080p`. BytePlus의 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경되지 않고 전달됩니다. - 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 작업에 실제로 사용된 생성 시드입니다. BytePlus의 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경되지 않고 전달됩니다. 형식: `int64` - 작업의 상태 + 작업의 상태입니다. 가능한 값: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` - 작업이 마지막으로 업데이트된 시간입니다. 값은 초 단위 UNIX 타임스탬프입니다. + 작업이 마지막으로 업데이트된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다. - 요청의 토큰 사용량 + 요청에 대한 토큰 사용량 @@ -433,7 +444,7 @@ Router가 `GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json`에 - 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않고 기본값이 0입니다. 따라서 total_tokens = completion_tokens입니다. + 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않으며 기본값은 0입니다. 따라서 total_tokens = completion_tokens입니다. ## 예시 diff --git a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx index 517c892428..0826421322 100644 --- a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx +++ b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx @@ -2,17 +2,16 @@ title: "Comfy Router로 Dreamina Seedance 2.0 Fast 260128 사용하기" description: "Comfy Router를 통해 byteplus/dreamina-seedance-2-0-fast-260128을 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "Dreamina Seedance 2.0 Fast 260128" -translationSourceHash: acad6428 +translationSourceHash: b02c6ed1 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx translationBlockHashes: "_intro": e4deed0d "Quick start": f5201dd4 - "Schema": a00368da + "Schema": e03c503a "Examples": 7714eccd --- - {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-0-fast-260128.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -181,33 +180,33 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128/ ### 입력 - 이 생성 작업 결과에 대한 콜백 알림 주소 + 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 절대 전송되지 않습니다. 대신 결과는 작업 상태 라우트를 폴링하여 확인하십시오. 형식: `uri` - 모델이 비디오를 생성하기 위한 입력 콘텐츠 + 모델이 비디오를 생성하기 위한 입력 콘텐츠입니다. - 입력 오디오 객체입니다. 오디오 입력은 Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 단독으로 사용할 수 없으며 최소 1개의 이미지나 비디오를 포함해야 합니다. Seedance 2.5는 오디오만 입력하는 것을 지원합니다. + 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만으로는 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오만 입력하는 것을 지원합니다. - 오디오 URL, Base64 인코딩 또는 Asset ID. + 오디오 URL, Base64 인코딩 또는 에셋 ID입니다. 오디오 URL: 오디오의 공개 URL(wav, mp3). -Base64: 형식 data:audio/\;base64,\ -Asset ID: 형식 asset://\ +Base64: data:audio/\;base64,\ 형식 +에셋 ID: asset://\ 형식 Seedance 2.5 전용입니다. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. -최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 이들을 다시 보내지 마세요. 해상도는 기본값이 1080p이며 1080p만 지원합니다. +최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 보내지 마십시오. 해상도는 기본값이 1080p이며 1080p만 지원합니다. - `draft`를 true로 설정하여 Draft 비디오를 생성할 때 반환된 작업 ID입니다. + `draft`를 true로 설정하여 Draft 비디오를 생성했을 때 반환된 작업 ID입니다. @@ -216,26 +215,26 @@ Asset ID: 형식 asset://\ 이미지 기반 비디오 생성을 위한 이미지 콘텐츠입니다(type이 "image_url"인 경우). -이미지 URL: 이미지 URL에 접근할 수 있는지 확인하세요. -Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여야 합니다. -Asset ID: 형식 asset://\ +이미지 URL: 이미지 URL에 접근할 수 있는지 확인하십시오. +Base64 인코딩 콘텐츠: data:image/\;base64,\ 형식이어야 합니다. +에셋 ID: asset://\ 형식 콘텐츠 항목의 역할/위치입니다. -이미지의 경우: first_frame, last_frame 또는 reference_image. -비디오의 경우: reference_video (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). -오디오의 경우: reference_audio (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). +이미지: first_frame, last_frame 또는 reference_image. +비디오: reference_video(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). +오디오: reference_audio(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). - 사용 가능한 값: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` + 가능한 값: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` - 모델에 제공되는 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. + 모델에 대한 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. -텍스트 프롬프트(필수): 중국어 및 영어 문자를 사용해 생성할 비디오에 대한 설명입니다. +텍스트 프롬프트(필수): 생성할 비디오에 대한 설명으로, 중국어와 영어 문자를 사용합니다. -파라미터(선택 사항): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어합니다: +파라미터(선택 사항): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어합니다. - --resolution (--rs): 480p, 720p, 1080p (기본값: 720p) - --ratio (--rt): 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, 9:21, adaptive (기본값: 16:9 또는 adaptive) - --duration (--dur): 3-12초 (기본값: 5) @@ -246,32 +245,33 @@ Asset ID: 형식 asset://\ 예: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -Comfy 측 가드레일이며 BytePlus 제약이 아닙니다. BytePlus는 텍스트 길이 제한을 공개하지 않았으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. 바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 몇 배가 될 수 있습니다. 이 가드레일은 이 필드 하나만 제한할 뿐 요청 전체를 제한하지 않습니다: `content`는 배열이며, 요청당 본문 제한이 전체 문서를 제한합니다. 이를 강제하는 표면은 Comfy Router(/v2/models/byteplus/\{model})이며, v1 /proxy를 직접 호출하면 BytePlus 자체 검증기가 대신 응답합니다. 실제 트래픽보다 훨씬 높게 설정되어 실제 프롬프트를 판정하는 일이 없도록 하며, 호출자에게 더 필요한 경우 값을 높이세요. +Comfy 측 가드레일이며 BytePlus의 제약이 아닙니다. BytePlus는 텍스트 길이 제한을 공개하지 않으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. +바이트가 아니라 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 몇 배가 될 수 있습니다. 이 제한은 요청 전체가 아니라 이 필드 하나만 제한합니다: `content`는 배열이며, 문서 전체를 제한하는 것은 요청당 본문 크기 제한입니다. 이를 강제하는 표면은 Comfy Router(/v2/models/byteplus/\{model})이며, v1 /proxy를 직접 호출할 때는 대신 BytePlus 자체 검증기가 응답합니다. 실제 트래픽보다 훨씬 높게 설정되어 있으므로 정상적인 프롬프트를 판정하지 않습니다. 호출자에게 더 많은 용량이 필요하면 이 값을 올리십시오. 입력 콘텐츠의 유형입니다. - 사용 가능한 값: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` + 가능한 값: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` - 입력 비디오 객체입니다. 비디오 입력은 Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 지원합니다. + 입력 비디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 비디오 입력을 지원합니다. - 비디오 URL 또는 Asset ID. + 비디오 URL 또는 에셋 ID입니다. 비디오 URL: 비디오의 공개 URL(mp4, mov). -Asset ID: 형식 asset://\ +에셋 ID: asset://\ 형식 - Seedance 2.5 전용입니다. 480p Draft 비디오를 생성하며 해상도는 480p여야 합니다. -최종 1080p 비디오를 렌더링하려면 반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하세요. Draft 작업 ID는 7일 동안 유효합니다. + Seedance 2.5 전용입니다. 480p Draft 비디오를 생성하며, 해상도는 480p여야 합니다. +반환된 작업 ID를 `draft_task` 콘텐츠 항목으로 전달하면 최종 1080p 비디오를 렌더링합니다. Draft 작업 ID는 7일 동안 유효합니다. - 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1 (자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1 (자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. + 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1(자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1(자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. 범위: `2` ~ `30` @@ -285,51 +285,49 @@ Asset ID: 형식 asset://\ Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 시각 요소와 동기화된 오디오가 포함되는지 여부입니다. true: 모델이 동기화된 오디오가 포함된 비디오를 출력합니다. -false: 모델이 무음 비디오를 출력합니다. -이를 지원하는 모델에서는 생성된 오디오 트랙이 비디오와 별도로 제공자에 의해 콘텐츠 검사를 받습니다. 여기서 거부되면 `content_policy_violation`으로 보고되며, 오디오는 실행마다 달라지므로 제공자가 평소 허용하는 입력에서도 간헐적으로 발생할 수 있습니다. 그런 경우 `false`를 보내 무음 비디오를 생성하세요. 이는 오디오가 거부된 모달리티일 때만 도움이 되며, 동기 Router 응답은 이를 `refusal_subject: output_audio`로 표시합니다(대기열에 넣은 요청은 아직 이를 식별하지 않습니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 생성하세요. +false: 모델이 무음 비디오를 출력합니다.이를 지원하는 모델에서 생성된 오디오 트랙은 공급자가 비디오와 별도로 콘텐츠 검사를 수행합니다. 이때 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지기 때문에 공급자가 그 외에는 허용하는 입력에 대해서도 간헐적으로 발생할 수 있습니다. 그런 경우 무음 비디오를 위해 `false`를 보내세요. 이는 오디오가 거부된 모달리티였을 때만 도움이 되며, 동기 Router 응답에서는 `refusal_subject: output_audio`로 명시됩니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 Draft를 `false`로 다시 생성하세요. - 호출할 모델의 ID입니다. 지원 모델: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini 및 dreamina-seedance-2-5-260628. v1을 직접 호출해 POST /proxy/byteplus/api/v3/contents/generations/tasks를 사용할 때는 반드시 제공해야 하며, 프록시는 다른 값이나 값이 누락된 경우 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이 값을 채우므로 Router 호출자는 생략하기 때문입니다. + 호출할 모델의 ID입니다. 지원되는 모델: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini 및 dreamina-seedance-2-5-260628. POST /proxy/byteplus/api/v3/contents/generations/tasks에 대한 직접 v1 호출은 반드시 이를 제공해야 합니다. 프록시는 다른 값이나 누락된 값에 대해 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이를 채우므로 Router 호출자는 이를 생략하기 때문입니다. - Seedance 2.5 전용입니다. 출력 비디오의 컨테이너 형식입니다. - + Seedance 2.5 전용. 출력 비디오의 컨테이너 형식입니다. mp4: 범용 컨테이너(H.264/AAC, yuv420p)로 호환성이 넓고 파일 크기가 더 작습니다. -mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색상 정밀도가 높아 후반 작업에 적합하지만 파일 크기가 더 큽니다. +mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색상 정밀도가 높아 후반 작업에 적합하며 파일 크기가 더 큽니다. 가능한 값: `mp4`, `mov` - 생성된 비디오의 비율입니다. Seedance 2.0, 2.0 fast 및 2.0 mini, 1.5 pro 기본값: adaptive. -Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 비율을 따르므로 `adaptive`(또는 필드 생략)만 허용되며, 구체적인 비율을 지정하면 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. + 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. +Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`(또는 필드 생략)만 허용되며, 구체적인 비율은 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. -참고: Seedance 2.0, 2.0 fast 및 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. + 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast & 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. +참고: Seedance 2.0, 2.0 fast & 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. 가능한 값: `480p`, `720p`, `1080p`, `4k` 생성된 비디오의 마지막 프레임 이미지를 반환할지 여부입니다. -참: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정하면 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. +true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 파라미터를 true로 설정한 후 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며, 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 파라미터를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않습니다. - 무작위성을 제어하기 위한 시드 정수입니다. 범위: [-1, 2^32-1]. -1은 무작위 시드를 사용합니다. + 무작위성을 제어하는 시드 정수입니다. 범위: [-1, 2^32-1]. -1은 무작위 시드를 사용합니다. 범위: `-1` ~ `4294967295` - 처리를 위한 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. + 처리 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. 가능한 값: `default`, `flex` @@ -338,32 +336,46 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 생성된 비디오에 워터마크가 포함되는지 여부입니다. -Router가 `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증할 때 사용하는 것과 동일한 문서입니다. +`GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 - 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과, BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지에 다시 호스팅(RE-HOSTED)되며, 여기에 있는 다른 모든 필드는 BytePlus 자체 필드입니다. Null 허용: BytePlus는 작업 후 24시간이 지나면 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. + 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체의 것입니다. Nullable입니다. BytePlus는 작업 후 24시간이 지나면 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. - 생성된 비디오의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정한 경우 반환됩니다. 이 URL에서 이미지 형식을 추론하지 마세요. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하고, Router는 전달받은 바이트를 그대로 다시 호스팅하며 업스트림 Content-Type 또는 콘텐츠 스니핑으로 형식을 판별합니다. `image/jpeg`는 둘 다 실패했을 때의 최후 수단 폴백일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지에 다시 호스팅하고 이 필드를 재작성하므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 한 시간도 안 되는 URL이 반환될 수 있습니다. 다시 호스팅을 수행할 수 없었던 경우에는 이 필드가 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지웁니다. 어느 쪽이든 링크는 만료되므로, URL을 저장하지 말고 프레임을 다운로드하세요. + 생성된 비디오의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정했을 때 반환됩니다. 이 URL로 이미지 형식을 추론하지 마십시오. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하지만, Router는 전달받은 바이트를 그대로 재호스팅하고 업스트림 Content-Type 또는 콘텐츠 스니핑으로 형식을 지정하며, `image/jpeg`는 둘 다 실패했을 때의 최후 수단 폴백일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지로 재호스팅하고 이 필드를 다시 쓰므로, 보통 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 되지 않는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우 이 필드는 대신 BytePlus 자체의 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지웁니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 프레임을 다운로드하십시오. - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환하는 경우입니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많으며(최상위 `output_format` 필드 참조), Router는 둘 중 존재하는 쪽을 읽습니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환하는 경우입니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많으며(최상위 `output_format` 필드 참조), Router는 둘 중 존재하는 값을 읽습니다. + + + + 업스트림 URL이 작동을 멈추는 RFC 3339 시각으로, 가장 이른 서명 시각에 URL 자체가 지니는 유효 기간을 더한 값입니다. `updated_at`이 존재하는 경우 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦을 수 없으며, 그렇지 않으면 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 어느 소스도 시각을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. + + 형식: `date-time` + + + + 마지막 프레임에 대한 BytePlus 자체의 다운로드 URL로, 재호스팅된 `last_frame_url` 옆에 `upstream_video_url`과 동일한 조건으로 바이트 단위 그대로 반환됩니다. 즉 옵트인된 워크스페이스에만, Seedance 2.x에만 해당하며, BytePlus가 지우면 사라지고, `upstream_expires_at`까지는 베어러 자격 증명입니다. + + + + 출력 비디오에 대한 BytePlus 자체의 다운로드 URL로, 재호스팅된 `video_url` 옆에 바이트 단위 그대로 반환됩니다. Comfy가 서버 측에서 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외 모든 경우에는 없습니다. 여기에는 워크스페이스로 확인되지 않는 자격 증명(예: 특정 워크스페이스에 범위가 지정되지 않은 레거시 API 키)이 포함되며, BytePlus가 생성 후 24시간이 지나 URL을 지우면 역시 없습니다. 이는 미리 서명된 오브젝트 스토리지 URL이므로 베어러 자격 증명입니다. 즉 이를 보유한 누구나 만료 전까지 비디오를 다운로드할 수 있으므로 비밀 정보처럼 다루십시오. `upstream_expires_at`에 만료되며, Seedance 2.5에서 BytePlus는 다운로드 횟수를 100회로 제한하며 그중 1회는 Router 자체의 재호스팅이 소비합니다. - 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지에 다시 호스팅하고 이 필드를 재작성하므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 한 시간도 안 되는 URL이 반환될 수 있습니다. 다시 호스팅을 수행할 수 없었던 경우에는 이 필드가 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로, URL을 저장하지 말고 비디오를 다운로드하세요. + 출력 비디오에 대한 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 재호스팅하고 이 필드를 다시 쓰므로, 보통 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 되지 않는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우 이 필드는 대신 BytePlus 자체의 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하십시오. - 작업이 생성된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다. + 작업이 생성된 시간입니다. 값은 초 단위 UNIX 타임스탬프입니다. - 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 일관성이 없어 정수가 아닌 숫자로 선언되었습니다. 비디오 작업은 정수 초를 반환하는 것이 관찰되었고, 인접한 다른 BytePlus 인터페이스는 소수 재생 시간을 보고하므로, 클라이언트는 이 값이 정수라고 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 일관성이 없어 정수 대신 숫자로 선언되었습니다. 비디오 작업이 정수 초를 반환한 사례가 관찰되었고, 인접한 BytePlus 표면에서는 소수 재생 시간을 보고하기도 하므로, 클라이언트는 값이 정수라고 가정해서는 안 됩니다. BytePlus 자체의 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. @@ -371,7 +383,7 @@ Router가 `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.jso - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 계열에는 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake처럼 점으로 구분된 사유가 있을 수 있습니다. 이는 열거형이 아니라 개방형 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 덮어쓰지 않으면서 HTTP 400 오류 응답 본문과 HTTP 200 실패 작업 응답에서 정책 계열을 인식합니다. + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 한 계열에 점으로 구분된 사유가 붙을 수 있으며, 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake 등이 있습니다. 이는 열거형이 아닌 개방형 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 덮어쓰지 않으면서 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 계열을 인식합니다. @@ -379,29 +391,29 @@ Router가 `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.jso - 비디오 생성 작업의 ID + 비디오 생성 작업의 ID입니다. - 작업에서 사용한 모델의 이름과 버전 + 작업에서 사용하는 모델의 이름과 버전입니다. - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, `content`의 형제 필드로 최상위에 반환됩니다. Seedance 비디오 작업 조회가 반환하는 위치입니다. BytePlus 자체 필드로, 변경 없이 전달됩니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)입니다. `content`의 형제 항목으로 최상위 레벨에서 반환되며, Seedance 비디오 작업 조회에서 이 위치에 반환됩니다. BytePlus 자체 필드이며 변경 없이 그대로 전달됩니다. - 생성된 비디오의 해상도입니다. 예를 들어 `1080p`입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 비디오의 해상도입니다. 예: `1080p`. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 그대로 전달됩니다. - 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 그대로 전달됩니다. 형식: `int64` - 작업의 상태 + 작업의 상태입니다. 가능한 값: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` @@ -411,11 +423,11 @@ Router가 `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.jso - 요청의 토큰 사용량 + 요청에 대한 토큰 사용량입니다. - 모델이 생성한 토큰 수 + 모델이 생성한 토큰 수입니다. diff --git a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx index cae58f667f..2d181e2a04 100644 --- a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx +++ b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx @@ -2,17 +2,16 @@ title: "Comfy Router와 함께 Dreamina Seedance 2.0 Mini 사용하기" description: "Comfy Router를 통해 byteplus/dreamina-seedance-2-0-mini를 호출합니다: endpoint, 요청 형태, 그리고 Router가 반환하는 응답을 다룹니다." sidebarTitle: "Dreamina Seedance 2.0 Mini" -translationSourceHash: 69d38df7 +translationSourceHash: 28c5c053 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx translationBlockHashes: "_intro": 45ff5bfd "Quick start": b0374f7d - "Schema": 2279819f + "Schema": 3c26a330 "Examples": db01067e --- - {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-0-mini.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -181,29 +180,29 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-mini/request ### 입력 - 이 생성 작업 결과에 대한 콜백 알림 주소 + 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 절대 전송되지 않습니다. 대신 작업 상태 조회 라우트를 폴링하여 결과를 확인하세요. 형식: `uri` - 모델이 비디오를 생성하기 위한 입력 콘텐츠 + 모델이 비디오를 생성하는 데 사용할 입력 콘텐츠입니다. - 입력 오디오 객체. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 단독으로 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오 전용 입력을 지원합니다. + 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오만으로 된 입력을 지원합니다. - 오디오 URL, Base64 인코딩 또는 에셋 ID. -오디오 URL: 오디오의 공개 URL (wav, mp3). -Base64: 형식 data:audio/\;base64,\ -에셋 ID: 형식 asset://\ + 오디오 URL, Base64 인코딩 또는 에셋 ID입니다. +오디오 URL: 오디오의 공개 URL입니다(wav, mp3). +Base64: data:audio/\;base64,\ 형식입니다. +에셋 ID: asset://\ 형식입니다. Seedance 2.5 전용입니다. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. -최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 전송하지 마세요. 해상도는 기본값이 1080p이며 1080p만 지원합니다. +최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 전송하지 마세요. 해상도는 기본값이자 유일한 지원 값인 1080p입니다. @@ -215,27 +214,27 @@ Base64: 형식 data:audio/\;base64,\ - 이미지 기반 비디오 생성을 위한 이미지 콘텐츠 (type이 "image_url"인 경우) + 이미지 기반 비디오 생성용 이미지 콘텐츠입니다(type이 "image_url"인 경우). 이미지 URL: 이미지 URL에 접근할 수 있는지 확인하세요. -Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여야 합니다. -에셋 ID: 형식 asset://\ +Base64 인코딩 콘텐츠: data:image/\;base64,\ 형식이어야 합니다. +에셋 ID: asset://\ 형식입니다. 콘텐츠 항목의 역할/위치입니다. 이미지의 경우: first_frame, last_frame 또는 reference_image. -비디오의 경우: reference_video (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만). -오디오의 경우: reference_audio (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만). +비디오의 경우: reference_video (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). +오디오의 경우: reference_audio (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). 가능한 값: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` - 모델에 대한 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. + 모델의 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. -텍스트 프롬프트 (필수): 중국어 및 영어 문자를 사용한 생성할 비디오에 대한 설명입니다. +텍스트 프롬프트(필수): 중국어 및 영어 문자로 작성한 생성할 비디오에 대한 설명입니다. -파라미터 (선택 사항): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어합니다: +파라미터(선택): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어합니다: - --resolution (--rs): 480p, 720p, 1080p (기본값: 720p) - --ratio (--rt): 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, 9:21, adaptive (기본값: 16:9 또는 adaptive) - --duration (--dur): 3-12초 (기본값: 5) @@ -246,30 +245,31 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 예시: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -BytePlus의 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 텍스트 길이 제한을 -공개하지 않으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. +BytePlus의 제약이 아닌 Comfy 측의 가드레일입니다. BytePlus는 텍스트 길이 +제한을 공개하지 않으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. 바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 -몇 배가 될 수 있습니다. 이 값은 이 필드 하나만 제한하며 요청 전체를 제한하지는 않습니다: -`content`는 배열이고, 전체 문서를 제한하는 것은 요청당 본문 제한입니다. 이를 강제하는 -표면은 Comfy Router (/v2/models/byteplus/\{model})이며, 직접 v1 /proxy 호출에서는 -BytePlus 자체 검증기가 대신 응답합니다. 실제 트래픽보다 훨씬 높게 설정되어 실제 -프롬프트를 판정하지 않으며, 호출자가 더 필요로 하면 값을 높이세요. +몇 배가 될 수 있습니다. 이 값은 이 필드 하나만 제한하며 요청 전체를 제한하지 +않습니다. `content`는 배열이고, 전체 문서를 제한하는 것은 요청 본문당 +제한입니다. 이를 강제하는 표면은 Comfy Router(/v2/models/byteplus/\{model})이며, +v1 /proxy를 직접 호출할 때는 BytePlus 자체 검증기가 대신 응답합니다. +실제 트래픽보다 훨씬 높게 설정되어 있으므로 정상적인 프롬프트를 절대 +거부하지 않습니다. 호출자에게 더 많은 양이 필요하면 이 값을 높이세요. - 입력 콘텐츠의 유형 + 입력 콘텐츠의 유형입니다. 가능한 값: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` - 입력 비디오 객체. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 비디오 입력을 지원합니다. + 입력 비디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 비디오 입력을 지원합니다. - 비디오 URL 또는 에셋 ID. -비디오 URL: 비디오의 공개 URL (mp4, mov). -에셋 ID: 형식 asset://\ + 비디오 URL 또는 에셋 ID입니다. +비디오 URL: 비디오의 공개 URL입니다(mp4, mov). +에셋 ID: asset://\ 형식입니다. @@ -278,64 +278,63 @@ BytePlus 자체 검증기가 대신 응답합니다. 실제 트래픽보다 훨 - 초 단위의 비디오 재생 시간입니다. Seedance 2.5: [4,30] 또는 -1 (자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1 (자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. + 초 단위의 비디오 재생 시간입니다. Seedance 2.5: [4,30] 또는 -1(자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1(자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. 범위: `2` ~ `30` - 초 단위의 작업 타임아웃 임계값입니다. 기본값 172800 (48시간). 범위: [3600, 259200]. + 초 단위의 작업 타임아웃 임계값입니다. 기본값 172800(48시간). 범위: [3600, 259200]. 범위: `3600` ~ `259200` - Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 화면과 동기화된 오디오가 포함되는지 여부입니다. -true: 모델이 동기화된 오디오가 있는 비디오를 출력합니다. -false: 모델이 무음 비디오를 출력합니다. -이를 지원하는 모델에서는 생성된 오디오 트랙이 비디오와 별도로 제공자에 의해 콘텐츠 검사를 받습니다. 여기서 거부되면 `content_policy_violation`으로 보고되며, 오디오는 실행마다 달라지므로 제공자가 평소 허용하는 입력에서도 간헐적으로 발생할 수 있습니다. 그런 경우 `false`를 보내 무음 비디오를 생성하세요. 이는 오디오가 거부된 모달리티일 때만 도움이 되며, 동기 Router 응답은 이를 `refusal_subject: output_audio`로 표시합니다(대기열에 넣은 요청은 아직 이를 식별하지 않습니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 생성하세요. + Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 화면과 동기화된 오디오를 포함할지 여부입니다. +true: 모델이 동기화된 오디오가 포함된 비디오를 출력합니다. +false: 모델이 무음 비디오를 출력합니다.이를 지원하는 모델에서는 생성된 오디오 트랙이 비디오와 별도로 공급자의 콘텐츠 검사를 받습니다. 여기서 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지기 때문에 공급자가 다른 조건에서는 허용하는 입력에 대해서도 간헐적으로 발생할 수 있습니다. 그런 경우 무음 비디오를 원한다면 `false`를 보내세요. 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 `refusal_subject: output_audio`로 이를 명시합니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 생성하세요. - 호출할 모델의 ID입니다. 지원되는 모델: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini 및 dreamina-seedance-2-5-260628. POST /proxy/byteplus/api/v3/contents/generations/tasks에 대한 직접 v1 호출은 반드시 이를 제공해야 하며, 프록시는 다른 값이나 누락된 값에 대해 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이를 채우기 때문에 Router 호출자는 이를 생략하기 때문입니다. + 호출할 모델의 ID입니다. 지원되는 모델: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini, dreamina-seedance-2-5-260628. POST /proxy/byteplus/api/v3/contents/generations/tasks에 대한 직접 v1 호출은 반드시 이를 제공해야 합니다. 프록시는 다른 값이나 값을 생략한 경우를 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이를 채우기 때문이며, 따라서 Router 호출자는 이를 생략합니다. Seedance 2.5 전용입니다. 출력 비디오의 컨테이너 형식입니다. mp4: 범용 컨테이너(H.264/AAC, yuv420p)로 호환성이 넓고 파일 크기가 더 작습니다. -mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색상 정밀도가 높아 후반 작업에 적합하지만 파일 크기가 더 큽니다. +mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색상 정밀도가 높아 후반 작업에 적합하며 파일 크기가 더 큽니다. 가능한 값: `mp4`, `mov` - 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast 및 2.0 mini, 1.5 pro 기본값: adaptive. -Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`만(또는 필드를 생략하는 경우만) 허용되며, 구체적인 비율을 지정하면 전달 전에 400으로 거부됩니다. Seedance 2.0은 이러한 모드에서 구체적인 비율을 허용합니다. + 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. +Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`만(또는 필드를 생략하는 것만) 허용되며, 구체적인 비율은 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. -참고: Seedance 2.0, 2.0 fast 및 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. + 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast & 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. +참고: Seedance 2.0, 2.0 fast & 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. 가능한 값: `480p`, `720p`, `1080p`, `4k` 생성된 비디오의 마지막 프레임 이미지를 반환할지 여부입니다. -true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정한 뒤 비디오 생성 작업 정보 조회를 호출하면 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 즉, 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. +true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정한 후 비디오 생성 작업 정보 조회를 호출하면 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며, 픽셀 너비와 높이는 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 즉, 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않습니다. - 무작위성을 제어하는 시드 정수입니다. 범위: [-1, 2^32-1]. -1은 무작위 시드를 사용합니다. + 무작위성을 제어하기 위한 시드 정수입니다. 범위: [-1, 2^32-1]. -1은 무작위 시드를 사용합니다. 범위: `-1` ~ `4294967295` - 처리 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. + 처리를 위한 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. 가능한 값: `default`, `flex` @@ -344,32 +343,46 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 생성된 비디오에 워터마크가 포함되는지 여부입니다. -Router가 `GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json`에서 제공하는 스키마를 기반으로 생성되었으며, 이는 요청이 공급자에게 도달하기 전에 호출을 검증할 때 사용하는 것과 동일한 문서입니다. +`GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json`에서 Router가 제공하는 스키마로, 요청이 공급자에 도달하기 전에 Router가 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 - 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅(RE-HOSTED)되며, 여기의 다른 모든 필드는 BytePlus 자체 필드입니다. Null 허용: BytePlus는 작업 후 24시간 뒤에 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. + 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체의 것입니다. nullable입니다. BytePlus는 작업 후 24시간이 지나면 URL을 정리하며, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. - 생성된 비디오의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정한 경우 반환됩니다. 이 URL로 이미지 형식을 추론하지 마세요. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하지만, Router는 전달받은 바이트를 그대로 재호스팅하고 업스트림 Content-Type 또는 콘텐츠 스니핑을 통해 형식을 판별하며, `image/jpeg`는 둘 다 실패했을 때의 최후 수단 폴백일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지로 재호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급될 때 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 안 되는 URL을 돌려받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간 뒤에 이를 지웁니다. 어느 쪽이든 링크는 만료되므로, URL을 저장하지 말고 프레임을 다운로드하세요. + 생성된 비디오의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정했을 때 반환됩니다. 이 URL로 이미지 형식을 추론하지 마세요. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하고, Router는 전달받은 바이트를 그대로 재호스팅하며 업스트림 Content-Type 또는 콘텐츠 스니핑으로 형식을 지정합니다. `image/jpeg`는 둘 다 실패했을 때의 최후 수단 폴백일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지로 재호스팅하고 이 필드를 다시 작성하므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중 폴링에서는 남은 시간이 한 시간도 안 되는 URL이 반환될 수 있습니다. 재호스팅을 수행할 수 없었을 때는 이 필드가 대신 BytePlus 자체의 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 정리합니다. 어느 경우든 링크가 만료되므로 URL을 저장하지 말고 프레임을 다운로드하세요. - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩할 때 사용됩니다. Seedance 모델은 더 흔히 이를 `content`의 최상위 형제 필드로 반환하며(최상위 `output_format` 필드 참고), Router는 둘 중 존재하는 것을 읽습니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환할 때 제공됩니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많으니 최상위 `output_format` 필드를 참고하세요. Router는 둘 중 존재하는 값을 읽습니다. + + + + 업스트림 URL이 작동을 멈추는 RFC 3339 시각으로, 가장 이른 서명 시각에 URL 자체가 지니는 유효 기간을 더한 값입니다. `updated_at`이 존재하면 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦지 않으며, 그렇지 않으면 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 어느 소스도 시각을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. + + 형식: `date-time` + + + + 마지막 프레임에 대한 BytePlus 자체의 다운로드 URL로, 재호스팅된 `last_frame_url` 옆에 바이트 단위로 그대로 반환되며 `upstream_video_url`과 동일한 조건을 따릅니다. 옵트인한 워크스페이스에만 해당하고, Seedance 2.x에만 해당하며, BytePlus가 정리한 뒤에는 존재하지 않고, `upstream_expires_at`까지는 베어러 자격 증명입니다. + + + + 출력 비디오에 대한 BytePlus 자체의 다운로드 URL로, 재호스팅된 `video_url` 옆에 바이트 단위로 그대로 반환됩니다. Comfy가 서버 측에서 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외의 경우에는 존재하지 않습니다. 워크스페이스로 확인되지 않는 자격 증명(예: 특정 워크스페이스에 범위가 지정되지 않은 레거시 API 키)도 마찬가지이며, 생성 후 24시간이 지나 BytePlus가 URL을 정리하면 존재하지 않습니다. presigned 객체 스토리지 URL이므로 베어러 자격 증명입니다. 이를 보유한 누구나 만료 전까지 비디오를 다운로드할 수 있으므로 비밀 정보처럼 다루세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드 횟수를 100회로 제한하는데 그중 한 번은 Router 자체의 재호스팅이 소비합니다. - 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 재호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급될 때 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 안 되는 URL을 돌려받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간 뒤에 이를 지우고 일부 모델에서는 다운로드를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로, URL을 저장하지 말고 비디오를 다운로드하세요. + 출력 비디오에 대한 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 재호스팅하고 이 필드를 다시 작성하므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중 폴링에서는 남은 시간이 한 시간도 안 되는 URL이 반환될 수 있습니다. 재호스팅을 수행할 수 없었을 때는 이 필드가 대신 BytePlus 자체의 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 정리하고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 경우든 링크가 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. - 작업이 생성된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다. + 작업이 생성된 시각입니다. 값은 초 단위의 UNIX 타임스탬프입니다. - 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이를 일관되게 처리하지 않기 때문에 정수가 아닌 숫자로 선언됩니다. 비디오 작업이 정수 초를 반환하는 것이 관찰된 반면, 인접한 BytePlus 인터페이스는 소수 재생 시간을 보고하므로, 클라이언트는 정수 값을 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 일관성이 없기 때문에 정수가 아닌 숫자로 선언되었습니다. 비디오 작업이 정수 초를 반환하는 사례가 관찰되었고, 인접한 다른 BytePlus 인터페이스는 소수 재생 시간을 보고합니다. 따라서 클라이언트는 정수 값을 가정해서는 안 됩니다. BytePlus 자체의 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. @@ -377,31 +390,32 @@ Router가 `GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json`에 - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 패밀리에는 점으로 구분된 사유가 있을 수 있으며, 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation 또는 OutputImageSensitiveContentDetected.DeepFake 등이 있습니다. 이는 열거형이 아닌 열린 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 덮어쓰지 않으면서 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 패밀리를 인식합니다. + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 하나의 패밀리에 점으로 구분된 사유가 붙을 수 있으며, 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake 등이 있습니다. 이것은 열거형이 아니라 개방형 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 패밀리를 인식하며, 전송 실패를 덮어쓰지 않습니다. - 오류 메시지 + 오류 메시지입니다. 비디오 생성 작업의 ID + - - 작업에 사용된 모델의 이름과 버전 + + 작업에서 사용한 모델의 이름과 버전 - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, `content`의 형제 필드로 최상위에 반환됩니다. Seedance 비디오 작업 조회가 이를 반환하는 위치입니다. BytePlus 자체 필드로, 변경 없이 전달됩니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov). `content`의 형제로 최상위 레벨에서 반환됩니다. Seedance 비디오 작업 조회가 이 위치에서 값을 반환합니다. BytePlus 자체 필드이며 변경 없이 그대로 전달됩니다. - 생성된 비디오의 해상도입니다. 예: `1080p`. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 비디오의 해상도입니다. 예: `1080p`. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 그대로 전달됩니다. - 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 그대로 전달됩니다. 형식: `int64` @@ -425,7 +439,7 @@ Router가 `GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json`에 - 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않고 기본값이 0입니다. 따라서 total_tokens = completion_tokens입니다. + 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않고 0으로 기본 설정됩니다. 따라서 total_tokens = completion_tokens입니다. ## 예시 diff --git a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx index c0c3e5a1cf..bec8e2c6d1 100644 --- a/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx +++ b/ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx @@ -2,18 +2,17 @@ title: "Comfy Router에서 Dreamina Seedance 2.5 260628 사용하기" description: "Comfy Router를 통해 byteplus/dreamina-seedance-2-5-260628을 호출합니다: 엔드포인트, 요청 형태, Router가 반환하는 응답을 설명합니다." sidebarTitle: "Dreamina Seedance 2.5 260628" -translationSourceHash: 9a342bd4 +translationSourceHash: 07fd9c64 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx translationBlockHashes: "_intro": 4b5f4cec "Quick start": a2bb8c28 "Serving providers": 197dd61a - "Schema": 0467a987 + "Schema": 0a76af44 "Examples": 5465695b --- - {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-5-260628.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -194,33 +193,33 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque ### 입력 - 이 생성 작업 결과에 대한 콜백 알림 주소 + 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 전혀 전송되지 않습니다. 대신 작업 상태 라우트를 폴링하여 결과를 확인하세요. 형식: `uri` - 모델이 비디오를 생성하기 위한 입력 콘텐츠 + 모델이 비디오를 생성하기 위한 입력 콘텐츠입니다. - 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 단독으로 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오만 입력하는 것을 지원합니다. + 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast & 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast & 2.0 mini는 오디오만 사용할 수 없으며 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오만으로 된 입력을 지원합니다. - 오디오 URL, Base64 인코딩 또는 에셋 ID. -오디오 URL: 오디오의 공개 URL (wav, mp3). -Base64: 형식 data:audio/\;base64,\ -에셋 ID: 형식 asset://\ + 오디오 URL, Base64 인코딩 또는 에셋 ID입니다. +오디오 URL: 오디오의 공개 URL(wav, mp3)입니다. +Base64: 형식은 data:audio/\;base64,\입니다. +에셋 ID: 형식은 asset://\입니다. - Seedance 2.5 전용입니다. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. + Seedance 2.5 전용입니다. 최종 비디오로 렌더링할 Draft 작업입니다. 이 항목은 유일한 콘텐츠 항목이어야 합니다. 최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 보내지 마세요. 해상도는 기본값이 1080p이며 1080p만 지원합니다. - `draft`를 true로 설정하여 Draft 비디오를 생성했을 때 반환되는 작업 ID입니다. + `draft`를 true로 설정하여 Draft 비디오를 생성했을 때 반환된 작업 ID입니다. @@ -228,17 +227,17 @@ Base64: 형식 data:audio/\;base64,\ - 이미지 기반 비디오 생성을 위한 이미지 콘텐츠입니다 (type이 "image_url"인 경우). + 이미지 기반 비디오 생성을 위한 이미지 콘텐츠입니다(type이 "image_url"인 경우). 이미지 URL: 이미지 URL에 접근할 수 있는지 확인하세요. -Base64 인코딩된 콘텐츠: 형식은 data:image/\;base64,\여야 합니다. -에셋 ID: 형식 asset://\ +Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여야 합니다. +에셋 ID: 형식은 asset://\입니다. 콘텐츠 항목의 역할/위치입니다. -이미지의 경우: first_frame, last_frame 또는 reference_image. -비디오의 경우: reference_video (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). -오디오의 경우: reference_audio (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). +이미지의 경우: first_frame, last_frame 또는 reference_image입니다. +비디오의 경우: reference_video(Seedance 2.5, 2.0, 2.0 fast & 2.0 mini 전용)입니다. +오디오의 경우: reference_audio(Seedance 2.5, 2.0, 2.0 fast & 2.0 mini 전용)입니다. 가능한 값: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` @@ -246,9 +245,9 @@ Base64 인코딩된 콘텐츠: 형식은 data:image/\;base64,\ 모델에 대한 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. -텍스트 프롬프트 (필수): 중국어 및 영어 문자를 사용하여 생성할 비디오에 대한 설명입니다. +텍스트 프롬프트(필수): 중국어 및 영어 문자를 사용한 생성할 비디오에 대한 설명입니다. -파라미터 (선택 사항): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어합니다: +파라미터(선택 사항): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어합니다: - --resolution (--rs): 480p, 720p, 1080p (기본값: 720p) - --ratio (--rt): 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, 9:21, adaptive (기본값: 16:9 또는 adaptive) - --duration (--dur): 3-12초 (기본값: 5) @@ -257,91 +256,96 @@ Base64 인코딩된 콘텐츠: 형식은 data:image/\;base64,\ - --seed (--seed): -1 ~ 2^32-1 (기본값: -1) - --camerafixed (--cf): true/false (기본값: false) -예시: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" +예: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -BytePlus의 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 텍스트 길이 제한을 공개하지 않았으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. 바이트가 아닌 문자를 세므로, 멀티바이트 프롬프트는 전송 시 이 크기의 몇 배가 될 수 있습니다. 이는 이 필드 하나만 제한하며 요청 전체를 제한하지는 않습니다. `content`는 배열이고, 문서 전체를 제한하는 것은 요청당 본문 제한입니다. 이를 강제하는 표면은 Comfy Router(/v2/models/byteplus/\{model})이며, 직접 v1 /proxy 호출에서는 대신 BytePlus 자체 검증기가 응답합니다. 실제 프롬프트를 판정하지 않도록 실제 트래픽보다 훨씬 높게 설정되어 있습니다. 호출자가 더 필요하면 이 값을 높이세요. +BytePlus의 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 +텍스트 길이 제한을 공개하지 않으며 테스트에서 40,000자를 허용했습니다(2026-09-17). +이는 바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 +몇 배가 될 수 있습니다. 이 제한은 요청 전체가 아니라 이 필드 하나를 제한합니다: +`content`는 배열이며, 요청당 본문 제한이 전체 문서를 제한합니다. 이를 강제하는 표면은 +Comfy Router(/v2/models/byteplus/\{model})이며, v1 /proxy를 직접 호출하면 대신 BytePlus 자체 +검증기가 응답합니다. 실제 트래픽보다 훨씬 높게 설정하여 실제 프롬프트를 판정하지 않도록 하세요. 호출자가 더 필요하면 값을 올리세요. - 입력 콘텐츠의 유형 + 입력 콘텐츠의 유형입니다. 가능한 값: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` - 입력 비디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 비디오 입력을 지원합니다. + 입력 비디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast & 2.0 mini만 비디오 입력을 지원합니다. - 비디오 URL 또는 에셋 ID. -비디오 URL: 비디오의 공개 URL (mp4, mov). -에셋 ID: 형식 asset://\ + 비디오 URL 또는 에셋 ID입니다. +비디오 URL: 비디오의 공개 URL(mp4, mov)입니다. +에셋 ID: 형식은 asset://\입니다. Seedance 2.5 전용입니다. 480p Draft 비디오를 생성하며, 해상도는 480p여야 합니다. -최종 1080p 비디오를 렌더링하려면 반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하세요. Draft 작업 ID는 7일 동안 유효합니다. +반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 1080p 비디오를 렌더링하세요. Draft 작업 ID는 7일 동안 유효합니다. - 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1 (자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1 (자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. + 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1(자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast & 2.0 mini: [4,15] 또는 -1(자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. 범위: `2` ~ `30` - 작업 타임아웃 임계값(초)입니다. 기본값 172800 (48시간). 범위: [3600, 259200]. + 작업 타임아웃 임계값(초)입니다. 기본값 172800(48시간). 범위: [3600, 259200]. 범위: `3600` ~ `259200` Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 화면과 동기화된 오디오가 포함되는지 여부입니다. -true: 모델이 동기화된 오디오가 있는 비디오를 출력합니다. -false: 모델이 무음 비디오를 출력합니다. -이를 지원하는 모델에서는 생성된 오디오 트랙이 비디오와 별도로 제공자에 의해 콘텐츠 검사를 받습니다. 여기서 거부되면 `content_policy_violation`으로 보고되며, 오디오는 실행마다 달라지므로 제공자가 평소 허용하는 입력에서도 간헐적으로 발생할 수 있습니다. 그런 경우 `false`를 보내 무음 비디오를 생성하세요. 이는 오디오가 거부된 모달리티일 때만 도움이 되며, 동기 Router 응답은 이를 `refusal_subject: output_audio`로 표시합니다(대기열에 넣은 요청은 아직 이를 식별하지 않습니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 생성하세요. +true: 모델이 동기화된 오디오가 포함된 비디오를 출력합니다. +false: 모델이 무음 비디오를 출력합니다.On models that support it, the generated audio track is content-checked by the provider separately from the video; a refusal there is reported as `content_policy_violation` and, because the audio differs each run, can be intermittent for an input the provider otherwise accepts. Send `false` for a silent video if that happens; this helps only when the audio was the refused modality, which a synchronous Router response names as `refusal_subject: output_audio` (a queued request does not identify it yet). A Seedance 2.5 final render inherits `generate_audio` from its Draft task, so recreate the Draft with `false` instead. - 호출할 모델의 ID입니다. 지원되는 모델: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini 및 dreamina-seedance-2-5-260628. POST /proxy/byteplus/api/v3/contents/generations/tasks에 대한 직접 v1 호출은 반드시 이를 제공해야 합니다. 프록시는 다른 값이나 생략된 값을 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이 값을 채우므로 Router 호출자는 이를 생략하기 때문입니다. + 호출할 모델의 ID입니다. 지원 모델: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini 및 dreamina-seedance-2-5-260628. `POST /proxy/byteplus/api/v3/contents/generations/tasks`에 대한 직접 v1 호출은 반드시 이 값을 제공해야 합니다. 프록시는 다른 값이나 누락된 값을 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 `/v2/models/byteplus/\{model}`의 `{model}` 경로 세그먼트에서 이 값을 채우므로 Router 호출자는 이를 생략하기 때문입니다. - Seedance 2.5 전용입니다. 출력 비디오의 컨테이너 형식입니다. -mp4: 범용 컨테이너(H.264/AAC, yuv420p)로 호환성이 넓고 파일 크기가 더 작습니다. -mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색상 정밀도가 높아 후반 작업에 적합하지만 파일 크기가 더 큽니다. + Seedance 2.5 전용. 출력 비디오의 컨테이너 형식입니다. +mp4: 호환성이 넓고 파일 크기가 더 작은 범용 컨테이너(H.264/AAC, yuv420p)입니다. +mov: 색상 정밀도가 높아 후반 제작에 적합하지만 파일 크기가 더 큰 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)입니다. 가능한 값: `mp4`, `mov` - 생성되는 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast 및 2.0 mini, 1.5 pro 기본값: adaptive. -Seedance 2.5의 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`(또는 필드 생략)만 허용되며, 구체적인 비율을 지정하면 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. + 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. +Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`만 허용되며(또는 필드를 생략해야 하며), 구체적인 비율은 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. -참고: Seedance 2.0, 2.0 fast 및 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. + 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast & 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. +참고: Seedance 2.0, 2.0 fast & 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. 가능한 값: `480p`, `720p`, `1080p`, `4k` 생성된 비디오의 마지막 프레임 이미지를 반환할지 여부입니다. -true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정한 뒤 비디오 생성 작업 정보 조회를 호출하면 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며, 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. +true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정하면 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며 픽셀 너비와 높이는 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않습니다. - 무작위성을 제어하기 위한 시드 정수입니다. 범위: [-1, 2^32-1]. -1은 무작위 시드를 사용합니다. + 무작위성을 제어하는 시드 정수입니다. 범위: [-1, 2^32-1]. -1은 무작위 시드를 사용합니다. 범위: `-1` ~ `4294967295` - 처리에 사용할 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. + 처리에 사용할 서비스 티어입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. 가능한 값: `default`, `flex` @@ -350,32 +354,46 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 생성된 비디오에 워터마크가 포함되는지 여부입니다. -Router가 `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에게 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. +`GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json`에서 Router가 제공하는 스키마로부터 생성되었으며, 이는 요청이 공급자에게 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 - 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 RE-HOSTED되며, 여기의 다른 모든 필드는 BytePlus 자체 필드입니다. null을 허용합니다. BytePlus는 작업 후 24시간이 지나면 URL을 지우며, 그 이후에 폴링한 succeeded 문서는 `content`가 없거나 null일 수 있습니다. + 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체 필드입니다. null일 수 있습니다. BytePlus는 작업 후 24시간이 지나면 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. - 생성된 비디오의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정한 경우 반환됩니다. 이 URL에서 이미지 형식을 추론하지 마세요. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하고, Router는 제공받은 바이트를 그대로 re-host하며 업스트림 Content-Type 또는 콘텐츠 스니핑을 통해 형식을 지정합니다. `image/jpeg`는 둘 다 실패했을 때의 최후 수단 대체값일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지로 re-host하고 이 필드를 다시 씁니다. 따라서 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급될 때 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 안 되는 URL이 반환될 수 있습니다. re-host를 수행할 수 없었던 경우에는 이 필드가 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지웁니다. 어느 쪽이든 링크는 만료되므로, URL을 저장하지 말고 프레임을 다운로드하세요. + 생성된 비디오의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정했을 때 반환됩니다. 이 URL에서 이미지 형식을 추론하지 마십시오. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하지만, Router는 제공받은 바이트를 그대로 재호스팅하고 업스트림 Content-Type 또는 콘텐츠 스니핑으로 타입을 정하며, `image/jpeg`는 둘 다 실패했을 때의 최후 수단 폴백일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지로 재호스팅하고 이 필드를 다시 쓰므로, 보통 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 1시간도 되지 않는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 24시간 후 이를 지웁니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 프레임을 다운로드하십시오. - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩할 때 사용됩니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많으며(최상위 `output_format` 필드 참조), Router는 둘 중 존재하는 쪽을 읽습니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환하는 경우의 값입니다. Seedance 모델은 더 흔히 `content`의 최상위 형제로 반환하며, 최상위 `output_format` 필드를 참고하십시오. Router는 둘 중 존재하는 것을 읽습니다. + + + + 업스트림 URL이 작동을 멈추는 RFC 3339 시각입니다. URL 자체가 가지는 가장 이른 서명 시각에 유효 기간을 더한 값이며, `updated_at`이 있을 때는 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦지 않습니다. `updated_at`이 없으면 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 두 소스 중 어느 것도 시각을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. + + 형식: `date-time` + + + + 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `last_frame_url` 옆에 바이트 단위 그대로 반환되며 `upstream_video_url`과 같은 조건을 따릅니다. 옵트인한 워크스페이스에만, Seedance 2.x에만 해당하며, BytePlus가 지운 뒤에는 없고, `upstream_expires_at`까지는 베어러 자격 증명입니다. + + + + 출력 비디오에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `video_url` 옆에 바이트 단위 그대로 반환됩니다. 서버 측에서 Comfy가 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외의 경우에는 없습니다. 워크스페이스로 확인되지 않는 자격 증명(예: 특정 워크스페이스에 속하지 않는 레거시 API 키)도 마찬가지이며, 생성 24시간 후 BytePlus가 URL을 지우면 없어집니다. 사전 서명된 오브젝트 스토리지 URL이므로 베어러 자격 증명입니다. 이를 가진 사람은 만료될 때까지 비디오를 다운로드할 수 있으므로 비밀처럼 다루십시오. `upstream_expires_at`에 만료되며, Seedance 2.5에서 BytePlus는 다운로드 횟수를 100회로 제한하는데 그중 하나는 Router 자체의 재호스팅이 소비합니다. - 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 re-host하고 이 필드를 다시 씁니다. 따라서 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급될 때 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 안 되는 URL이 반환될 수 있습니다. re-host를 수행할 수 없었던 경우에는 이 필드가 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로, URL을 저장하지 말고 비디오를 다운로드하세요. + 출력 비디오에 대한 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 재호스팅하고 이 필드를 다시 쓰므로, 보통 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 1시간도 되지 않는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 24시간 후 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하십시오. - 작업이 생성된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다. + 작업이 생성된 시각입니다. 값은 초 단위 UNIX 타임스탬프입니다. - 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 대해 일관성이 없기 때문에 정수가 아닌 숫자로 선언됩니다. 비디오 작업이 정수 초를 반환하는 것이 관찰되었고, 동일한 BytePlus 인터페이스는 소수 재생 시간을 보고하기도 하므로, 클라이언트는 정수 값을 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 일관적이지 않기 때문에 정수 대신 숫자로 선언됩니다. 비디오 작업이 정수 초를 반환한 사례가 관찰되었고, BytePlus의 다른 표면들은 소수 재생 시간을 보고하므로 클라이언트는 정수 값을 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. @@ -383,7 +401,7 @@ Router가 `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json`에 - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 패밀리에는 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake처럼 점으로 구분된 이유가 붙을 수 있습니다. 이는 enum이 아닌 개방형 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 재정의하지 않으면서 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 패밀리를 인식합니다. + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 하나의 계열에 점으로 구분된 사유가 붙을 수 있으며, 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake 등이 있습니다. 이는 열거형이 아니라 개방형 문자열입니다. 다른 코드들은 검증 및 공급자 실패를 설명합니다. Router는 전송 실패를 덮어쓰지 않으면서 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 계열을 인식합니다. @@ -395,19 +413,19 @@ Router가 `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json`에 - 작업에서 사용한 모델의 이름과 버전 + 작업에서 사용된 모델의 이름과 버전 - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, `content`의 형제 필드로서 최상위 레벨에서 반환됩니다. Seedance 비디오 작업 쿼리가 이 위치에서 반환합니다. BytePlus 자체 필드로, 변경 없이 전달됩니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)이며, `content`의 형제로 최상위 수준에서 반환됩니다. Seedance 비디오 작업 쿼리에서 이 필드를 반환하는 위치입니다. BytePlus 자체 필드이며 변경 없이 전달됩니다. - 생성된 비디오의 해상도, 예: `1080p`. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 비디오의 해상도입니다. 예: `1080p`. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 전달됩니다. - 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되고 변경 없이 전달됩니다. 형식: `int64` @@ -419,19 +437,19 @@ Router가 `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json`에 - 작업이 마지막으로 업데이트된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다. + 작업이 마지막 업데이트된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다. - 요청의 토큰 사용량 + 요청에 대한 토큰 사용량 - 모델이 생성한 토큰 수 + 모델에서 생성된 토큰 수 - 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않고 0으로 기본 설정됩니다. 따라서 total_tokens = completion_tokens입니다. + 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않으며 기본값은 0입니다. 따라서 total_tokens = completion_tokens입니다. ## 예시 diff --git a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx index 6e8122eeb1..6f3a74f569 100644 --- a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx @@ -2,17 +2,16 @@ title: "Comfy Router로 Seedance 1.0 Pro 250528 사용하기" description: "Comfy Router를 통해 byteplus/seedance-1-0-pro-250528을 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "Seedance 1.0 Pro 250528" -translationSourceHash: 084b73ac +translationSourceHash: 450bbe6e translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx translationBlockHashes: "_intro": e1a3501d "Quick start": c762675f - "Schema": af62a34c + "Schema": fc979e05 "Examples": 815d621e --- - {/* GENERATED FILE. Generated from router-schemas/byteplus/seedance-1-0-pro-250528.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -181,28 +180,28 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528/requests/$ ### 입력 - 이 생성 작업의 결과를 받을 콜백 알림 주소 + 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 전혀 전송되지 않습니다. 대신 결과는 작업 상태 조회 경로를 폴링하여 확인하십시오. 형식: `uri` - 모델이 비디오를 생성하는 데 사용할 입력 콘텐츠 + 모델이 비디오를 생성하기 위한 입력 콘텐츠입니다 - 입력 오디오 객체. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 단독으로 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오만 입력하는 것을 지원합니다. + 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 사용할 수 없으며, 최소 1개의 이미지나 비디오를 포함해야 합니다. Seedance 2.5는 오디오만으로 된 입력을 지원합니다. - 오디오 URL, Base64 인코딩 또는 에셋 ID. -오디오 URL: 오디오의 공개 URL(wav, mp3). -Base64: 형식 data:audio/\;base64,\ -에셋 ID: 형식 asset://\ + 오디오 URL, Base64 인코딩 또는 에셋 ID입니다. +오디오 URL: 오디오(wav, mp3)의 공개 URL입니다. +Base64: 형식은 data:audio/\;base64,\입니다. +에셋 ID: 형식은 asset://\입니다. - Seedance 2.5 전용. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. + Seedance 2.5 전용입니다. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. 최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 전송하지 마십시오. resolution은 기본값이 1080p이며 1080p만 지원합니다. @@ -218,14 +217,14 @@ Base64: 형식 data:audio/\;base64,\ 이미지 기반 비디오 생성용 이미지 콘텐츠입니다(type이 "image_url"인 경우). 이미지 URL: 이미지 URL에 접근할 수 있는지 확인하십시오. Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여야 합니다. -에셋 ID: 형식 asset://\ +에셋 ID: 형식은 asset://\입니다. - 콘텐츠 항목의 역할/위치. -이미지의 경우: first_frame, last_frame 또는 reference_image. -비디오의 경우: reference_video(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). -오디오의 경우: reference_audio(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). + 콘텐츠 항목의 역할/위치입니다. +이미지의 경우: first_frame, last_frame 또는 reference_image입니다. +비디오의 경우: reference_video(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용)입니다. +오디오의 경우: reference_audio(Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용)입니다. 가능한 값: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` @@ -233,7 +232,7 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 모델에 대한 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. -텍스트 프롬프트(필수): 중국어 및 영어 문자를 사용한 생성할 비디오에 대한 설명. +텍스트 프롬프트(필수): 중국어 및 영어 문자로 생성할 비디오를 설명합니다. 파라미터(선택): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어합니다: - --resolution (--rs): 480p, 720p, 1080p (기본값: 720p) @@ -246,86 +245,89 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 예시: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -BytePlus의 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 +BytePlus의 제약이 아닌 Comfy 측의 가드레일입니다. BytePlus는 텍스트 길이 제한을 공개하지 않았으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. 바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 -이 크기의 몇 배가 될 수 있습니다. 이 제한은 이 필드 하나만 제한하며 요청 전체를 -제한하지 않습니다. `content`는 배열이고, 요청 본문 전체를 제한하는 것은 -요청당 본문 제한입니다. 이를 강제하는 표면은 Comfy Router(/v2/models/byteplus/\{model})이며, -직접 v1 /proxy 호출에서는 대신 BytePlus 자체 검증기가 응답합니다. 실제 -트래픽보다 훨씬 높게 설정되어 있어 실제 프롬프트를 판정하는 일이 없습니다. 호출자에게 더 -많은 용량이 필요하면 이 값을 올리세요. +이 크기의 몇 배가 될 수 있습니다. 이 제한은 이 필드 하나만 제한하며 +요청 전체를 제한하지는 않습니다. `content`는 배열이고, 전체 문서는 +요청별 본문 제한에 의해 제한됩니다. 이를 적용하는 것은 Comfy Router +(/v2/models/byteplus/\{model})이며, v1 /proxy를 직접 호출할 때는 +BytePlus 자체 검증기가 대신 응답합니다. 실제 트래픽보다 훨씬 높게 +설정되어 있으므로 정상적인 프롬프트를 거부하는 일은 없습니다. 호출자가 +더 많은 양을 필요로 한다면 이 값을 높이십시오. - 입력 콘텐츠의 유형 + 입력 콘텐츠의 유형입니다 가능한 값: `text`, `image_url`, `video_url`, `audio_url`, `draft_task` - 입력 비디오 객체. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 비디오 입력을 지원합니다. + 입력 비디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 비디오 입력을 지원합니다. - 비디오 URL 또는 에셋 ID. -비디오 URL: 비디오의 공개 URL(mp4, mov). -에셋 ID: 형식 asset://\ + 비디오 URL 또는 에셋 ID입니다. +비디오 URL: 비디오(mp4, mov)의 공개 URL입니다. +에셋 ID: 형식은 asset://\입니다. - Seedance 2.5 전용. 480p Draft 비디오를 생성하며, 해상도는 480p여야 합니다. -반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 1080p 비디오를 렌더링하십시오. Draft 작업 ID는 7일 동안 유효합니다. + Seedance 2.5 전용입니다. 480p Draft 비디오를 생성하며 resolution은 480p여야 합니다. +최종 1080p 비디오를 렌더링하려면 반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하십시오. Draft 작업 ID는 7일 동안 유효합니다. - 비디오 재생 시간(초). Seedance 2.5: [4,30] 또는 -1(자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1(자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. + 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1(자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1(자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. 범위: `2` ~ `30` - 작업 타임아웃 임계값(초). 기본값 172800(48시간). 범위: [3600, 259200]. + 작업 타임아웃 임계값(초)입니다. 기본값 172800(48시간). 범위: [3600, 259200]. 범위: `3600` ~ `259200` - Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 화면과 동기화된 오디오가 포함되는지 여부입니다. -true: 모델이 동기화된 오디오가 있는 비디오를 출력합니다. + Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 시각 요소와 동기화된 오디오가 포함되는지 여부입니다. +true: 모델이 동기화된 오디오가 포함된 비디오를 출력합니다. false: 모델이 무음 비디오를 출력합니다. -이를 지원하는 모델에서는 생성된 오디오 트랙이 비디오와 별도로 제공자에 의해 콘텐츠 검사를 받습니다. 여기서 거부되면 `content_policy_violation`으로 보고되며, 오디오는 실행마다 달라지므로 제공자가 평소 허용하는 입력에서도 간헐적으로 발생할 수 있습니다. 그런 경우 `false`를 보내 무음 비디오를 생성하세요. 이는 오디오가 거부된 모달리티일 때만 도움이 되며, 동기 Router 응답은 이를 `refusal_subject: output_audio`로 표시합니다(대기열에 넣은 요청은 아직 이를 식별하지 않습니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 생성하세요. +On 이를 지원하는 모델에서는 생성된 오디오 트랙을 공급자가 비디오와 별도로 콘텐츠 검사합니다. 여기서 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지므로 공급자가 평소 허용하는 입력에서도 간헐적으로 발생할 수 있습니다. 그런 경우 무음 비디오를 원한다면 `false`를 보내세요. 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 `refusal_subject: output_audio`로 이를 명시합니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 생성하세요. + + - 호출할 모델의 ID. 지원 모델: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini 및 dreamina-seedance-2-5-260628. POST /proxy/byteplus/api/v3/contents/generations/tasks에 대한 직접 v1 호출은 반드시 이를 제공해야 하며, 프록시는 다른 값이나 누락된 값을 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이 값을 채우므로 Router 호출자는 이를 생략하기 때문입니다. + 호출할 모델의 ID입니다. 지원되는 모델: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini 및 dreamina-seedance-2-5-260628. POST /proxy/byteplus/api/v3/contents/generations/tasks에 대한 직접 v1 호출은 반드시 이를 제공해야 합니다. 프록시는 다른 값이나 누락된 값을 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이를 채우기 때문이며, 따라서 Router 호출자는 이를 생략합니다. - Seedance 2.5 전용. 출력 비디오의 컨테이너 형식입니다. -mp4: 범용 컨테이너(H.264/AAC, yuv420p)로 호환성이 넓고 파일 크기가 더 작습니다. -mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색상 정밀도가 높아 후반 작업에 적합하지만 파일 크기가 더 큽니다. + Seedance 2.5 전용입니다. 출력 비디오의 컨테이너 형식입니다. +mp4: 호환성이 넓고 파일 크기가 더 작은 범용 컨테이너(H.264/AAC, yuv420p)입니다. +mov: 색상 정밀도가 높아 후반 작업에 적합한 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)이며 파일 크기가 더 큽니다. 가능한 값: `mp4`, `mov` - 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast 및 2.0 mini, 1.5 pro 기본값: adaptive. -Seedance 2.5의 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`(또는 필드 생략)만 허용되며, 구체적인 비율을 지정하면 디스패치 전에 400 오류로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. + 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. +Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`만(또는 필드 생략만) 허용되며, 구체적인 비율은 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. -참고: Seedance 2.0, 2.0 fast 및 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. + 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast & 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. +참고: Seedance 2.0, 2.0 fast & 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. 가능한 값: `480p`, `720p`, `1080p`, `4k` 생성된 비디오의 마지막 프레임 이미지를 반환할지 여부입니다. -true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정하면 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. +true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정한 후 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 이전에 생성된 비디오의 마지막 프레임이 다음 비디오 작업의 첫 프레임으로 사용되어 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않습니다. @@ -336,33 +338,47 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 처리를 위한 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. + 처리용 서비스 티어입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. 가능한 값: `default`, `flex` - 생성된 비디오에 워터마크가 포함되는지 여부입니다. + 생성된 비디오에 워터마크를 포함할지 여부입니다. -`GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에게 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. +Router가 `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 Router가 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 - 비디오 생성 작업이 완료된 후의 출력입니다. 출력 비디오의 다운로드 URL과, BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체 필드입니다. Null을 허용합니다. BytePlus는 작업 24시간 후 URL을 지우므로, 그 이후에 폴링한 succeeded 문서에는 `content`가 없거나 null일 수 있습니다. + 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지에 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체의 것입니다. Nullable입니다. BytePlus는 작업 후 24시간이 지나면 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. - 생성된 비디오의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정한 경우 반환됩니다. 이 URL에서 이미지 형식을 추론하지 마세요. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하고, Router는 제공받은 바이트를 그대로 재호스팅하며 업스트림 Content-Type 또는 콘텐츠 스니핑으로 타입을 지정합니다. `image/jpeg`는 둘 다 실패했을 때의 최후 수단 대체값일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지로 재호스팅하고 이 필드를 다시 씁니다. 따라서 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL이며, 발급 시점에 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 안 되는 URL이 반환될 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 24시간 후 이를 지웁니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 프레임을 다운로드하세요. + 생성된 비디오의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정했을 때 반환됩니다. 이 URL로 이미지 형식을 추론하지 마세요. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하지만, Router는 제공받은 바이트를 그대로 재호스팅하고 업스트림 Content-Type 또는 콘텐츠 스니핑으로 형식을 지정하며, `image/jpeg`는 둘 다 실패했을 때의 최후 폴백일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지에 재호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 한 시간도 안 되는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지웁니다. 어느 경우든 링크는 만료되므로 URL을 저장하지 말고 프레임을 다운로드하세요. - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환하는 경우입니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많습니다. 최상위 `output_format` 필드를 참고하세요. Router는 둘 중 존재하는 쪽을 읽습니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환하는 경우입니다. Seedance 모델은 이를 `content`의 최상위 형제로 반환하는 경우가 더 많으며(최상위 `output_format` 필드 참조), Router는 둘 중 존재하는 것을 읽습니다. + + + + 업스트림 URL이 작동을 멈추는 RFC 3339 시간입니다. URL 자체가 지니는 가장 이른 서명 시간에 유효 기간을 더한 값이며, `updated_at`이 존재하는 경우 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦지 않고, 그렇지 않으면 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 어느 소스도 시간을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. + + 형식: `date-time` + + + + 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, `upstream_video_url`과 동일한 조건으로 재호스팅된 `last_frame_url` 옆에 바이트 그대로 반환됩니다. 즉 옵트인한 워크스페이스에만, Seedance 2.x에만 해당하며, BytePlus가 지운 뒤에는 없고, `upstream_expires_at`까지는 베어러 자격 증명입니다. + + + + 출력 비디오에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `video_url` 옆에 바이트 그대로 반환됩니다. 서버 측에서 Comfy가 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외 모두에게는 없습니다. 여기에는 워크스페이스로 확인되지 않는 자격 증명(예: 특정 워크스페이스에 한정되지 않은 레거시 API 키)도 포함되며, 생성 후 24시간이 지나 BytePlus가 URL을 지우면 역시 없습니다. 이는 미리 서명된 객체 스토리지 URL이므로 베어러 자격 증명입니다. 이를 가진 사람은 만료 전까지 비디오를 다운로드할 수 있으므로 비밀 정보처럼 다루세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드를 100회로 제한하고 그중 한 번은 Router 자체의 재호스팅이 소비합니다. - 출력 비디오에 대한 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 재호스팅하고 이 필드를 다시 씁니다. 따라서 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL이며, 발급 시점에 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 안 되는 URL이 반환될 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 24시간 후 이를 지우고 일부 모델에서는 다운로드를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. + 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지에 재호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 한 시간도 안 되는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지우고 일부 모델에서는 다운로드를 100회로 제한합니다. 어느 경우든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. @@ -370,7 +386,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 일관성이 없기 때문에 정수 대신 숫자로 선언됩니다. 비디오 작업에서 정수 초를 반환한 사례가 관찰되었고, 인접한 BytePlus 표면에서는 소수 재생 시간을 보고하므로, 클라이언트는 값이 정수라고 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이에 대해 일관성이 없기 때문에 정수가 아닌 숫자로 선언됩니다. 비디오 작업이 정수 초를 반환하는 것이 관측되었고, 같은 BytePlus의 다른 표면은 소수 재생 시간을 보고하므로, 클라이언트는 정수 값을 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. @@ -378,7 +394,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected 및 OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 하나의 계열에 점으로 구분된 사유가 있을 수 있습니다. 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation 또는 OutputImageSensitiveContentDetected.DeepFake 등입니다. 이것은 열거형이 아니라 개방형 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 계열을 인식하며, 전송 실패를 덮어쓰지 않습니다. + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 하나의 계열에 점으로 구분된 사유가 붙을 수 있으며, 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation 또는 OutputImageSensitiveContentDetected.DeepFake와 같습니다. 이는 열린 문자열이며 열거형이 아닙니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 계열을 인식하며, 전송 실패를 덮어쓰지 않습니다. @@ -390,19 +406,19 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 작업에서 사용한 모델의 이름과 버전 + 작업에서 사용된 모델의 이름과 버전 - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, `content`의 형제로 최상위에 반환됩니다. Seedance 비디오 작업 조회가 반환하는 위치가 바로 여기입니다. BytePlus 자체 필드로, 변경 없이 전달됩니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, `content`와 같은 레벨의 최상위에 반환됩니다. Seedance 비디오 작업 조회에서 이 위치에 값을 반환하며, BytePlus 자체 필드 값을 그대로 전달합니다. - 생성된 비디오의 해상도입니다. 예를 들어 `1080p`입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 생성된 비디오의 해상도이며, 예를 들어 `1080p`입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 값을 그대로 전달합니다. - 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. + 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 값을 그대로 전달합니다. 형식: `int64` @@ -426,7 +442,7 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않고 기본값이 0입니다. 따라서 total_tokens = completion_tokens입니다. + 비디오 생성 모델의 경우 입력 토큰 수를 계산하지 않고 0으로 기본 설정합니다. 따라서 total_tokens = completion_tokens입니다. ## 예시 diff --git a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx index 0185e2547f..cdaa6117ea 100644 --- a/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx @@ -2,17 +2,16 @@ title: "Comfy Router에서 Seedance 1.0 Pro Fast 251015 사용하기" description: "Comfy Router를 통해 byteplus/seedance-1-0-pro-fast-251015를 호출하는 방법: 엔드포인트, 요청 형태, Router가 반환하는 응답을 설명합니다." sidebarTitle: "Seedance 1.0 Pro Fast 251015" -translationSourceHash: 600f57b4 +translationSourceHash: 43683424 translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx translationBlockHashes: "_intro": 451ffa4b "Quick start": ec2a21ac - "Schema": 1df5b053 + "Schema": a882b2d8 "Examples": 1469ab97 --- - {/* 생성된 파일. router-schemas/byteplus/seedance-1-0-pro-fast-251015.json에서 `pnpm code-pages:gen`으로 생성됨. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -181,7 +180,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-fast-251015/reque ### 입력 - 이 생성 작업 결과에 대한 콜백 알림 주소입니다. + 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만, 작업이 제출되기 전에 제거되므로 콜백은 절대 전송되지 않습니다. 대신 작업 상태 라우트를 폴링하여 결과를 확인하세요. 형식: `uri` @@ -191,19 +190,19 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-fast-251015/reque - 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 단독으로 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오만 입력하는 것을 지원합니다. + 입력 오디오 객체입니다. 오디오 입력은 Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 사용할 수 없으며, 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오 전용 입력을 지원합니다. 오디오 URL, Base64 인코딩 또는 에셋 ID입니다. -오디오 URL: 오디오의 공개 URL(wav, mp3)입니다. -Base64: 형식은 data:audio/\;base64,\입니다. -에셋 ID: 형식은 asset://\입니다. +오디오 URL: 오디오의 공개 URL입니다(wav, mp3). +Base64: data:audio/\;base64,\ 형식입니다. +에셋 ID: asset://\ 형식입니다. Seedance 2.5 전용입니다. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. -최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 전송하지 마십시오. 해상도는 기본값이 1080p이며 1080p만 지원합니다. +최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 이를 다시 전송하지 마세요. 해상도는 1080p가 기본값이며 1080p만 지원합니다. @@ -215,17 +214,17 @@ Base64: 형식은 data:audio/\;base64,\입니다. - 이미지 기반 비디오 생성용 이미지 콘텐츠입니다(type이 "image_url"인 경우). -이미지 URL: 이미지 URL에 접근할 수 있는지 확인하십시오. -Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여야 합니다. -에셋 ID: 형식은 asset://\입니다. + 이미지 기반 비디오 생성을 위한 이미지 콘텐츠입니다(type이 "image_url"인 경우). +이미지 URL: 이미지 URL에 접근할 수 있는지 확인하세요. +Base64 인코딩 콘텐츠: data:image/\;base64,\ 형식이어야 합니다. +에셋 ID: asset://\ 형식입니다. 콘텐츠 항목의 역할/위치입니다. -이미지의 경우: first_frame, last_frame 또는 reference_image. -비디오의 경우: reference_video (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 해당). -오디오의 경우: reference_audio (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 해당). +이미지: first_frame, last_frame 또는 reference_image. +비디오: reference_video (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). +오디오: reference_audio (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). 가능한 값: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` @@ -235,7 +234,7 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 텍스트 프롬프트(필수): 중국어 및 영어 문자를 사용하여 생성할 비디오에 대한 설명입니다. -파라미터(선택 사항): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어합니다: +파라미터(선택): 비디오 사양을 제어하려면 텍스트 프롬프트 뒤에 --[parameters]를 추가하세요: - --resolution (--rs): 480p, 720p, 1080p (기본값: 720p) - --ratio (--rt): 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, 9:21, adaptive (기본값: 16:9 또는 adaptive) - --duration (--dur): 3-12초 (기본값: 5) @@ -246,8 +245,9 @@ Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여 예: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -BytePlus의 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 텍스트 길이 제한을 공개하지 않았으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. -바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 몇 배가 될 수 있습니다. 이 제한은 요청 전체가 아니라 이 필드 하나를 제한합니다. `content`는 배열이며, 전체 문서를 제한하는 것은 요청당 본문 제한입니다. 이를 적용하는 표면은 Comfy Router(/v2/models/byteplus/\{model})이며, 직접 v1 /proxy 호출에서는 대신 BytePlus 자체 검증기가 응답합니다. 실제 트래픽보다 훨씬 높게 설정되어 있어 실제 프롬프트를 판정하는 일이 없습니다. 호출자에게 더 많은 용량이 필요하면 이 값을 높이십시오. +Comfy 측 가드레일이며 BytePlus의 제약이 아닙니다. BytePlus는 텍스트 길이 제한을 공개하지 않으며, 테스트(2026-09-17)에서 40,000자를 허용했습니다. +바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 몇 배가 될 수 있습니다. 이 값은 요청 전체가 아니라 이 단일 필드만 제한합니다. +`content`는 배열이며, 전체 문서는 요청당 본문 제한으로 제한됩니다. 이를 적용하는 표면은 Comfy Router(/v2/models/byteplus/\{model})이며, v1 /proxy를 직접 호출하면 대신 BytePlus 자체 검증기가 응답합니다. 실제 프롬프트를 판정하는 일이 없도록 실제 트래픽보다 훨씬 높게 설정되어 있으므로, 호출자가 더 필요하면 값을 높이세요. @@ -257,18 +257,18 @@ BytePlus의 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 텍스 - 입력 비디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 비디오 입력을 지원합니다. + 입력 비디오 객체입니다. 비디오 입력은 Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 지원합니다. 비디오 URL 또는 에셋 ID입니다. -비디오 URL: 비디오의 공개 URL(mp4, mov)입니다. -에셋 ID: 형식은 asset://\입니다. +비디오 URL: 비디오의 공개 URL입니다(mp4, mov). +에셋 ID: asset://\ 형식입니다. Seedance 2.5 전용입니다. 480p Draft 비디오를 생성하며, 해상도는 480p여야 합니다. -반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하여 최종 1080p 비디오를 렌더링하십시오. Draft 작업 ID는 7일 동안 유효합니다. +최종 1080p 비디오를 렌더링하려면 반환된 작업 ID를 `draft_task` 콘텐츠 항목에 전달하세요. Draft 작업 ID는 7일 동안 유효합니다. @@ -278,47 +278,46 @@ BytePlus의 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 텍스 - 작업 타임아웃 임계값(초)입니다. 기본값 172800(48시간). 범위: [3600, 259200]. + 작업 타임아웃 임계값(초)입니다. 기본값 172800 (48시간). 범위: [3600, 259200]. 범위: `3600` ~ `259200` - Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 화면과 동기화된 오디오가 포함되는지 여부입니다. + Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 시각 요소와 동기화된 오디오가 포함되는지 여부입니다. true: 모델이 동기화된 오디오가 포함된 비디오를 출력합니다. -false: 모델이 무음 비디오를 출력합니다. -이를 지원하는 모델에서는 생성된 오디오 트랙이 비디오와 별도로 제공자에 의해 콘텐츠 검사를 받습니다. 여기서 거부되면 `content_policy_violation`으로 보고되며, 오디오는 실행마다 달라지므로 제공자가 평소 허용하는 입력에서도 간헐적으로 발생할 수 있습니다. 그런 경우 `false`를 보내 무음 비디오를 생성하세요. 이는 오디오가 거부된 모달리티일 때만 도움이 되며, 동기 Router 응답은 이를 `refusal_subject: output_audio`로 표시합니다(대기열에 넣은 요청은 아직 이를 식별하지 않습니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 생성하세요. +false: 모델이 무음 비디오를 출력합니다.이를 지원하는 모델에서는 생성된 오디오 트랙을 공급자가 비디오와 별도로 콘텐츠 검사합니다. 여기서 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지기 때문에 공급자가 그 외에는 허용하는 입력에 대해서도 간헐적으로 발생할 수 있습니다. 그런 경우 무음 비디오를 원한다면 `false`를 보내세요. 이는 거부된 양식이 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 `refusal_subject: output_audio`로 이를 명시합니다(대기 중인 요청은 아직 이를 식별하지 못합니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 Draft를 `false`로 다시 생성하세요. - 호출할 모델의 ID입니다. 지원되는 모델: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini 및 dreamina-seedance-2-5-260628. POST /proxy/byteplus/api/v3/contents/generations/tasks에 대한 직접 v1 호출은 반드시 이를 제공해야 합니다. 프록시는 다른 값이나 누락된 값을 400으로 거부합니다. Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이 값을 채우므로 Router 호출자는 이를 생략하기 때문에, 이 필드는 이 스키마의 `required` 목록에 없습니다. + 호출할 모델의 ID입니다. 지원되는 모델: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini, dreamina-seedance-2-5-260628. POST /proxy/byteplus/api/v3/contents/generations/tasks에 대한 직접 v1 호출은 반드시 이 값을 제공해야 합니다. 프록시는 다른 값이나 누락된 값을 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이 값을 채우기 때문이며, 따라서 Router 호출자는 이를 생략합니다. Seedance 2.5 전용입니다. 출력 비디오의 컨테이너 형식입니다. mp4: 범용 컨테이너(H.264/AAC, yuv420p)로 호환성이 넓고 파일 크기가 더 작습니다. -mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색상 정밀도가 높아 후반 작업에 적합하지만 파일 크기가 더 큽니다. +mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색상 정밀도가 높아 후반 작업에 적합하며, 파일 크기가 더 큽니다. - 사용 가능한 값: `mp4`, `mov` + 가능한 값: `mp4`, `mov` - 생성된 비디오의 종횡비입니다. Seedance 2.0, 2.0 fast 및 2.0 mini, 1.5 pro 기본값: adaptive. -Seedance 2.5의 첫 프레임 / 첫 프레임-마지막 프레임 생성: 출력은 첫 프레임의 종횡비를 따르므로 `adaptive`만(또는 필드 생략) 허용되며, 구체적인 비율을 지정하면 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. + 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. +Seedance 2.5 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`만(또는 필드를 생략하는 것만) 허용되며, 구체적인 비율은 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 이러한 모드에서 구체적인 비율을 허용합니다. - 사용 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` + 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - 비디오 해상도. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro 및 pro-fast 기본값: 1080p. -참고: Seedance 2.0, 2.0 fast 및 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. + 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast & 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. +참고: Seedance 2.0, 2.0 fast & 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. - 사용 가능한 값: `480p`, `720p`, `1080p`, `4k` + 가능한 값: `480p`, `720p`, `1080p`, `4k` 생성된 비디오의 마지막 프레임 이미지를 반환할지 여부입니다. -참: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 파라미터를 true로 설정한 후 비디오 생성 작업 정보 조회를 호출하면 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 파라미터를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다: 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. +true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정한 후 비디오 생성 작업 정보 조회를 호출하면 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다: 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않습니다. @@ -329,41 +328,55 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 - 처리를 위한 서비스 등급입니다. Seedance 2.5, 2.0 및 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. + 처리를 위한 서비스 등급입니다. Seedance 2.5, 2.0 & 2.0 fast는 flex(오프라인 추론)를 지원하지 않습니다. - 사용 가능한 값: `default`, `flex` + 가능한 값: `default`, `flex` 생성된 비디오에 워터마크가 포함되는지 여부입니다. -Router가 `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에게 도달하기 전에 호출을 검증할 때 사용하는 것과 동일한 문서입니다. +`GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json`에서 Router가 제공하는 스키마로 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 - 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과, BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체 필드입니다. Nullable: BytePlus는 작업 후 24시간이 지나면 URL을 삭제하므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. + 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체 필드입니다. null일 수 있습니다: BytePlus는 작업 후 24시간이 지나면 URL을 지우므로, 그 이후에 폴링된 성공 문서는 `content`가 없거나 null일 수 있습니다. - 생성된 비디오의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정한 경우 반환됩니다. 이 URL로 이미지 형식을 추측하지 마세요. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하지만, Router는 전달받은 바이트를 그대로 재호스팅하고 업스트림 Content-Type 또는 콘텐츠 스니핑으로 형식을 판별하며, `image/jpeg`는 둘 다 실패했을 때의 최후 대체값일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지로 재호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시점에 24시간으로 서명되고 23시간짜리 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 한 시간도 되지 않는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 대신 BytePlus 자체 URL이 유지되며, BytePlus는 작업 후 24시간이 지나면 이를 삭제합니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 프레임을 다운로드하세요. + 요청에서 `return_last_frame`을 설정했을 때 반환되는, 생성된 비디오의 마지막 프레임에 대한 다운로드 URL입니다. 이 URL에서 이미지 형식을 추론하지 마십시오. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하고, Router는 전달받은 바이트를 그대로 재호스팅하며 업스트림 Content-Type 또는 콘텐츠 스니핑으로 형식을 지정합니다. `image/jpeg`는 둘 다 실패했을 때의 최후 수단 폴백일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지로 재호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시점에 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 1시간도 되지 않을 수 있습니다. 재호스팅을 수행할 수 없었을 때는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지웁니다. 어느 경우든 링크는 만료되므로 URL을 저장하지 말고 프레임을 다운로드하십시오. - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 넣는 경우입니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많으며(최상위 `output_format` 필드 참고), Router는 둘 중 존재하는 값을 읽습니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환할 때 존재합니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많으므로 최상위 `output_format` 필드를 참고하십시오. Router는 둘 중 존재하는 쪽을 읽습니다. + + + + 업스트림 URL이 작동을 멈추는 RFC 3339 시각입니다. 가장 이른 서명 시각에 URL 자체가 지니는 유효 기간을 더한 값이며, `updated_at`이 존재할 때는 작업의 `updated_at`에 24시간(BytePlus가 문서화한 URL 수명)을 더한 값보다 늦지 않습니다. `updated_at`이 없으면 작업의 `updated_at`에 24시간을 더한 값입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 어느 소스도 시각을 제공하지 않으면 생략됩니다. 재호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. + + 형식: `date-time` + + + + 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `last_frame_url` 옆에 바이트 단위로 그대로 반환되며 조건은 `upstream_video_url`과 같습니다. 옵트인한 워크스페이스에만, Seedance 2.x에만 해당하고, BytePlus가 지우면 사라지며, `upstream_expires_at`까지는 베어러 자격 증명입니다. + + + + 출력 비디오에 대한 BytePlus 자체 다운로드 URL로, 재호스팅된 `video_url` 옆에 바이트 단위로 그대로 반환됩니다. Comfy가 서버 측에서 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재합니다(요청 파라미터는 없습니다). 그 외의 경우에는 존재하지 않으며, 워크스페이스로 확인되지 않는 자격 증명(예: 특정 워크스페이스에 한정되지 않은 레거시 API 키)도 마찬가지이고, 생성 후 24시간이 지나 BytePlus가 URL을 지우면 존재하지 않습니다. 사전 서명된 객체 스토리지 URL이므로 베어러 자격 증명입니다. 이를 가진 사람은 만료될 때까지 비디오를 다운로드할 수 있으므로 비밀 정보처럼 다루십시오. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드 횟수를 100회로 제한하는데, 그중 한 번은 Router 자체의 재호스팅이 소모합니다. - 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 재호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시점에 24시간으로 서명되고 23시간짜리 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 한 시간도 되지 않는 URL을 받을 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 대신 BytePlus 자체 URL이 유지되며, BytePlus는 작업 후 24시간이 지나면 이를 삭제하고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 쪽이든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. + 출력 비디오에 대한 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 재호스팅하고 이 필드를 다시 쓰므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시점에 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 유효 시간이 1시간도 되지 않을 수 있습니다. 재호스팅을 수행할 수 없었을 때는 이 필드가 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 경우든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하십시오. - 작업이 생성된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다. + 작업이 생성된 시각입니다. 값은 초 단위의 UNIX 타임스탬프입니다. - 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값을 일관되게 다루지 않기 때문에 정수가 아닌 숫자로 선언됩니다. 비디오 작업에서는 정수 초를 반환한 사례가 관찰되었고, 인접한 다른 BytePlus 인터페이스에서는 소수 재생 시간을 보고하므로, 클라이언트는 값이 정수라고 가정해서는 안 됩니다. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되어 변경 없이 전달됩니다. + 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이 값에 일관성이 없기 때문에 정수가 아닌 숫자로 선언됩니다. 비디오 작업이 정수 초를 반환하는 사례가 관찰되었고, 인접한 BytePlus 표면은 소수 재생 시간을 보고합니다. 따라서 클라이언트는 값이 정수라고 가정해서는 안 됩니다. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되어 변경 없이 전달됩니다. @@ -371,7 +384,7 @@ Router가 `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json`에 - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 하나의 패밀리에 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake처럼 점으로 구분된 사유가 붙을 수 있습니다. 이는 열거형이 아니라 개방형 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 패밀리를 인식하며, 전송 실패를 덮어쓰지는 않습니다. + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 계열에는 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation, OutputImageSensitiveContentDetected.DeepFake처럼 점으로 구분된 사유가 붙을 수 있습니다. 이것은 열거형이 아닌 열린 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 계열을 인식하며, 전송 실패를 덮어쓰지 않습니다. @@ -383,25 +396,25 @@ Router가 `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json`에 - 작업에 사용된 모델의 이름과 버전 + 작업에서 사용한 모델의 이름과 버전 - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, `content`의 형제로 최상위 수준에서 반환됩니다. Seedance 비디오 작업 조회가 반환하는 위치가 바로 여기입니다. BytePlus 자체 필드이며, 변경 없이 전달됩니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, `content`의 형제 요소로 최상위 레벨에서 반환됩니다. Seedance 비디오 작업 조회가 이 위치에서 값을 반환합니다. BytePlus 자체 필드이며 변경 없이 전달됩니다. - 생성된 비디오의 해상도입니다(예: `1080p`). BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되어 변경 없이 전달됩니다. + 생성된 비디오의 해상도입니다. 예: `1080p`. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. - 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드이며, 성공한 비디오 작업에서 반환되어 변경 없이 전달됩니다. + 해당 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. 형식: `int64` - 작업의 상태 + 작업 상태 가능한 값: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` @@ -419,7 +432,7 @@ Router가 `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json`에 - 비디오 생성 모델의 경우 입력 토큰 수를 계산하지 않고 0으로 기본 설정합니다. 따라서 total_tokens = completion_tokens입니다. + 비디오 생성 모델의 경우 입력 토큰 수는 계산되지 않고 0으로 기본 설정됩니다. 따라서 total_tokens = completion_tokens입니다. ## 예시 diff --git a/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx b/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx index 92c49acdba..1775147352 100644 --- a/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx +++ b/ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx @@ -2,17 +2,16 @@ title: "Comfy Router로 Seedance 1.5 Pro 251215 사용하기" description: "Comfy Router를 통해 byteplus/seedance-1-5-pro-251215를 호출합니다: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답을 설명합니다." sidebarTitle: "Seedance 1.5 Pro 251215" -translationSourceHash: 13f3fe20 +translationSourceHash: 1d016721 translationFrom: development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx translationBlockHashes: "_intro": 5f93a1f1 "Quick start": 71aafccf - "Schema": 6d6d6ec1 + "Schema": 35f3b5dc "Examples": 7e73ac5c --- - {/* 생성된 파일. `pnpm code-pages:gen`에 의해 router-schemas/byteplus/seedance-1-5-pro-251215.json에서 생성되었습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -181,7 +180,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-5-pro-251215/requests/$ ### 입력 - 이 생성 작업의 결과를 받을 콜백 알림 주소입니다. + 무시됩니다. BytePlus 요청 형태와의 호환성을 위해 허용되지만 작업이 제출되기 전에 제거되므로 콜백은 절대 전송되지 않습니다. 대신 결과는 작업 상태 라우트를 폴링하세요. 형식: `uri` @@ -191,19 +190,19 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-5-pro-251215/requests/$ - 입력 오디오 객체입니다. 오디오 입력은 Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 지원합니다. Seedance 2.0, 2.0 fast 및 2.0 mini는 오디오만 사용할 수 없으며 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오만 입력하는 것을 지원합니다. + 입력 오디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast, 2.0 mini만 오디오 입력을 지원합니다. Seedance 2.0, 2.0 fast, 2.0 mini는 오디오만 사용할 수 없으며 최소 1개의 이미지 또는 비디오를 포함해야 합니다. Seedance 2.5는 오디오 전용 입력을 지원합니다. 오디오 URL, Base64 인코딩 또는 에셋 ID입니다. -오디오 URL: 오디오의 공개 URL(wav, mp3)입니다. -Base64: data:audio/\;base64,\ 형식입니다. -에셋 ID: asset://\ 형식입니다. +오디오 URL: 오디오의 공개 URL (wav, mp3). +Base64: 형식 data:audio/\;base64,\ +에셋 ID: 형식 asset://\ Seedance 2.5 전용입니다. 최종 비디오로 렌더링할 Draft 작업입니다. 유일한 콘텐츠 항목이어야 합니다. -최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 전송하지 마세요. 해상도는 기본값이 1080p이며 1080p만 지원합니다. +최종 비디오는 Draft 작업의 프롬프트, 입력 에셋, 재생 시간, 비율, 시드, generate_audio 및 omni_reference_task_type을 재사용하므로 다시 보내지 마세요. 해상도는 기본값이 1080p이며 1080p만 지원합니다. @@ -215,17 +214,17 @@ Base64: data:audio/\;base64,\ 형식입니다. - 이미지 기반 비디오 생성을 위한 이미지 콘텐츠입니다(type이 "image_url"인 경우). + 이미지 기반 비디오 생성을 위한 이미지 콘텐츠입니다 (type이 "image_url"인 경우). 이미지 URL: 이미지 URL에 접근할 수 있는지 확인하세요. -Base64 인코딩 콘텐츠: data:image/\;base64,\ 형식이어야 합니다. -에셋 ID: asset://\ 형식입니다. +Base64 인코딩 콘텐츠: 형식은 data:image/\;base64,\여야 합니다. +에셋 ID: 형식 asset://\ 콘텐츠 항목의 역할/위치입니다. -이미지: first_frame, last_frame 또는 reference_image. -비디오: reference_video (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). -오디오: reference_audio (Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini 전용). +이미지의 경우: first_frame, last_frame 또는 reference_image. +비디오의 경우: reference_video (Seedance 2.5, 2.0, 2.0 fast, 2.0 mini만 해당). +오디오의 경우: reference_audio (Seedance 2.5, 2.0, 2.0 fast, 2.0 mini만 해당). 가능한 값: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` @@ -233,9 +232,9 @@ Base64 인코딩 콘텐츠: data:image/\;base64,\ 형식이어 모델에 대한 입력 텍스트 정보입니다. 텍스트 프롬프트와 선택적 파라미터를 포함합니다. -텍스트 프롬프트(필수): 중국어 및 영어 문자를 사용하여 생성할 비디오를 설명합니다. +텍스트 프롬프트 (필수): 중국어 및 영어 문자로 생성할 비디오를 설명합니다. -파라미터(선택): 비디오 사양을 제어하려면 텍스트 프롬프트 뒤에 --[parameters]를 추가하세요: +파라미터 (선택): 텍스트 프롬프트 뒤에 --[parameters]를 추가하여 비디오 사양을 제어합니다: - --resolution (--rs): 480p, 720p, 1080p (기본값: 720p) - --ratio (--rt): 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, 9:21, adaptive (기본값: 16:9 또는 adaptive) - --duration (--dur): 3-12초 (기본값: 5) @@ -244,9 +243,17 @@ Base64 인코딩 콘텐츠: data:image/\;base64,\ 형식이어 - --seed (--seed): -1 ~ 2^32-1 (기본값: -1) - --camerafixed (--cf): true/false (기본값: false) -예: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" - -BytePlus의 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 텍스트 길이 제한을 공개하지 않았으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. 바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 몇 배가 될 수 있습니다. 이 제한은 요청이 아니라 이 단일 필드에 적용됩니다. `content`는 배열이며, 전체 문서를 제한하는 것은 요청별 본문 제한입니다. 이를 강제하는 표면은 Comfy Router(/v2/models/byteplus/\{model})입니다. 직접 v1 /proxy 호출에서는 대신 BytePlus 자체 검증기가 응답합니다. 실제 트래픽보다 훨씬 높게 설정되어 실제 프롬프트를 판정하는 일이 없도록 합니다. 호출자가 더 필요하면 값을 높이세요. +예시: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" + +Comfy 측 가드레일이며 BytePlus의 제약이 아닙니다. BytePlus는 텍스트 길이 제한을 +공개하지 않으며 테스트(2026-09-17)에서 40,000자를 허용했습니다. +바이트가 아닌 문자를 세므로 멀티바이트 프롬프트는 전송 시 이 크기의 +몇 배가 될 수 있습니다. 이 제한은 요청 전체가 아니라 이 단일 필드에 +적용됩니다. `content`는 배열이며, 전체 문서의 범위를 정하는 것은 +요청당 본문 제한입니다. 이를 강제하는 표면은 Comfy Router(/v2/models/byteplus/\{model})이며, +v1 /proxy를 직접 호출할 때는 대신 BytePlus 자체 검증기가 응답합니다. +실제 트래픽보다 훨씬 높게 설정되어 있어 실제 프롬프트를 판정하는 일이 +없습니다. 호출자가 더 필요로 하면 이 값을 올리세요. @@ -256,13 +263,13 @@ BytePlus의 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 텍스 - 입력 비디오 객체입니다. 비디오 입력은 Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini만 지원합니다. + 입력 비디오 객체입니다. Seedance 2.5, 2.0, 2.0 fast, 2.0 mini만 비디오 입력을 지원합니다. 비디오 URL 또는 에셋 ID입니다. -비디오 URL: 비디오의 공개 URL(mp4, mov)입니다. -에셋 ID: asset://\ 형식입니다. +비디오 URL: 비디오의 공개 URL (mp4, mov). +에셋 ID: 형식 asset://\ @@ -271,53 +278,52 @@ BytePlus의 제약이 아닌 Comfy 측 가드레일입니다. BytePlus는 텍스 - 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1(자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast 및 2.0 mini: [4,15] 또는 -1(자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. + 비디오 재생 시간(초)입니다. Seedance 2.5: [4,30] 또는 -1 (자동, 비디오 편집 작업은 -1만 지원). Seedance 2.0, 2.0 fast, 2.0 mini: [4,15] 또는 -1 (자동). Seedance 1.5 pro: [4,12] 또는 -1. Seedance 1.0: [2,12]. 범위: `2` ~ `30` - 작업 타임아웃 임계값(초)입니다. 기본값 172800(48시간). 범위: [3600, 259200]. + 작업 타임아웃 임계값(초)입니다. 기본값 172800 (48시간). 범위: [3600, 259200]. 범위: `3600` ~ `259200` - Seedance 2.5, 2.0, 2.0 fast, 2.0 mini 및 1.5 pro에서 지원됩니다. 생성된 비디오에 시각적 요소와 동기화된 오디오가 포함되는지 여부입니다. -true: 모델이 동기화된 오디오가 있는 비디오를 출력합니다. -false: 모델이 무음 비디오를 출력합니다. -이를 지원하는 모델에서는 생성된 오디오 트랙이 비디오와 별도로 제공자에 의해 콘텐츠 검사를 받습니다. 여기서 거부되면 `content_policy_violation`으로 보고되며, 오디오는 실행마다 달라지므로 제공자가 평소 허용하는 입력에서도 간헐적으로 발생할 수 있습니다. 그런 경우 `false`를 보내 무음 비디오를 생성하세요. 이는 오디오가 거부된 모달리티일 때만 도움이 되며, 동기 Router 응답은 이를 `refusal_subject: output_audio`로 표시합니다(대기열에 넣은 요청은 아직 이를 식별하지 않습니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 `false`로 Draft를 다시 생성하세요. + Seedance 2.5, 2.0, 2.0 fast, 2.0 mini, 1.5 pro에서 지원됩니다. 생성된 비디오에 시각 요소와 동기화된 오디오가 포함되는지 여부입니다. +true: 모델이 동기화된 오디오가 포함된 비디오를 출력합니다. +false: 모델이 무음 비디오를 출력합니다.이를 지원하는 모델에서는 생성된 오디오 트랙을 비디오와 별도로 공급자가 콘텐츠 검사합니다. 여기서 거부가 발생하면 `content_policy_violation`으로 보고되며, 오디오는 실행할 때마다 달라지기 때문에 공급자가 평소에는 허용하는 입력에서도 간헐적으로 나타날 수 있습니다. 그런 경우 무음 비디오를 원한다면 `false`를 보내세요. 다만 이는 거부된 모달리티가 오디오였을 때만 도움이 되며, 동기 Router 응답에서는 이를 `refusal_subject: output_audio`로 명시합니다(대기 중인 요청은 아직 이를 식별하지 않습니다). Seedance 2.5 최종 렌더는 Draft 작업에서 `generate_audio`를 상속하므로, 대신 Draft를 `false`로 다시 생성하세요. - 호출할 모델의 ID입니다. 지원 모델: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini 및 dreamina-seedance-2-5-260628. POST /proxy/byteplus/api/v3/contents/generations/tasks에 대한 직접 v1 호출은 반드시 이를 제공해야 합니다. 프록시는 다른 값이나 누락된 값에 대해 400으로 거부합니다. 이 스키마의 `required` 목록에 없는 이유는 Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이를 채우므로 Router 호출자는 이를 생략하기 때문입니다. + 호출할 모델의 ID입니다. 지원 모델: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini 및 dreamina-seedance-2-5-260628. POST /proxy/byteplus/api/v3/contents/generations/tasks로 직접 v1 호출을 할 때는 반드시 이 값을 제공해야 합니다. 프록시는 다른 값이나 누락된 값 모두 400으로 거부합니다. 이 필드는 이 스키마의 `required` 목록에 없습니다. Comfy Router가 /v2/models/byteplus/\{model}의 `{model}` 경로 세그먼트에서 이 값을 채우므로, Router 호출자는 이 필드를 생략합니다. Seedance 2.5 전용입니다. 출력 비디오의 컨테이너 형식입니다. mp4: 범용 컨테이너(H.264/AAC, yuv420p)로 호환성이 넓고 파일 크기가 더 작습니다. -mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색 정밀도가 높아 후반 작업에 적합하지만 파일 크기가 더 큽니다. +mov: 전문가용 컨테이너(H.264 High 4:4:4 Predictive/PCM, yuv444p)로 색상 정밀도가 높아 후반 작업에 적합하지만 파일 크기가 더 큽니다. 가능한 값: `mp4`, `mov` - 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast 및 2.0 mini, 1.5 pro 기본값: adaptive. -Seedance 2.5의 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`(또는 필드 생략)만 허용되며, 구체적인 비율을 지정하면 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. + 생성된 비디오의 화면 비율입니다. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro 기본값: adaptive. +Seedance 2.5의 첫 프레임 / 첫-마지막 프레임 생성: 출력은 첫 프레임의 화면 비율을 따르므로 `adaptive`만(또는 필드를 생략하는 것만) 허용되며, 구체적인 비율을 지정하면 디스패치 전에 400으로 거부됩니다. Seedance 2.0은 해당 모드에서 구체적인 비율을 허용합니다. 가능한 값: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast 및 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. -참고: Seedance 2.0, 2.0 fast 및 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. + 비디오 해상도입니다. Seedance 2.5, 2.0, 2.0 fast & 2.0 mini, 1.5 pro, 1.0 lite 기본값: 720p. Seedance 1.0 pro & pro-fast 기본값: 1080p. +참고: Seedance 2.0, 2.0 fast & 2.0 mini는 1080p를 지원하지 않습니다. Seedance 2.5는 480p, 720p, 1080p를 지원합니다. 가능한 값: `480p`, `720p`, `1080p`, `4k` 생성된 비디오의 마지막 프레임 이미지를 반환할지 여부입니다. -true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정한 후 비디오 생성 작업 정보 조회를 호출하면 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 즉, 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 여러 개의 연속된 비디오를 빠르게 생성할 수 있습니다. +true: 생성된 비디오의 마지막 프레임 이미지를 반환합니다. 이 매개변수를 true로 설정하면 비디오 생성 작업 정보 조회를 호출하여 마지막 프레임 이미지를 얻을 수 있습니다. 마지막 프레임 이미지는 PNG 형식이며 픽셀 너비와 높이가 생성된 비디오와 동일하고 워터마크가 포함되지 않습니다. 이 매개변수를 사용하면 여러 개의 연속된 비디오를 생성할 수 있습니다. 즉, 이전에 생성된 비디오의 마지막 프레임을 다음 비디오 작업의 첫 프레임으로 사용하여 연속된 비디오를 빠르게 생성할 수 있습니다. false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않습니다. @@ -337,32 +343,46 @@ false: 생성된 비디오의 마지막 프레임 이미지를 반환하지 않 생성된 비디오에 워터마크가 포함되는지 여부입니다. -Router가 `GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. +`GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json`에서 Router가 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. ### 출력 - 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지로 재호스팅되며, 여기에 있는 다른 모든 필드는 BytePlus의 것입니다. Nullable: BytePlus는 작업 24시간 후 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. + 비디오 생성 작업이 완료된 후의 출력으로, 출력 비디오의 다운로드 URL과 BytePlus가 반환하는 경우 마지막 프레임의 다운로드 URL을 포함합니다. `video_url`과 `last_frame_url`은 모두 Comfy 스토리지에 다시 호스팅되며, 여기의 다른 모든 필드는 BytePlus 자체 필드입니다. null 허용: BytePlus는 작업 후 24시간이 지나면 URL을 지우므로, 그 이후에 폴링한 성공 문서는 `content`가 없거나 null일 수 있습니다. - 생성된 비디오의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정했을 때 반환됩니다. 이 URL로 이미지 형식을 추론하지 마세요. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하지만, Router는 제공받은 바이트를 그대로 재호스팅하고 업스트림 Content-Type 또는 콘텐츠 스니핑으로 형식을 판별하며, `image/jpeg`는 둘 다 실패했을 때의 최후 수단 폴백일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지로 재호스팅하고 이 필드를 다시 씁니다. 따라서 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 1시간도 남지 않은 URL이 반환될 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus의 자체 URL을 유지하며, BytePlus는 작업 24시간 후 이를 지웁니다. 어느 경우든 링크는 만료되므로, URL을 저장하지 말고 프레임을 다운로드하세요. + 생성된 비디오의 마지막 프레임에 대한 다운로드 URL로, 요청에서 `return_last_frame`을 설정한 경우 반환됩니다. 이 URL로 이미지 형식을 추론하지 마세요. BytePlus는 요청 측에서 마지막 프레임을 PNG로 문서화하지만, Router는 제공받은 바이트를 그대로 다시 호스팅하고 업스트림 Content-Type 또는 콘텐츠 스니핑으로 형식을 지정하며, `image/jpeg`는 둘 다 실패했을 때의 최후 수단 폴백일 뿐입니다. Router는 마지막 프레임을 Comfy 스토리지에 다시 호스팅하고 이 필드를 다시 작성하므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 안 되는 URL을 받을 수 있습니다. 다시 호스팅을 수행할 수 없었을 때는 이 필드가 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지웁니다. 어느 경우든 링크는 만료되므로 URL을 저장하지 말고 프레임을 다운로드하세요. - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 `content` 안에 중첩해 반환할 때 존재합니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많으며(최상위 `output_format` 필드 참조), Router는 둘 중 존재하는 쪽을 읽습니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, BytePlus가 이를 `content` 안에 중첩해 반환하는 경우입니다. Seedance 모델은 이를 `content`의 최상위 형제 필드로 반환하는 경우가 더 많습니다. 최상위 `output_format` 필드를 참고하세요. Router는 둘 중 존재하는 것을 읽습니다. + + + + 업스트림 URL이 작동을 멈추는 RFC 3339 시간: URL 자체가 지니는 가장 이른 서명 시간에 유효 기간을 더한 값이며, `updated_at`이 있으면 작업의 `updated_at` 더하기 24시간(BytePlus가 문서화한 URL 수명)을 넘지 않고, 그렇지 않으면 작업의 `updated_at` 더하기 24시간입니다. `upstream_video_url` 또는 `upstream_last_frame_url`이 있을 때만 존재하며, 어느 소스도 시간을 제공하지 않으면 생략됩니다. 다시 호스팅된 `video_url` / `last_frame_url`의 수명과는 무관합니다. + + 형식: `date-time` + + + + 마지막 프레임에 대한 BytePlus 자체 다운로드 URL로, 다시 호스팅된 `last_frame_url` 옆에 `upstream_video_url`과 동일한 조건으로 바이트 단위 그대로 반환됩니다: 옵트인한 워크스페이스 전용, Seedance 2.x 전용, BytePlus가 지우면 없음, 그리고 `upstream_expires_at`까지는 베어러 자격 증명입니다. + + + + 출력 비디오에 대한 BytePlus 자체 다운로드 URL로, 다시 호스팅된 `video_url` 옆에 바이트 단위 그대로 반환됩니다. 서버 측에서 Comfy가 옵트인한 워크스페이스가 폴링한 Seedance 2.x 작업에만 존재하며(요청 파라미터는 없습니다), 그 외에는 모두 없습니다. 워크스페이스로 확인되지 않는 자격 증명(예: 워크스페이스에 범위가 지정되지 않은 레거시 API 키)도 포함됩니다. 또한 생성 후 24시간이 지나 BytePlus가 URL을 지우면 없습니다. 이는 presigned 객체 스토리지 URL이므로 베어러 자격 증명입니다. 이를 가진 사람은 만료될 때까지 비디오를 다운로드할 수 있으므로 비밀처럼 다루세요. `upstream_expires_at`에 만료되며, Seedance 2.5에서는 BytePlus가 다운로드 횟수를 100회로 제한하고 그중 하나는 Router 자체의 다시 호스팅이 소비합니다. - 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지로 재호스팅하고 이 필드를 다시 씁니다. 따라서 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 1시간도 남지 않은 URL이 반환될 수 있습니다. 재호스팅을 수행할 수 없었던 경우에는 이 필드가 BytePlus의 자체 URL을 유지하며, BytePlus는 작업 24시간 후 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 경우든 링크는 만료되므로, URL을 저장하지 말고 비디오를 다운로드하세요. + 출력 비디오의 다운로드 URL입니다. Router는 비디오를 Comfy 스토리지에 다시 호스팅하고 이 필드를 다시 작성하므로, 일반적으로 최대 24시간 동안 유효한 Comfy 서명 URL입니다. 발급 시 24시간으로 서명되고 23시간 메모에서 재생되므로, 나중에 폴링하면 남은 시간이 1시간도 안 되는 URL을 받을 수 있습니다. 다시 호스팅을 수행할 수 없었을 때는 이 필드가 대신 BytePlus 자체 URL을 유지하며, BytePlus는 작업 후 24시간이 지나면 이를 지우고 일부 모델에서는 다운로드 횟수를 100회로 제한합니다. 어느 경우든 링크는 만료되므로 URL을 저장하지 말고 비디오를 다운로드하세요. - 작업이 생성된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다. + 작업이 생성된 시간입니다. 값은 초 단위 UNIX 타임스탬프입니다. - 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이를 일관되게 다루지 않기 때문에 정수가 아닌 숫자로 선언됩니다. 비디오 작업에서 정수 초를 반환한 사례가 관찰되었고, 인접한 BytePlus 표면에서는 소수점 재생 시간을 보고하므로, 클라이언트는 값이 정수라고 가정해서는 안 됩니다. BytePlus의 자체 필드로, 성공한 비디오 작업에서 반환되며 그대로 전달됩니다. + 생성된 비디오의 재생 시간(초)입니다. BytePlus가 이에 대해 일관성이 없기 때문에 정수가 아닌 숫자로 선언됩니다. 비디오 작업이 정수 초를 반환한 사례가 관찰되었고, 같은 BytePlus의 다른 표면에서는 소수 재생 시간을 보고하므로, 클라이언트는 정수 값을 가정해서는 안 됩니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 변경 없이 전달됩니다. @@ -370,7 +390,7 @@ Router가 `GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json`에서 - 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected 및 OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 하나의 계열에 점으로 구분된 사유가 붙을 수 있습니다. 예를 들어 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation 또는 OutputImageSensitiveContentDetected.DeepFake 등입니다. 이것은 열거형이 아니라 열린 문자열입니다. 다른 코드들은 검증 및 공급자 실패를 설명합니다. Router는 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 계열을 인식하며, 전송 실패를 덮어쓰지 않습니다. + 업스트림 ModelArk 오류 코드입니다. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected, OutputAudioSensitiveContentDetected는 콘텐츠 정책 거부를 나타냅니다. 패밀리에는 InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation 또는 OutputImageSensitiveContentDetected.DeepFake 같은 점으로 구분된 사유가 있을 수 있습니다. 이것은 열거형이 아닌 개방형 문자열입니다. 다른 코드는 검증 및 공급자 실패를 설명합니다. Router는 HTTP 400 오류 봉투와 HTTP 200 실패 작업 응답에서 정책 패밀리를 인식하며, 전송 실패를 덮어쓰지 않습니다. @@ -386,15 +406,15 @@ Router가 `GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json`에서 - 생성된 비디오의 컨테이너 형식(mp4 또는 mov)으로, `content`의 형제로 최상위에 반환됩니다. Seedance 비디오 작업 조회가 반환하는 위치가 바로 여기입니다. BytePlus의 자체 필드로, 그대로 전달됩니다. + 생성된 비디오의 컨테이너 형식(mp4 또는 mov)이며, `content`의 형제로 최상위 레벨에서 반환됩니다. Seedance 비디오 작업 조회가 이 값을 반환하는 위치입니다. BytePlus 자체 필드이며 그대로 전달됩니다. - 생성된 비디오의 해상도입니다. 예: `1080p`. BytePlus의 자체 필드로, 성공한 비디오 작업에서 반환되며 그대로 전달됩니다. + 생성된 비디오의 해상도입니다. 예: `1080p`. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 그대로 전달됩니다. - 작업에 실제로 사용된 생성 시드입니다. BytePlus의 자체 필드로, 성공한 비디오 작업에서 반환되며 그대로 전달됩니다. + 작업에 실제로 사용된 생성 시드입니다. BytePlus 자체 필드로, 성공한 비디오 작업에서 반환되며 그대로 전달됩니다. 형식: `int64` @@ -406,7 +426,7 @@ Router가 `GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json`에서 - 작업이 마지막으로 업데이트된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다. + 작업이 마지막 업데이트된 시간입니다. 값은 초 단위의 UNIX 타임스탬프입니다. diff --git a/ko/development/comfy-router/models/krea/krea-3/code.mdx b/ko/development/comfy-router/models/krea/krea-3/code.mdx index b455b3e707..66cb4f98b6 100644 --- a/ko/development/comfy-router/models/krea/krea-3/code.mdx +++ b/ko/development/comfy-router/models/krea/krea-3/code.mdx @@ -2,15 +2,16 @@ title: "Comfy Router로 Krea 3 사용하기" description: "Comfy Router를 통해 krea/krea-3를 호출하는 방법: 엔드포인트, 요청 형태 및 Router가 반환하는 응답입니다." sidebarTitle: "Krea 3" -translationSourceHash: a539ac5a +translationSourceHash: bf8b60e8 translationFrom: development/comfy-router/models/krea/krea-3/code.mdx translationBlockHashes: "_intro": ac71b80c "Quick start": d6a4d54e - "Schema": 9c44fce0 + "Schema": 672a9195 "Examples": 276619d9 --- + {/* GENERATED FILE. Generated from router-schemas/krea/krea-3.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -155,7 +156,7 @@ curl https://api.comfy.org/v2/models/krea/krea-3/requests/$REQUEST_ID \ - 입력 이미지 URL이며 최대 8개입니다. 각 URL은 이미지를 POST /proxy/krea/assets에 업로드하여 반환된 image_url이어야 합니다(multipart form 필드 `file`). 호스트 app-uploads.krea.ai의 https URL이 아닌 링크는 자체 https URL을 포함하여 400으로 거부되며, 실제 업로드가 아닌 app-uploads.krea.ai 링크는 5xx 오류로 실패합니다. 텍스트 기반 이미지 생성 시에는 생략합니다. + 입력 이미지 URL이며 최대 8개입니다. 이미지를 POST /proxy/krea/assets에 업로드하여 반환된 image_url(multipart form 필드 `file`)은 항상 허용됩니다. 다른 공개 https URL이 허용되는지는 환경에 따라 다릅니다. 허용되지 않는 환경에서는 호스트 app-uploads.krea.ai의 https URL이 아닌 링크가 400으로 거부됩니다. 허용되는 환경에서는 공개 https 이미지 URL이면 모두 허용되며, 형식이 잘못되었거나 https가 아닌 URL은 400으로 거부됩니다. 이 경우 형식이 올바른 https URL에 대해서는 호출자가 수정할 수 있는 참조가 해당 호스트를 명시하며 400으로 거부됩니다. 가져오기 전에 확인했을 때 호스트가 확인되지 않거나 공개적으로 접근할 수 없는 경우, 허용된 횟수를 초과하여 리디렉션하는 경우, https가 아닌 URL이나 공개적으로 접근할 수 없는 호스트로 리디렉션하는 경우, 408 또는 429가 아닌 4xx를 반환하는 경우, 이미지가 아닌 경우, 읽을 수 없는 형식의 이미지인 경우, 이미지 크기 헤더가 처음 2 MiB 이내에 없는 경우, 또는 선언된 길이가 없거나 청크 인코딩된 응답이 이미지 크기 헤더 전에 끝나는 경우입니다. 그 밖의 가져오기 실패는 POST /proxy/krea에서 502 오류로 실패합니다(Comfy Router는 이에 500 internal_error로 응답합니다). 일시적인 DNS, TLS 또는 연결 실패, 타임아웃, 원본의 408, 429, 5xx 또는 기타 200이 아닌 상태, 또는 해당 검사를 통과했지만 가져오기가 연결할 때 확인되지 않거나 공개적으로 접근할 수 없는 호스트가 여기에 해당합니다. 다른 URL이 허용되지 않는 환경에서는 실제 업로드가 아닌 app-uploads.krea.ai 링크가 5xx 오류로 실패하고, 허용되는 환경에서는 다른 접근 불가능한 참조와 마찬가지로 400으로 거부됩니다. 서버가 어느 쪽이 적용되는지 아직 파악하지 못한 동안에는 호스트가 app-uploads.krea.ai 링크가 아닌 모든 https URL이 공개 여부와 관계없이 재시도해도 안전한 503 오류로 실패합니다. 텍스트 기반 이미지 생성 시에는 생략합니다. 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..1fe510d477 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,14 +2,15 @@ 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에서 생성되었습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -172,7 +173,7 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 스타일/콘텐츠 가이드를 위한 참조 이미지입니다. type이 'image'인 경우 최대 9개, 'image_edit'인 경우 최대 8개입니다. + 스타일/콘텐츠 가이드를 위한 참조 이미지입니다. type 'image'의 경우 최대 9개, type 'image_edit'의 경우 최대 8개입니다. @@ -184,7 +185,7 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - MIME 타입입니다. data와 함께 필수이며, 비디오 소스의 경우 url과도 함께 필수입니다(예: video_edit / video_reframe에서 video/mp4). + MIME 타입입니다. data와 함께 필수이며, 비디오 소스의 경우 url과 함께 필수입니다(예: video_edit / video_reframe에서 video/mp4). @@ -206,7 +207,7 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 이미지 또는 비디오에 대한 참조입니다. 스타일/콘텐츠 가이드, 가이드 생성, video-edit/video-reframe 소스 및 가이드 키프레임에 사용됩니다. generation_id, url, data 중 정확히 하나를 제공하세요. + 이미지 또는 비디오에 대한 참조입니다. 스타일/콘텐츠 가이드, 가이드 생성, video-edit/video-reframe 소스 및 가이드 키프레임에 사용됩니다. generation_id, url 또는 data 중 정확히 하나를 제공하세요. @@ -218,7 +219,7 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - MIME 타입입니다. data와 함께 필수이며, 비디오 소스의 경우 url과도 함께 필수입니다(예: video_edit / video_reframe에서 video/mp4). + MIME 타입입니다. data와 함께 필수이며, 비디오 소스의 경우 url과 함께 필수입니다(예: video_edit / video_reframe에서 video/mp4). @@ -232,13 +233,13 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 수행할 생성 유형입니다. image/image_edit는 uni-1 / uni-1-max 모델에서 생성되며, video/video_edit/video_reframe은 ray-3.2 모델에서 생성됩니다. + 수행할 생성 유형입니다. image/image_edit는 uni-1 / uni-1-max 모델에서 생성되고, video/video_edit/video_reframe은 ray-3.2 모델에서 생성됩니다. 가능한 값: `image`, `image_edit`, `video`, `video_edit`, `video_reframe` - ray-3.2의 비디오 출력 설정입니다. 여기에서는 검증 및 과금에 영향을 주는 필드만 모델링됩니다. 추가 필드(편집 제어, source_position)는 수정 없이 Luma로 전달됩니다. + ray-3.2의 비디오 출력 설정입니다. 검증 및 청구에 영향을 주는 필드만 여기에 모델링됩니다. 추가 필드(편집 컨트롤, source_position)는 수정 없이 Luma로 전달됩니다. @@ -248,7 +249,7 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 이미지 또는 비디오에 대한 참조입니다. 스타일/콘텐츠 가이드, 가이드 생성, video-edit/video-reframe 소스 및 가이드 키프레임에 사용됩니다. generation_id, url, data 중 정확히 하나를 제공하세요. + 이미지 또는 비디오에 대한 참조입니다. 스타일/콘텐츠 가이드, 가이드 생성, video-edit/video-reframe 소스 및 가이드 키프레임에 사용됩니다. generation_id, url 또는 data 중 정확히 하나를 제공하세요. @@ -260,7 +261,7 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - MIME 타입입니다. data와 함께 필수이며, 비디오 소스의 경우 url과도 함께 필수입니다(예: video_edit / video_reframe에서 video/mp4). + MIME 타입입니다. data와 함께 필수이며, 비디오 소스의 경우 url과 함께 필수입니다(예: video_edit / video_reframe에서 video/mp4). @@ -268,7 +269,7 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 아직 사용할 수 없습니다: Luma가 EXR 제공을 시작할 때까지 `exr_export=true` 요청은 400으로 거부됩니다. 향후 MP4와 함께 EXR 파일을 내보냅니다(hdr가 true여야 함). video_reframe에서는 거부됩니다. + 아직 사용 불가: Luma가 EXR 제공을 출시할 때까지 exr_export=true 요청은 400으로 거부됩니다. MP4와 함께 EXR 파일을 내보냅니다(hdr true 필요). video_reframe에서는 거부됩니다. @@ -276,11 +277,11 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - `keyframes`의 출력 프레임 위치이며 길이가 같아야 합니다. 5s의 경우 0–120, 10s의 경우 0–240입니다. 수정 없이 전달됩니다. + `keyframes`의 출력 프레임 위치이며 길이가 같습니다. 5s의 경우 0–120, 10s의 경우 0–240입니다. 그대로 전달됩니다. - 가이드 프레임 이미지(1–64)이며 start_frame/end_frame과 상호 배타적입니다. 요청된 재생 시간을 기준으로 과금되며, keyframes 요청은 단일 키프레임 연장이 아닙니다. + 가이드 프레임 이미지(1–64)이며 start_frame/end_frame과 상호 배타적입니다. 요청된 재생 시간으로 청구되며, keyframes 요청은 단일 키프레임 확장이 결코 아닙니다. @@ -292,7 +293,7 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - MIME 타입입니다. data와 함께 필수이며, 비디오 소스의 경우 url과도 함께 필수입니다(예: video_edit / video_reframe에서 video/mp4). + MIME 타입입니다. data와 함께 필수이며, 비디오 소스의 경우 url과 함께 필수입니다(예: video_edit / video_reframe에서 video/mp4). @@ -300,17 +301,17 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 생성된 클립을 반복합니다. 생성 시에만 가능합니다(type video). + 생성된 클립을 반복합니다. 생성 전용(type video)입니다. - ray-3.2 비디오의 출력 해상도입니다. 기본값은 720p입니다. 360p는 초안 등급입니다. HDR에는 720p 또는 1080p가 필요합니다. + ray-3.2 video의 출력 해상도입니다. 기본값은 720p입니다. 360p는 초안 등급입니다. HDR에는 720p 또는 1080p가 필요합니다. 가능한 값: `360p`, `540p`, `720p`, `1080p` - 이미지 또는 비디오에 대한 참조입니다. 스타일/콘텐츠 가이드, 가이드 생성, video-edit/video-reframe 소스 및 가이드 키프레임에 사용됩니다. generation_id, url, data 중 정확히 하나를 제공하세요. + 이미지 또는 비디오에 대한 참조입니다. 스타일/콘텐츠 가이드, 가이드 생성, video-edit/video-reframe 소스 및 가이드 키프레임에 사용됩니다. generation_id, url 또는 data 중 정확히 하나를 제공하세요. @@ -318,11 +319,11 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 소스로 재사용할 이전 완료된 생성의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. + 소스로 재사용할 이전에 완료된 생성의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. - MIME 유형. data와 함께 필수입니다 (비디오 소스의 경우 url과도 함께, 예: video_edit / video_reframe에서 video/mp4). + MIME 유형입니다. data와 함께 필수입니다(비디오 소스의 경우 url과도 함께 필수이며, 예를 들어 video_edit / video_reframe에서는 video/mp4). @@ -330,10 +331,10 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 웹 검색 그라운딩 활성화 + 검색 그라운딩 활성화 -Router가 `GET /v2/models/luma_2/ray-3.2/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 동일한 문서입니다. +Router가 `GET /v2/models/luma_2/ray-3.2/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 전에 호출을 검증하는 기준이 되는 동일한 문서입니다. ### 출력 @@ -342,13 +343,13 @@ Router가 `GET /v2/models/luma_2/ray-3.2/openapi.json`에서 제공하는 스키 - 프로그래밍 방식으로 처리할 수 있는 기계 판독 가능 실패 코드 + 프로그래밍 방식 처리를 위한 기계 판독 가능 실패 코드 가능한 값: `content_moderated`, `generation_failed`, `budget_exhausted`, `output_not_found` - 사람이 읽을 수 있는 실패 설명으로, FAILED 상태의 생성에서만 채워집니다. 성공한 생성에서는 `null`입니다. + 사람이 읽을 수 있는 실패 설명이며, 실패한 생성에서만 채워집니다. 성공한 경우 `null`입니다. @@ -364,11 +365,11 @@ Router가 `GET /v2/models/luma_2/ray-3.2/openapi.json`에서 제공하는 스키 - 미디어 유형 (예: 이미지) + 미디어 유형(예: 이미지) - 미리 서명된 URL (1시간 후 만료) + 프리사인드 URL(1시간 후 만료) @@ -378,7 +379,7 @@ Router가 `GET /v2/models/luma_2/ray-3.2/openapi.json`에서 제공하는 스키 - 수행할 생성의 종류입니다. image/image_edit는 uni-1 / uni-1-max 모델에서, video/video_edit/video_reframe은 ray-3.2 모델에서 생성됩니다. + 수행할 생성의 종류입니다. image/image_edit는 uni-1 / uni-1-max 모델에서 생성되며, video/video_edit/video_reframe은 ray-3.2 모델에서 생성됩니다. 가능한 값: `image`, `image_edit`, `video`, `video_edit`, `video_reframe` 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..83f6d47001 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,17 +2,16 @@ 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 --- - {/* 생성된 파일. `pnpm code-pages:gen`에 의해 router-schemas/luma_2/uni-1-max.json에서 생성되었습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -153,13 +152,13 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ ### 입력 - 출력 가로세로 비율. ray-3.2 비디오 모델은 9:16, 3:4, 1:1, 4:3, 16:9, 21:9 하위 집합을 지원합니다. + 출력 화면 비율입니다. ray-3.2 비디오 모델은 9:16, 3:4, 1:1, 4:3, 16:9, 21:9 하위 집합을 지원합니다. 가능한 값: `3:1`, `2:1`, `21:9`, `16:9`, `3:2`, `4:3`, `1:1`, `3:4`, `2:3`, `9:16`, `1:2`, `1:3` - 스타일/콘텐츠 가이드를 위한 참조 이미지. type 'image'인 경우 최대 9개, type 'image_edit'인 경우 최대 8개입니다. + 스타일/콘텐츠 가이드용 참조 이미지입니다. type 'image'의 경우 최대 9개, type 'image_edit'의 경우 최대 8개입니다. @@ -167,11 +166,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 소스로 재사용할 이전에 완료된 생성의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. + 소스로 재사용할 이전 완료된 생성의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. - MIME 타입. data와 함께 필수입니다(비디오 소스의 경우 url과도 함께 필수이며, 예: video_edit / video_reframe에서 video/mp4). + MIME 타입입니다. data와 함께 필수이며, 비디오 소스의 경우 url과도 함께 필요합니다(예: video_edit / video_reframe에서 video/mp4). @@ -179,7 +178,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 사용할 모델. 이미지 생성에는 uni-1 / uni-1-max, 비디오 생성, 편집, 리프레이밍에는 ray-3.2를 사용합니다. + 사용할 모델입니다. 이미지 생성에는 uni-1 / uni-1-max, 비디오 생성, 편집 및 리프레이밍에는 ray-3.2를 사용합니다. @@ -193,7 +192,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 이미지 또는 비디오에 대한 참조입니다. 스타일/콘텐츠 가이드, 가이드 생성, video-edit/video-reframe 소스, 가이드 키프레임에 사용됩니다. generation_id, url, data 중 정확히 하나를 제공하세요. + 이미지 또는 비디오에 대한 참조입니다. 스타일/콘텐츠 가이드, 가이드 생성, video-edit/video-reframe 소스, 가이드 키프레임에 사용됩니다. generation_id, url, data 중 정확히 하나만 제공하세요. @@ -201,11 +200,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 소스로 재사용할 이전에 완료된 생성의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. + 소스로 재사용할 이전 완료된 생성의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. - MIME 타입. data와 함께 필수입니다(비디오 소스의 경우 url과도 함께 필수이며, 예: video_edit / video_reframe에서 video/mp4). + MIME 타입입니다. data와 함께 필수이며, 비디오 소스의 경우 url과도 함께 필요합니다(예: video_edit / video_reframe에서 video/mp4). @@ -219,23 +218,23 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 수행할 생성의 종류. image/image_edit는 uni-1 / uni-1-max 모델이 생성하고, video/video_edit/video_reframe은 ray-3.2 모델이 생성합니다. + 수행할 생성의 종류입니다. image/image_edit는 uni-1 / uni-1-max 모델이 생성하고, video/video_edit/video_reframe은 ray-3.2 모델이 생성합니다. 가능한 값: `image`, `image_edit`, `video`, `video_edit`, `video_reframe` - ray-3.2의 비디오 출력 설정입니다. 여기에는 검증과 과금에 영향을 주는 필드만 모델링되어 있으며, 추가 필드(편집 제어, source_position)는 수정 없이 Luma로 전달됩니다. + ray-3.2의 비디오 출력 설정입니다. 여기서는 검증과 과금에 영향을 주는 필드만 모델링되며, 추가 필드(편집 컨트롤, source_position)는 수정 없이 Luma로 전달됩니다. - ray-3.2 video / video_edit의 클립 재생 시간. 기본값은 5s입니다. HDR 생성(type video)은 5s로 제한됩니다. + ray-3.2 video / video_edit의 클립 재생 시간입니다. 기본값은 5s입니다. HDR 생성(type video)은 5s로 제한됩니다. 가능한 값: `5s`, `10s` - 이미지 또는 비디오에 대한 참조입니다. 스타일/콘텐츠 가이드, 가이드 생성, video-edit/video-reframe 소스, 가이드 키프레임에 사용됩니다. generation_id, url, data 중 정확히 하나를 제공하세요. + 이미지 또는 비디오에 대한 참조입니다. 스타일/콘텐츠 가이드, 가이드 생성, video-edit/video-reframe 소스, 가이드 키프레임에 사용됩니다. generation_id, url, data 중 정확히 하나만 제공하세요. @@ -243,11 +242,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 소스로 재사용할 이전에 완료된 생성의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. + 소스로 재사용할 이전 완료된 생성의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. - MIME 타입. data와 함께 필수입니다(비디오 소스의 경우 url과도 함께 필수이며, 예: video_edit / video_reframe에서 video/mp4). + MIME 타입입니다. data와 함께 필수이며, 비디오 소스의 경우 url과도 함께 필요합니다(예: video_edit / video_reframe에서 video/mp4). @@ -255,7 +254,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에서는 거부됩니다. @@ -263,11 +262,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - `keyframes`에 대한 출력 프레임 위치이며 길이가 같아야 합니다. 5s의 경우 0–120, 10s의 경우 0–240입니다. 수정 없이 전달됩니다. + `keyframes`의 출력 프레임 위치이며 길이가 같습니다. 5s의 경우 0–120, 10s의 경우 0–240입니다. 수정 없이 전달됩니다. - 가이드 프레임 이미지(1–64개)로, start_frame/end_frame과 함께 사용할 수 없습니다. 요청된 재생 시간 기준으로 과금되며, keyframes 요청은 단일 키프레임 확장이 아닙니다. + 가이드 프레임 이미지(1–64)이며 start_frame/end_frame과 함께 사용할 수 없습니다. 요청된 재생 시간을 기준으로 과금되며, keyframes 요청은 단일 키프레임 확장이 아닙니다. @@ -275,11 +274,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 소스로 재사용할 이전에 완료된 생성의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. + 소스로 재사용할 이전 완료된 생성의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. - MIME 타입. data와 함께 필수입니다(비디오 소스의 경우 url과도 함께 필수이며, 예: video_edit / video_reframe에서 video/mp4). + MIME 타입입니다. data와 함께 필수이며, 비디오 소스의 경우 url과도 함께 필요합니다(예: video_edit / video_reframe에서 video/mp4). @@ -287,17 +286,17 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 생성된 클립을 반복합니다. 생성 시에만 사용 가능합니다(type video). + 생성된 클립을 반복 재생합니다. 생성 시에만 사용 가능(type video)합니다. - ray-3.2 video의 출력 해상도. 기본값은 720p입니다. 360p는 초안 등급입니다. HDR은 720p 또는 1080p가 필요합니다. + ray-3.2 비디오의 출력 해상도입니다. 기본값은 720p입니다. 360p는 초안(draft) 등급입니다. HDR에는 720p 또는 1080p가 필요합니다. 가능한 값: `360p`, `540p`, `720p`, `1080p` - 이미지 또는 비디오에 대한 참조입니다. 스타일/콘텐츠 가이드, 가이드 생성, video-edit/video-reframe 소스, 가이드 키프레임에 사용됩니다. generation_id, url, data 중 정확히 하나를 제공하세요. + 이미지 또는 비디오에 대한 참조입니다. 스타일/콘텐츠 가이드, 가이드 생성, video-edit/video-reframe 소스, 가이드 키프레임에 사용됩니다. generation_id, url, data 중 정확히 하나만 제공하세요. @@ -305,11 +304,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 소스로 재사용할, 이전에 완료된 생성의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. + 소스로 재사용할 이전에 완료된 생성의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. - MIME 타입입니다. data와 함께 필수이며, 비디오 소스의 경우 url과도 함께 필수입니다(예: video_edit / video_reframe에서 video/mp4). + MIME 타입입니다. data와 함께 필수이며, 비디오 소스의 경우 url과도 함께 필수입니다(예: video_edit / video_reframe의 video/mp4). @@ -317,10 +316,10 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 검색 그라운딩 활성화 + 웹 검색 그라운딩 활성화 -Router가 `GET /v2/models/luma_2/uni-1-max/openapi.json`에서 제공하는 스키마에서 생성되며, 이는 요청이 공급자에 도달하기 이전에 호출을 검증하는 데 사용하는 것과 동일한 문서입니다. +Router가 `GET /v2/models/luma_2/uni-1-max/openapi.json`에서 제공하는 스키마에서 생성되며, 요청이 공급자에 도달하기 전에 호출을 검증하는 동일한 문서입니다. ### 출력 @@ -329,13 +328,13 @@ Router가 `GET /v2/models/luma_2/uni-1-max/openapi.json`에서 제공하는 스 - 프로그래밍 방식으로 처리할 수 있는 기계 판독 가능한 실패 코드 + 프로그래밍 방식 처리를 위한 기계 판독 가능한 실패 코드 가능한 값: `content_moderated`, `generation_failed`, `budget_exhausted`, `output_not_found` - 사람이 읽을 수 있는 실패 설명. FAILED 상태의 생성에서만 채워지며, 성공한 생성에서는 `null`입니다. + 사람이 읽을 수 있는 실패 설명이며, FAILED 생성에서만 채워집니다. 성공한 경우 `null`입니다. @@ -351,11 +350,11 @@ Router가 `GET /v2/models/luma_2/uni-1-max/openapi.json`에서 제공하는 스 - 미디어 유형 (예: 이미지) + 미디어 유형(예: 이미지) - 미리 서명된 URL (1시간 후 만료) + 사전 서명된 URL(1시간 후 만료) @@ -365,7 +364,7 @@ Router가 `GET /v2/models/luma_2/uni-1-max/openapi.json`에서 제공하는 스 - 수행할 생성의 종류. image/image_edit는 uni-1 / uni-1-max 모델에서 생성되며, video/video_edit/video_reframe은 ray-3.2 모델에서 생성됩니다. + 수행할 생성 종류입니다. image/image_edit는 uni-1 / uni-1-max 모델에서 생성되며, video/video_edit/video_reframe은 ray-3.2 모델에서 생성됩니다. 가능한 값: `image`, `image_edit`, `video`, `video_edit`, `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..3f1f335049 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,17 +2,16 @@ 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 --- - {/* 생성된 파일. `pnpm code-pages:gen`에 의해 router-schemas/luma_2/uni-1.json에서 생성되었습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -171,7 +170,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - MIME 타입입니다. data와 함께 필수입니다(비디오 소스의 경우 url과 함께 사용, 예: video_edit / video_reframe의 video/mp4). + MIME 타입입니다. data와 함께 필수입니다(비디오 소스의 경우 url과도 함께, 예: video_edit / video_reframe의 video/mp4). @@ -179,7 +178,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 사용할 모델입니다. 이미지 생성에는 uni-1 / uni-1-max, 비디오 생성, 편집, 리프레이밍에는 ray-3.2입니다. + 사용할 모델입니다. 이미지 생성에는 uni-1 / uni-1-max, 비디오 생성과 편집, 리프레이밍에는 ray-3.2를 사용합니다. @@ -205,7 +204,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - MIME 타입입니다. data와 함께 필수입니다(비디오 소스의 경우 url과 함께 사용, 예: video_edit / video_reframe의 video/mp4). + MIME 타입입니다. data와 함께 필수입니다(비디오 소스의 경우 url과도 함께, 예: video_edit / video_reframe의 video/mp4). @@ -219,7 +218,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 수행할 생성의 종류입니다. image/image_edit는 uni-1 / uni-1-max 모델이 생성하며, video/video_edit/video_reframe은 ray-3.2 모델이 생성합니다. + 수행할 생성의 종류입니다. image/image_edit는 uni-1 / uni-1-max 모델이 생성하고, video/video_edit/video_reframe은 ray-3.2 모델이 생성합니다. 가능한 값: `image`, `image_edit`, `video`, `video_edit`, `video_reframe` @@ -247,7 +246,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - MIME 타입입니다. data와 함께 필수입니다(비디오 소스의 경우 url과 함께 사용, 예: video_edit / video_reframe의 video/mp4). + MIME 타입입니다. data와 함께 필수입니다(비디오 소스의 경우 url과도 함께, 예: video_edit / video_reframe의 video/mp4). @@ -255,7 +254,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에서는 거부됩니다. @@ -263,11 +262,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - `keyframes`에 대한 출력 프레임 위치이며 길이가 같습니다. 5s는 0–120, 10s는 0–240입니다. 수정 없이 전달됩니다. + `keyframes`의 출력 프레임 위치이며 길이가 같습니다. 5s의 경우 0–120, 10s의 경우 0–240입니다. 수정 없이 전달됩니다. - 가이드 프레임 이미지(1–64)이며 start_frame/end_frame과 상호 배타적입니다. 요청된 재생 시간을 기준으로 과금되며, keyframes 요청은 단일 키프레임 연장이 아닙니다. + 가이드 프레임 이미지(1–64)이며 start_frame/end_frame과 함께 사용할 수 없습니다. 요청된 재생 시간을 기준으로 과금되며, keyframes 요청은 단일 키프레임 확장이 아닙니다. @@ -279,7 +278,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - MIME 타입입니다. data와 함께 필수입니다(비디오 소스의 경우 url과 함께 사용, 예: video_edit / video_reframe의 video/mp4). + MIME 타입입니다. data와 함께 필수입니다(비디오 소스의 경우 url과도 함께, 예: video_edit / video_reframe의 video/mp4). @@ -287,7 +286,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 생성된 클립을 반복 재생합니다. 생성 전용(type video)입니다. + 생성된 클립을 반복 재생합니다. 생성 시에만 사용 가능(type video). @@ -305,11 +304,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 소스로 재사용할, 이전에 완료된 생성의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. + 소스로 재사용할 이전 완료된 생성의 UUID입니다. ray-3.2 video_edit / video_reframe에서 사용됩니다. - MIME 타입입니다. data와 함께 필수입니다(비디오 소스의 경우 url과도 함께, 예: video_edit / video_reframe에서 video/mp4). + MIME 유형입니다. data와 함께 필수이며, 비디오 소스의 경우 url과도 함께 필수입니다(예: video_edit / video_reframe에서 video/mp4). @@ -317,10 +316,10 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 검색 그라운딩 활성화 + 웹 검색 그라운딩 활성화 -Router가 `GET /v2/models/luma_2/uni-1/openapi.json`에서 제공하는 스키마에서 생성되었으며, 이는 요청이 공급자에 도달하기 이전에 호출을 검증하는 대상과 동일한 문서입니다. +Router가 `GET /v2/models/luma_2/uni-1/openapi.json`에서 제공하는 스키마에서 생성되며, 이 문서는 요청이 공급자에 도달하기 전에 호출을 검증하는 기준이 되는 동일한 문서입니다. ### 출력 @@ -329,13 +328,13 @@ Router가 `GET /v2/models/luma_2/uni-1/openapi.json`에서 제공하는 스키 - 프로그래밍 방식 처리를 위한 기계 판독 가능한 실패 코드 + 프로그래밍 방식으로 처리하기 위한 기계 판독 가능 실패 코드 가능한 값: `content_moderated`, `generation_failed`, `budget_exhausted`, `output_not_found` - 사람이 읽을 수 있는 실패 설명으로, FAILED 생성에서만 채워집니다. 성공한 경우 `null`입니다. + 사람이 읽을 수 있는 실패 설명이며, FAILED 상태의 생성에서만 채워집니다. 성공한 생성에서는 `null`입니다. @@ -351,11 +350,11 @@ Router가 `GET /v2/models/luma_2/uni-1/openapi.json`에서 제공하는 스키 - 미디어 유형(예: 이미지) + 미디어 유형 (예: image) - 사전 서명된 URL (1시간 후 만료) + Presigned URL (1시간 만료) @@ -365,7 +364,7 @@ Router가 `GET /v2/models/luma_2/uni-1/openapi.json`에서 제공하는 스키 - 수행할 생성 유형입니다. image/image_edit는 uni-1 / uni-1-max 모델에서 생성되며, video/video_edit/video_reframe는 ray-3.2 모델에서 생성됩니다. + 수행할 생성의 종류입니다. image/image_edit는 uni-1 / uni-1-max 모델에서 생성되며, video/video_edit/video_reframe은 ray-3.2 모델에서 생성됩니다. 가능한 값: `image`, `image_edit`, `video`, `video_edit`, `video_reframe` diff --git a/ko/development/comfy-router/models/veed/fabric-1-0/code.mdx b/ko/development/comfy-router/models/veed/fabric-1-0/code.mdx index d4c41003b9..954ce34a70 100644 --- a/ko/development/comfy-router/models/veed/fabric-1-0/code.mdx +++ b/ko/development/comfy-router/models/veed/fabric-1-0/code.mdx @@ -2,14 +2,15 @@ title: "Comfy Router에서 Fabric 1.0 사용하기" description: "Comfy Router를 통해 veed/fabric-1.0을 호출하는 방법: 엔드포인트, 요청 형태, 그리고 Router가 반환하는 응답입니다." sidebarTitle: "Fabric 1.0" -translationSourceHash: 8e2360a2 +translationSourceHash: 0d5557e0 translationFrom: development/comfy-router/models/veed/fabric-1-0/code.mdx translationBlockHashes: "_intro": c0f6ceff "Quick start": 2856fd42 - "Schema": 9ea03528 + "Schema": 17071210 "Examples": 952acc85 --- + {/* 생성된 파일. `pnpm code-pages:gen`에 의해 router-schemas/veed/fabric-1.0.json에서 생성되었습니다. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -154,7 +155,7 @@ curl https://api.comfy.org/v2/models/veed/fabric-1.0/requests/$REQUEST_ID \ ### 입력 - 립싱크 대상 음성 트랙의 공개 http(s) URL입니다. 비디오 길이는 오디오 길이와 같습니다. + 립싱크 대상 음성 트랙의 공개 http(s) URL입니다. 비디오 길이는 오디오 길이와 같습니다. 오디오가 호출당 입력 한도를 초과하면 400으로 거부됩니다. @@ -165,7 +166,7 @@ curl https://api.comfy.org/v2/models/veed/fabric-1.0/requests/$REQUEST_ID \ 출력 해상도: 480p 또는 720p. -Router가 `GET /v2/models/veed/fabric-1.0/openapi.json`에서 제공하는 스키마에서 생성되었으며, 요청이 공급자에 도달하기 전에 호출을 검증할 때 사용하는 문서와 동일합니다. +Router가 `GET /v2/models/veed/fabric-1.0/openapi.json`에서 제공하는 스키마에서 생성되었으며, 요청이 공급자에 도달하기 전에 호출을 검증하는 데 사용하는 문서와 동일합니다. ### 출력 diff --git a/ko/development/comfy-router/models/veed/lipsync-2-0/code.mdx b/ko/development/comfy-router/models/veed/lipsync-2-0/code.mdx index a21ffdcd56..c6f7a8f9e9 100644 --- a/ko/development/comfy-router/models/veed/lipsync-2-0/code.mdx +++ b/ko/development/comfy-router/models/veed/lipsync-2-0/code.mdx @@ -2,14 +2,15 @@ title: "Comfy Router로 Lipsync 2.0 사용하기" description: "Comfy Router를 통해 veed/lipsync-2.0을 호출합니다. 엔드포인트, 요청 형태, Router가 반환하는 응답을 설명합니다." sidebarTitle: "Lipsync 2.0" -translationSourceHash: 3d623f70 +translationSourceHash: 55607886 translationFrom: development/comfy-router/models/veed/lipsync-2-0/code.mdx translationBlockHashes: "_intro": 1fd676f1 "Quick start": 05550229 - "Schema": a26c8117 + "Schema": 24733e29 "Examples": 01527a02 --- + {/* GENERATED FILE. Generated from router-schemas/veed/lipsync-2.0.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/ko/comfy-router/model-code-footer.mdx"; @@ -150,7 +151,7 @@ curl https://api.comfy.org/v2/models/veed/lipsync-2.0/requests/$REQUEST_ID \ ### 입력 - 비디오에 립싱크할 새 오디오 트랙의 공개 http(s) URL입니다. + 비디오에 립싱크할 새 오디오 트랙의 공개 http(s) URL입니다. 오디오가 호출당 입력 상한보다 길면 400으로 거부됩니다. diff --git a/ko/development/comfy-router/reference.mdx b/ko/development/comfy-router/reference.mdx index 0f7bb35a2d..502d958a25 100644 --- a/ko/development/comfy-router/reference.mdx +++ b/ko/development/comfy-router/reference.mdx @@ -2,17 +2,17 @@ title: "Comfy Router API 레퍼런스" description: "Comfy API 계약에서 생성된 모든 Comfy Router 엔드포인트, 매개변수, 응답 본문 및 오류 버킷." sidebarTitle: "API 레퍼런스" -translationSourceHash: 1b971d1c +translationSourceHash: 9a5e0219 translationFrom: development/comfy-router/reference.mdx translationBlockHashes: "_intro": 3f6e5d23 - "Endpoints": fbcaaf0e - "Error buckets": 36170340 + "Endpoints": 222fd740 + "Error buckets": 02a09cb4 "Response headers": 403c8bf5 - "Pre-flight cost estimates": 3ecabac6 - "Result assets": 65fc939b + "Pre-flight cost estimates": 862a49f8 + "Result assets": 18fe6dad "Per-model input and output schemas": 61c6bde8 - "Schemas": 77cfa4db + "Schemas": 0c65163b --- @@ -26,7 +26,6 @@ translationBlockHashes: - {/* 생성된 파일: 손으로 편집하지 마십시오. @@ -1022,6 +1021,8 @@ Router가 실행 전에 아직 가격을 산정할 수 없는 모델은 [실행 다른 모델은 공급자 에셋 참조 또는 인라인 바이트를 반환합니다. 공급자 URL은 공급자의 만료 정책을 따르며, 이는 위 수명보다 훨씬 짧을 수 있고 Router 계약에 명시되어 있지 않습니다. +**BytePlus 원본 URL(Seedance 2.x, 선택적 적용).** Comfy가 서버 측에서 선택 적용한 워크스페이스에서는 Seedance 2.x 결과에 복사된 URL과 함께 BytePlus 자체 URL이 `content.upstream_video_url` 및 `content.upstream_last_frame_url`에 포함되고, `content.upstream_expires_at`도 함께 제공됩니다. 이를 제어하는 요청 파라미터는 없으며 기본적으로 선택 적용된 워크스페이스는 없습니다. 이 URL은 생성 후 24시간 뒤 만료되고, BytePlus가 삭제하면 더 이상 존재하지 않습니다. Seedance 2.5에서는 BytePlus가 각 URL의 다운로드를 100회로 제한하며, Router 자체 복사본도 그중 한 번을 사용합니다. 각 URL은 해당 객체에 대한 베어러 자격 증명이므로, 보유한 사람은 만료 전까지 누구나 해당 에셋을 다운로드할 수 있습니다. + 복사는 에셋별 최선 노력 방식으로 수행됩니다. 복사 하나가 실패하면 해당 항목은 공급자 참조를 유지합니다. 응답에는 Comfy URL과 공급자 URL이 모두 포함될 수 있으며, 에셋별 복사 상태 필드는 명시적으로 없습니다. 생성은 여전히 성공하며 과금됩니다. 성공적으로 재호스팅된 에셋 하나로 모든 URL의 수명을 추론하지 마세요. 결과가 Comfy 호스팅인지 여부는 완료된 호출을 나중에 해당 `Idempotency-Key` 레코드에서 재생할 수 있는지도 결정합니다. 위의 `Idempotency-Key` 매개변수는 재생할 수 없을 때 재시도에 무엇이 응답되는지 설명합니다. @@ -1034,6 +1035,24 @@ Router가 실행 전에 아직 가격을 산정할 수 없는 모델은 [실행 ## 스키마 +### RouterBilledWorkspace + +거부된 호출이 청구되었을 지갑으로, `RouterErrorResponse.billed_workspace`에 나타납니다. "어느 지갑이 비어 있는가"에 답하는 필드이며, 호출자의 UI가 현재 선택한 워크스페이스와 반드시 같지는 않습니다. 팀 구성원이 개인 자격 증명을 사용하면 자금이 있는 팀을 열어 둔 상태라도 여기에는 개인 지갑이 표시됩니다. `denied_reason`과 함께 있을 때만 존재합니다. + +**필드** + + + Cloud 워크스페이스 ID입니다. 레거시 경로에서는 없습니다. + + + + `personal` 또는 `team`입니다. 열린 문자열이므로 다른 값은 `personal`로 처리하세요. + + + + 호출이 Cloud 워크스페이스가 아니라 호출자의 워크스페이스 이전 Metronome 고객에게 청구될 때 `legacy`입니다. 해당 고객에게는 워크스페이스 ID가 없습니다. Cloud 워크스페이스에서는 없습니다. + + ### RouterChargesOnPolicyRejection 이 모델에 대해 콘텐츠 정책 거부가 청구되는지 여부입니다. 알 수 없는 값은 청구될 수 있는 것으로 간주하세요. @@ -1145,6 +1164,20 @@ Router가 실행 전에 아직 가격을 산정할 수 없는 모델은 [실행 **필드** + + 파트너 노드 지출이 거부되었을 때의 청구 측 정책 분기입니다. `no_funds`는 청구 대상 지갑이 비어 있음을, `unspecified`는 자금 조회로 이유가 밝혀지지 않은 채 호출이 거부되었음을 뜻합니다. `error_type`이 `insufficient_credits`이고 배포가 지갑 정보를 보고할 때만 존재하며, 그 외에는 없습니다. 표시용 텍스트가 아니라 기계 판독용 코드이므로 표시에는 `detail`을 쓰고 분기는 이 필드로 하세요. + + + + 거부된 호출이 청구되었을 지갑으로, `RouterErrorResponse.billed_workspace`에 나타납니다. "어느 지갑이 비어 있는가"에 답하는 필드이며, 호출자의 UI가 현재 선택한 워크스페이스와 반드시 같지는 않습니다. 팀 구성원이 개인 자격 증명을 사용하면 자금이 있는 팀을 열어 둔 상태라도 여기에는 개인 지갑이 표시됩니다. `denied_reason`과 함께 있을 때만 존재합니다. + + Type: [`RouterBilledWorkspace`](#routerbilledworkspace) + + + + 거부된 요청이 어떤 자격 증명으로 인증되었는지입니다. `personal_api_key`, `team_api_key`, `personal_session`, `team_session` 중 하나입니다. "다른 지갑으로 청구하려면 어떤 자격 증명으로 바꿔야 하는가"에 답합니다. 권한이 아니며 아무것도 부여하지 않습니다. `denied_reason`과 함께 있을 때만 존재합니다. + + 이 모델이 콘텐츠 정책을 이유로 거부한 호출이 그럼에도 호출자에게 과금되는지 여부입니다. 공급자마다 다르고, 그 차이는 호출 시점에는 드러나지 않으며, 같은 호출에 대해 오류와 과금을 함께 보게 된 사용자는 미리 알 방법이 없었습니다. 그래서 공급자마다의 통설에 맡기는 대신, 모델별로 호출 전에 명시합니다. diff --git a/ko/tutorials/video/minimax/minimax-h3-fastvideo.mdx b/ko/tutorials/video/minimax/minimax-h3-fastvideo.mdx index 21741f66bc..bb33aa767b 100644 --- a/ko/tutorials/video/minimax/minimax-h3-fastvideo.mdx +++ b/ko/tutorials/video/minimax/minimax-h3-fastvideo.mdx @@ -2,7 +2,7 @@ title: "FastVideo FastH3: ComfyUI 워크플로 예제" description: "FastVideo FastH3는 ComfyUI에서 8 샘플링 스텝으로 동기화 오디오가 포함된 MiniMax H3 비디오를 생성합니다. 텍스트 기반 및 첫/마지막 프레임 워크플로를 지원합니다." sidebarTitle: "FastVideo FastH3" -translationSourceHash: 7cbe9703 +translationSourceHash: cb542dfa translationFrom: tutorials/video/minimax/minimax-h3-fastvideo.mdx translationBlockHashes: "_intro": 096c332e @@ -10,7 +10,7 @@ translationBlockHashes: "FastH3 Text to Video": 1c4cb909 "FastH3 Image to Video": ec7d82bf "Model downloads": b88037db - "Workflow structure notes": 0542b184 + "Workflow structure notes": 8f5d2153 --- [FastVideo FastH3](https://huggingface.co/FastVideo/FastVideo-FastH3-8-Step-V2)는 FastVideo 팀이 MiniMax H3를 DMD2로 증류한 체크포인트로, 베이스 모델의 전체 스케줄 대신 **8 샘플링 스텝**으로 네이티브 동기화 오디오가 포함된 비디오를 생성합니다. H3의 텍스트 인코더, 비디오 VAE, 오디오 VAE를 그대로 사용하므로 출력 설정은 베이스 모델과 동일하면서 샘플링만 크게 단축됩니다. @@ -131,13 +131,13 @@ ComfyUI/ │ └── minimax_h3_audio_vae_fp32.safetensors ``` -## 워크플로우 구조 노트 +## 워크플로 구조 노트 -두 FastH3 워크플로우는 베이스 H3 구성과 다음 노드를 공유하며, 증류 관련 설정이 추가되어 있습니다: +두 FastH3 워크플로는 베이스 H3 구성과 다음 노드를 공유하며, 증류 관련 설정이 추가되어 있습니다: - **BlockSparseAttention**: Video Sparse Attention(VSA)을 `keep_percent` 10으로, 스케줄의 20% 지점부터 실행하여 품질을 유지하면서 어텐션 비용을 줄입니다 - **MiniMaxH3SigmaShift**: 증류 스케줄에 맞는 H3 시그마 시프트(비디오 10, 오디오 3)를 적용합니다 -- **ComfyMathExpression**: 길이 입력을 24fps의 17k+5 그리드에서 유효한 프레임 `length`로 변환합니다 +- **ComfyMathExpression**: 재생 시간 입력을 24fps의 17k+5 그리드에서 유효한 프레임 `length`로 변환합니다 - **샘플러**: `res_multistep` 샘플러, `simple` 스케줄러, 8스텝 -FastH3 가중치에는 `to_gate_compress` 게이트 레이어가 있고, VSA의 거친 브랜치가 이를 읽습니다. 베이스 H3 체크포인트에는 없습니다. 비교하려면 **Model Sparse Attention** 노드의 `method`를 `sol-attn`으로 두고 시드를 고정하세요. `sol-attn`은 대응 가중치가 필요 없고 어떤 H3 체크포인트에서든 설정한 `tau` 값으로 동작합니다. +FastH3 가중치에는 `to_gate_compress` 게이트 레이어가 있고, VSA의 거친 브랜치가 이를 읽습니다. 베이스 H3 체크포인트에는 없습니다. 방법을 비교하려면 **Model Sparse Attention** 노드의 `method`를 `sol-attn`으로 두고 시드를 동일하게 유지하세요. `sol-attn`은 대응 가중치가 필요 없고 어떤 H3 체크포인트에서든 설정한 `tau` 값으로 동작합니다. diff --git a/ko/tutorials/video/minimax/minimax-h3-prompt-guide.mdx b/ko/tutorials/video/minimax/minimax-h3-prompt-guide.mdx index e45e85a9bc..9fe249a0c4 100644 --- a/ko/tutorials/video/minimax/minimax-h3-prompt-guide.mdx +++ b/ko/tutorials/video/minimax/minimax-h3-prompt-guide.mdx @@ -2,12 +2,12 @@ title: "ComfyUI MiniMax H3 프롬프트 가이드: 공식 가이드, 팁, 프롬프트 임베딩" description: "ComfyUI에서 더 나은 MiniMax H3 프롬프트 작성하기: MiniMax 공식 프롬프트 작성 가이드, 일반 프롬프트 팁, 대사와 화자 규칙, 스타일 임베딩." sidebarTitle: "프롬프트 가이드" -translationSourceHash: 0d858ae8 +translationSourceHash: 0f1ded35 translationFrom: tutorials/video/minimax/minimax-h3-prompt-guide.mdx translationBlockHashes: "_intro": da22cc9d "Official guides": 3d762c67 - "General tips": 91822299 + "General tips": fab4ad35 "Shots and cuts": 8184dae6 "Dialogue and speakers": 4985438e "Prompt embeddings": 9c899169 @@ -26,7 +26,7 @@ H3는 하나의 멀티모달 프롬프트에 샷, 카메라, 대사, SFX를 담 ## 일반 팁 -I2VA는 고정 이미지 정렬 줄, 빈 줄, 본문 필드. FL2VA/L2VA는 각 정렬 줄; T2VA는 필드부터: +I2VA는 고정된 이미지 정렬 줄과 빈 줄로 시작한 뒤 본문 필드가 이어집니다. FL2VA/L2VA는 자체 정렬 줄을 사용하며, T2VA는 필드부터 바로 시작합니다: ```text integrated_multimodal_description: [Shot 1] ... @@ -34,19 +34,19 @@ overall_soundscape: ... non_diegetic_music: ... ``` -프롬프트는**영어**; 대사/가사 ``; 화면 텍스트 원문. +프롬프트는 **영어**로 작성합니다. 대사/가사는 `` 태그 안에 넣고, 화면 텍스트는 원래 언어 그대로 옮깁니다. -1. **장면 우선**: 전체 후 `integrated_multimodal_description` `[Shot 1]` 샷 -2. **한 블록**: 샷, 카메라, 오디오 -3. **해상도**: 16:9 네이티브 **1344×768**; **32** 배수 -4. **길이**: `length` 24fps 프레임(기본 **124** ≈ 5s), **17k+5** 스냅 -5. **화면 텍스트**: 영어 큰따옴표·원문(예 `A red neon sign reading "营业中"`); 대사 `` -6. **R2V 오디오 마커**: `fully_copy`, `partially_copy`, `reference`, `weak_reference`(공식 ref 표) -7. **오디오 필드**: `overall_soundscape` 환경/SFX/비언어(1–4문; 진짜 무음만 `N/A`). 대사·다이제틱 음악은 샷 안. `non_diegetic_music` 스코어만(1–3문; 없으면 `N/A`) -8. **네거티브 없음**: `BasicGuider` `cfg` 1, 네거티브 분기 없음. 금지 목록 역효과; 나타낼 것을 쓰거나 R2V 유지 필드 -9. **참조 시트(R2V)**: 한 이미지 다패널; 별도 ``(`` 안만 쓰지 말 것), 샷에서 패널 지정(예 `` 정면 전신) +1. **장면 우선**: 전체 장면을 먼저 쓰고, 그다음 `integrated_multimodal_description`의 `[Shot 1]` 안에 시간별 샷을 작성합니다 +2. **하나의 블록**: 샷, 카메라, 오디오를 함께 작성합니다 +3. **해상도**: 16:9 기준 네이티브 **1344×768**; **32**의 배수를 사용합니다 +4. **길이**: `length`는 24fps 기준 프레임 수이며(기본 **124** ≈ 5s), **17k+5**에 맞춰집니다 +5. **화면 텍스트**: 문자열마다 영어 큰따옴표로 원문 그대로 표기합니다(예: `A red neon sign reading "营业中"`). 대사는 큰따옴표가 아니라 ``를 사용합니다 +6. **R2V 오디오 마커**: 유지 분석에서 각 오디오 참조를 `fully_copy`, `partially_copy`, `reference`, `weak_reference` 중 하나로 표시해 클립이 사용되는 방식과 일치시킵니다(공식 ref 가이드 표 참고) +7. **오디오 필드**: `overall_soundscape` = 앰비언트/SFX/비언어 사운드(1–4문장; 완전히 무음일 때만 `N/A`). 대사와 다이제틱 음악은 샷 안에 남깁니다. `non_diegetic_music` = 스코어만(1–3문장; 없으면 `N/A`). 원치 않는 말소리가 나타나면 두 필드를 모두 명시적으로 채웁니다 +8. **네거티브 없음**: `BasicGuider`는 네거티브 분기 없이 `cfg` 1로 실행됩니다. 금지 목록은 오히려 원치 않는 개념을 추가합니다. 나타나야 하는 것을 서술하세요(또는 R2V 유지 필드 `fully_preserved`, `partially_preserved` 등을 사용하세요) +9. **참조 시트(R2V)**: 하나의 이미지에 여러 패널을 담을 수 있습니다. 시트에 자체 ``을 부여하고(`` 안에만 두지 말 것), 패널을 설명한 뒤 샷에서 특정 패널을 가리키게 하세요(예: ``의 정면 전신). 패널 라벨을 명확히 표시하세요 -워크플로별 태그는 각 워크플로 페이지. +워크플로별 태그와 컨트롤은 각 워크플로 페이지에 있습니다. ## 샷과 컷 diff --git a/zh/development/api-development/sdks.mdx b/zh/development/api-development/sdks.mdx index dffa890068..b192412580 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 @@ -144,7 +144,7 @@ const client = new Comfy({ apiKey: "comfyui-..." }); 开箱即用。创建 [API 密钥](/zh/development/api-development/getting-an-api-key) 并将其传递给客户端。 - API 访问需要付费的 Comfy Cloud 订阅。免费层级不包含此权限。一次可以运行多少个任务取决于您的层级。请参阅[并发限制](/zh/development/deploy/cloud-usage#并发限制)。 + API 访问需要付费的 Comfy Cloud 订阅。免费层级不包含此访问权限。一次可以运行多少个任务取决于您的层级。请参阅[并发限制](/zh/development/deploy/cloud-usage#并发限制)。 diff --git a/zh/development/cloud/api-reference.mdx b/zh/development/cloud/api-reference.mdx index c2908985e9..183ad780b9 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 @@ -343,7 +343,7 @@ print(f"Submitted job: {prompt_id}") ### 使用合作节点 -如果您的工作流包含[合作节点](/zh/tutorials/partner-nodes/overview)(调用外部 AI 服务的节点,如 Flux Pro、Ideogram 等),您必须在请求负载的 `extra_data` 字段中包含您的 [Comfy API 密钥](/zh/development/api-development/getting-an-api-key)。 +如果您的工作流包含[合作节点](/zh/tutorials/partner-nodes/overview)(即调用 Flux Pro、Ideogram 等外部 AI 服务的节点),您必须在请求负载的 `extra_data` 字段中包含您的 [Comfy API 密钥](/zh/development/api-development/getting-an-api-key)。 在浏览器中运行工作流时,ComfyUI 前端会自动将您的 API 密钥打包到 `extra_data` 中。本节仅适用于直接调用 API 的情况。 @@ -392,7 +392,7 @@ def submit_workflow_with_partner_nodes(workflow: dict, api_key: str) -> str: Args: workflow: API 格式的 ComfyUI 工作流 - api_key: 您来自 platform.comfy.org 的 API 密钥 + api_key: 您从 platform.comfy.org 获取的 API 密钥 Returns: 用于跟踪任务的 prompt_id @@ -416,7 +416,7 @@ prompt_id = submit_workflow_with_partner_nodes(workflow, API_KEY) - 在 [platform.comfy.org](https://platform.comfy.org/login) 生成您的 API 密钥。此密钥与 Cloud API 身份验证(`X-API-Key` 请求头)使用的是同一个密钥。请参阅[获取 API 密钥](/zh/development/api-development/getting-an-api-key)了解详细步骤。 + 请在 [platform.comfy.org](https://platform.comfy.org/login) 生成您的 API 密钥。此密钥与用于 Cloud API 身份验证(`X-API-Key` 请求头)的是同一个密钥。请参阅[获取 API 密钥](/zh/development/api-development/getting-an-api-key)了解分步说明。 ### 修改工作流输入 diff --git a/zh/development/comfy-router/limitations.mdx b/zh/development/comfy-router/limitations.mdx index ba749ba687..ee7533d251 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: d97521f9 translationFrom: development/comfy-router/limitations.mdx translationBlockHashes: "_intro": 6b871cf3 @@ -13,9 +13,9 @@ translationBlockHashes: "Request bodies are capped": 675b77c8 "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 - "Router does not cover every partner operation": 97d31362 + "Comfy charges and usage": 7f5ccda7 + "Models without a pre-flight estimate": 495bdb2b + "Router does not cover every partner operation": 786c0fb2 "Model outputs and stored assets": 06c737c1 "Next": be85b789 --- @@ -102,48 +102,52 @@ Router 只返回最终响应,不提供流式 token、服务器发送事件、 响应中可能包含提供商的用量或成本字段,但它们并不代表通用的 Comfy 收费。`X-Comfy-Credits-Used` 是可选响应头:缺失该响应头意味着成本未被报告,而不是该次运行免费。重放的响应(`Idempotent-Replayed: true`)不会再次计费,但可能重复给出原始运行的数字,因此不要将同一个 `Idempotency-Key` 的多次重试中的该响应头累加。请使用 Comfy 平台查询余额、用量和发票。 -模型目录提供计费事实,包括 `billing.charges_on_policy_rejection`,但不提供价格。请显式处理 `yes`、`no` 和 `unknown`。参见[计费](/zh/development/comfy-router/billing#模型计费事实)。 +模型目录提供计费事实,包括 `billing.charges_on_policy_rejection`,但不提供价格。请显式处理 `yes`、`no` 和 `unknown`。当其值为 `yes` 时,同步的 `content_policy_violation` 错误可能携带 `X-Comfy-Credits-Used`:若提供商拒绝了模型已生成的输出,且 Comfy 为该次被拒绝的生成记录了用量,则该错误会携带这个响应头,并给出相应的数量。输入侧的拒绝和同键重放不会携带该响应头;没有该响应头的拒绝表示未报告成本,而不是免费。参见[计费](/zh/development/comfy-router/billing#模型计费事实)。 -要在运行之前查看价格,可以调用 `POST /v2/models/{provider}/{model}/estimate`,或读取已排队提交的 `201` 响应中的 `estimate` 对象。在估算功能逐步推出的期间,该路由会返回 `403`,并附带 `error_type: not_enabled`,同时提交响应中会省略 `estimate`。两者的价格都来自 Comfy 为该次运行计费所依据的费率卡,但该数字只是估算值,并非最终收费;最终以你工作区的用量与计费记录中的结算金额为准。它也不是价格锁定。使用你自己的提供商密钥运行不会被 Comfy 计费,即使 `/estimate` 为其返回了数字;而 `unknown` 估算不包含任何数字,这并不意味着免费。`X-Comfy-Credits-Used` 仍然只是一次运行的事后四舍五入数字,而不是收据。关于如何解读 `exact`、`estimated` 和 `unknown`,参见[预检成本估算](/zh/development/comfy-router/reference#预检费用预估)。无法在运行前定价的模型列在[没有预检估算的模型](#无法预先估算的模型)中。 +要在运行之前查看价格,可以调用 `POST /v2/models/{provider}/{model}/estimate`,或读取排队提交的 `201` 响应中的 `estimate` 对象。在估算功能逐步推出的期间,该路由会返回 `403`,并附带 `error_type: not_enabled`,同时提交响应中会省略 `estimate`。两者的价格都来自 Comfy 为该次运行计费所依据的费率卡(对于按供应商所报告成本计费的模型,则改为根据供应商公布的价格表估算),但该数字只是估算值,并非最终收费;最终以你工作区的用量与计费记录中的结算金额为准。它也不是价格锁定。使用你自己的提供商密钥运行不会被 Comfy 计费,即使 `/estimate` 为其返回了数字;而 `unknown` 估算不包含任何数字,这并不意味着免费。`X-Comfy-Credits-Used` 仍然只是一次运行的事后四舍五入数字,而不是收据。关于如何解读 `exact`、`estimated` 和 `unknown`,参见[预检成本估算](/zh/development/comfy-router/reference#预检费用预估)。无法在运行前定价的模型列在[没有预检估算的模型](#无法预先估算的模型)中。 ## 无法预先估算的模型 -Router 目前还无法在运行前可靠地为对以下模型的调用定价,因此对于这些模型,`/estimate` 以及排队提交的 `estimate` 都会返回 `source: unknown`,不过其中一些模型针对特定请求体可能会返回具体数额。`unknown` 表示未给出数额,而不是说明该次运行免费。[Comfy 计费与用量](#comfy-费用与用量) 规则仍然适用:使用你自己的提供商密钥运行不会由 Comfy 计费,并且 `X-Comfy-Credits-Used` 是可选的,因此缺少该响应头意味着费用未被报告。未列在此处的模型针对特定请求体同样可能返回 `unknown`,所以请对每次估算都查看 `source`。 +Router 目前还无法在运行前可靠地为对以下模型的调用定价,因此对于这些模型,`/estimate` 以及排队提交的 `estimate` 都会返回 `source: unknown`,不过其中一些模型针对特定请求体可能会返回具体数额。`unknown` 表示未给出数额,并不代表该次运行免费。[Comfy 计费与用量](#comfy-费用与用量) 规则仍然适用:使用你自己的提供商密钥运行不会由 Comfy 计费,并且 `X-Comfy-Credits-Used` 是可选的,因此缺少该响应头意味着费用未被报告。未列在此处的模型针对特定请求体同样可能返回 `unknown`,所以请对每次估算都查看 `source`。 随着估算覆盖范围不断扩大,这个列表会逐渐缩短。它由 Router 自身的定价代码生成,且未公开提供的模型永远不会被列出。 {/* BEGIN GENERATED: models without a pre-flight estimate. Do not hand-edit; regenerate with -update-quote-coverage-docs. */} -- **bfl**: `bfl/erase-v1`, `bfl/flux-2-max`, `bfl/flux-2-pro`, `bfl/flux-3-image`, `bfl/flux-3-video`, `bfl/flux-kontext-max`, `bfl/flux-kontext-pro`, `bfl/flux-pro-1.0-expand`, `bfl/flux-pro-1.0-fill`, `bfl/flux-pro-1.1`, `bfl/flux-pro-1.1-ultra`, `bfl/video-edit-v1`, `bfl/video-upscale-v1`, `bfl/vto-v1` +- **bfl**: `bfl/erase-v1`, `bfl/video-edit-v1`, `bfl/video-upscale-v1`, `bfl/vto-v1` - **byteplus**: `byteplus/seed-audio-1.0`, `byteplus/seed-audio-1.0-multilingual` -- **elevenlabs**: `elevenlabs/eleven_sfx_v2` - **fal**: `fal/crystal-upscaler`, `fal/crystal-video-upscaler`, `fal/fal-gpt-image-2`, `fal/fal-gpt-image-2.5-flare`, `fal/fal-gpt-image-2.5-sunburst`, `fal/fal-nano-banana-2`, `fal/fal-nano-banana-pro`, `fal/fal-seedance-2.0`, `fal/fal-seedance-2.5`, `fal/flux-3-max`, `fal/patina` - **freepik**: `freepik/ai-image-upscaler-precision-v2`, `freepik/ai-skin-enhancer-creative`, `freepik/ai-skin-enhancer-faithful`, `freepik/ai-skin-enhancer-flexible` - **heygen**: `heygen/starfish` - **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` +- **luma**: `luma/photon-1`, `luma/photon-flash-1` - **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` +- **openai**: `openai/gpt-image-1.5` - **openrouter**: `openrouter/chat-completions` - **pika**: `pika/pika-gpt-image-2`, `pika/pika-nano-banana-2`, `pika/pika-nano-banana-pro` -- **recraft**: `recraft/recraftv2`, `recraft/recraftv3`, `recraft/recraftv4`, `recraft/recraftv4_1`, `recraft/recraftv4_1_pro`, `recraft/recraftv4_1_pro_vector`, `recraft/recraftv4_1_utility`, `recraft/recraftv4_1_utility_pro`, `recraft/recraftv4_1_utility_pro_vector`, `recraft/recraftv4_1_utility_vector`, `recraft/recraftv4_1_vector`, `recraft/recraftv4_pro`, `recraft/recraftv4_styles`, `recraft/recraftv4_styles_pro`, `recraft/recraftv4_styles_pro_vector`, `recraft/recraftv4_styles_vector` - **runware**: `runware/runware-gpt-image-2`, `runware/runware-gpt-image-2.5-flare`, `runware/runware-gpt-image-2.5-sunburst`, `runware/runware-nano-banana-2`, `runware/runware-nano-banana-pro`, `runware/runware-seedance-2.0`, `runware/runware-seedance-2.5` -- **runway**: `runway/gen4_image` - **synclabs**: `synclabs/sync-3` - **veed**: `veed/clean-audio`, `veed/clean-audio-video`, `veed/fabric-1.0`, `veed/lipsync-2.0`, `veed/video-background-removal`, `veed/video-background-removal-fast`, `veed/video-background-removal-green-screen` -- **wavespeed**: `wavespeed/flashvsr`, `wavespeed/seedvr2`, `wavespeed/ultimate-image-upscaler`, `wavespeed/wavespeed-gpt-image-2`, `wavespeed/wavespeed-gpt-image-2.5-flare`, `wavespeed/wavespeed-gpt-image-2.5-sunburst` -- **xai**: `xai/grok-imagine-image`, `xai/grok-imagine-image-2.0`, `xai/grok-imagine-image-pro`, `xai/grok-imagine-image-quality`, `xai/grok-imagine-video`, `xai/grok-imagine-video-1.5`, `xai/grok-imagine-video-1.5-lite`, `xai/grok-imagine-video-1.5-preview` +- **wavespeed**: `wavespeed/wavespeed-gpt-image-2`, `wavespeed/wavespeed-gpt-image-2.5-flare`, `wavespeed/wavespeed-gpt-image-2.5-sunburst` {/* END GENERATED: models without a pre-flight estimate */} +对 `openai/gpt-image-2`、`openai/gpt-image-2.5-flare` 和 `openai/gpt-image-2.5-sunburst` 的编辑同样没有预检估算。对这些模型之一发起编辑调用,或者发起携带输入图像的生成调用,都会返回 `source: unknown`。对它们的纯文本生成调用则可以估算,这正是它们不在上方列表中的原因。 + ## Router 并不覆盖每个合作伙伴操作 Router 运行模型。文件上传、账户读取、资产管理、流式传输以及提供商任务控制可能需要位于 `/proxy/…` 下的合作伙伴代理路由,这些路由处在 Router 之外,Router 的契约也不涵盖它们。Router 自身对外提供的接口以 [Comfy Router 规范](/router-openapi.yaml) 为准;支持情况因提供商而异。 -### Krea 3 的参考图像必须先上传 +### Krea 3 参考图像:先上传,或使用公共 https URL + +在 `krea/krea-3` 的 `image_urls` 中,由 `POST /proxy/krea/assets` 返回的 `image_url`(即 `https://app-uploads.krea.ai/...` URL)始终会被接受。其他链接是否会被接受取决于环境;在 api.comfy.org 上目前会被接受。 + +- **在会接受其他链接的环境中**,任何公共 `https` 图像 URL 都可以使用。Router 会在模型运行前读取每张图像的尺寸:主机无法公开访问或根本不存在的链接、返回 `408` 或 `429` 之外 `4xx` 的链接,或者指向的不是图像的链接,都会被拒绝并返回 `400` `invalid_input`,并指明其主机。暂时性的 DNS、TLS 或连接失败、超时,或源站返回 `408` 或 `429`,都会以 `502` 错误失败。不是有效上传的 `app-uploads.krea.ai` 链接会像其他任何不可达的参考一样被拒绝并返回 `400`。服务器刚启动时,在尚未确定适用哪条规则之前,不是 `app-uploads.krea.ai` 链接的公共 `https` URL 可能会失败并返回 `503`,此时可以安全重试。 +- **在不接受其他链接的环境中**,每一项都必须是某次上传得到的 `image_url`。Router 只检查该链接能否解析为 `https` URL,且其主机名恰好是 `app-uploads.krea.ai`(不能是其他主机,也不能带显式端口):任何其他链接,包括你自己托管的公共 `https` URL,都会在模型运行前被拒绝并返回 `400` `invalid_input`。通过该检查但并非有效上传的链接(已过期、已删除或输入有误)仍会通过,随后 Router 无法读取图像尺寸,返回 `5xx` 错误而不是 `400`。 -`krea/krea-3` 不接受任意图像链接。`image_urls` 中的每一项都必须是 `POST /proxy/krea/assets` 返回的 `image_url`,也就是一个 `https://app-uploads.krea.ai/...` URL。Router 只检查该链接能否解析为 `https` URL,并且其主机名恰好是 `app-uploads.krea.ai`(不能是其他主机,也不能带显式端口):任何其他链接,包括你自己托管的公共 `https` URL,都会在模型运行前被拒绝,并返回 `400` `invalid_input`。通过了该检查但并非仍然有效的上传链接(已过期、已删除或输入有误)仍会通过,随后 Router 无法读取图像尺寸,并返回 `5xx` 错误而不是 `400`,因此请始终原样传入上传返回的 `image_url`。 +上传在所有环境中都可用,因此是可移植的选择;请始终原样传入上传返回的 `image_url`。 1. 将每张参考图像以 `multipart/form-data` 上传,图像放在表单字段 `file` 中(JPEG、PNG 或 WebP,最大 75 MB)。使用与 Router 相同的方式进行身份验证,即使用 `X-API-Key` 或 `Authorization: Bearer`。 diff --git a/zh/development/comfy-router/litellm.mdx b/zh/development/comfy-router/litellm.mdx index 5cc2509c46..f1cefaa889 100644 --- a/zh/development/comfy-router/litellm.mdx +++ b/zh/development/comfy-router/litellm.mdx @@ -2,12 +2,12 @@ title: "将 Comfy Router 与 LiteLLM 配合使用" sidebarTitle: "LiteLLM" description: "将 Comfy Router 置于 LiteLLM Proxy 之后作为直通端点,并从 x-litellm-response-cost 响应头中记录每次运行的确切美元成本,无需维护价格表。" -translationSourceHash: e35cd883 +translationSourceHash: 8183ff58 translationFrom: development/comfy-router/litellm.mdx translationBlockHashes: "_intro": 1ddb0d0a "Configure the pass-through": 380c3ae3 - "How spend is recorded": f852c18c + "How spend is recorded": 699ed64b "Queued delivery": 46044c93 "Notes": 50e3cf6b --- @@ -91,7 +91,7 @@ X-Litellm-Response-Cost: 0.0592417062 X-Litellm-Total-Tokens: 0 ``` -`X-Comfy-Credits-Used` 是该次运行以 Comfy 积分表示的价格,四舍五入到两位小数。`X-Litellm-Response-Cost` 是同一价格由未舍入的积分数量换算成的美元金额,因此用显示的积分数除以换算比率,结果可能与它在最后几位上有所不同。响应头名称不区分大小写,所以 LiteLLM 会将其读取为 `x-litellm-response-cost`。LiteLLM 会原样记录它,并用它替代你的 `cost_per_request`。`x-litellm-total-tokens` 始终为 `0`,因为媒体类运行不按 token 计量。 +`X-Comfy-Credits-Used` 是该次运行以 Comfy 积分表示的价格,四舍五入到两位小数。`X-Litellm-Response-Cost` 是同一价格由未舍入的积分数量换算成的美元金额,因此用显示的积分数除以换算比率得到的结果,在最后几位上可能与之不同。响应头名称不区分大小写,所以 LiteLLM 会将其读取为 `x-litellm-response-cost`。LiteLLM 会原样记录它,并用它替代你的 `cost_per_request`。`x-litellm-total-tokens` 始终为 `0`,因为媒体类运行不按 token 计量。 与 `X-Comfy-Credits-Used` 一样,该响应头报告的是价格,而不是已结算的扣费。请以[工作区计费](https://platform.comfy.org)为准核对,而不是以 LiteLLM 的合计为准。 @@ -102,11 +102,11 @@ X-Litellm-Total-Tokens: 0 - 使用你自己的提供商密钥计费、而不是计入你的 Comfy 积分的运行 - 尚未列入 Router 会报告每次运行积分价格的模型列表中的模型。该列表较为保守,有些提供商完全不在其中 - 未进入 Comfy 计费环节的扣费 -- 错误响应 +- 错误响应。对于 `billing.charges_on_policy_rejection` 为 `yes` 的模型,其同步 `content_policy_violation` 可能携带 `X-Comfy-Credits-Used`,其值为被拒绝那次生成的价格;它绝不会携带 `x-litellm-response-cost`,因为错误不是 LiteLLM 应记录的结果 -当 Router 针对使用相同 `Idempotency-Key` 的重试(通过代理发送时为 `x-pass-Idempotency-Key`)重放已存储的结果时,该响应头也会缺失。该重试不会再次计费,因此这次重放不会第二次报告该次运行的确切成本。出于同样的原因,排队运行的结果收集中只有一次会携带该响应头,即该次运行的价格被记录后的第一次收集;再次收集同一结果仍会返回 `X-Comfy-Credits-Used`,但不会返回 `x-litellm-response-cost`。 +当 Router 针对使用相同 `Idempotency-Key` 的重试(该键通过代理发送时名为 `x-pass-Idempotency-Key`)重放已存储的结果时,该响应头也会缺失。该重试不会再次计费,因此这次重放不会第二次报告该次运行的确切成本。出于同样的原因,排队运行的结果收集中只有一次会携带该响应头,即该次运行的价格被记录后的第一次收集;再次收集同一结果仍会返回 `X-Comfy-Credits-Used`,但不会返回 `x-litellm-response-cost`。 -当该响应头缺失时,LiteLLM 会回退到端点的 `cost_per_request`。这适用于上述所有情况。因此,错误响应、使用你自己的提供商密钥计费的运行以及幂等重放,都会按你设置的估值记录,即使 Comfy 并未为此扣除你的积分。请将 `cost_per_request` 设置为对典型运行的合理估值,而不是 `0`,这样不报告成本的运行就不会在你的支出报告中显示为免费,同时也要预期这些记录会使 LiteLLM 的合计高于你的 Comfy 账单。一次已被定价且确实没有任何花费的运行会报告 `x-litellm-response-cost: 0`,LiteLLM 会将其记录为零。 +当该响应头缺失时,LiteLLM 会回退到端点的 `cost_per_request`。这适用于上述所有情况。因此,错误响应、使用你自己的提供商密钥计费的运行以及幂等重放,都会按你的估值记录。其中大多数并未从你的积分中扣费,但并非全部:携带 `X-Comfy-Credits-Used` 的内容策略拒绝已被定价,因此应从该响应头读取其成本;另外,少数其他失败(例如 Router 无法将生成结果交还给你的情况)可能已计费,却没有报告成本。请以工作区的用量记录为准核对。请将 `cost_per_request` 设置为对典型运行的合理估值,而不是 `0`,这样不报告成本的运行就不会在你的支出报告中显示为免费;同时也要预期这些记录会使 LiteLLM 的合计高于你的 Comfy 账单。一次已被定价且确实没有任何花费的运行会报告 `x-litellm-response-cost: 0`,LiteLLM 会将其记录为零。 ## 队列投递 diff --git a/zh/development/comfy-router/models.mdx b/zh/development/comfy-router/models.mdx index 614ecfce4c..ebe7e56c31 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: 3c934831 translationFrom: development/comfy-router/models.mdx translationBlockHashes: "_intro": 2584e428 - "Find by output": 380e121d + "Find by output": 9b1b4039 "Anthropic": de8acc20 "Beeble": b52ea340 "Black Forest Labs": 2934e3eb @@ -23,12 +23,12 @@ translationBlockHashes: "Kling": 3002befa "Krea": 16b83e5e "LTX": 32595bf9 - "Luma": 37a12a19 + "Luma": 8cd2a7ce "Luma 2": 585eb637 - "Meshy": 9292a0a8 + "Meshy": 67e26a17 "MiniMax": 87560ab7 "Moonvalley": 9e63fb77 - "OpenAI": c5c4af80 + "OpenAI": a5c1e692 "Openrouter": a4f6806b "Pika": f2b1d797 "Pruna": 903d76ee @@ -53,7 +53,7 @@ translationBlockHashes: ## 按输出查找 - + - [SwitchX](/zh/development/comfy-router/models/beeble/switchx/code):`beeble/switchx` - [FLUX 3 Video](/zh/development/comfy-router/models/black-forest-labs/flux-3-video/code):`bfl/flux-3-video` @@ -89,8 +89,6 @@ translationBlockHashes: - [LTX 2.5 Fast](/zh/development/comfy-router/models/ltx/ltx-2-5-fast/code):`ltx/ltx-2-5-fast` - [LTX 2.5 Pro](/zh/development/comfy-router/models/ltx/ltx-2-5-pro/code):`ltx/ltx-2-5-pro` - [Ray 3.2](/zh/development/comfy-router/models/luma_2/ray-3-2/code):`luma_2/ray-3.2` -- [Ray 2](/zh/development/comfy-router/models/luma/ray-2/code):`luma/ray-2` -- [Ray Flash 2](/zh/development/comfy-router/models/luma/ray-flash-2/code):`luma/ray-flash-2` - [MiniMax H3](/zh/development/comfy-router/models/minimax/minimax-h3/code):`minimax/minimax-h3` - [Image To Video](/zh/development/comfy-router/models/moonvalley/image-to-video/code):`moonvalley/image-to-video` - [Text To Video](/zh/development/comfy-router/models/moonvalley/text-to-video/code):`moonvalley/text-to-video` @@ -106,8 +104,7 @@ translationBlockHashes: - [Lipsync 2.0](/zh/development/comfy-router/models/veed/lipsync-2-0/code):`veed/lipsync-2.0` - [Video Background Removal Fast](/zh/development/comfy-router/models/veed/video-background-removal-fast/code):`veed/video-background-removal-fast` - [Video Background Removal Green Screen](/zh/development/comfy-router/models/veed/video-background-removal-green-screen/code):`veed/video-background-removal-green-screen` -- [Video Background Removal](/zh/development/comfy-router/models/veed/video-background-removal/code):`veed/video-background-removal` -- [Veo 3.1 Fast Generate 001](/zh/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code):`veo/veo-3.1-fast-generate-001` +- [Video Background Removal](/zh/development/comfy-router/models/veed/video-background-removal/code):`veed/video-background-removal`- [Veo 3.1 Fast Generate 001](/zh/development/comfy-router/models/veo/veo-3-1-fast-generate-001/code):`veo/veo-3.1-fast-generate-001` - [Veo 3.1 Generate 001](/zh/development/comfy-router/models/veo/veo-3-1-generate-001/code):`veo/veo-3.1-generate-001` - [Veo 3.1 Lite Generate 001](/zh/development/comfy-router/models/veo/veo-3-1-lite-generate-001/code):`veo/veo-3.1-lite-generate-001` - [HappyHorse 1.0 I2V](/zh/development/comfy-router/models/wan/happyhorse-1-0-i2v/code):`wan/happyhorse-1.0-i2v` @@ -135,7 +132,7 @@ translationBlockHashes: - [Grok Imagine Video](/zh/development/comfy-router/models/xai/grok-imagine-video/code):`xai/grok-imagine-video` - + - [SwitchX](/zh/development/comfy-router/models/beeble/switchx/code):`beeble/switchx` - [Erase V1](/zh/development/comfy-router/models/black-forest-labs/erase-v1/code):`bfl/erase-v1` @@ -160,9 +157,7 @@ translationBlockHashes: - [图像编辑:重新打光](/zh/development/comfy-router/models/bria/image-edit-relight/code):`bria/image-edit-relight` - [图像编辑:引导式移除背景](/zh/development/comfy-router/models/bria/image-edit-remove-background-guided/code):`bria/image-edit-remove-background-guided` - [图像编辑:移除背景](/zh/development/comfy-router/models/bria/image-edit-remove-background/code):`bria/image-edit-remove-background` -- [图像编辑:替换背景](/zh/development/comfy-router/models/bria/image-edit-replace-background/code):`bria/image-edit-replace-background` -- [图像编辑:按文本替换对象](/zh/development/comfy-router/models/bria/image-edit-replace-object-by-text/code):`bria/image-edit-replace-object-by-text` -- [图像编辑:Reseason](/zh/development/comfy-router/models/bria/image-edit-reseason/code):`bria/image-edit-reseason` +- [图像编辑:替换背景](/zh/development/comfy-router/models/bria/image-edit-replace-background/code):`bria/image-edit-replace-background`- [图像编辑:Reseason](/zh/development/comfy-router/models/bria/image-edit-reseason/code):`bria/image-edit-reseason` - [图像编辑:修复](/zh/development/comfy-router/models/bria/image-edit-restore/code):`bria/image-edit-restore` - [图像](/zh/development/comfy-router/models/bria/image/code):`bria/image` - [Seedream 4.0 250828](/zh/development/comfy-router/models/byteplus/seedream-4-0-250828/code):`byteplus/seedream-4-0-250828` @@ -198,7 +193,6 @@ translationBlockHashes: - [Photon 1](/zh/development/comfy-router/models/luma/photon-1/code):`luma/photon-1` - [Photon Flash 1](/zh/development/comfy-router/models/luma/photon-flash-1/code):`luma/photon-flash-1` - [GPT Image 1.5](/zh/development/comfy-router/models/openai/gpt-image-1-5/code):`openai/gpt-image-1.5` -- [GPT Image 1](/zh/development/comfy-router/models/openai/gpt-image-1/code):`openai/gpt-image-1` - [GPT Image 2.5 Flare](/zh/development/comfy-router/models/openai/gpt-image-2-5-flare/code):`openai/gpt-image-2.5-flare` - [GPT Image 2.5 Sunburst](/zh/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code):`openai/gpt-image-2.5-sunburst` - [GPT Image 2](/zh/development/comfy-router/models/openai/gpt-image-2/code):`openai/gpt-image-2` @@ -213,9 +207,7 @@ translationBlockHashes: - [Recraft V4.1 Utility Vector](/zh/development/comfy-router/models/recraft/recraftv4-1-utility-vector/code):`recraft/recraftv4_1_utility_vector` - [Recraft V4.1 Utility](/zh/development/comfy-router/models/recraft/recraftv4-1-utility/code):`recraft/recraftv4_1_utility` - [Recraft V4.1 Vector](/zh/development/comfy-router/models/recraft/recraftv4-1-vector/code):`recraft/recraftv4_1_vector` -- [Recraft V4.1](/zh/development/comfy-router/models/recraft/recraftv4-1/code):`recraft/recraftv4_1` -- [Recraft V4 Pro](/zh/development/comfy-router/models/recraft/recraftv4-pro/code):`recraft/recraftv4_pro` -- [Recraft V4 Styles Pro Vector](/zh/development/comfy-router/models/recraft/recraftv4-styles-pro-vector/code):`recraft/recraftv4_styles_pro_vector` +- [Recraft V4.1](/zh/development/comfy-router/models/recraft/recraftv4-1/code):`recraft/recraftv4_1`- [Recraft V4 Styles Pro Vector](/zh/development/comfy-router/models/recraft/recraftv4-styles-pro-vector/code):`recraft/recraftv4_styles_pro_vector` - [Recraft V4 Styles Pro](/zh/development/comfy-router/models/recraft/recraftv4-styles-pro/code):`recraft/recraftv4_styles_pro` - [Recraft V4 Styles Vector](/zh/development/comfy-router/models/recraft/recraftv4-styles-vector/code):`recraft/recraftv4_styles_vector` - [Recraft V4 Styles](/zh/development/comfy-router/models/recraft/recraftv4-styles/code):`recraft/recraftv4_styles` @@ -269,14 +261,13 @@ translationBlockHashes: - [Wan 2.5 T2V Preview](/zh/development/comfy-router/models/wan/wan2-5-t2v-preview/code):`wan/wan2.5-t2v-preview` - [Wan 2.6 I2V](/zh/development/comfy-router/models/wan/wan2-6-i2v/code):`wan/wan2.6-i2v` - [Wan 2.6 R2V](/zh/development/comfy-router/models/wan/wan2-6-r2v/code):`wan/wan2.6-r2v` -- [Wan 2.6 T2V](/zh/development/comfy-router/models/wan/wan2-6-t2v/code):`wan/wan2.6-t2v` -- [Wan 2.7 I2V](/zh/development/comfy-router/models/wan/wan2-7-i2v/code):`wan/wan2.7-i2v` +- [Wan 2.6 T2V](/zh/development/comfy-router/models/wan/wan2-6-t2v/code):`wan/wan2.6-t2v`- [Wan 2.7 I2V](/zh/development/comfy-router/models/wan/wan2-7-i2v/code):`wan/wan2.7-i2v` - [Wan 2.7 T2V](/zh/development/comfy-router/models/wan/wan2-7-t2v/code):`wan/wan2.7-t2v` - [Wan 3.0 Video Prime](/zh/development/comfy-router/models/wan/wan3-0-video-prime/code):`wan/wan3.0-video-prime` - [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 6](/zh/development/comfy-router/models/meshy/meshy-6/code):`meshy/meshy-6` @@ -290,7 +281,7 @@ translationBlockHashes: - [Hunyuan 3D Uv](/zh/development/comfy-router/models/tencent/hunyuan-3d-uv/code):`tencent/hunyuan-3d-uv` - + - [Claude Fable 5.1](/zh/development/comfy-router/models/anthropic/claude-fable-5-1/code):`anthropic/claude-fable-5-1` - [Claude Fable 5](/zh/development/comfy-router/models/anthropic/claude-fable-5/code):`anthropic/claude-fable-5` @@ -319,7 +310,6 @@ translationBlockHashes: - [Nano Banana 2](/zh/development/comfy-router/models/google/nano-banana-2/code):`vertexai/gemini-3.1-flash-image` - [Nano Banana Pro](/zh/development/comfy-router/models/google/nano-banana-pro/code):`vertexai/gemini-3-pro-image` - [GPT 4.1 Mini](/zh/development/comfy-router/models/openai/gpt-4-1-mini/code):`openai/gpt-4.1-mini` -- [GPT 4.1 Nano](/zh/development/comfy-router/models/openai/gpt-4-1-nano/code):`openai/gpt-4.1-nano` - [GPT 4.1](/zh/development/comfy-router/models/openai/gpt-4-1/code):`openai/gpt-4.1` - [GPT 4o](/zh/development/comfy-router/models/openai/gpt-4o/code):`openai/gpt-4o` - [GPT 5.5 Pro](/zh/development/comfy-router/models/openai/gpt-5-5-pro/code):`openai/gpt-5.5-pro` @@ -332,11 +322,7 @@ translationBlockHashes: - [GPT 5](/zh/development/comfy-router/models/openai/gpt-5/code):`openai/gpt-5` - [GPT 6 Astra](/zh/development/comfy-router/models/openai/gpt-6-astra/code):`openai/gpt-6-astra` - [GPT 6 Luna](/zh/development/comfy-router/models/openai/gpt-6-luna/code):`openai/gpt-6-luna` -- [GPT 6 Sol](/zh/development/comfy-router/models/openai/gpt-6-sol/code):`openai/gpt-6-sol` -- [o1-pro](/zh/development/comfy-router/models/openai/o1-pro/code):`openai/o1-pro` -- [o1](/zh/development/comfy-router/models/openai/o1/code):`openai/o1` -- [o3](/zh/development/comfy-router/models/openai/o3/code):`openai/o3` -- [o4-mini](/zh/development/comfy-router/models/openai/o4-mini/code):`openai/o4-mini` +- [GPT 6 Sol](/zh/development/comfy-router/models/openai/gpt-6-sol/code):`openai/gpt-6-sol`- [o3](/zh/development/comfy-router/models/openai/o3/code):`openai/o3` - [Chat Completions](/zh/development/comfy-router/models/openrouter/chat-completions/code):`openrouter/chat-completions` @@ -543,8 +529,6 @@ translationBlockHashes: | --- | --- | --- | --- | | [Photon 1](/zh/development/comfy-router/models/luma/photon-1/code) | `luma/photon-1` | 文本 | 图像 | | [Photon Flash 1](/zh/development/comfy-router/models/luma/photon-flash-1/code) | `luma/photon-flash-1` | 文本 | 图像 | -| [Ray 2](/zh/development/comfy-router/models/luma/ray-2/code) | `luma/ray-2` | 文本, 图像 | 视频 | -| [Ray Flash 2](/zh/development/comfy-router/models/luma/ray-flash-2/code) | `luma/ray-flash-2` | 文本, 图像 | 视频 | ## Luma 2 @@ -583,30 +567,25 @@ translationBlockHashes: | 模型 | ID | 输入 | 输出 | | --- | --- | --- | --- | -| [GPT 4.1 Mini](/zh/development/comfy-router/models/openai/gpt-4-1-mini/code) | `openai/gpt-4.1-mini` | 文本, 图像 | 文本 | -| [GPT 4.1 Nano](/zh/development/comfy-router/models/openai/gpt-4-1-nano/code) | `openai/gpt-4.1-nano` | 文本, 图像 | 文本 | -| [GPT 4.1](/zh/development/comfy-router/models/openai/gpt-4-1/code) | `openai/gpt-4.1` | 文本, 图像 | 文本 | -| [GPT 4o](/zh/development/comfy-router/models/openai/gpt-4o/code) | `openai/gpt-4o` | 文本, 图像 | 文本 | -| [GPT 5.5 Pro](/zh/development/comfy-router/models/openai/gpt-5-5-pro/code) | `openai/gpt-5.5-pro` | 文本, 图像 | 文本 | -| [GPT 5.5](/zh/development/comfy-router/models/openai/gpt-5-5/code) | `openai/gpt-5.5` | 文本, 图像 | 文本 | -| [GPT 5.6 Luna](/zh/development/comfy-router/models/openai/gpt-5-6-luna/code) | `openai/gpt-5.6-luna` | 文本, 图像 | 文本 | -| [GPT 5.6 Sol](/zh/development/comfy-router/models/openai/gpt-5-6-sol/code) | `openai/gpt-5.6-sol` | 文本, 图像 | 文本 | -| [GPT 5.6 Terra](/zh/development/comfy-router/models/openai/gpt-5-6-terra/code) | `openai/gpt-5.6-terra` | 文本, 图像 | 文本 | -| [GPT 5 Mini](/zh/development/comfy-router/models/openai/gpt-5-mini/code) | `openai/gpt-5-mini` | 文本, 图像 | 文本 | -| [GPT 5 Nano](/zh/development/comfy-router/models/openai/gpt-5-nano/code) | `openai/gpt-5-nano` | 文本, 图像 | 文本 | -| [GPT 5](/zh/development/comfy-router/models/openai/gpt-5/code) | `openai/gpt-5` | 文本, 图像 | 文本 | -| [GPT 6 Astra](/zh/development/comfy-router/models/openai/gpt-6-astra/code) | `openai/gpt-6-astra` | 文本, 图像 | 文本 | -| [GPT 6 Luna](/zh/development/comfy-router/models/openai/gpt-6-luna/code) | `openai/gpt-6-luna` | 文本, 图像 | 文本 | -| [GPT 6 Sol](/zh/development/comfy-router/models/openai/gpt-6-sol/code) | `openai/gpt-6-sol` | 文本, 图像 | 文本 | -| [GPT Image 1.5](/zh/development/comfy-router/models/openai/gpt-image-1-5/code) | `openai/gpt-image-1.5` | 文本, 图像 | 图像 | -| [GPT Image 1](/zh/development/comfy-router/models/openai/gpt-image-1/code) | `openai/gpt-image-1` | 文本, 图像 | 图像 | -| [GPT Image 2.5 Flare](/zh/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | `openai/gpt-image-2.5-flare` | 文本, 图像 | 图像 | -| [GPT Image 2.5 Sunburst](/zh/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | `openai/gpt-image-2.5-sunburst` | 文本, 图像 | 图像 | -| [GPT Image 2](/zh/development/comfy-router/models/openai/gpt-image-2/code) | `openai/gpt-image-2` | 文本, 图像 | 图像 | -| [o1-pro](/zh/development/comfy-router/models/openai/o1-pro/code) | `openai/o1-pro` | 文本, 图像 | 文本 | -| [o1](/zh/development/comfy-router/models/openai/o1/code) | `openai/o1` | 文本, 图像 | 文本 | -| [o3](/zh/development/comfy-router/models/openai/o3/code) | `openai/o3` | 文本, 图像 | 文本 | -| [o4-mini](/zh/development/comfy-router/models/openai/o4-mini/code) | `openai/o4-mini` | 文本, 图像 | 文本 | +| [GPT 4.1 Mini](/zh/development/comfy-router/models/openai/gpt-4-1-mini/code) | `openai/gpt-4.1-mini` | 文本、图像 | 文本 | +| [GPT 4.1](/zh/development/comfy-router/models/openai/gpt-4-1/code) | `openai/gpt-4.1` | 文本、图像 | 文本 | +| [GPT 4o](/zh/development/comfy-router/models/openai/gpt-4o/code) | `openai/gpt-4o` | 文本、图像 | 文本 | +| [GPT 5.5 Pro](/zh/development/comfy-router/models/openai/gpt-5-5-pro/code) | `openai/gpt-5.5-pro` | 文本、图像 | 文本 | +| [GPT 5.5](/zh/development/comfy-router/models/openai/gpt-5-5/code) | `openai/gpt-5.5` | 文本、图像 | 文本 | +| [GPT 5.6 Luna](/zh/development/comfy-router/models/openai/gpt-5-6-luna/code) | `openai/gpt-5.6-luna` | 文本、图像 | 文本 | +| [GPT 5.6 Sol](/zh/development/comfy-router/models/openai/gpt-5-6-sol/code) | `openai/gpt-5.6-sol` | 文本、图像 | 文本 | +| [GPT 5.6 Terra](/zh/development/comfy-router/models/openai/gpt-5-6-terra/code) | `openai/gpt-5.6-terra` | 文本、图像 | 文本 | +| [GPT 5 Mini](/zh/development/comfy-router/models/openai/gpt-5-mini/code) | `openai/gpt-5-mini` | 文本、图像 | 文本 | +| [GPT 5 Nano](/zh/development/comfy-router/models/openai/gpt-5-nano/code) | `openai/gpt-5-nano` | 文本、图像 | 文本 | +| [GPT 5](/zh/development/comfy-router/models/openai/gpt-5/code) | `openai/gpt-5` | 文本、图像 | 文本 | +| [GPT 6 Astra](/zh/development/comfy-router/models/openai/gpt-6-astra/code) | `openai/gpt-6-astra` | 文本、图像 | 文本 | +| [GPT 6 Luna](/zh/development/comfy-router/models/openai/gpt-6-luna/code) | `openai/gpt-6-luna` | 文本、图像 | 文本 | +| [GPT 6 Sol](/zh/development/comfy-router/models/openai/gpt-6-sol/code) | `openai/gpt-6-sol` | 文本、图像 | 文本 | +| [GPT Image 1.5](/zh/development/comfy-router/models/openai/gpt-image-1-5/code) | `openai/gpt-image-1.5` | 文本、图像 | 图像 | +| [GPT Image 2.5 Flare](/zh/development/comfy-router/models/openai/gpt-image-2-5-flare/code) | `openai/gpt-image-2.5-flare` | 文本、图像 | 图像 | +| [GPT Image 2.5 Sunburst](/zh/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code) | `openai/gpt-image-2.5-sunburst` | 文本、图像 | 图像 | +| [GPT Image 2](/zh/development/comfy-router/models/openai/gpt-image-2/code) | `openai/gpt-image-2` | 文本、图像 | 图像 | +| [o3](/zh/development/comfy-router/models/openai/o3/code) | `openai/o3` | 文本、图像 | 文本 | ## Openrouter diff --git a/zh/development/comfy-router/models/black-forest-labs/flux-video-upscale/code.mdx b/zh/development/comfy-router/models/black-forest-labs/flux-video-upscale/code.mdx index c5872803d7..b231125169 100644 --- a/zh/development/comfy-router/models/black-forest-labs/flux-video-upscale/code.mdx +++ b/zh/development/comfy-router/models/black-forest-labs/flux-video-upscale/code.mdx @@ -2,16 +2,17 @@ title: "通过 Comfy Router 使用 FLUX Video Upscale" description: "使用 Python、TypeScript 和 cURL 代码片段,通过 Comfy Router 以 HTTP 方式调用 FLUX Video Upscale 对视频进行放大,并说明请求字段与结果结构" sidebarTitle: "FLUX Video Upscale" -translationSourceHash: 0b09f0ee +translationSourceHash: 37a8dde1 translationFrom: development/comfy-router/models/black-forest-labs/flux-video-upscale/code.mdx translationBlockHashes: "_intro": cf804f5f "Quick start": b745a238 - "Schema": 4675f835 + "Schema": c0dca73f "Examples": d1ffa3d6 --- + {/* GENERATED FILE. Edit code.yaml in this directory and run `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -170,11 +171,11 @@ curl https://api.comfy.org/v2/models/bfl/video-upscale-v1/requests/$REQUEST_ID \ - 要放大的视频,可以是 HTTP(S) URL 或 base64 编码的 MP4。来源素材最长 20 秒且不超过 50MB。 + 要放大的视频,可以是 HTTP(S) URL 或 base64 编码的 MP4。来源素材最长 20 秒,且每帧不超过 50MB 和 2560x1440(3.7 兆像素);若来源素材更大,请先缩小再提交。 - 可选的片段内容描述,用于引导增强后的细节。留空则进行中性的放大处理。 + 可选的视频片段内容描述,用于引导增强后的细节。留空则进行中性的放大处理。 @@ -184,7 +185,7 @@ curl https://api.comfy.org/v2/models/bfl/video-upscale-v1/requests/$REQUEST_ID \ - 输出相对于来源分辨率的缩放倍数。输出会保留来源的宽高比,并限制在每帧约 14.4 兆像素以内,因此非常大的来源素材放大倍数会小于请求的值。 + 输出相对于来源分辨率的缩放倍数。输出会保留来源的宽高比,并限制在每帧约 14.4 兆像素以内,因此非常大的来源素材放大倍数会小于请求的值。没有分辨率选项;若要得到 2K(2560x1440)或 4K(3840x2160),请用目标高度除以来源高度。720p 的来源在倍数为 2 时达到 2K,倍数为 3 时达到 4K;1080p 的来源在倍数为 2 时达到 4K,但无法达到 2K,因为那需要 1.33。 范围:`1.5` 到 `3` 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..fa4f513a38 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,17 +2,18 @@ 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 --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/bria/image-edit-relight.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -160,7 +161,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" 之一。 @@ -168,7 +169,7 @@ curl https://api.comfy.org/v2/models/bria/image-edit-relight/requests/$REQUEST_I 要应用的光照氛围,取值为 "midday"、"blue hour light"、"low-angle sunlight"、"sunrise light"、"spotlight on subject, keep background settings"、"overcast light"、"soft overcast daylight lighting"、"cloud-filtered lighting"、"fog-diffused lighting"、"moonlight lighting"、"starlight lighting nighttime"、"soft bokeh lighting" 或 "harsh studio lighting keep background setting" 之一。 -由 Router 在 `GET /v2/models/bria/image-edit-relight/openapi.json` 提供的 schema 生成,该文档也是请求到达提供商之前 Router 用于校验调用的同一份文档。 +根据 Router 在 `GET /v2/models/bria/image-edit-relight/openapi.json` 提供的 schema 生成,该文档也是请求到达提供商之前 Router 用于校验调用的同一份文档。 ### 输出 @@ -205,7 +206,7 @@ curl https://api.comfy.org/v2/models/bria/image-edit-relight/requests/$REQUEST_I - 提示词的优化版本;若 COMPLETED 的生成任务中 Bria 未进行优化,则为 null。可为 null 是因为该键是存在的并携带 null,而不是被省略;在 bria/image-edit-gen-fill 上实际观察到过。 + 提示词的优化版本;若 COMPLETED 的生成任务中 Bria 未进行优化,则为 null。可为 null 是因为该键存在并携带 null,而不是被省略;在 bria/image-edit-gen-fill 上实际观察到过。 diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx index b41516a4fd..b038fd77c2 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx @@ -2,19 +2,17 @@ title: "使用 Dreamina Seedance 2.0 260128 与 Comfy Router" description: "通过 Comfy Router 调用 byteplus/dreamina-seedance-2-0-260128:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Dreamina Seedance 2.0 260128" -translationSourceHash: 98890ddf +translationSourceHash: 9604ca27 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx translationBlockHashes: "_intro": 54eac94b "Quick start": ca074ca5 "Serving providers": 74eb2a7c - "Schema": 5c27d10f + "Schema": 6c5da06a "Examples": 641c458b --- - - {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/byteplus/dreamina-seedance-2-0-260128.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -196,17 +194,17 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128/reque ### 输入 - 本次生成任务结果的回调通知地址 + 已忽略。仅为兼容 BytePlus 的请求结构而接受该字段,但在任务提交前会被移除,因此永远不会发送回调;请改为轮询任务状态接口获取结果。 格式:`uri` - 模型用于生成视频的输入内容 + 供模型生成视频的输入内容 - 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须至少包含 1 个图像或视频;Seedance 2.5 支持仅音频输入。 + 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须至少包含 1 个图像或视频;Seedance 2.5 支持纯音频输入。 @@ -218,11 +216,11 @@ Base64:格式为 data:audio/\;base64,\ 仅 Seedance 2.5 支持。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 -最终视频会复用该 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些参数。分辨率默认为且仅支持 1080p。 +最终视频会复用 Draft 任务的 prompt、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;不要再次发送这些内容。resolution 默认为且仅支持 1080p。 - 使用 `draft` 设为 true 创建 Draft 视频时返回的任务 ID。 + 创建 Draft 视频时 `draft` 设为 true 所返回的任务 ID。 @@ -232,7 +230,7 @@ Base64:格式为 data:audio/\;base64,\ 用于图生视频生成的图像内容(当 type 为 "image_url" 时) 图片网址:请确保图片网址可访问。 -Base64 编码的内容:格式必须为 data:image/\;base64,\ +Base64 编码内容:格式必须为 data:image/\;base64,\ 资产 ID:格式为 asset://\ @@ -246,9 +244,9 @@ Base64 编码的内容:格式必须为 data:image/\;base64,\ - 模型输入的文本信息。包含文本提示词和可选参数。 + 模型的输入文本信息。包括文本提示词和可选参数。 -文本提示词(必填):使用中文和英文字符描述要生成的视频。 +文本提示词(必填):使用中英文字符描述要生成的视频。 参数(可选):在文本提示词后添加 --[parameters] 以控制视频规格: - --resolution(--rs):480p、720p、1080p(默认:720p) @@ -256,16 +254,20 @@ Base64 编码的内容:格式必须为 data:image/\;base64,\ - --duration(--dur):3-12 秒(默认:5) - --framepersecond(--fps):24(默认:24) - --watermark(--wm):true/false(默认:false) -- --seed(--seed):-1 至 2^32-1(默认:-1) +- --seed(--seed):-1 到 2^32-1(默认:-1) - --camerafixed(--cf):true/false(默认:false) 示例:"A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -Comfy 侧的保护性限制,并非 BytePlus 的约束。BytePlus 未公布文本长度限制,在测试中接受了 40,000 个字符(2026-09-17)。 -它按字符计数而非字节,因此多字节的提示词在传输时可能达到该数值的数倍。它约束的是这一个字段,而不是整个请求: -`content` 是一个数组,整体文档受每次请求的体积上限约束。实施该限制的界面是 -Comfy Router(/v2/models/byteplus/\{model});直接调用 v1 /proxy 时,则由 BytePlus 自己的校验器给出响应。 -该值设置得远高于真实流量,因此它绝不会对真实提示词做出判定:如果调用方需要更多,可以提高该值。 +这是 Comfy 侧的保护限制,并非 BytePlus 的约束。BytePlus 未公布 +文本长度限制,且在测试中接受了 40,000 个字符(2026-09-17)。 +它统计的是字符数而非字节数,因此多字节提示词在传输时可能达到该上限的 +数倍。它只约束这一个字段,而不约束整个请求: +`content` 是数组,整个文档由每请求的请求体上限约束。 +执行该限制的入口是 Comfy Router(/v2/models/byteplus/\{model}); +在直接调用 v1 /proxy 时,则由 BytePlus 自身的校验器作答。 +该值设置得远高于真实流量,因此永远不会对真实提示词做出裁定。如果调用方需要更多, +可以提高它。 @@ -285,102 +287,119 @@ Comfy Router(/v2/models/byteplus/\{model});直接调用 v1 /proxy 时, - 仅 Seedance 2.5 支持。生成 480p 的 Draft 视频;分辨率必须为 480p。 -将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 + 仅 Seedance 2.5 支持。生成 480p 的 Draft 视频;resolution 必须为 480p。 +将返回的任务 ID 传入 `draft_task` 内容项即可渲染最终的 1080p 视频。Draft 任务 ID 有效期为 7 天。 - 视频时长(秒)。Seedance 2.5:[4,30] 或 -1(自动;视频编辑任务仅支持 -1)。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。Seedance 1.5 pro:[4,12] 或 -1。Seedance 1.0:[2,12]。 + 视频时长,单位为秒。Seedance 2.5:[4,30] 或 -1(自动;视频编辑任务仅支持 -1)。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。Seedance 1.5 pro:[4,12] 或 -1。Seedance 1.0:[2,12]。 - 范围:`2` 至 `30` + 范围:`2` 到 `30` 任务超时阈值,单位为秒。默认 172800(48 小时)。范围:[3600, 259200]。 - 范围:`3600` 至 `259200` + 范围:`3600` 到 `259200` Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 true:模型输出带同步音频的视频。 false:模型输出无声视频。 -在支持该功能的模型上,生成的音轨由提供商与视频分开进行内容审核;此处的拒绝会报告为 `content_policy_violation`,而且由于每次运行的音频都不同,对提供商本来接受的输入也可能间歇性地出现拒绝。遇到这种情况时发送 `false` 即可得到无声视频;这只在音频是被拒的模态时有效,同步的 Router 响应会在此时标明 `refusal_subject: output_audio`(排队请求目前还不会指明这一点)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改为用 `false` 重新创建 Draft。 +在支持该功能的模型上,生成的音轨会由提供商与视频分开进行内容审核;若此处被拒绝,会以 `content_policy_violation` 报告,并且由于每次运行的音频都不同,对于提供商本来可以接受的输入,这种拒绝可能是间歇性的。发生这种情况时,发送 `false` 可获得静音视频;但这仅在音频是被拒绝的模态时才有帮助,同步的 Router 响应会将其标记为 `refusal_subject: output_audio`(排队中的请求尚无法指明这一点)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此应改用 `false` 重新创建 Draft。 + + - 要调用的模型 ID。支持的模型:seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini 和 dreamina-seedance-2-5-260628。直接调用 v1 的 POST /proxy/byteplus/api/v3/contents/generations/tasks 时必须提供该值:代理会拒绝任何其他值,若省略该值则返回 400。它不在本结构的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方会省略它。 + 要调用的模型 ID。支持的模型:seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini 和 dreamina-seedance-2-5-260628。直接以 v1 调用 POST /proxy/byteplus/api/v3/contents/generations/tasks 时必须提供它:代理会以 400 拒绝任何其他值,以及省略该值的情况。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方会省略它。 - 仅 Seedance 2.5 支持。输出视频的容器格式。mp4:通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 + 仅 Seedance 2.5。输出视频的容器格式。 +mp4:通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 mov:专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 - 可选值:`mp4`、`mov` + 可选值:`mp4`, `mov` - 已生成视频的宽高比。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认:adaptive。 -Seedance 2.5 首帧 / 首尾帧生成:输出会沿用首帧的宽高比,因此只接受 `adaptive`(或省略该字段);具体比例会在派发之前以 400 拒绝。Seedance 2.0 在这些模式下接受具体比例。 + 生成视频的宽高比。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认值:adaptive。 +Seedance 2.5 首帧 / 首尾帧生成:输出会遵循首帧的宽高比,因此只接受 `adaptive`(或省略该字段);具体比例会在派发之前以 400 被拒绝。Seedance 2.0 在这些模式下接受具体比例。 - 可选值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` + 可选值:`16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认:720p。Seedance 1.0 pro 和 pro-fast 默认:1080p。 + 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认值:720p。Seedance 1.0 pro 和 pro-fast 默认值:1080p。 注意:Seedance 2.0、2.0 fast 和 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p 和 1080p。 - 可选值:`480p`、`720p`、`1080p`、`4k` + 可选值:`480p`, `720p`, `1080p`, `4k` - 是否返回已生成视频的最后一帧图像。 -true:返回已生成视频的最后一帧图像。将该参数设置为 true 后,你可以通过调用查询视频生成任务信息来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,并且不包含水印。使用该参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 -false:不返回已生成视频的最后一帧图像。 + 是否返回已生成视频的尾帧图像。 +true:返回已生成视频的尾帧图像。将此参数设置为 true 后,可以通过调用查询视频生成任务信息来获取尾帧图像。尾帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,并且不包含水印。使用该参数可以实现多个连续视频的生成:将前一个已生成视频的尾帧作为下一个视频任务的首帧,从而快速生成多个连续视频。 +false:不返回已生成视频的尾帧图像。 用于控制随机性的种子整数。范围:[-1, 2^32-1]。-1 表示使用随机种子。 - 范围:`-1` 至 `4294967295` + 取值范围:`-1` 至 `4294967295` - 处理所用的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 + 用于处理的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 - 可选值:`default`、`flex` + 可选值:`default`, `flex` 已生成视频是否包含水印。 -由 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json` 提供的 schema 生成,该文档也是请求到达提供商之前 Router 用于校验调用的同一份文档。 +本文档由 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json` 提供的 schema 生成,这也是它在请求到达提供商之前用于校验调用的同一份文档。 ### 输出 - 视频生成任务完成后返回的输出,其中包含输出视频的下载 URL,以及在 BytePlus 返回时包含其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储上;此处其他所有字段均来自 BytePlus 本身。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,因此在之后轮询到的成功文档可能不带 `content` 字段,或该字段为 null。 + 视频生成任务完成后得到的输出,包含输出视频的下载 URL,以及当 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储;这里的其他字段都是 BytePlus 自己的。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,而在此之后轮询一个已成功的文档时,`content` 可能缺失或为 null。 - 生成视频最后一帧的下载 URL,在请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它收到的任意字节,并根据上游的 Content-Type 或内容嗅探来确定类型,只有在两者都失败时才回退为 `image/jpeg`。Router 会将最后一帧重新托管到 Comfy 存储并重写此字段,因此它通常是有效期最长 24 小时的 Comfy 签名 URL:签发时按 24 小时签名,并从 23 小时的缓存中重放,因此之后的轮询可能返回一个仅剩一小时有效期的 URL。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除该 URL。无论哪种方式,链接都会过期,因此请下载该帧,而不要保存 URL。 + 已生成视频最后一帧的下载 URL,当请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它实际收到的字节,并根据上游 Content-Type 或内容嗅探确定其类型,而仅当两者都失败时,`image/jpeg` 才是最后的兜底值。Router 会将最后一帧重新托管到 Comfy 存储并重写此字段,因此它通常是一个有效期最长 24 小时的 Comfy 签名 URL:生成时按 24 小时签名,并从 23 小时的缓存记录中重放,所以后续轮询可能返回一个剩余有效期仅一小时的 URL。当无法执行重新托管时,该字段会改为保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除该 URL。无论哪种情况,链接都会过期,因此请下载该帧,而不要存储 URL。 - 生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 内时提供。Seedance 模型更常将其作为 `content` 的顶层同级字段返回,请参阅顶层的 `output_format` 字段。Router 会读取两者中存在的那个。 + 已生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 内时提供。Seedance 模型更常将其作为 `content` 的顶层同级字段返回,参见顶层 `output_format` 字段;Router 会读取两者中存在的那个。 + + + + 上游 URL 停止工作的 RFC 3339 时间:最早签名时间加上这些 URL 自身携带的有效期,当存在 `updated_at` 时,不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档中说明的 URL 生存期);否则为任务的 `updated_at` 加 24 小时。仅当存在 `upstream_video_url` 或 `upstream_last_frame_url` 时出现;当两个来源都未提供时间时省略。与重新托管的 `video_url` / `last_frame_url` 的生存期无关。 + + 格式:`date-time` + + + + BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 并列、按与 `upstream_video_url` 相同的条件逐字节原样返回:仅限已选择加入的工作区,仅限 Seedance 2.x,BytePlus 清除后即缺失,并且在 `upstream_expires_at` 之前是 bearer 凭证。 + + + + BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 并列逐字节原样返回。仅当轮询 Seedance 2.x 任务的工作区已在服务器端被 Comfy 选择加入时出现(没有请求参数);对其他所有情况均缺失,包括无法解析到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥),并且在生成 24 小时后 BytePlus 清除其 URL 后即缺失。它是预签名对象存储 URL,因此也是一种 bearer 凭证:任何持有它的人都能在过期前下载视频,所以请将其视为机密。它在 `upstream_expires_at` 过期;在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次会被 Router 自身的重新托管消耗。 - 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写此字段,因此它通常是有效期最长 24 小时的 Comfy 签名 URL:签发时按 24 小时签名,并从 23 小时的缓存中重放,因此之后的轮询可能返回一个仅剩一小时有效期的 URL。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除该 URL,并且在某些模型上将其下载次数上限设为 100 次。无论哪种方式,链接都会过期,因此请下载该视频,而不要保存 URL。 + 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写此字段,因此它通常是一个有效期最长 24 小时的 Comfy 签名 URL:生成时按 24 小时签名,并从 23 小时的缓存记录中重放,所以后续轮询可能返回一个剩余有效期仅一小时的 URL。当无法执行重新托管时,该字段会改为保留 BytePlus 自己的 URL;BytePlus 会在任务完成 24 小时后清除该 URL,并在某些模型上将其限制为 100 次下载。无论哪种情况,链接都会过期,因此请下载视频,而不要存储 URL。 - 任务创建的时间。该值为 UNIX 时间戳(秒)。 + 任务创建的时间。该值为以秒为单位的 UNIX 时间戳。 - 生成视频的时长(秒)。声明为数字而非整数,是因为 BytePlus 在这点上并不一致:观察到视频任务返回整秒数,而 BytePlus 的其他同类接口会报告小数时长,因此客户端不能假定其为整数值。这是 BytePlus 自有字段,在成功的视频任务中返回并原样转发。 + 已生成视频的时长,单位为秒。声明为 number 而非 integer,因为 BytePlus 在这点上并不一致:已观察到视频任务返回整秒,而 BytePlus 的其他同级接口会报告小数时长,因此客户端不得假定它是整数值。BytePlus 自己的字段,在已成功的视频任务上返回,并原样转发。 @@ -388,7 +407,7 @@ false:不返回已生成视频的最后一帧图像。 - 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示因内容策略而被拒绝。同一系列可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而非枚举:其他错误码描述验证失败和提供商失败。Router 会在 HTTP 400 错误信封和 HTTP 200 失败任务响应中识别策略系列,但不会覆盖传输层失败。 + 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。某个系列可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而非枚举:其他错误码描述验证和提供商失败。Router 会在 HTTP 400 错误响应封装和 HTTP 200 失败任务响应中识别策略系列,而不会覆盖传输失败。 @@ -404,31 +423,31 @@ false:不返回已生成视频的最后一帧图像。 - 生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回:这正是 Seedance 视频任务查询返回它的位置。这是 BytePlus 自有字段,原样转发。 + 生成视频的容器格式(`mp4` 或 `mov`),在顶层(TOP LEVEL)作为 `content` 的同级字段返回:Seedance 视频任务查询正是从此处返回该字段。这是 BytePlus 自有字段,原样透传。 - 生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在成功的视频任务中返回并原样转发。 + 生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在成功的视频任务上返回并原样透传。 - 该任务实际使用的生成种子。这是 BytePlus 自有字段,在成功的视频任务中返回并原样转发。 + 任务实际使用的生成种子。这是 BytePlus 自有字段,在成功的视频任务上返回并原样透传。 格式:`int64` - 任务的状态 + 任务状态 可能的值:`queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` - 任务最后更新的时间。该值为 UNIX 时间戳(秒)。 + 任务最后更新的时间。该值为 UNIX 时间戳,单位为秒。 - 该请求的 token 用量 + 请求的 token 用量 @@ -436,7 +455,7 @@ false:不返回已生成视频的最后一帧图像。 - 对于视频生成模型,不计算输入 token 数,默认为 0。因此,total_tokens = completion_tokens。 + 对于视频生成模型,不计算输入 token 数量,默认为 0。因此,total_tokens = completion_tokens。 ## 示例 diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx index 25f2608e22..63415ed683 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx @@ -2,17 +2,16 @@ title: "使用 Comfy Router 调用 Dreamina Seedance 2.0 Fast 260128" description: "通过 Comfy Router 调用 byteplus/dreamina-seedance-2-0-fast-260128:端点、请求结构以及 Router 返回的响应。" sidebarTitle: "Dreamina Seedance 2.0 Fast 260128" -translationSourceHash: acad6428 +translationSourceHash: b02c6ed1 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx translationBlockHashes: "_intro": e4deed0d "Quick start": f5201dd4 - "Schema": a00368da + "Schema": e03c503a "Examples": 7714eccd --- - {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-0-fast-260128.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -181,7 +180,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128/ ### 输入 - 本次生成任务结果的回调通知地址 + 已忽略。保留该字段是为了兼容 BytePlus 的请求结构,但它会在任务提交前被移除,因此不会发送任何回调;请改为轮询任务状态路由来获取结果。 格式:`uri` @@ -191,23 +190,23 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128/ - 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须至少包含 1 个图像或视频;Seedance 2.5 支持仅音频输入。 + 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须包含至少 1 个图像或视频;Seedance 2.5 支持纯音频输入。 音频 URL、Base64 编码或资产 ID。 音频 URL:音频的公开 URL(wav、mp3)。 -Base64:格式为 data:audio/\;base64,\ -资产 ID:格式为 asset://\ +Base64:格式 data:audio/\;base64,\ +资产 ID:格式 asset://\ 仅 Seedance 2.5。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 -最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次提交这些内容。分辨率默认为且仅支持 1080p。 +最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;不要再次发送它们。resolution 默认为 1080p,且仅支持 1080p。 - 创建 Draft 视频(`draft` 设为 true)时返回的任务 ID。 + 使用 `draft` 设置为 true 创建 Draft 视频时返回的任务 ID。 @@ -215,9 +214,9 @@ Base64:格式为 data:audio/\;base64,\ - 用于图生视频生成的图像内容(当 type 为 "image_url" 时) -图像 URL:请确保图像 URL 可访问。 -Base64 编码内容:格式必须为 data:image/\;base64,\ + 图生视频生成的图像内容(当 type 为 "image_url" 时) +图片网址:确保图片网址可访问。 +Base64 编码的内容:格式必须为 data:image/\;base64,\ 资产 ID:格式为 asset://\ @@ -231,30 +230,25 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ - 供模型使用的输入文本信息。包括文本提示词和可选参数。 + 模型的输入文本信息。包括文本提示词和可选参数。 -文本提示词(必填):使用中英文字符描述要生成的视频。 +文本提示词(必填):使用中文字符和英文字符描述要生成的视频。 -参数(可选):在文本提示词后添加 --[parameters] 以控制视频规格: -- --resolution (--rs):480p、720p、1080p(默认:720p) -- --ratio (--rt):21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(默认:16:9 或 adaptive) -- --duration (--dur):3-12 秒(默认:5) -- --framepersecond (--fps):24(默认:24) -- --watermark (--wm):true/false(默认:false) -- --seed (--seed):-1 到 2^32-1(默认:-1) -- --camerafixed (--cf):true/false(默认:false) +参数(可选):在文本提示词后添加 --[parameters],以控制视频规格: +- --resolution (--rs): 480p、720p、1080p(默认值:720p) +- --ratio (--rt): 21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(默认值:16:9 或 adaptive) +- --duration (--dur): 3-12 秒(默认值:5) +- --framepersecond (--fps): 24(默认值:24) +- --watermark (--wm): true/false(默认值:false) +- --seed (--seed): -1 到 2^32-1(默认值:-1) +- --camerafixed (--cf): true/false(默认值:false) 示例:"A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -Comfy 侧的护栏限制,而非 BytePlus 的约束。BytePlus 未公布 -文本长度限制,且在测试(2026-09-17)中接受了 40,000 个字符。 -它按字符计数,而非字节,因此多字节提示词在传输时可能是 -该大小的数倍。它约束的是这一个字段,而不是请求本身: -`content` 是一个数组,整个文档受每个请求的请求体限制约束。 -Comfy Router(/v2/models/byteplus/\{model})是执行该限制的接口; -在直接调用 v1 /proxy 时,则由 BytePlus 自己的校验器来响应。 -其设置远高于真实流量,因此绝不会对真实提示词做出裁决。如果调用方 -需要更多,可以调高它。 +这是 Comfy 侧的防护限制,不是 BytePlus 的约束。BytePlus 并未公布文本长度限制,并在测试中接受了 40,000 个字符(2026-09-17)。 +它按字符数而非字节数计算,因此多字节提示词在实际传输时可能达到该字符数的数倍。它只限制这一个字段,而不是整个请求: +`content` 是一个数组,整个文档由每请求正文大小限制来约束。Comfy Router(/v2/models/byteplus/\{model})是执行该限制的入口; +直接调用 v1 /proxy 时,则由 BytePlus 自己的验证器作出响应。该限制设置得远高于真实流量,因此绝不会判定真实提示词;如果调用方需要更多,请提高该限制。 @@ -275,7 +269,7 @@ Comfy Router(/v2/models/byteplus/\{model})是执行该限制的接口; 仅 Seedance 2.5。生成 480p 的 Draft 视频;分辨率必须为 480p。 -将返回的任务 ID 传入 `draft_task` 内容项以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 +将返回的任务 ID 放入 `draft_task` 内容项,以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 @@ -292,40 +286,40 @@ Comfy Router(/v2/models/byteplus/\{model})是执行该限制的接口; Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 -true:模型输出带有同步音频的视频。 -false:模型输出无声视频。 -在支持该功能的模型上,生成的音轨由提供商与视频分开进行内容审核;此处的拒绝会报告为 `content_policy_violation`,而且由于每次运行的音频都不同,对提供商本来接受的输入也可能间歇性地出现拒绝。遇到这种情况时发送 `false` 即可得到无声视频;这只在音频是被拒的模态时有效,同步的 Router 响应会在此时标明 `refusal_subject: output_audio`(排队请求目前还不会指明这一点)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改为用 `false` 重新创建 Draft。 +true: 模型输出包含同步音频的视频。 +false: 模型输出无声视频。在支持该功能的模型上,已生成的音频轨会由提供商与视频分开进行内容检查;若音频在那里被拒绝,会报告为 `content_policy_violation`,并且由于每次运行生成的音频不同,对于提供商原本接受的输入,这种拒绝可能间歇出现。如果发生这种情况,请为静音视频发送 `false`;仅当音频是被拒绝的模态时,这才会有所帮助,同步 Router 响应会以 `refusal_subject: output_audio` 指明这一点(排队中的请求尚不能指明它)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改为使用 `false` 重新创建 Draft。 - 要调用的模型 ID。支持的模型:seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini 和 dreamina-seedance-2-5-260628。直接以 v1 调用 POST /proxy/byteplus/api/v3/contents/generations/tasks 时必须提供它,代理会拒绝任何其他值,若省略则以 400 拒绝。它不在此模式的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方可省略。 + 要调用的模型 ID。支持的模型:seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini 和 dreamina-seedance-2-5-260628。直接向 POST /proxy/byteplus/api/v3/contents/generations/tasks 发起 v1 调用时必须提供它:代理会以 400 拒绝任何其他值;省略该值时也是如此。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方会省略它。 - 仅 Seedance 2.5。输出视频的容器格式。mp4:通用容器(H.264/AAC,yuv420p),兼容性广泛且文件大小更小。 -mov:专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 + 仅适用于 Seedance 2.5。输出视频的容器格式。 +mp4: 通用容器(H.264/AAC、yuv420p),兼容性广,文件大小更小。 +mov: 专业容器(H.264 High 4:4:4 Predictive/PCM、yuv444p),颜色精度高,适合后期制作;文件大小更大。 - 可选值:`mp4`、`mov` + 可能的值:`mp4`、`mov` - 已生成视频的宽高比例。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认值:adaptive。 -Seedance 2.5 首帧 / 首尾帧生成:输出会沿用首帧的宽高比例,因此只接受 `adaptive`(或省略该字段);若指定具体比例,会在派发前以 400 拒绝。Seedance 2.0 在这些模式下可以接受具体比例。 + 生成视频的宽高比。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 的默认值:adaptive。 +Seedance 2.5 的首帧/首尾帧生成:输出会遵循首帧的宽高比,因此仅接受 `adaptive`(或省略该字段);具体比例会在调度前被拒绝并返回 400。在这些模式下,Seedance 2.0 接受具体比例。 - 可选值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` + 可能的值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` - 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认值:720p。Seedance 1.0 pro 与 pro-fast 默认值:1080p。 + 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 的默认值:720p。Seedance 1.0 pro 和 pro-fast 的默认值:1080p。 注意:Seedance 2.0、2.0 fast 和 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p 和 1080p。 - 可选值:`480p`、`720p`、`1080p`、`4k` + 可能的值:`480p`、`720p`、`1080p`、`4k` - 是否返回已生成视频的尾帧图像。 -true:返回已生成视频的尾帧图像。将该参数设为 true 之后,可通过调用查询视频生成任务信息来获取尾帧图像。尾帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不含水印。使用该参数可以生成多个连续的视频:将前一个已生成视频的尾帧作为下一个视频任务的首帧,从而快速生成多个连续视频。 -false:不返回已生成视频的尾帧图像。 + 是否返回已生成视频的最后一帧图像。 +true: 返回已生成视频的最后一帧图像。将此参数设置为 true 后,可以通过调用“查询视频生成任务信息”来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,并且不包含水印。使用此参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 +false: 不返回已生成视频的最后一帧图像。 @@ -335,49 +329,63 @@ false:不返回已生成视频的尾帧图像。 - 用于处理的服务层级。Seedance 2.5、2.0 与 2.0 fast 不支持 flex(离线推理)。 + 用于处理的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 - 可选值:`default`、`flex` + 可能的值:`default`、`flex` 已生成视频是否包含水印。 -根据 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.json` 提供的 schema 生成,该文档与请求到达提供商之前用于校验调用的文档相同。 +根据 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.json` 提供的 schema 生成,该 schema 也是请求到达提供商之前 Router 用来校验调用的同一份文档。 ### 输出 - 视频生成任务完成后得到的输出,其中包含输出视频的下载 URL,以及在 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储上;这里其他所有字段都是 BytePlus 自有的。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,此后轮询到的 succeeded 文档可能缺失 `content` 或其为 null。 + 视频生成任务完成后得到的输出,其中包含输出视频的下载 URL,以及在 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储上;此处的其他字段均为 BytePlus 自带字段。可为空:BytePlus 会在任务完成 24 小时后清空这些 URL,因此在该时间之后轮询已成功的文档时,`content` 可能缺失或为 null。 - 已生成视频最后一帧的下载 URL,当请求设置了 `return_last_frame` 时返回。不要根据该 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它收到的任何字节,并根据上游的 Content-Type 或内容嗅探来判定其类型,只有在两者都失败时才以 `image/jpeg` 作为最后兜底。Router 会将最后一帧重新托管到 Comfy 存储并重写该字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时签名有效期为 24 小时,并从 23 小时的备忘缓存中重放,所以稍后的一次轮询可能返回仅剩一小时有效期的 URL。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后将其清除。无论哪种情况,链接都会过期,因此请下载该帧,而不要只保存 URL。 + 已生成视频最后一帧的下载 URL,仅在请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它实际收到的任意字节,并根据上游的 Content-Type 或内容嗅探来确定其类型,只有两者都失败时才回退为 `image/jpeg`。Router 会将最后一帧重新托管到 Comfy 存储上并改写此字段,因此它通常是一个由 Comfy 签发的签名 URL,有效期最长 24 小时。该 URL 在签发时以 24 小时有效期签名,并从一份 23 小时的备忘中重放,因此后续轮询返回的 URL 剩余有效期可能只有一小时。当无法执行重新托管时,此字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后将其清空。无论哪种情况,链接都会过期,因此请下载该帧,而不要只保存 URL。 - 已生成视频的容器格式(mp4 或 mov),在 BytePlus 将其嵌套在 `content` 内时出现。Seedance 模型更常将其作为 `content` 的顶层同级字段返回,参见顶层的 `output_format` 字段,Router 会读取两者中存在的那个。 + 已生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 内时出现。Seedance 模型更常将其作为 `content` 的顶层同级字段返回,参见顶层 `output_format` 字段,Router 会读取两者中存在的那个。 + + + + RFC 3339 时间,表示上游 URL 失效的时间:即最早的签名时间加上这些 URL 自身携带的有效期;当 `updated_at` 存在时,不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档中所述的 URL 生命周期),否则为任务的 `updated_at` 加 24 小时。仅在存在 `upstream_video_url` 或 `upstream_last_frame_url` 时出现,当两个来源都未提供时间时则省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 + + 格式:`date-time` + + + + BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 一同原样返回,其条件与 `upstream_video_url` 相同:仅限已选择加入的工作区,仅限 Seedance 2.x,BytePlus 清空后即缺失,并且在 `upstream_expires_at` 之前属于持有者凭证。 + + + + BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 一同原样返回。仅当轮询 Seedance 2.x 任务且该任务所属工作区已在服务器端被 Comfy 选择加入时才存在(没有对应的请求参数);对其他所有情况均缺失,包括无法解析到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥),并且在 BytePlus 于生成 24 小时后清空其 URL 后也缺失。它是预签名对象存储 URL,因此属于持有者凭证:任何持有它的人都能在过期前下载该视频,请将其视为机密。它在 `upstream_expires_at` 时过期,并且在 Seedance 2.5 上 BytePlus 将其限制为 100 次下载,其中一次会被 Router 自身的重新托管消耗掉。 - 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写该字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时签名有效期为 24 小时,并从 23 小时的备忘缓存中重放,所以稍后的一次轮询可能返回仅剩一小时有效期的 URL。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后将其清除,并且在某些模型上限制为 100 次下载。无论哪种情况,链接都会过期,因此请下载视频,而不要只保存 URL。 + 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储上并改写此字段,因此它通常是一个由 Comfy 签发的签名 URL,有效期最长 24 小时。该 URL 在签发时以 24 小时有效期签名,并从一份 23 小时的备忘中重放,因此后续轮询返回的 URL 剩余有效期可能只有一小时。当无法执行重新托管时,此字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后将其清空,并在部分模型上将其限制为 100 次下载。无论哪种情况,链接都会过期,因此请下载该视频,而不要只保存 URL。 - 任务的创建时间。该值为 UNIX 时间戳,单位为秒。 + 任务创建的时间。该值为 UNIX 时间戳,单位为秒。 - 已生成视频的时长,单位为秒。声明为 number 而不是 integer,是因为 BytePlus 在这一点上并不一致:视频任务曾观察到返回整数秒,而同类的 BytePlus 接口会报告小数时长,因此客户端不能假定它是整数值。这是 BytePlus 自有字段,在成功的视频任务中返回并原样转发。 + 已生成视频的时长,单位为秒。声明为数字而非整数,是因为 BytePlus 对此并不一致:视频任务曾被观察到返回整秒,而 BytePlus 的其他同类接口会报告带小数的时长,因此客户端不能假定它是整数值。这是 BytePlus 自己的字段,在成功的视频任务上返回并原样转发。 - 错误信息。任务成功时返回 null。任务失败时返回错误信息。 + 错误信息。如果任务成功,则返回 null。如果任务失败,则返回错误信息。 - 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。同一族系可以带以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而非枚举:其他错误码描述验证和提供商故障。Router 会在 HTTP 400 错误信封和 HTTP 200 失败任务响应中识别策略族系,而不会覆盖传输层故障。 + 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。某一类别可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串而非枚举:其他错误码描述验证失败和提供商故障。Router 会在 HTTP 400 错误响应体和 HTTP 200 失败任务响应中识别策略类别,但不会覆盖传输层故障。 @@ -385,47 +393,47 @@ false:不返回已生成视频的尾帧图像。 - 视频生成任务的 ID + The ID of the video generation task - 任务所用模型的名称和版本 + The name and version of the model used by the task - 已生成视频的容器格式(mp4 或 mov),作为 `content` 的同级字段在顶层返回:Seedance 视频任务查询就是在这里返回它的。这是 BytePlus 自有字段,原样转发。 + Container format of the generated video (mp4 or mov), returned at the TOP LEVEL as a sibling of `content` - this is where the Seedance video task query returns it. BytePlus's own field, forwarded unchanged. - 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在成功的视频任务中返回并原样转发。 + The resolution of the generated video, for example `1080p`. BytePlus's own field, returned on succeeded video tasks and forwarded unchanged. - 任务实际使用的生成种子。这是 BytePlus 自有字段,在成功的视频任务中返回并原样转发。 + The generation seed actually used for the task. BytePlus's own field, returned on succeeded video tasks and forwarded unchanged. - 格式:`int64` + Format: `int64` - 任务状态 + The state of the task - 可选值:`queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` + Possible values: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired` - 任务最后更新的时间。该值为 UNIX 时间戳,单位为秒。 + The time when the task was last updated. The value is a UNIX timestamp in seconds. - 本次请求的 token 用量 + The token usage for the request - 模型生成的 token 数量 + The number of tokens generated by the model - 对于视频生成模型,输入 token 数量不予计算,默认为 0。因此 total_tokens = completion_tokens。 + For the video generation model, the number of input tokens is not calculated and defaults to 0. Therefore, total_tokens = completion_tokens. ## 示例 diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx index 64e063d836..a79cb89c41 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx @@ -2,17 +2,16 @@ title: "通过 Comfy Router 使用 Dreamina Seedance 2.0 Mini" description: "通过 Comfy Router 调用 byteplus/dreamina-seedance-2-0-mini:endpoint、请求结构以及 Router 返回的响应。" sidebarTitle: "Dreamina Seedance 2.0 Mini" -translationSourceHash: 69d38df7 +translationSourceHash: 28c5c053 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx translationBlockHashes: "_intro": 45ff5bfd "Quick start": b0374f7d - "Schema": 2279819f + "Schema": 3c26a330 "Examples": db01067e --- - {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/byteplus/dreamina-seedance-2-0-mini.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -352,6 +351,20 @@ false:不返回已生成视频的最后一帧图像。 已生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 内时返回。Seedance 模型更常将其作为 `content` 的顶层同级字段返回,参见顶层的 `output_format` 字段;Router 会读取两者中存在的那个。 + + BytePlus 自身的输出视频下载 URL,与重新托管的 `video_url` 一并按原样返回。仅对由 Comfy 已在服务端开启该功能的工作区轮询的 Seedance 2.x 任务存在(没有对应的请求参数);其他情况都不存在,包括解析不到工作区的凭证(例如未绑定工作区的旧版 API 密钥),以及 BytePlus 在生成 24 小时后清除这些 URL 之后。它是对象存储的预签名 URL,因此也是 bearer 凭证:任何持有它的人都能在过期前下载该视频,请按密钥对待。它在 `upstream_expires_at` 到期;在 Seedance 2.5 上 BytePlus 限制最多下载 100 次,其中一次会被 Router 自己的重新托管消耗。 + + + + BytePlus 自身的末帧下载 URL,与重新托管的 `last_frame_url` 一并按原样返回,条件与 `upstream_video_url` 相同:仅限已开启的工作区、仅限 Seedance 2.x、BytePlus 清除后即不存在,并在 `upstream_expires_at` 之前一直是 bearer 凭证。 + + + + RFC 3339 时间,上游 URL 在该时刻后失效:取 URL 自身携带的最早签名时间加有效期,当 `updated_at` 存在时不超过任务的 `updated_at` 加 24 小时(BytePlus 文档记载的 URL 有效期);否则为任务的 `updated_at` 加 24 小时。仅当 `upstream_video_url` 或 `upstream_last_frame_url` 存在时才存在,两者都无法给出时间时省略。与重新托管的 `video_url` / `last_frame_url` 的有效期无关。 + + 格式:`date-time` + + 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储上并重写此字段,因此它通常是一个有效期最长 24 小时的 Comfy 签名 URL(签发时按 24 小时签名,但从 23 小时的备忘录中回放,因此之后的轮询可能返回一个仅剩一小时有效期的 URL)。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后清除它,并且某些模型上该 URL 最多只允许 100 次下载。无论哪种情况,链接都会过期,因此请下载视频,而不要保存 URL。 diff --git a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx index 9b6d4ea687..a7557fe4e1 100644 --- a/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx +++ b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx @@ -2,18 +2,17 @@ title: "使用 Dreamina Seedance 2.5 260628 与 Comfy Router" description: "通过 Comfy Router 调用 byteplus/dreamina-seedance-2-5-260628:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Dreamina Seedance 2.5 260628" -translationSourceHash: 9a342bd4 +translationSourceHash: 07fd9c64 translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx translationBlockHashes: "_intro": 4b5f4cec "Quick start": a2bb8c28 "Serving providers": 197dd61a - "Schema": 0467a987 + "Schema": 0a76af44 "Examples": 5465695b --- - {/* GENERATED FILE. Generated from router-schemas/byteplus/dreamina-seedance-2-5-260628.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -194,33 +193,33 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque ### 输入 - 本次生成任务结果的回调通知地址 + 已忽略。仅为兼容 BytePlus 的请求结构而接受,但在任务提交前会被移除,因此永远不会发送回调;请改为轮询任务状态路由来获取结果。 格式:`uri` - 模型生成视频的输入内容 + 供模型生成视频的输入内容 - 输入音频对象。仅 Seedance 2.5、2.0 和 2.0 fast、2.0 mini 支持音频输入。Seedance 2.0 和 2.0 fast、2.0 mini 不能单独使用音频,必须至少包含 1 张图像或 1 段视频;Seedance 2.5 支持纯音频输入。 + 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须至少包含 1 个图像或视频;Seedance 2.5 支持纯音频输入。 - 音频 URL、Base64 编码或资产 ID。 + 音频 URL、Base64 编码或 Asset ID。 音频 URL:音频的公开 URL(wav、mp3)。 Base64:格式为 data:audio/\;base64,\ -资产 ID:格式为 asset://\ +Asset ID:格式为 asset://\ - 仅 Seedance 2.5。要渲染为最终视频的草稿任务。它必须是唯一的内容项。 -最终视频会复用草稿任务的提示词、输入资产、时长、比例、种子、generate_audio 以及 omni_reference_task_type;请勿再次发送这些内容。分辨率默认为且仅支持 1080p。 + 仅 Seedance 2.5 支持。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 +最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type,请勿再次发送这些内容。resolution 默认为 1080p,且仅支持 1080p。 - 创建草稿视频时(`draft` 设置为 true)返回的任务 ID。 + 创建 Draft 视频时通过将 `draft` 设为 true 所返回的任务 ID。 @@ -231,37 +230,42 @@ Base64:格式为 data:audio/\;base64,\ 用于图生视频生成的图像内容(当 type 为 "image_url" 时) 图像 URL:请确保该图像 URL 可访问。 Base64 编码内容:格式必须为 data:image/\;base64,\ -资产 ID:格式为 asset://\ +Asset ID:格式为 asset://\ 内容项的角色/位置。 对于图像:first_frame、last_frame 或 reference_image。 -对于视频:reference_video(仅 Seedance 2.5、2.0 和 2.0 fast、2.0 mini)。 -对于音频:reference_audio(仅 Seedance 2.5、2.0 和 2.0 fast、2.0 mini)。 +对于视频:reference_video(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 +对于音频:reference_audio(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 可选值:`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` - 模型的输入文本信息。包含文本提示词和可选参数。 + 模型的输入文本信息。包括文本提示词和可选参数。 文本提示词(必填):使用中英文字符描述要生成的视频。 -参数(可选):在文本提示词后添加 --[参数] 以控制视频规格: +参数(可选):在文本提示词之后添加 --[parameters] 来控制视频规格: - --resolution (--rs):480p、720p、1080p(默认:720p) - --ratio (--rt):21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(默认:16:9 或 adaptive) - --duration (--dur):3-12 秒(默认:5) - --framepersecond (--fps):24(默认:24) - --watermark (--wm):true/false(默认:false) -- --seed (--seed):-1 到 2^32-1(默认:-1) +- --seed (--seed):-1 至 2^32-1(默认:-1) - --camerafixed (--cf):true/false(默认:false) 示例:"A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -这是 Comfy 侧的保护性限制,并非 BytePlus 的约束。BytePlus 未公布文本长度限制,测试中接受了 40,000 个字符(2026-09-17)。 -它统计的是字符而非字节,因此多字节提示词在传输时可能达到该大小的数倍。它限制的是这一个字段,而不是整个请求: -`content` 是一个数组,整个文档受每请求正文限制的约束。Comfy Router(/v2/models/byteplus/\{model})是执行该限制的入口;而在直接的 v1 /proxy 调用中,由 BytePlus 自己的校验器负责处理。该值设置得远高于真实流量,因此绝不会对真实提示词做出裁定。如果调用方需要更多,请提高该值。 +这是 Comfy 侧的防护限制,并非 BytePlus 的约束。BytePlus 未公布文本长度上限, +且在测试(2026-09-17)中接受了 40,000 个字符。 +它按字符计数,而非按字节,因此一个多字节提示词在实际传输时可能达到该大小的数倍。 +它限制的是这一个字段,而不是整个请求:`content` 是一个数组, +而约束整个文档的是每个请求的请求体上限。执行该限制的入口是 +Comfy Router(/v2/models/byteplus/\{model});在直接调用 v1 /proxy 时, +则由 BytePlus 自身的校验器作答。该值设置得远高于真实流量,因此它永远不会裁定 +真实提示词;如果调用方需要更多,请提高该值。 @@ -271,122 +275,134 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ - 输入视频对象。仅 Seedance 2.5、2.0 和 2.0 fast、2.0 mini 支持视频输入。 + 输入视频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持视频输入。 - 视频 URL 或资产 ID。 + 视频 URL 或 Asset ID。 视频 URL:视频的公开 URL(mp4、mov)。 -资产 ID:格式为 asset://\ +Asset ID:格式为 asset://\ - 仅 Seedance 2.5。生成 480p 草稿视频;分辨率必须为 480p。 -将返回的任务 ID 传入 `draft_task` 内容项即可渲染最终的 1080p 视频。草稿任务 ID 的有效期为 7 天。 + 仅 Seedance 2.5 支持。生成 480p 的 Draft 视频;resolution 必须为 480p。 +将返回的任务 ID 传入 `draft_task` 内容项,即可渲染最终的 1080p 视频。Draft 任务 ID 有效期为 7 天。 - 视频时长(秒)。Seedance 2.5:[4,30] 或 -1(自动;视频编辑任务仅支持 -1)。Seedance 2.0 和 2.0 fast、2.0 mini:[4,15] 或 -1(自动)。Seedance 1.5 pro:[4,12] 或 -1。Seedance 1.0:[2,12]。 + 视频时长,单位为秒。Seedance 2.5:[4,30] 或 -1(自动;视频编辑任务仅支持 -1)。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。Seedance 1.5 pro:[4,12] 或 -1。Seedance 1.0:[2,12]。 - 范围:`2` 到 `30` + 范围:`2` 至 `30` - 任务超时阈值(秒)。默认 172800(48 小时)。范围:[3600, 259200]。 + 任务超时阈值,单位为秒。默认 172800(48 小时)。范围:[3600, 259200]。 - 范围:`3600` 到 `259200` + 范围:`3600` 至 `259200` - Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 -true:模型输出带同步音频的视频。 -false:模型输出无声视频。 -在支持该功能的模型上,生成的音轨由提供商与视频分开进行内容审核;此处的拒绝会报告为 `content_policy_violation`,而且由于每次运行的音频都不同,对提供商本来接受的输入也可能间歇性地出现拒绝。遇到这种情况时发送 `false` 即可得到无声视频;这只在音频是被拒的模态时有效,同步的 Router 响应会在此时标明 `refusal_subject: output_audio`(排队请求目前还不会指明这一点)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改为用 `false` 重新创建 Draft。 + 受 Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 +true:模型输出带有同步音频的视频。 +false:模型输出无声视频。在支持该功能的模型上,生成的音频轨会由提供商与视频分开进行内容审核;若音频未通过审核,会报告为 `content_policy_violation`,并且由于每次运行的音频都不同,对于提供商原本接受的输入,这种失败可能间歇性出现。如果遇到这种情况,请传 `false` 以生成无声视频;这仅在音频是被拒绝的模态时才有帮助,同步的 Router 响应会将其标明为 `refusal_subject: output_audio`(排队中的请求还无法识别它)。Seedance 2.5 的最终渲染会继承其 Draft 任务的 `generate_audio`,因此请改用 `false` 重新创建 Draft。 - 要调用的模型 ID。支持的模型:seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini 和 dreamina-seedance-2-5-260628。直接对 POST /proxy/byteplus/api/v3/contents/generations/tasks 发起 v1 调用时必须提供它:代理会拒绝任何其他值以及省略的值,并返回 400。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方可以省略。 + 要调用的模型 ID。支持的模型:seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini 和 dreamina-seedance-2-5-260628。直接以 v1 调用 POST /proxy/byteplus/api/v3/contents/generations/tasks 时必须提供它,代理会以 400 拒绝任何其他值以及省略该值的情况。它不在本 Schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段中填充它,所以 Router 调用方可以省略它。 仅 Seedance 2.5。输出视频的容器格式。 +mp4:通用容器(H.264/AAC,yuv420p),兼容性广,文件更小。 +mov:专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),色彩精度高,适合后期制作;文件更大。 -mp4:通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 -mov:专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 - - 可选值:`mp4`、`mov` + 可能的值:`mp4`、`mov` - 已生成视频的宽高比。Seedance 2.0 与 2.0 fast、2.0 mini、1.5 pro 默认值:adaptive。 -Seedance 2.5 首帧 / 首尾帧生成:输出会遵循首帧的宽高比,因此只接受 `adaptive`(或省略该字段);若指定具体比例,会在派发之前以 400 拒绝。在这些模式下,Seedance 2.0 接受具体比例。 + 生成视频的宽高比。Seedance 2.0、2.0 fast 与 2.0 mini、1.5 pro 默认:adaptive。 +Seedance 2.5 首帧 / 首尾帧生成:输出遵循首帧的宽高比,因此只接受 `adaptive`(或省略该字段);具体比例会在派发之前以 400 拒绝。Seedance 2.0 在这些模式下接受具体比例。 - 可选值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` + 可能的值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` - 视频分辨率。Seedance 2.5、2.0 与 2.0 fast、2.0 mini、1.5 pro、1.0 lite 默认值:720p。Seedance 1.0 pro 与 pro-fast 默认值:1080p。 -注意:Seedance 2.0 与 2.0 fast、2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p 和 1080p。 + 视频分辨率。Seedance 2.5、2.0、2.0 fast 与 2.0 mini、1.5 pro、1.0 lite 默认:720p。Seedance 1.0 pro 与 pro-fast 默认:1080p。 +注意:Seedance 2.0、2.0 fast 与 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p 和 1080p。 - 可选值:`480p`、`720p`、`1080p`、`4k` + 可能的值:`480p`、`720p`、`1080p`、`4k` - 是否返回已生成视频的最后一帧图像。 -true:返回已生成视频的最后一帧图像。将该参数设为 true 后,你可以通过查询视频生成任务信息来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用该参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 -false:不返回已生成视频的最后一帧图像。 + 是否返回生成视频的最后一帧图像。 +true:返回生成视频的最后一帧图像。将该参数设为 true 后,你可以通过调用查询视频生成任务信息来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与生成的视频一致,且不包含水印。使用该参数可以生成多个连续视频:将前一个生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 +false:不返回生成视频的最后一帧图像。 用于控制随机性的种子整数。范围:[-1, 2^32-1]。-1 表示使用随机种子。 - 范围:`-1` 到 `4294967295` + 范围:`-1` 至 `4294967295` - 用于处理的服务层级。Seedance 2.5、2.0 与 2.0 fast 不支持 flex(离线推理)。 + 处理所用的服务层级。Seedance 2.5、2.0 与 2.0 fast 不支持 flex(离线推理)。 - 可选值:`default`、`flex` + 可能的值:`default`、`flex` - 已生成的视频是否包含水印。 + 生成的视频是否包含水印。 -根据 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json` 提供的 schema 生成,请求到达提供商之前,Router 校验调用时使用的也是同一份文档。 +根据 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json` 提供的 Schema 生成,该文档也是它在请求到达提供商之前用于校验调用的同一份文档。 ### 输出 - 视频生成任务完成后返回的输出,其中包含输出视频的下载 URL,以及在 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储上;此处的其他所有字段均为 BytePlus 自有字段。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,因此之后轮询到的已成功文档可能不带 `content` 或将其置为 null。 + 视频生成任务完成后的输出,包含输出视频的下载 URL,以及当 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会重新托管到 Comfy 存储;这里的其他每个字段都是 BytePlus 自己的。可为空:BytePlus 会在任务结束 24 小时后清除这些 URL,在此之后轮询已成功的文档记录时,`content` 可能缺失或为 null。 - 已生成视频最后一帧的下载 URL,仅在请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它收到的任意字节,并根据上游 Content-Type 或内容嗅探来确定其类型,`image/jpeg` 只是两者都失败时的最后兜底。Router 会将最后一帧重新托管到 Comfy 存储并重写此字段,因此它通常是有效的 Comfy 签名 URL,最长有效 24 小时:签发时按 24 小时签名,并从 23 小时的备忘中重放,所以后续轮询返回的 URL 可能只剩不到一小时的有效期。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后清除它。无论哪种情况,链接都会过期,因此请下载该帧,而不要保存 URL。 + 已生成视频最后一帧的下载 URL,当请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧的文档中将最后一帧规定为 PNG,Router 会重新托管它收到的任意字节,并根据上游 Content-Type 或内容嗅探确定其类型,仅当两者都失败时,`image/jpeg` 才是最后的回退类型。Router 会将最后一帧重新托管到 Comfy 存储并重写此字段,因此它通常是一个由 Comfy 签名的 URL,有效期最长 24 小时。它在签发时按 24 小时签名,并从 23 小时缓存记录中重放,因此之后的轮询可能返回一个剩余有效期只有一小时的 URL。如果无法执行重新托管,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务结束 24 小时后清除它。无论哪种情况,链接都会过期,因此请下载该帧,而不是保存 URL。 - 已生成视频的容器格式(mp4 或 mov),前提是 BytePlus 将其嵌套在 `content` 内。Seedance 模型更常将它作为 `content` 的顶层同级字段返回,请参见顶层 `output_format` 字段,Router 会读取两者中存在的那一个。 + 已生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 内时返回。Seedance 模型更常将其作为 `content` 的顶层同级字段返回,参见顶层的 `output_format` 字段,Router 会读取两者中存在的那个。 + + + + 上游 URL 停止工作的 RFC 3339 时间:最早签名时间加上 URL 自身携带的有效期;当 `updated_at` 存在时,绝不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档说明的 URL 生命周期);否则为任务的 `updated_at` 加 24 小时。仅当存在 `upstream_video_url` 或 `upstream_last_frame_url` 时出现,当两个来源都未提供时间时省略。与重新托管后的 `video_url` / `last_frame_url` 的生命周期无关。 + + 格式:`date-time` + + + + BytePlus 自己的最后一帧下载 URL,按与 `upstream_video_url` 相同的条件,与重新托管后的 `last_frame_url` 并列逐字节返回:仅限已选择加入的工作区,仅限 Seedance 2.x,在 BytePlus 清除后即缺失,并且在 `upstream_expires_at` 之前是 Bearer 凭证。 + + + + BytePlus 自己的输出视频下载 URL,与重新托管后的 `video_url` 并列逐字节返回。仅当轮询 Seedance 2.x 任务的工作区已由 Comfy 在服务器端选择加入时才存在(没有请求参数);对其他所有情况都不存在,包括解析不到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥),并且在生成 24 小时后 BytePlus 清除其 URL 后即缺失。它是预签名的对象存储 URL,因此是 Bearer 凭证:任何持有它的人都能在它过期前下载视频,因此请像对待机密一样对待它。它在 `upstream_expires_at` 过期;在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次会被 Router 自己的重新托管消耗。 - 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写此字段,因此它通常是有效的 Comfy 签名 URL,最长有效 24 小时:签发时按 24 小时签名,并从 23 小时的备忘中重放,所以后续轮询返回的 URL 可能只剩不到一小时的有效期。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除它,并在某些模型上将下载次数限制为 100 次。无论哪种情况,链接都会过期,因此请下载视频,而不要保存 URL。 + 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写此字段,因此它通常是一个由 Comfy 签名的 URL,有效期最长 24 小时。它在签发时按 24 小时签名,并从 23 小时缓存记录中重放,因此之后的轮询可能返回一个剩余有效期只有一小时的 URL。如果无法执行重新托管,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务结束 24 小时后清除它,并在某些模型上将其限制为 100 次下载。无论哪种情况,链接都会过期,因此请下载视频,而不是保存 URL。 - 任务创建的时间。该值为以秒为单位的 UNIX 时间戳。 + 任务创建时间。该值为 UNIX 时间戳,单位为秒。 - 已生成视频的时长,单位为秒。声明为 number 而非 integer,是因为 BytePlus 在这点上并不一致:已观察到视频任务返回整数秒,而 BytePlus 的其他并列接口会报告带小数的时长,因此客户端不能假定它一定是整数值。这是 BytePlus 自有字段,在视频任务成功时返回并原样转发。 + 已生成视频的时长,单位为秒。声明为 number 而不是 integer,因为 BytePlus 对此并不一致:已观察到视频任务返回整秒数,而 BytePlus 的其他相邻接口报告带小数的时长,因此客户端不得假定该值是整数。这是 BytePlus 自己的字段,在已成功的视频任务上返回,并原样转发。 - 错误信息。如果任务成功,返回 null。如果任务失败,则返回错误信息。 + 错误信息。如果任务成功,则返回 null。如果任务失败,则返回错误信息。 - 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。同一系列的错误码可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而非枚举:其他错误码描述验证和提供商故障。Router 会识别 HTTP 400 错误响应和 HTTP 200 失败任务响应中的策略系列,但不会覆盖传输层故障。 + 上游 ModelArk 错误代码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 用于标识内容策略拒绝。某个系列可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而不是枚举:其他代码描述验证和提供商失败。Router 会在 HTTP 400 错误响应包和 HTTP 200 失败任务响应中识别策略系列,但不会覆盖传输失败。 @@ -394,23 +410,24 @@ false:不返回已生成视频的最后一帧图像。 - 视频生成任务的 ID + 生成视频任务的 ID + - 任务所用模型的名称和版本 + 该任务所用模型的名称和版本 - 已生成视频的容器格式(mp4 或 mov),作为 `content` 的同级字段在顶层返回,Seedance 视频任务查询正是这样返回它的。这是 BytePlus 自有字段,原样转发。 + 生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回。Seedance 视频任务查询正是在此位置返回该字段。这是 BytePlus 自有字段,原样透传。 - 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在视频任务成功时返回并原样转发。 + 生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在成功的视频任务中返回,并原样透传。 - 任务实际使用的生成种子。这是 BytePlus 自有字段,在视频任务成功时返回并原样转发。 + 该任务实际使用的生成种子。这是 BytePlus 自有字段,在成功的视频任务中返回,并原样透传。 格式:`int64` @@ -422,11 +439,11 @@ false:不返回已生成视频的最后一帧图像。 - 任务最后更新的时间。该值为以秒为单位的 UNIX 时间戳。 + 任务最后更新的时间。该值为 UNIX 时间戳,单位为秒。 - 本次请求的 token 用量 + 该请求的 token 用量 @@ -434,7 +451,7 @@ false:不返回已生成视频的最后一帧图像。 - 对于视频生成模型,不计算输入 token 数量,其默认值为 0。因此 total_tokens = completion_tokens。 + 对于视频生成模型,不计算输入 token 数量,默认值为 0。因此,total_tokens = completion_tokens。 ## 示例 diff --git a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx index 86c4fbc675..a68c3701ef 100644 --- a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx @@ -2,17 +2,16 @@ title: "将 Seedance 1.0 Pro 250528 与 Comfy Router 配合使用" description: "通过 Comfy Router 调用 byteplus/seedance-1-0-pro-250528:endpoint、请求形状以及 Router 返回的响应。" sidebarTitle: "Seedance 1.0 Pro 250528" -translationSourceHash: 084b73ac +translationSourceHash: 450bbe6e translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx translationBlockHashes: "_intro": e1a3501d "Quick start": c762675f - "Schema": af62a34c + "Schema": fc979e05 "Examples": 815d621e --- - {/* GENERATED FILE. Generated from router-schemas/byteplus/seedance-1-0-pro-250528.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -181,33 +180,33 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528/requests/$ ### 输入 - 本次生成任务结果的回调通知地址 + 忽略。为兼容 BytePlus 请求形状而接受,但在提交任务之前会被移除,因此永远不会发送回调;请改为轮询任务状态路由以获取结果。 - 格式: `uri` + 格式:`uri` - 模型生成视频所用的输入内容 + 供模型生成视频的输入内容 - 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须至少包含 1 个图像或视频;Seedance 2.5 支持仅音频输入。 + 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须包含至少 1 个图像或视频;Seedance 2.5 支持纯音频输入。 音频 URL、Base64 编码或资产 ID。 -音频 URL:音频的公开网址(wav、mp3)。 +音频 URL:音频的公开 URL(wav、mp3)。 Base64:格式为 data:audio/\;base64,\ 资产 ID:格式为 asset://\ 仅 Seedance 2.5。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 -最终视频会复用 Draft 任务的 prompt、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type,请勿再次提交这些内容。resolution 默认为 1080p,且仅支持 1080p。 +最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;不要再次发送它们。resolution 默认为 1080p,并且仅支持 1080p。 - 当 Draft 视频以 `draft` 设置为 true 创建时返回的任务 ID。 + 使用 `draft` 设为 true 创建 Draft 视频时返回的任务 ID。 @@ -216,7 +215,7 @@ Base64:格式为 data:audio/\;base64,\ 用于图生视频生成的图像内容(当 type 为 "image_url" 时) -图片网址:请确保图片网址可访问。 +图片网址:确保图片网址可访问。 Base64 编码内容:格式必须为 data:image/\;base64,\ 资产 ID:格式为 asset://\ @@ -227,15 +226,15 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ 对于视频:reference_video(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 对于音频:reference_audio(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 - 可能的值:`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` + 可能的值:`first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio` - 模型的输入文本信息。包含文本提示词和可选参数。 + 供模型使用的输入文本信息。包含文本提示词和可选参数。 文本提示词(必填):使用中英文字符描述要生成的视频。 -参数(可选):在文本提示词之后添加 --[参数] 以控制视频规格: +参数(可选):在文本提示词后添加 --[parameters] 以控制视频规格: - --resolution (--rs):480p、720p、1080p(默认:720p) - --ratio (--rt):21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(默认:16:9 或 adaptive) - --duration (--dur):3-12 秒(默认:5) @@ -246,18 +245,14 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ 示例:"A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -这是 Comfy 侧的保护限制,而非 BytePlus 的约束。BytePlus 未公布文本长度限制,并且在测试中(2026-09-17)接受了 40,000 个字符。 -它按字符计数,而非按字节,因此多字节提示词在传输时可能达到该数值的数倍。它约束的只是这一个字段,而非整个请求: -`content` 是一个数组,整个文档受每次请求的请求体大小限制约束。执行该限制的入口是 -Comfy Router(/v2/models/byteplus/\{model});在直接调用 v1 /proxy 时,则由 BytePlus 自身的验证器 -作出响应。该值设置得远高于实际流量,因此它绝不会对真实提示词进行裁定。如果调用方需要更大的值, -可以提高它。 +Comfy 侧的护栏,而不是 BytePlus 的约束。BytePlus 未发布文本长度限制,并在测试中接受了 40,000 个字符(2026-09-17)。 +它按字符计数,而不是按字节计数,因此多字节提示词在传输时可能达到此大小的数倍。它限制的是这一个字段,而不是整个请求:`content` 是一个数组,而整个文档受每次请求的正文限制约束。Comfy Router(/v2/models/byteplus/\{model})是执行该限制的入口;在直接调用 v1 /proxy 时,则由 BytePlus 自己的验证器来响应。该值设置得远高于真实流量,因此它永远不会裁决真实提示词;如果调用方需要更多,可以提高它。 输入内容的类型 - 可能的值:`text`、`image_url`、`video_url`、`audio_url`、`draft_task` + 可能的值:`text`, `image_url`, `video_url`, `audio_url`, `draft_task` @@ -266,7 +261,7 @@ Comfy Router(/v2/models/byteplus/\{model});在直接调用 v1 /proxy 时 视频 URL 或资产 ID。 -视频 URL:视频的公开网址(mp4、mov)。 +视频 URL:视频的公开 URL(mp4、mov)。 资产 ID:格式为 asset://\ @@ -288,93 +283,107 @@ Comfy Router(/v2/models/byteplus/\{model});在直接调用 v1 /proxy 时 - Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持此参数。生成的视频是否包含与画面同步的音频。 -true:模型输出带同步音频的视频。 -false:模型输出无声视频。 -在支持该功能的模型上,生成的音轨由提供商与视频分开进行内容审核;此处的拒绝会报告为 `content_policy_violation`,而且由于每次运行的音频都不同,对提供商本来接受的输入也可能间歇性地出现拒绝。遇到这种情况时发送 `false` 即可得到无声视频;这只在音频是被拒的模态时有效,同步的 Router 响应会在此时标明 `refusal_subject: output_audio`(排队请求目前还不会指明这一点)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改为用 `false` 重新创建 Draft。 + 受 Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 +true: 模型输出带同步音频的视频。 +false: 模型输出静音视频。在支持该功能的模型上,已生成的音频轨道由提供商与视频分开进行内容审核;若音频被拒绝,会报告为 `content_policy_violation`,并且由于每次运行生成的音频都不同,对于提供商本来可以接受的输入,这种拒绝可能是间歇性的。如果出现这种情况,请发送 `false` 以生成无声视频;这仅在音频是被拒绝的模态时才有帮助,同步的 Router 响应会将其标识为 `refusal_subject: output_audio`(排队中的请求还不会标明这一点)。Seedance 2.5 的最终渲染会从它的 Draft 任务继承 `generate_audio`,因此请改用 `false` 重新创建 Draft。 - 要调用的模型 ID。支持的模型:seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini 和 dreamina-seedance-2-5-260628。直接调用 v1 接口 POST /proxy/byteplus/api/v3/contents/generations/tasks 时必须提供该参数:代理会以 400 拒绝任何其他值以及省略该值的情况。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方会省略它。 + 要调用的模型 ID。支持的模型:seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini 和 dreamina-seedance-2-5-260628。直接向 POST /proxy/byteplus/api/v3/contents/generations/tasks 发起 v1 调用时必须提供该值:代理会对任何其他值以及省略该值的情况返回 400 拒绝。它不在本 Schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以通过 Router 调用时可以省略。 - 仅 Seedance 2.5。输出视频的容器格式。mp4:通用容器(H.264/AAC,yuv420p),兼容性广且文件大小更小。 -mov:专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),色彩精度高,适合后期制作;文件大小更大。 + 仅 Seedance 2.5。输出视频的容器格式。 +mp4:通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 +mov:专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 - 可能的值: `mp4`, `mov` + Possible values: `mp4`, `mov` - 已生成视频的比例。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认为:adaptive。 -Seedance 2.5 首帧/首尾帧生成:输出会跟随首帧的比例,因此仅接受 `adaptive`(或省略该字段);具体的比例会在派发前以 400 拒绝。在这些模式下,Seedance 2.0 接受具体的比例。 + 已生成视频的比例。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认:adaptive。 +Seedance 2.5 首帧 / 首尾帧生成:输出会沿用首帧的比例,因此只接受 `adaptive`(或省略该字段);具体比例会在派发之前以 400 拒绝。Seedance 2.0 在这些模式下接受具体比例。 - 可能的值: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` + Possible values: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive` - 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认为:720p。Seedance 1.0 pro 与 pro-fast 默认为:1080p。 + 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认:720p。Seedance 1.0 pro 和 pro-fast 默认:1080p。 注意:Seedance 2.0、2.0 fast 和 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p 和 1080p。 - 可能的值: `480p`, `720p`, `1080p`, `4k` + Possible values: `480p`, `720p`, `1080p`, `4k` - 是否返回已生成视频的最后一帧图像。 -true:返回已生成视频的最后一帧图像。将此参数设置为 true 后,您可以通过调用查询视频生成任务信息来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用此参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 -false:不返回已生成视频的最后一帧图像。 + 是否返回已生成视频的尾帧图像。 +true:返回已生成视频的尾帧图像。将该参数设为 true 后,你可以通过调用查询视频生成任务信息来获取尾帧图像。尾帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不含水印。使用该参数可以生成多个连续视频:把上一个已生成视频的尾帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 +false:不返回已生成视频的尾帧图像。 - 用于控制随机性的种子整数。范围:[-1, 2^32-1]。-1 使用随机种子。 + 用于控制随机性的种子整数。范围:[-1, 2^32-1]。-1 表示使用随机种子。 - 范围: `-1` 到 `4294967295` + Range: `-1` to `4294967295` - 用于处理的服务层级。Seedance 2.5、2.0 与 2.0 fast 不支持 flex(离线推理)。 + 处理所用的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 - 可能的值: `default`, `flex` + Possible values: `default`, `flex` 已生成视频是否包含水印。 -根据 Router 在 `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` 提供的 schema 生成,与它在请求到达提供商之前用于校验调用的文档相同。 +本页内容生成自 Router 在 `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` 提供的 Schema,这也是请求到达提供商之前 Router 用来校验调用的同一份文档。 ### 输出 - 视频生成任务完成后返回的输出内容,包含输出视频的下载 URL,以及当 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储上;这里的其他所有字段均来自 BytePlus 自身。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,因此在此之后轮询到的成功文档可能缺少 `content` 或其为 null。 + 视频生成任务完成后得到的输出,其中包含输出视频的下载 URL,以及 BytePlus 返回时最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都被重新托管(RE-HOSTED)到 Comfy 存储上;这里的其他所有字段均为 BytePlus 自带。可为空:BytePlus 会在任务结束 24 小时后清除这些 URL,此后轮询到的成功文档可能不包含 `content` 或将其置为 null。 - 生成视频最后一帧的下载 URL,当请求设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它收到的任意字节,并根据上游的 Content-Type 或内容嗅探来确定其类型,而 `image/jpeg` 只是在两者都失败时的最后兜底。Router 会将最后一帧重新托管到 Comfy 存储并重写该字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时;签发时按 24 小时签名,并从 23 小时的缓存记录中重放,因此稍后的轮询可能返回一个只剩一小时有效期的链接。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后将其清除。无论哪种情况,链接都会过期,因此请下载该帧,而不要存储 URL。 + 已生成视频最后一帧的下载 URL,当请求设置了 `return_last_frame` 时返回。不要从这个 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它收到的任何字节,并根据上游的 Content-Type 或内容嗅探来确定类型,而 `image/jpeg` 只是两者都失败时的最后兜底。Router 会将最后一帧重新托管到 Comfy 存储并改写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时。签发时签名 24 小时,并从 23 小时的记忆化结果中重放,因此稍后的轮询可能只返回剩余一小时有效的链接。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务结束 24 小时后清除它。无论哪种情况链接都会过期,因此请下载该帧,而不是保存 URL。 - 生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 内时出现。Seedance 模型更常将其作为 `content` 的顶层同级字段返回,请参见顶层的 `output_format` 字段;Router 会读取两者中存在的那个。 + 已生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 内时提供。Seedance 模型更常把它作为 `content` 的顶层同级字段返回,参见顶层的 `output_format` 字段;Router 会读取两者中存在的那个。 + + + + 上游 URL 停止工作的 RFC 3339 时间:即最早的签名时间加上这些 URL 自身携带的有效期,当 `updated_at` 存在时永远不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档说明的 URL 寿命);否则为任务的 `updated_at` 加 24 小时。仅当 `upstream_video_url` 或 `upstream_last_frame_url` 存在时才存在,当两个来源都不提供时间时省略。与重新托管的 `video_url` / `last_frame_url` 的寿命无关。 + + 格式:`date-time` + + + + BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 并列、按字节原样返回,条件与 `upstream_video_url` 相同:仅限已选择加入的工作区、仅限 Seedance 2.x、一旦 BytePlus 清除便不存在,且在 `upstream_expires_at` 之前都是持有者凭证。 + + + + BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 并列、按字节原样返回。仅对由 Comfy 在服务器端选择加入的工作区轮询的 Seedance 2.x 任务存在(没有可用的请求参数);对其他所有情况都不存在,包括解析不到任何工作区的凭证(例如未绑定到某个工作区的传统 API 密钥),并且在 BytePlus 于生成 24 小时后清除其 URL 之后也不存在。它是一个预签名的对象存储 URL,因此也是持有者凭证:任何持有它的人都能在过期前下载视频,所以请把它当作机密对待。它在 `upstream_expires_at` 过期,而在 Seedance 2.5 上 BytePlus 将其限制为 100 次下载,Router 自身的重新托管会消耗其中一次。 - 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写该字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时;签发时按 24 小时签名,并从 23 小时的缓存记录中重放,因此稍后的轮询可能返回一个只剩一小时有效期的链接。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后将其清除,并且某些模型上最多允许 100 次下载。无论哪种情况,链接都会过期,因此请下载该视频,而不要存储 URL。 + 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并改写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时。签发时签名 24 小时,并从 23 小时的记忆化结果中重放,因此稍后的轮询可能只返回剩余一小时有效的链接。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务结束 24 小时后清除它,并在某些模型上限制为 100 次下载。无论哪种情况链接都会过期,因此请下载视频,而不是保存 URL。 - 任务创建的时间。该值为 UNIX 时间戳,单位为秒。 + 任务创建的时间。值为 UNIX 时间戳,单位为秒。 - 生成视频的时长,单位为秒。之所以声明为 number 而不是 integer,是因为 BytePlus 对此并不一致:观察到视频任务返回整数秒,而同属 BytePlus 的其他接口会返回小数时长,因此客户端不应假定其为整数值。该字段属于 BytePlus 自身,在成功的视频任务中返回并原样转发。 + 已生成视频的时长,单位为秒。声明为数字(number)而非整数(integer),是因为 BytePlus 在这点上并不一致:已观察到视频任务返回整秒,而同属 BytePlus 的其他接口会报告带小数的时长,因此客户端不能假定它是整数值。这是 BytePlus 自己的字段,在成功的视频任务上返回并原样转发。 - 错误信息。如果任务成功,则返回 null。如果任务失败,则返回错误信息。 + 错误信息。如果任务成功,返回 null。如果任务失败,则返回错误信息。 - 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。某一错误族可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放式字符串,而非枚举:其他错误码描述验证和提供商故障。Router 会在 HTTP 400 错误响应和 HTTP 200 任务失败响应中识别策略错误族,且不会覆盖传输层故障。 + 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。同一类别可能带有点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放的字符串,而不是枚举:其他错误码描述验证和提供商故障。Router 会在 HTTP 400 错误信封和 HTTP 200 失败任务响应中识别策略类别,但不会覆盖传输故障。 @@ -386,19 +395,19 @@ false:不返回已生成视频的最后一帧图像。 - 该任务所用模型的名称和版本 + 该任务所使用的模型名称与版本 - 生成视频的容器格式(mp4 或 mov),作为 `content` 的同级字段在顶层返回,Seedance 视频任务查询就是在这里返回它的。该字段属于 BytePlus 自身,原样转发。 + 已生成视频的容器格式(mp4 或 mov),在**顶层**作为 `content` 的同级字段返回,Seedance 视频任务查询正是在此处返回该字段。这是 BytePlus 自有字段,原样转发。 - 生成视频的分辨率,例如 `1080p`。该字段属于 BytePlus 自身,在成功的视频任务中返回并原样转发。 + 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在成功的视频任务中返回并原样转发。 - 该任务实际使用的生成种子。该字段属于 BytePlus 自身,在成功的视频任务中返回并原样转发。 + 该任务实际使用的生成种子。这是 BytePlus 自有字段,在成功的视频任务中返回并原样转发。 格式:`int64` @@ -410,11 +419,11 @@ false:不返回已生成视频的最后一帧图像。 - 任务最后一次更新的时间。该值为 UNIX 时间戳,单位为秒。 + 任务最后更新的时间。该值为以秒为单位的 UNIX 时间戳。 - 该请求的 token 使用量 + 本次请求的 token 用量 @@ -422,7 +431,7 @@ false:不返回已生成视频的最后一帧图像。 - 对于视频生成模型,不计算输入 token 数量,默认为 0。因此 total_tokens = completion_tokens。 + 对于视频生成模型,输入 token 数量不参与计算,默认为 0。因此 total_tokens = completion_tokens。 ## 示例 diff --git a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx index 355b348247..c9d29328ec 100644 --- a/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx @@ -2,17 +2,16 @@ title: "使用 Comfy Router 调用 Seedance 1.0 Pro Fast 251015" description: "通过 Comfy Router 调用 byteplus/seedance-1-0-pro-fast-251015:endpoint、请求结构以及 Router 返回的响应。" sidebarTitle: "Seedance 1.0 Pro Fast 251015" -translationSourceHash: 600f57b4 +translationSourceHash: 43683424 translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx translationBlockHashes: "_intro": 451ffa4b "Quick start": ec2a21ac - "Schema": 1df5b053 + "Schema": a882b2d8 "Examples": 1469ab97 --- - {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/byteplus/seedance-1-0-pro-fast-251015.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -181,17 +180,17 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-fast-251015/reque ### 输入 - 本次生成任务结果的回调通知地址 + 已忽略。该字段仅为兼容 BytePlus 的请求形状而接受,但在任务提交之前就会被移除,因此永远不会发送回调;请改为轮询任务状态路由来获取结果。 格式:`uri` - 模型用于生成视频的输入内容 + 供模型生成视频的输入内容 - 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须至少包含 1 个图像或视频;Seedance 2.5 支持仅音频输入。 + 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 与 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 与 2.0 mini 不能单独使用音频,必须至少包含 1 个图像或视频;Seedance 2.5 支持纯音频输入。 @@ -202,12 +201,12 @@ Base64:格式为 data:audio/\;base64,\ - 仅 Seedance 2.5。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 -最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些参数。resolution 默认为且仅支持 1080p。 + 仅 Seedance 2.5 支持。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 +最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。resolution 默认且仅支持 1080p。 - 使用 `draft` 设置为 true 创建 Draft 视频时返回的任务 ID。 + 创建 Draft 视频时将 `draft` 设为 true 所返回的任务 ID。 @@ -215,48 +214,56 @@ Base64:格式为 data:audio/\;base64,\ - 用于图生视频的图像内容(当 type 为 "image_url" 时) -图片网址:请确保该图片网址可访问。 + 用于图生视频生成的图像内容(当 type 为 "image_url" 时) +图片 URL:请确保该图片 URL 可访问。 Base64 编码内容:格式必须为 data:image/\;base64,\ 资产 ID:格式为 asset://\ 内容项的角色/位置。 -图像:first_frame、last_frame 或 reference_image。 -视频:reference_video(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 -音频:reference_audio(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 +对于图像:first_frame、last_frame 或 reference_image。 +对于视频:reference_video(仅 Seedance 2.5、2.0、2.0 fast 与 2.0 mini)。 +对于音频:reference_audio(仅 Seedance 2.5、2.0、2.0 fast 与 2.0 mini)。 - 可选值:`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` + 可能的值:`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` - 模型的输入文本信息。包含文本提示词和可选参数。 + 供模型使用的输入文本信息。包含文本提示词和可选参数。 -文本提示词(必填):使用中英文字符描述要生成的视频。 +文本提示词(必填):用中英文字符描述要生成的视频。 -参数(可选):在文本提示词之后添加 --[parameters] 以控制视频规格: -- --resolution (--rs):480p、720p、1080p(默认:720p) -- --ratio (--rt):21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(默认:16:9 或 adaptive) -- --duration (--dur):3-12 秒(默认:5) -- --framepersecond (--fps):24(默认:24) -- --watermark (--wm):true/false(默认:false) -- --seed (--seed):-1 到 2^32-1(默认:-1) -- --camerafixed (--cf):true/false(默认:false) +参数(可选):在文本提示词之后添加 --[parameters] 来控制视频规格: +- --resolution(--rs):480p、720p、1080p(默认:720p) +- --ratio(--rt):21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(默认:16:9 或 adaptive) +- --duration(--dur):3-12 秒(默认:5) +- --framepersecond(--fps):24(默认:24) +- --watermark(--wm):true/false(默认:false) +- --seed(--seed):-1 到 2^32-1(默认:-1) +- --camerafixed(--cf):true/false(默认:false) 示例:"A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -这是 Comfy 侧的防护限制,并非 BytePlus 的约束。BytePlus 未公布文本长度限制,在测试中接受了 40,000 个字符(2026-09-17)。它统计的是字符数而非字节数,因此多字节提示词在网络传输时可能达到该大小的数倍。它限制的是这一个字段,而不是整个请求:`content` 是一个数组,整个文档受每请求正文大小限制约束。Comfy Router(/v2/models/byteplus/\{model})是执行该限制的接口;而直接进行 v1 /proxy 调用时,由 BytePlus 自己的校验器负责答复。该值设置得远高于真实流量,因此它永远不会裁决真实的提示词。如果调用方需要更多,可以提高该值。 +这是 Comfy 侧的防护限制,而不是 BytePlus 的约束。BytePlus 未公布 +文本长度上限,测试中接受过 40,000 个字符(2026-09-17)。 +它统计的是字符数而非字节数,因此多字节的提示词在实际传输中可能达到该数值的 +数倍。它只约束这一个字段,而不约束整个请求: +`content` 是一个数组,整个文档的边界由每次请求的请求体上限决定。 +执行该限制的入口是 Comfy Router(/v2/models/byteplus/\{model}); +在直接调用 v1 /proxy 时,则由 BytePlus 自己的校验器给出结果。该值设置得 +远高于真实流量,因此永远不会对真实提示词作出裁决。如果调用方需要更多, +可以提高它。 输入内容的类型 - 可选值:`text`、`image_url`、`video_url`、`audio_url`、`draft_task` + 可能的值:`text`、`image_url`、`video_url`、`audio_url`、`draft_task` - 输入视频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持视频输入。 + 输入视频对象。仅 Seedance 2.5、2.0、2.0 fast 与 2.0 mini 支持视频输入。 @@ -266,110 +273,124 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ - 仅 Seedance 2.5。生成 480p 的 Draft 视频;分辨率必须为 480p。 -将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终的 1080p 视频。Draft 任务 ID 有效期为 7 天。 + 仅 Seedance 2.5 支持。生成 480p 的 Draft 视频;分辨率必须为 480p。 +在 `draft_task` 内容项中传入返回的任务 ID,即可渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 - 视频时长,单位为秒。Seedance 2.5:[4,30] 或 -1(自动;视频编辑任务仅支持 -1)。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。Seedance 1.5 pro:[4,12] 或 -1。Seedance 1.0:[2,12]。 + 视频时长(秒)。Seedance 2.5:[4,30] 或 -1(自动;视频编辑任务仅支持 -1)。Seedance 2.0、2.0 fast 与 2.0 mini:[4,15] 或 -1(自动)。Seedance 1.5 pro:[4,12] 或 -1。Seedance 1.0:[2,12]。 范围:`2` 到 `30` - 任务超时阈值,单位为秒。默认 172800(48 小时)。范围:[3600, 259200]。 + 任务超时阈值(秒)。默认 172800(48 小时)。范围:[3600, 259200]。 范围:`3600` 到 `259200` Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 -true:模型输出带有同步音频的视频。 -false:模型输出无声视频。 -在支持该功能的模型上,生成的音轨由提供商与视频分开进行内容审核;此处的拒绝会报告为 `content_policy_violation`,而且由于每次运行的音频都不同,对提供商本来接受的输入也可能间歇性地出现拒绝。遇到这种情况时发送 `false` 即可得到无声视频;这只在音频是被拒的模态时有效,同步的 Router 响应会在此时标明 `refusal_subject: output_audio`(排队请求目前还不会指明这一点)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改为用 `false` 重新创建 Draft。 +true:模型输出带同步音频的视频。 +false:模型输出无声视频。在支持该功能的模型上,提供商会对已生成的音频轨道单独进行内容检查,与视频分开处理;此处的拒绝会报告为 `content_policy_violation`,并且由于每次运行的音频都不同,对于提供商原本接受的输入,这种拒绝可能会间歇性出现。如果遇到这种情况,请发送 `false` 以获得静音视频;这仅在音频是被拒绝的模态时才有帮助,同步的 Router 响应会将其标记为 `refusal_subject: output_audio`(排队中的请求尚无法识别)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此应改用 `false` 重新创建 Draft。 - 要调用的模型 ID。支持的模型:seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini 和 dreamina-seedance-2-5-260628。直接对 POST /proxy/byteplus/api/v3/contents/generations/tasks 发起 v1 调用时,必须提供该值:代理会拒绝任何其他值,省略时也会返回 400。它不在本架构的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,因此 Router 调用方可以省略。 + 要调用的模型 ID。支持的模型:seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini 和 dreamina-seedance-2-5-260628。直接对 POST /proxy/byteplus/api/v3/contents/generations/tasks 发起 v1 调用时必须提供它:代理会以 400 拒绝任何其他值,也会以 400 拒绝省略它的情况。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充该值,因此 Router 调用方会省略它。 - 仅 Seedance 2.5。输出视频的容器格式。mp4:通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 + 仅 Seedance 2.5。输出视频的容器格式。 +mp4:通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 mov:专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 - 可选值:`mp4`、`mov` + 可能的值:`mp4`、`mov` - 已生成视频的宽高比。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认值:adaptive。 -Seedance 2.5 首帧 / 首尾帧生成:输出会遵循首帧的宽高比,因此仅接受 `adaptive`(或省略该字段);传入具体比例会在派发前以 400 拒绝。Seedance 2.0 在这些模式下接受具体比例。 + 已生成视频的比例。Seedance 2.0、2.0 fast 与 2.0 mini、1.5 pro 默认:adaptive。 +Seedance 2.5 首帧 / 首尾帧生成:输出会遵循首帧的比例,因此只接受 `adaptive`(或省略该字段);具体的比例会在调度前以 400 被拒绝。Seedance 2.0 在这些模式下接受具体的比例。 - 可选值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` + 可能的值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` - 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认值:720p。Seedance 1.0 pro 与 pro-fast 默认值:1080p。 -注意:Seedance 2.0、2.0 fast 和 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p 和 1080p。 + 视频分辨率。Seedance 2.5、2.0、2.0 fast 与 2.0 mini、1.5 pro、1.0 lite 默认:720p。Seedance 1.0 pro 与 pro-fast 默认:1080p。 +注意:Seedance 2.0、2.0 fast 与 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p 和 1080p。 - 可选值:`480p`、`720p`、`1080p`、`4k` + 可能的值:`480p`、`720p`、`1080p`、`4k` 是否返回已生成视频的最后一帧图像。 -true:返回已生成视频的最后一帧图像。将该参数设置为 true 后,可通过调用“查询视频生成任务信息”获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用该参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 +true:返回已生成视频的最后一帧图像。将该参数设置为 true 后,你可以通过调用查询视频生成任务信息来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用该参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。 false:不返回已生成视频的最后一帧图像。 用于控制随机性的种子整数。范围:[-1, 2^32-1]。-1 表示使用随机种子。 - 范围:`-1` 至 `4294967295` + 范围:`-1` 到 `4294967295` 处理所用的服务层级。Seedance 2.5、2.0 与 2.0 fast 不支持 flex(离线推理)。 - 可选值:`default`、`flex` + 可能的值:`default`、`flex` - 已生成视频是否包含水印。 + 已生成的视频是否包含水印。 -根据 Router 在 `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json` 提供的 schema 生成,与请求到达提供商之前用于校验调用的文档完全一致。 +由 Router 在 `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json` 提供的 schema 生成,该文档与它在请求到达提供商之前用于校验调用的文档相同。 ### 输出 - 视频生成任务完成后返回的输出内容,包含输出视频的下载 URL,以及在 BytePlus 返回时该视频最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储上;这里其他所有字段都来自 BytePlus。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,因此之后轮询一个已成功的文档时,`content` 可能缺失或为 null。 + 视频生成任务完成后得到的输出,其中包含输出视频的下载 URL,以及在 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会被重新托管到 Comfy 存储上;这里的其他字段都是 BytePlus 自己的字段。可为空:BytePlus 会在任务结束 24 小时后清除这些 URL,此后轮询一个已成功的文档时,`content` 可能缺失或为 null。 - 生成视频最后一帧的下载 URL,当请求设置了 `return_last_frame` 时返回。不要根据该 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它收到的任何字节,并根据上游的 Content-Type 或内容嗅探来判断其类型,而 `image/jpeg` 只是在两者都失败时的最后兜底。Router 会将最后一帧重新托管到 Comfy 存储上并改写该字段,因此它通常是 Comfy 签名 URL,有效期最长 24 小时:签发时按 24 小时签名,并从 23 小时的备忘中重放,所以后续轮询返回的 URL 可能只剩不到一小时的有效期。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后清除它。无论哪种情况,链接都会过期,因此请下载该帧,而不是保存 URL。 + 生成视频最后一帧的下载 URL,仅在请求设置了 `return_last_frame` 时返回。不要从这个 URL 推断图像格式:BytePlus 在请求侧把最后一帧记录为 PNG,Router 会重新托管它实际收到的任意字节,并根据上游的 Content-Type 或内容嗅探来确定类型,而 `image/jpeg` 只是在两者都失败时的最后兜底。Router 会把最后一帧重新托管到 Comfy 存储并改写该字段,因此它通常是有效期最长 24 小时的 Comfy 签名 URL:签发时按 24 小时签名,并从 23 小时的备忘中重放,所以之后的轮询返回的 URL 可能只剩一小时有效期。无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务结束 24 小时后清除它。无论哪种情况链接都会过期,因此请下载该帧,而不是保存 URL。 - 生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 内时返回。Seedance 模型更常将它作为 `content` 的顶层同级字段返回,参见顶层 `output_format` 字段。Router 会读取两者中存在的那个。 + 生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 内时出现。Seedance 模型更常把它作为 `content` 的顶层同级字段返回,请参见顶层 `output_format` 字段;Router 会读取两者中存在的那个。 + + + + 上游 URL 失效的 RFC 3339 时间:即最早的签名时间加上 URL 自身携带的有效期;当 `updated_at` 存在时,绝不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档记录的 URL 生存期);否则为任务的 `updated_at` 加 24 小时。仅当 `upstream_video_url` 或 `upstream_last_frame_url` 存在时才存在,当两个来源都没有给出时间时则省略。与重新托管的 `video_url` / `last_frame_url` 的生存期无关。 + + 格式:`date-time` + + + + BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 并排逐字节返回,条件与 `upstream_video_url` 相同:仅限已选择加入的工作区、仅限 Seedance 2.x、BytePlus 清除后即缺失,并且在 `upstream_expires_at` 之前都是一种持有即用的凭据。 + + + + BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 并排逐字节返回。仅对由 Comfy 在服务器端选择加入的工作区所轮询的 Seedance 2.x 任务存在(没有请求参数);对其他所有人都不存在,包括无法解析到任何工作区的凭据(例如未绑定工作区的传统 API 密钥),并且在生成 24 小时后 BytePlus 清除其 URL 后也不存在。它是一个预签名对象存储 URL,因此是一种持有即用的凭据:任何持有它的人都能在过期前下载视频,所以请像对待机密一样对待它。它在 `upstream_expires_at` 过期;在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次会被 Router 自身的重新托管消耗。 - 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储上并改写该字段,因此它通常是 Comfy 签名 URL,有效期最长 24 小时:签发时按 24 小时签名,并从 23 小时的备忘中重放,所以后续轮询返回的 URL 可能只剩不到一小时的有效期。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后清除它,并在某些模型上限制为 100 次下载。无论哪种情况,链接都会过期,因此请下载该视频,而不是保存 URL。 + 输出视频的下载 URL。Router 会把视频重新托管到 Comfy 存储并改写该字段,因此它通常是有效期最长 24 小时的 Comfy 签名 URL:签发时按 24 小时签名,并从 23 小时的备忘中重放,所以之后的轮询返回的 URL 可能只剩一小时有效期。无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务结束 24 小时后清除它,并在某些模型上将其限制为 100 次下载。无论哪种情况链接都会过期,因此请下载视频,而不是保存 URL。 - 任务创建的时间。该值为 UNIX 时间戳,单位为秒。 + 任务的创建时间。该值是以秒为单位的 UNIX 时间戳。 - 生成视频的时长,单位为秒。声明为 number 而非 integer,是因为 BytePlus 在这一点上并不一致:已观察到视频任务返回整数秒,而 BytePlus 的其他同类接口会报告带小数的时长,因此客户端不能假定它是整数值。这是 BytePlus 自己的字段,在成功的视频任务中返回并原样转发。 + 生成视频的时长,单位为秒。之所以声明为 number 而非 integer,是因为 BytePlus 在此并不一致:已观察到视频任务返回整秒数,而同系列的其他 BytePlus 接口会反馈带小数的时长,因此客户端不能假定它是整数值。这是 BytePlus 自己的字段,在成功的视频任务上返回并原样转发。 - 错误信息。如果任务成功,则返回 null。如果任务失败,则返回错误信息。 + 错误信息。如果任务成功,返回 null。如果任务失败,则返回错误信息。 - 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。某个错误族可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是开放字符串,而非枚举:其他错误码描述验证失败和提供商故障。Router 会在 HTTP 400 错误信封和 HTTP 200 失败任务响应中识别策略族,且不会覆盖传输层故障。 + 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。同一系列可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而不是枚举:其他错误码描述验证失败和提供商故障。Router 会在 HTTP 400 错误封装和 HTTP 200 失败任务响应中识别策略系列,但不会覆盖传输故障。 @@ -381,25 +402,25 @@ false:不返回已生成视频的最后一帧图像。 - 任务所用模型的名称和版本 + 任务所使用的模型名称和版本 - 生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回,Seedance 视频任务查询即在此处返回它。这是 BytePlus 自己的字段,原样转发。 + 已生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回,Seedance 视频任务查询正是从这里返回该字段。这是 BytePlus 自有字段,原样转发。 - 生成视频的分辨率,例如 `1080p`。这是 BytePlus 自己的字段,在成功的视频任务中返回并原样转发。 + 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在成功的视频任务中返回并原样转发。 - 任务实际使用的生成种子。这是 BytePlus 自己的字段,在成功的视频任务中返回并原样转发。 + 任务实际使用的生成种子。这是 BytePlus 自有字段,在成功的视频任务中返回并原样转发。 格式:`int64` - 任务的状态 + 任务状态 可能的值:`queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` @@ -409,7 +430,7 @@ false:不返回已生成视频的最后一帧图像。 - 该请求的 token 使用量 + 请求的 token 用量 @@ -417,7 +438,7 @@ false:不返回已生成视频的最后一帧图像。 - 对于视频生成模型,不计算输入 token 数量,默认为 0。因此,total_tokens = completion_tokens。 + 对于视频生成模型,不计算输入 token 的数量,其默认值为 0。因此,total_tokens = completion_tokens。 ## 示例 diff --git a/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx b/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx index 7c9c1cb63b..6bceae78b4 100644 --- a/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx +++ b/zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx @@ -2,17 +2,16 @@ title: "通过 Comfy Router 使用 Seedance 1.5 Pro 251215" description: "通过 Comfy Router 调用 byteplus/seedance-1-5-pro-251215:endpoint、请求形状以及 Router 返回的响应。" sidebarTitle: "Seedance 1.5 Pro 251215" -translationSourceHash: 13f3fe20 +translationSourceHash: 1d016721 translationFrom: development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx translationBlockHashes: "_intro": 5f93a1f1 "Quick start": 71aafccf - "Schema": 6d6d6ec1 + "Schema": 35f3b5dc "Examples": 7e73ac5c --- - {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/byteplus/seedance-1-5-pro-251215.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -181,7 +180,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-5-pro-251215/requests/$ ### 输入 - 本次生成任务结果的回调通知地址 + 已忽略。为兼容 BytePlus 的请求形状而接受,但在提交任务之前会被移除,因此永远不会发送回调;请改为轮询任务状态路由以获取结果。 格式:`uri` @@ -191,23 +190,23 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-5-pro-251215/requests/$ - 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须至少包含 1 个图像或视频;Seedance 2.5 支持仅音频输入。 + 输入音频对象。仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini 支持音频输入。Seedance 2.0、2.0 fast 和 2.0 mini 不能单独使用音频,必须至少包含 1 张图像或 1 个视频;Seedance 2.5 支持纯音频输入。 - 音频网址、Base64 编码或资产 ID。 -音频网址:音频的公开网址(wav、mp3)。 -Base64:格式为 data:audio/\;base64,\ -资产 ID:格式为 asset://\ + 音频 URL、Base64 编码或资产 ID。 +音频 URL:音频的公开 URL(wav、mp3)。 +Base64:格式 data:audio/\;base64,\ +资产 ID:格式 asset://\ 仅 Seedance 2.5。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。 -最终视频会复用该 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type,请勿再次提交它们。resolution 默认为 1080p,且仅支持 1080p。 +最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。resolution 默认为 1080p,且仅支持 1080p。 - 使用 `draft` 设为 true 创建 Draft 视频时返回的任务 ID。 + 以 `draft` 设为 true 创建 Draft 视频时返回的任务 ID。 @@ -218,7 +217,7 @@ Base64:格式为 data:audio/\;base64,\ 用于图生视频生成的图像内容(当 type 为 "image_url" 时) 图片网址:请确保图片网址可访问。 Base64 编码内容:格式必须为 data:image/\;base64,\ -资产 ID:格式为 asset://\ +资产 ID:格式 asset://\ @@ -227,7 +226,7 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ 对于视频:reference_video(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 对于音频:reference_audio(仅 Seedance 2.5、2.0、2.0 fast 和 2.0 mini)。 - 可选值:`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` + 可能的值:`first_frame`、`last_frame`、`reference_image`、`reference_video`、`reference_audio` @@ -236,23 +235,25 @@ Base64 编码内容:格式必须为 data:image/\;base64,\ 文本提示词(必填):使用中英文字符描述要生成的视频。 参数(可选):在文本提示词之后添加 --[parameters] 以控制视频规格: -- --resolution (--rs):480p、720p、1080p(默认:720p) -- --ratio (--rt):21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(默认:16:9 或 adaptive) -- --duration (--dur):3-12 秒(默认:5) -- --framepersecond (--fps):24(默认:24) -- --watermark (--wm):true/false(默认:false) -- --seed (--seed):-1 到 2^32-1(默认:-1) -- --camerafixed (--cf):true/false(默认:false) +- --resolution(--rs):480p、720p、1080p(默认:720p) +- --ratio(--rt):21:9、16:9、4:3、1:1、3:4、9:16、9:21、adaptive(默认:16:9 或 adaptive) +- --duration(--dur):3-12 秒(默认:5) +- --framepersecond(--fps):24(默认:24) +- --watermark(--wm):true/false(默认:false) +- --seed(--seed):-1 到 2^32-1(默认:-1) +- --camerafixed(--cf):true/false(默认:false) 示例:"A beautiful landscape --ratio 16:9 --resolution 720p --duration 5" -Comfy 侧护栏,而非 BytePlus 的限制。BytePlus 未公布文本长度限制,在测试中接受了 40,000 个字符(2026-09-17)。它统计的是字符而非字节,因此多字节提示词在传输时可能达到该数值的数倍。它约束的是这一个字段,而不是整个请求:`content` 是数组,真正约束整个文档的是每请求的 body 限制。Comfy Router(/v2/models/byteplus/\{model})是执行该限制的入口;在直接调用 v1 /proxy 时,则由 BytePlus 自身的校验器应答。该值设置得远高于真实流量,因此绝不会对真实提示词作出裁决。如果调用方需要更多,可以提高它。 +这是 Comfy 侧的防护限制,而非 BytePlus 的约束。BytePlus 未公布文本长度限制,在测试中(2026-09-17)接受了 40,000 个字符。 +它统计的是字符数而非字节数,因此多字节提示词在网络传输中的大小可能是该数值的数倍。它限制的是这一个字段,而不是整个请求: +`content` 是数组,整个文档的大小由每请求的请求体限制所约束。Comfy Router(/v2/models/byteplus/\{model})是执行该限制的接口;直接调用 v1 /proxy 时,则由 BytePlus 自己的校验器作答。该值设置得远高于真实流量,因此它永远不会裁决真实提示词;如果调用方需要更多,可将其调高。 输入内容的类型 - 可选值:`text`、`image_url`、`video_url`、`audio_url`、`draft_task` + 可能的值:`text`、`image_url`、`video_url`、`audio_url`、`draft_task` @@ -260,63 +261,63 @@ Comfy 侧护栏,而非 BytePlus 的限制。BytePlus 未公布文本长度限 - 视频网址或资产 ID。 -视频网址:视频的公开网址(mp4、mov)。 -资产 ID:格式为 asset://\ + 视频 URL 或资产 ID。 +视频 URL:视频的公开 URL(mp4、mov)。 +资产 ID:格式 asset://\ 仅 Seedance 2.5。生成 480p 的 Draft 视频;resolution 必须为 480p。 -将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。 +将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终的 1080p 视频。Draft 任务 ID 有效期为 7 天。 - 视频时长(秒)。Seedance 2.5:[4,30] 或 -1(自动;视频编辑任务仅支持 -1)。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。Seedance 1.5 pro:[4,12] 或 -1。Seedance 1.0:[2,12]。 + 视频时长,单位为秒。Seedance 2.5:[4,30] 或 -1(自动;视频编辑任务仅支持 -1)。Seedance 2.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。Seedance 1.5 pro:[4,12] 或 -1。Seedance 1.0:[2,12]。 范围:`2` 到 `30` - 任务超时阈值(秒)。默认 172800(48 小时)。范围:[3600, 259200]。 + 任务超时阈值,单位为秒。默认 172800(48 小时)。范围:[3600, 259200]。 范围:`3600` 到 `259200` - Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 -true:模型输出带同步音频的视频。 -false:模型输出无声视频。 -在支持该功能的模型上,生成的音轨由提供商与视频分开进行内容审核;此处的拒绝会报告为 `content_policy_violation`,而且由于每次运行的音频都不同,对提供商本来接受的输入也可能间歇性地出现拒绝。遇到这种情况时发送 `false` 即可得到无声视频;这只在音频是被拒的模态时有效,同步的 Router 响应会在此时标明 `refusal_subject: output_audio`(排队请求目前还不会指明这一点)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改为用 `false` 重新创建 Draft。 + 由 Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。 +true: 模型输出带有同步音频的视频。 +false: 模型输出无声视频。在支持该功能的模型上,提供商会对已生成的音频轨道与视频分开进行内容检查;如果音频被拒,会报告为 `content_policy_violation`,而且由于每次运行的音频都不同,对于提供商本来可以接受的输入,这种拒绝可能会间歇性出现。如果遇到这种情况,请发送 `false` 以获得无声视频;仅当被拒的模态是音频时这才有帮助,同步的 Router 响应会将其标记为 `refusal_subject: output_audio`(排队中的请求还无法标识它)。Seedance 2.5 的最终渲染会从其 Draft 任务继承 `generate_audio`,因此请改用 `false` 重新创建 Draft。 - 要调用的模型 ID。支持的模型:seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini 和 dreamina-seedance-2-5-260628。直接调用 v1 的 POST /proxy/byteplus/api/v3/contents/generations/tasks 时必须提供它,代理会拒绝任何其他值,未提供时同样返回 400。它不在本 Schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方可以省略。 + 要调用的模型 ID。支持的模型:seedance-1-5-pro-251215、seedance-1-0-pro-250528、seedance-1-0-pro-fast-251015、dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini 和 dreamina-seedance-2-5-260628。直接向 POST /proxy/byteplus/api/v3/contents/generations/tasks 发起的 v1 调用必须提供它:代理会以 400 拒绝任何其他值,也会以 400 拒绝省略该值的情况。它不在本 schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,所以 Router 调用方会省略它。 - 仅 Seedance 2.5。输出视频的容器格式。mp4:通用容器(H.264/AAC、yuv420p),兼容性广,文件大小更小。 -mov:专业容器(H.264 High 4:4:4 Predictive/PCM、yuv444p),色彩精度高,适合后期制作;但文件大小更大。 + 仅 Seedance 2.5 支持。输出视频的容器格式。 +mp4:通用容器(H.264/AAC,yuv420p),兼容性广,文件大小更小。 +mov:专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度高,适合后期制作;文件大小更大。 - 可选值:`mp4`、`mov` + 可能的值:`mp4`、`mov` - 已生成视频的比例。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 默认:adaptive。 -Seedance 2.5 首帧 / 首尾帧生成:输出会跟随首帧的比例,因此只接受 `adaptive`(或省略该字段);若传入具体比例,会在派发前以 400 拒绝。Seedance 2.0 在这些模式下可接受具体比例。 + 已生成视频的宽高比。Seedance 2.0、2.0 fast 和 2.0 mini、1.5 pro 的默认值:adaptive。 +Seedance 2.5 的首帧 / 首尾帧生成:输出会遵循首帧的宽高比,因此只接受 `adaptive`(或省略该字段);具体比例会在派发之前以 400 拒绝。Seedance 2.0 在这些模式下接受具体比例。 - 可选值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` + 可能的值:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`9:21`、`adaptive` - 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 默认:720p。Seedance 1.0 pro 与 pro-fast 默认:1080p。 + 视频分辨率。Seedance 2.5、2.0、2.0 fast 和 2.0 mini、1.5 pro、1.0 lite 的默认值:720p。Seedance 1.0 pro 和 pro-fast 的默认值:1080p。 注意:Seedance 2.0、2.0 fast 和 2.0 mini 不支持 1080p。Seedance 2.5 支持 480p、720p 和 1080p。 - 可选值:`480p`、`720p`、`1080p`、`4k` + 可能的值:`480p`、`720p`、`1080p`、`4k` 是否返回已生成视频的最后一帧图像。 -true:返回已生成视频的最后一帧图像。将该参数设为 true 后,你可以通过调用“查询视频生成任务信息”来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不含水印。使用该参数可以生成多个连续的视频:将上一个已生成视频的最后一帧作为下一个视频任务的首帧,从而快速生成多个连续的视频。 +true:返回已生成视频的最后一帧图像。将此参数设为 true 后,你可以通过调用查询视频生成任务信息来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用此参数可以连续生成多个视频:将前一个已生成视频的最后一帧作为下一个视频任务的首帧,从而快速生成多个连续视频。 false:不返回已生成视频的最后一帧图像。 @@ -327,41 +328,55 @@ false:不返回已生成视频的最后一帧图像。 - 处理所用的服务层级。Seedance 2.5、2.0 与 2.0 fast 不支持 flex(离线推理)。 + 用于处理的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。 - 可选值:`default`、`flex` + 可能的值:`default`、`flex` - 已生成视频是否包含水印。 + 已生成的视频是否包含水印。 -该文档由 Router 在 `GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json` 提供的 schema 生成,它也是请求到达提供商之前用于校验调用的同一份文档。 +由 Router 在 `GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json` 提供的 schema 生成,这也是它在请求到达提供商之前校验调用所依据的同一份文档。 ### 输出 - 视频生成任务完成后返回的输出,其中包含输出视频的下载 URL,以及当 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会重新托管到 Comfy 存储上;此处的其他所有字段均由 BytePlus 提供。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,因此在之后轮询一个已成功的文档时,其 `content` 可能缺失或为 null。 + 视频生成任务完成后得到的输出,包含输出视频的下载 URL,以及 BytePlus 返回时其最后一帧的下载 URL。`video_url` 和 `last_frame_url` 都会重新托管到 Comfy 存储;此处其他字段均为 BytePlus 自有字段。可为空:BytePlus 会在任务完成 24 小时后清除这些 URL,因此之后轮询已成功的文档时,`content` 可能不存在或为 null。 - 已生成视频最后一帧的下载 URL,当请求中设置了 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管它收到的任何字节,并根据上游 Content-Type 或内容嗅探确定类型,而 `image/jpeg` 只是两者都失败时的最后兜底。Router 会将最后一帧重新托管到 Comfy 存储上并改写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时按 24 小时签名,并从 23 小时的备忘中回放,因此后续轮询返回的 URL 可能只剩一小时有效期。当无法执行重新托管时,此字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后清除该 URL。无论哪种方式链接都会过期,因此请下载该帧,而不要存储 URL。 + 已生成视频最后一帧的下载 URL,在请求设置 `return_last_frame` 时返回。不要根据此 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 会重新托管其收到的任意字节,并根据上游 Content-Type 或内容嗅探确定类型,而 `image/jpeg` 仅在两者都失败时作为最后的兜底方案。Router 会将最后一帧重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时签名有效期为 24 小时,并从 23 小时缓存中重放,因此之后的轮询可能返回只剩一小时有效期的 URL。无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后清除该 URL。无论哪种方式,链接都会过期,因此请下载该帧,而不是存储 URL。 - 已生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 中时出现。Seedance 模型更常将其作为 `content` 的顶层同级字段返回(参见顶层 `output_format` 字段),Router 会读取二者中存在的那个。 + 已生成视频的容器格式(mp4 或 mov),当 BytePlus 将其嵌套在 `content` 中时出现。Seedance 模型更常将其作为 `content` 的顶层同级字段返回(参见顶层 `output_format` 字段),Router 会读取两者中存在的那个。 + + + + 上游 URL 停止工作的 RFC 3339 时间:取 URL 本身携带的最早签名时间加有效期;当 `updated_at` 存在时,绝不晚于任务的 `updated_at` 加 24 小时(BytePlus 文档记录的 URL 生命周期),否则为任务的 `updated_at` 加 24 小时。仅当存在 `upstream_video_url` 或 `upstream_last_frame_url` 时出现,两个来源都未提供时间时省略。与重新托管的 `video_url` / `last_frame_url` 的生命周期无关。 + + 格式:`date-time` + + + + BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 并排逐字节返回,条款与 `upstream_video_url` 相同:仅限已选择加入的工作区,仅限 Seedance 2.x,在 BytePlus 清除后不存在,并且在 `upstream_expires_at` 之前是持有者凭证。 + + + + BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 并排逐字节返回。仅当任务由 Comfy 已在服务器端选择加入的工作区轮询的 Seedance 2.x 任务时出现(没有请求参数);其他所有情况均不存在,包括解析不到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥),并且 BytePlus 在生成 24 小时后清除其 URL 后也不存在。它是预签名的对象存储 URL,因此是持有者凭证:任何持有它的人都能在过期前下载视频,所以请将其视为机密。它在 `upstream_expires_at` 过期,并且在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次会被 Router 自身的重新托管消耗。 - 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储上并改写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时按 24 小时签名,并从 23 小时的备忘中回放,因此后续轮询返回的 URL 可能只剩一小时有效期。当无法执行重新托管时,此字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后清除该 URL,并在某些模型上将下载次数上限设为 100 次。无论哪种方式链接都会过期,因此请下载视频,而不要存储 URL。 + 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时签名有效期为 24 小时,并从 23 小时缓存中重放,因此之后的轮询可能返回只剩一小时有效期的 URL。无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后清除该 URL,并在某些模型上限制为 100 次下载。无论哪种方式,链接都会过期,因此请下载视频,而不是存储 URL。 - 任务创建的时间。该值为 UNIX 时间戳,以秒为单位。 + 任务创建的时间。值为 UNIX 时间戳,单位为秒。 - 已生成视频的时长,以秒为单位。之所以声明为 number 而不是 integer,是因为 BytePlus 对此并不一致:已观察到视频任务返回整数秒,而 BytePlus 的其他同类接口会报告带小数的时长,因此客户端不应假定它是整数值。这是 BytePlus 自己的字段,在成功的视频任务中返回,并原样转发。 + 已生成视频的时长,单位为秒。声明为数字而非整数,因为 BytePlus 对此并不一致:已观察到视频任务返回整秒,而同级 BytePlus 接口报告小数时长,因此客户端不得假定为整数值。这是 BytePlus 自有字段,在已成功的视频任务上返回并原样转发。 @@ -369,7 +384,7 @@ false:不返回已生成视频的最后一帧图像。 - 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。同一族系可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是一个开放字符串,而不是枚举:其他错误码描述验证和提供商故障。Router 会在 HTTP 400 错误信封和 HTTP 200 失败任务响应中识别策略族系,而不会覆盖传输层故障。 + 上游 ModelArk 错误码。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected 和 OutputAudioSensitiveContentDetected 表示内容策略拒绝。一个系列可能带有以点分隔的原因,例如 InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation 或 OutputImageSensitiveContentDetected.DeepFake。这是开放字符串,不是枚举:其他错误码描述验证和提供商失败。Router 会在 HTTP 400 错误响应封套和 HTTP 200 失败任务响应中识别策略系列,而不会覆盖传输失败。 @@ -381,19 +396,19 @@ false:不返回已生成视频的最后一帧图像。 - 任务所用模型的名称和版本 + 该任务所使用的模型名称和版本 - 已生成视频的容器格式(mp4 或 mov),作为 `content` 的同级字段在顶层返回:Seedance 视频任务查询即在此处返回它。这是 BytePlus 自己的字段,原样转发。 + 生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回,Seedance 视频任务查询正是在此返回该字段。这是 BytePlus 自有字段,原样透传。 - 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自己的字段,在成功的视频任务中返回,并原样转发。 + 生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在视频任务成功时返回并原样透传。 - 任务实际使用的生成种子。这是 BytePlus 自己的字段,在成功的视频任务中返回,并原样转发。 + 该任务实际使用的生成种子。这是 BytePlus 自有字段,在视频任务成功时返回并原样透传。 格式:`int64` @@ -401,15 +416,15 @@ false:不返回已生成视频的最后一帧图像。 任务的状态 - 可能的值:`queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` + 可选值:`queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired` - 任务最后更新的时间。该值为 UNIX 时间戳,以秒为单位。 + 任务最后更新的时间。该值为 UNIX 时间戳,单位为秒。 - 请求的 token 用量 + 本次请求的 token 用量 @@ -417,7 +432,7 @@ false:不返回已生成视频的最后一帧图像。 - 对于视频生成模型,不计算输入 token 数量,默认为 0。因此,total_tokens = completion_tokens。 + 对于视频生成模型,不计算输入 token 数,默认值为 0。因此 total_tokens = completion_tokens。 ## 示例 diff --git a/zh/development/comfy-router/models/krea/krea-3/code.mdx b/zh/development/comfy-router/models/krea/krea-3/code.mdx index acd55f4f3c..47e63fc832 100644 --- a/zh/development/comfy-router/models/krea/krea-3/code.mdx +++ b/zh/development/comfy-router/models/krea/krea-3/code.mdx @@ -2,15 +2,16 @@ title: "通过 Comfy Router 使用 Krea 3" description: "通过 Comfy Router 调用 krea/krea-3:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Krea 3" -translationSourceHash: a539ac5a +translationSourceHash: bf8b60e8 translationFrom: development/comfy-router/models/krea/krea-3/code.mdx translationBlockHashes: "_intro": ac71b80c "Quick start": d6a4d54e - "Schema": 9c44fce0 + "Schema": 672a9195 "Examples": 276619d9 --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/krea/krea-3.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -155,7 +156,7 @@ curl https://api.comfy.org/v2/models/krea/krea-3/requests/$REQUEST_ID \ - 输入图像 URL,最多 8 个。每个都必须是先将图像上传到 POST /proxy/krea/assets(multipart 表单字段 `file`)后返回的 image_url;任何不是主机 app-uploads.krea.ai 上的 https URL 的链接(包括你自己的 https URL)都会被以 400 拒绝,而非实时上传的 app-uploads.krea.ai 链接则会以 5xx 错误失败。文生图时省略。 + 输入图像 URL,最多 8 个。将图像上传到 POST /proxy/krea/assets(multipart 表单字段 `file`)后返回的 image_url 始终会被接受。是否接受其他公共 https URL 取决于环境:不接受时,任何不是主机 app-uploads.krea.ai 上的 https URL 的链接都会以 400 被拒绝;接受时,任何公共 https 图像 URL 都会被接受,而格式错误或不是 https 的 URL 会以 400 被拒绝。在后一种情况下,对于格式正确的 https URL,调用方可修正的引用会以 400 被拒绝并指明其主机:在抓取之前检查时,其主机无法解析或不可公开访问,它重定向的次数超过允许次数、重定向到不是 https 的 URL 或重定向到不可公开访问的主机,它返回除 408 或 429 以外的 4xx,它不是图像,它是格式无法读取的图像,它的图像尺寸头部不在前 2 MiB 内,或者没有声明长度或使用分块编码的响应在其图像尺寸头部之前就结束了。抓取它时的任何其他失败都会在 POST /proxy/krea 上以 502 错误失败(Comfy Router 以 500 internal_error 应答):临时的 DNS、TLS 或连接失败,超时,源站返回 408、429、5xx 或其他非 200 状态,或者主机通过了该检查但在抓取连接时无法解析或不可公开访问。在不接受其他 URL 的情况下,不是实时上传的 app-uploads.krea.ai 链接会以 5xx 错误失败;在接受的情况下,它会像任何其他不可达引用一样以 400 被拒绝。当服务器尚未确定适用哪种情况时,任何主机不是 app-uploads.krea.ai 链接的 https URL(无论是否公共)都会以 503 错误失败,该错误可安全重试。文生图时省略。 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..38a52fa761 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,14 +2,15 @@ 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 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -166,13 +167,13 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ ### 输入 - 输出宽高比。ray-3.2 视频模型支持 9:16、3:4、1:1、4:3、16:9、21:9 这一子集。 + 输出宽高比。ray-3.2 视频模型支持其中的 9:16、3:4、1:1、4:3、16:9、21:9 子集。 - 可能的值:`3:1`、`2:1`、`21:9`、`16:9`、`3:2`、`4:3`、`1:1`、`3:4`、`2:3`、`9:16`、`1:2`、`1:3` + 可选值:`3:1`、`2:1`、`21:9`、`16:9`、`3:2`、`4:3`、`1:1`、`3:4`、`2:3`、`9:16`、`1:2`、`1:3` - 用于风格/内容引导的参考图像。type 为 'image' 时最多 9 张,type 为 'image_edit' 时最多 8 张。 + 用于风格/内容引导的参考图像。类型为 'image' 时最多 9 张,类型为 'image_edit' 时最多 8 张。 @@ -180,11 +181,11 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 先前已完成生成的 UUID,用于复用为来源。供 ray-3.2 video_edit / video_reframe 使用。 + 此前已完成的生成任务的 UUID,用作来源。供 ray-3.2 的 video_edit / video_reframe 使用。 - MIME 类型。与 data 一起使用时为必填(对于视频来源还需与 url 一起使用,例如 video_edit / video_reframe 上的 video/mp4)。 + MIME 类型。与 data 一起使用时为必填(视频来源时还需与 url 一起使用,例如 video_edit / video_reframe 上的 video/mp4)。 @@ -192,13 +193,13 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 要使用的模型。uni-1 / uni-1-max 用于图像生成,ray-3.2 用于视频生成、编辑和重新取景。 + 要使用的模型。图像生成使用 uni-1 / uni-1-max,视频生成、编辑和重构图使用 ray-3.2。 输出图像格式 - 可能的值:`png`、`jpeg` + 可选值:`png`、`jpeg` @@ -206,7 +207,7 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 对图像或视频的引用。用于风格/内容引导、引导式生成、video-edit/video-reframe 来源以及引导关键帧。请提供 generation_id、url 或 data 中的恰好一个。 + 对图像或视频的引用。用于风格/内容引导、引导式生成、video-edit/video-reframe 来源以及引导关键帧。请从 generation_id、url 或 data 中恰好提供一个。 @@ -214,11 +215,11 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 先前已完成生成的 UUID,用于复用为来源。供 ray-3.2 video_edit / video_reframe 使用。 + 此前已完成的生成任务的 UUID,用作来源。供 ray-3.2 的 video_edit / video_reframe 使用。 - MIME 类型。与 data 一起使用时为必填(对于视频来源还需与 url 一起使用,例如 video_edit / video_reframe 上的 video/mp4)。 + MIME 类型。与 data 一起使用时为必填(视频来源时还需与 url 一起使用,例如 video_edit / video_reframe 上的 video/mp4)。 @@ -228,27 +229,27 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ 风格预设 - 可能的值:`auto`、`manga` + 可选值:`auto`、`manga` 要执行的生成类型。image/image_edit 由 uni-1 / uni-1-max 模型生成;video/video_edit/video_reframe 由 ray-3.2 模型生成。 - 可能的值:`image`、`image_edit`、`video`、`video_edit`、`video_reframe` + 可选值:`image`、`image_edit`、`video`、`video_edit`、`video_reframe` - ray-3.2 的视频输出设置。此处仅建模影响验证和计费的字段;其他字段(编辑控制项、source_position)将原样转发给 Luma。 + ray-3.2 的视频输出设置。此处仅对影响验证和计费的字段建模;其他字段(编辑控制项、source_position)会原样转发给 Luma。 ray-3.2 video / video_edit 的片段时长。默认为 5s。HDR 生成(type 为 video)仅限 5s。 - 可能的值:`5s`、`10s` + 可选值:`5s`、`10s` - 对图像或视频的引用。用于风格/内容引导、引导式生成、video-edit/video-reframe 来源以及引导关键帧。请提供 generation_id、url 或 data 中的恰好一个。 + 对图像或视频的引用。用于风格/内容引导、引导式生成、video-edit/video-reframe 来源以及引导关键帧。请从 generation_id、url 或 data 中恰好提供一个。 @@ -256,11 +257,11 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 先前已完成生成的 UUID,用于复用为来源。供 ray-3.2 video_edit / video_reframe 使用。 + 此前已完成的生成任务的 UUID,用作来源。供 ray-3.2 的 video_edit / video_reframe 使用。 - MIME 类型。与 data 一起使用时为必填(对于视频来源还需与 url 一起使用,例如 video_edit / video_reframe 上的 video/mp4)。 + MIME 类型。与 data 一起使用时为必填(视频来源时还需与 url 一起使用,例如 video_edit / video_reframe 上的 video/mp4)。 @@ -268,19 +269,19 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 暂不可用:在 Luma 提供 EXR 交付之前,带 `exr_export=true` 的请求会以 400 拒绝。将来会在 MP4 之外同时导出 EXR 文件(需要 hdr 为 true)。video_reframe 下会被拒绝。 + 尚不可用:在 Luma 提供 EXR 交付之前,带有 exr_export=true 的请求会返回 400 被拒绝。将在 MP4 之外额外导出一个 EXR 文件(要求 hdr 为 true)。video_reframe 会拒绝此项。 - 以 HDR 渲染。需要 720p/1080p。video_reframe 下会被拒绝。 + 以 HDR 渲染。要求 720p/1080p。video_reframe 会拒绝此项。 - `keyframes` 对应的输出帧位置,长度相同;5s 时为 0–120,10s 时为 0–240。原样转发。 + `keyframes` 的输出帧位置,长度相同;5s 时为 0–120,10s 时为 0–240。原样转发。 - 引导帧图像(1–64),与 start_frame/end_frame 互斥。按请求的时长计费;keyframes 请求绝不会是单关键帧延长。 + 引导帧图像(1–64),与 start_frame/end_frame 互斥。按请求的时长计费;keyframes 请求绝不会被视为单关键帧延长。 @@ -288,11 +289,11 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 先前已完成生成的 UUID,用于复用为来源。供 ray-3.2 video_edit / video_reframe 使用。 + 此前已完成的生成任务的 UUID,用作来源。供 ray-3.2 的 video_edit / video_reframe 使用。 - MIME 类型。与 data 一起使用时为必填(对于视频来源还需与 url 一起使用,例如 video_edit / video_reframe 上的 video/mp4)。 + MIME 类型。与 data 一起使用时为必填(视频来源时还需与 url 一起使用,例如 video_edit / video_reframe 上的 video/mp4)。 @@ -304,13 +305,13 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - ray-3.2 视频的输出分辨率。默认为 720p。360p 为草稿档位。HDR 需要 720p 或 1080p。 + ray-3.2 video 的输出分辨率。默认为 720p。360p 为草稿档位。HDR 要求 720p 或 1080p。 - 可能的值:`360p`、`540p`、`720p`、`1080p` + 可选值:`360p`、`540p`、`720p`、`1080p` - 对图像或视频的引用。用于风格/内容引导、引导式生成、video-edit/video-reframe 来源以及引导关键帧。请提供 generation_id、url 或 data 中的恰好一个。 + 对图像或视频的引用。用于风格/内容引导、引导式生成、video-edit/video-reframe 来源以及引导关键帧。请从 generation_id、url 或 data 中恰好提供一个。 @@ -318,11 +319,11 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 先前已完成生成的 UUID,用于复用为来源。供 ray-3.2 video_edit / video_reframe 使用。 + 先前已完成生成的 UUID,用作来源。由 ray-3.2 video_edit / video_reframe 使用。 - MIME 类型。与 data 搭配时为必填(对于视频来源,还需搭配 url,例如在 video_edit / video_reframe 上使用 video/mp4)。 + MIME 类型。搭配 data 时必填(视频来源还需搭配 url,例如 video_edit / video_reframe 上的 video/mp4)。 @@ -330,10 +331,10 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 启用网络搜索依据 + 启用网络搜索 grounding -根据 Router 在 `GET /v2/models/luma_2/ray-3.2/openapi.json` 提供的 schema 生成,该文档也是它在请求到达提供商之前用于校验调用的同一份文档。 +根据 Router 在 `GET /v2/models/luma_2/ray-3.2/openapi.json` 提供的 schema 生成,该文档与它在请求到达提供商之前校验调用所用的文档相同。 ### 输出 @@ -342,7 +343,7 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 供程序化处理的机器可读失败代码 + 供程序化处理使用的机器可读失败代码 可能的值:`content_moderated`、`generation_failed`、`budget_exhausted`、`output_not_found` @@ -356,11 +357,11 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 使用的模型 + 所使用的模型 - 一条生成的输出条目 + 一条生成输出条目 @@ -368,7 +369,7 @@ curl https://api.comfy.org/v2/models/luma_2/ray-3.2/requests/$REQUEST_ID \ - 预签名 URL(1 小时过期) + 预签名 URL(有效期 1 小时) 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..a59bc2d4c6 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,17 +2,16 @@ 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 --- - {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/luma_2/uni-1-max.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -153,7 +152,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ ### 输入 - 输出宽高比。ray-3.2 视频模型支持 9:16、3:4、1:1、4:3、16:9、21:9 这一子集。 + 输出宽高比。ray-3.2 视频模型支持子集 9:16、3:4、1:1、4:3、16:9、21:9。 可能的值:`3:1`、`2:1`、`21:9`、`16:9`、`3:2`、`4:3`、`1:1`、`3:4`、`2:3`、`9:16`、`1:2`、`1:3` @@ -167,11 +166,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 先前已完成生成的 UUID,可复用为来源。供 ray-3.2 video_edit / video_reframe 使用。 + 先前已完成生成的 UUID,用于复用为来源。由 ray-3.2 的 video_edit / video_reframe 使用。 - MIME 类型。与 data 同时使用时为必填(对于视频来源,还需与 url 同时使用,例如 video_edit / video_reframe 上的 video/mp4)。 + MIME 类型。与 data 一起时为必填(对于视频来源还需配合 url,例如 video_edit / video_reframe 上的 video/mp4)。 @@ -179,7 +178,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 要使用的模型。uni-1 / uni-1-max 用于图像生成,ray-3.2 用于视频生成、编辑和重新取景。 + 要使用的模型。uni-1 / uni-1-max 用于图像生成,ray-3.2 用于视频生成、编辑和重新构图。 @@ -193,7 +192,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 对图像或视频的引用。用于风格/内容引导、引导式生成、视频编辑/重新取景来源以及引导关键帧。必须且只能提供 generation_id、url 或 data 中的一个。 + 对图像或视频的引用。用于风格/内容引导、引导式生成、视频编辑/视频重新构图的来源以及引导关键帧。请提供 generation_id、url 或 data 中的恰好一个。 @@ -201,11 +200,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 先前已完成生成的 UUID,可复用为来源。供 ray-3.2 video_edit / video_reframe 使用。 + 先前已完成生成的 UUID,用于复用为来源。由 ray-3.2 的 video_edit / video_reframe 使用。 - MIME 类型。与 data 同时使用时为必填(对于视频来源,还需与 url 同时使用,例如 video_edit / video_reframe 上的 video/mp4)。 + MIME 类型。与 data 一起时为必填(对于视频来源还需配合 url,例如 video_edit / video_reframe 上的 video/mp4)。 @@ -225,7 +224,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - ray-3.2 的视频输出设置。此处仅对影响验证和计费的字段建模;其他字段(编辑控制、source_position)会原样转发给 Luma。 + ray-3.2 的视频输出设置。此处仅对影响验证和计费的字段建模;其他字段(编辑控制项、source_position)会原样转发给 Luma。 @@ -235,7 +234,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 对图像或视频的引用。用于风格/内容引导、引导式生成、视频编辑/重新取景来源以及引导关键帧。必须且只能提供 generation_id、url 或 data 中的一个。 + 对图像或视频的引用。用于风格/内容引导、引导式生成、视频编辑/视频重新构图的来源以及引导关键帧。请提供 generation_id、url 或 data 中的恰好一个。 @@ -243,11 +242,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 先前已完成生成的 UUID,可复用为来源。供 ray-3.2 video_edit / video_reframe 使用。 + 先前已完成生成的 UUID,用于复用为来源。由 ray-3.2 的 video_edit / video_reframe 使用。 - MIME 类型。与 data 同时使用时为必填(对于视频来源,还需与 url 同时使用,例如 video_edit / video_reframe 上的 video/mp4)。 + MIME 类型。与 data 一起时为必填(对于视频来源还需配合 url,例如 video_edit / video_reframe 上的 video/mp4)。 @@ -255,19 +254,19 @@ 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 会拒绝该字段。 - 以 HDR 渲染。要求 720p/1080p。在 video_reframe 中会被拒绝。 + 以 HDR 渲染。需要 720p/1080p。video_reframe 会拒绝该字段。 - `keyframes` 的输出帧位置,长度相同;5s 时为 0–120,10s 时为 0–240。原样转发。 + `keyframes` 的输出帧位置,长度相同;5s 为 0–120,10s 为 0–240。原样转发。 - 引导帧图像(1–64),与 start_frame/end_frame 互斥。按请求的时长计费;keyframes 请求绝不会是单关键帧延长。 + 引导帧图像(1–64 张),与 start_frame/end_frame 互斥。按请求的时长计费;keyframes 请求绝不会是单关键帧的延长。 @@ -275,11 +274,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 先前已完成生成的 UUID,可复用为来源。供 ray-3.2 video_edit / video_reframe 使用。 + 先前已完成生成的 UUID,用于复用为来源。由 ray-3.2 的 video_edit / video_reframe 使用。 - MIME 类型。与 data 同时使用时为必填(对于视频来源,还需与 url 同时使用,例如 video_edit / video_reframe 上的 video/mp4)。 + MIME 类型。与 data 一起时为必填(对于视频来源还需配合 url,例如 video_edit / video_reframe 上的 video/mp4)。 @@ -287,17 +286,17 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 循环已生成的片段。仅创建时可用(type 为 video)。 + 循环生成的片段。仅创建时可用(type 为 video)。 - ray-3.2 视频的输出分辨率。默认为 720p。360p 是草稿档位。HDR 要求 720p 或 1080p。 + ray-3.2 video 的输出分辨率。默认为 720p。360p 是草稿档位。HDR 需要 720p 或 1080p。 可能的值:`360p`、`540p`、`720p`、`1080p` - 对图像或视频的引用。用于风格/内容引导、引导式生成、视频编辑/重新取景来源以及引导关键帧。必须且只能提供 generation_id、url 或 data 中的一个。 + 对图像或视频的引用。用于风格/内容引导、引导式生成、视频编辑/视频重新构图的来源以及引导关键帧。请提供 generation_id、url 或 data 中的恰好一个。 @@ -305,11 +304,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 此前已完成的生成 UUID,可复用为来源。供 ray-3.2 的 video_edit / video_reframe 使用。 + 先前已完成的生成任务的 UUID,用作来源。用于 ray-3.2 的 video_edit / video_reframe。 - MIME 类型。与 data 一起使用时必填(对于视频来源,还需与 url 一起使用,例如在 video_edit / video_reframe 上使用 video/mp4)。 + MIME 类型。与 data 一起使用时为必填(视频来源与 url 一起使用时同样必填,例如 video_edit / video_reframe 上的 video/mp4)。 @@ -317,10 +316,10 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 启用网络搜索接地 + 启用搜索依据 -根据 Router 在 `GET /v2/models/luma_2/uni-1-max/openapi.json` 提供的 schema 生成,该文档也是 Router 在请求到达提供商之前用于校验调用的同一份文档。 +根据 Router 在 `GET /v2/models/luma_2/uni-1-max/openapi.json` 提供的 schema 生成,这也是它在请求到达提供商之前用于校验调用的同一份文档。 ### 输出 @@ -329,13 +328,13 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 供程序化处理的机器可读失败代码 + 用于程序化处理的机器可读失败代码 - 可能的值:`content_moderated`、`generation_failed`、`budget_exhausted`、`output_not_found` + 可选值:`content_moderated`、`generation_failed`、`budget_exhausted`、`output_not_found` - 人类可读的失败描述,仅在生成状态为 FAILED 时填充。成功时为 `null`。 + 人类可读的失败描述,仅在生成失败时填充。成功时为 `null`。 @@ -343,11 +342,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 使用的模型 + 所使用的模型 - 一个已生成的输出条目 + 一条生成的输出条目 @@ -355,19 +354,19 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1-max/requests/$REQUEST_ID \ - 预签名 URL(有效期 1 小时) + 预签名 URL(1 小时后过期) 生成的当前状态 - 可能的值:`queued`、`processing`、`completed`、`failed` + 可选值:`queued`、`processing`、`completed`、`failed` 要执行的生成类型。image/image_edit 由 uni-1 / uni-1-max 模型生成;video/video_edit/video_reframe 由 ray-3.2 模型生成。 - 可能的值:`image`、`image_edit`、`video`、`video_edit`、`video_reframe` + 可选值:`image`、`image_edit`、`video`、`video_edit`、`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..e610e8d4e7 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,17 +2,16 @@ 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 --- - {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/luma_2/uni-1.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -153,7 +152,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ ### 输入 - 输出宽高比。ray-3.2 视频模型支持 9:16、3:4、1:1、4:3、16:9、21:9 这一子集。 + 输出宽高比。ray-3.2 视频模型支持的子集为 9:16、3:4、1:1、4:3、16:9、21:9。 可能的值:`3:1`、`2:1`、`21:9`、`16:9`、`3:2`、`4:3`、`1:1`、`3:4`、`2:3`、`9:16`、`1:2`、`1:3` @@ -167,11 +166,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 之前已完成生成的 UUID,可复用为来源。用于 ray-3.2 的 video_edit / video_reframe。 + 之前已完成生成的 UUID,可复用为来源。供 ray-3.2 video_edit / video_reframe 使用。 - MIME 类型。与 data 一起使用时必填(视频来源还需与 url 一起使用,例如 video_edit / video_reframe 上的 video/mp4)。 + MIME 类型。与 data 一起时为必填(视频来源与 url 一起时也为必填,例如 video_edit / video_reframe 上的 video/mp4)。 @@ -179,7 +178,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 要使用的模型。uni-1 / uni-1-max 用于图像生成,ray-3.2 用于视频生成、编辑和重新取景。 + 要使用的模型。图像生成使用 uni-1 / uni-1-max,视频生成、编辑和重新取景使用 ray-3.2。 @@ -193,7 +192,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 对图像或视频的引用。用于风格/内容引导、引导式生成、video-edit/video-reframe 来源以及引导关键帧。请仅提供 generation_id、url 或 data 三者之一。 + 对图像或视频的引用。用于风格/内容引导、引导式生成、video-edit/video-reframe 来源以及引导关键帧。必须且只能提供 generation_id、url 或 data 中的一个。 @@ -201,11 +200,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 之前已完成生成的 UUID,可复用为来源。用于 ray-3.2 的 video_edit / video_reframe。 + 之前已完成生成的 UUID,可复用为来源。供 ray-3.2 video_edit / video_reframe 使用。 - MIME 类型。与 data 一起使用时必填(视频来源还需与 url 一起使用,例如 video_edit / video_reframe 上的 video/mp4)。 + MIME 类型。与 data 一起时为必填(视频来源与 url 一起时也为必填,例如 video_edit / video_reframe 上的 video/mp4)。 @@ -225,17 +224,17 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - ray-3.2 的视频输出设置。此处仅对影响验证和计费的字段建模;其他字段(编辑控制项、source_position)会原样转发给 Luma。 + ray-3.2 的视频输出设置。此处仅建模影响验证和计费的字段;其他字段(编辑控制项、source_position)会原样转发给 Luma。 - ray-3.2 video / video_edit 的片段时长。默认 5s。HDR 生成(类型 video)仅限 5s。 + ray-3.2 video / video_edit 的片段时长。默认为 5s。HDR 生成(type 为 video)仅限 5s。 可能的值:`5s`、`10s` - 对图像或视频的引用。用于风格/内容引导、引导式生成、video-edit/video-reframe 来源以及引导关键帧。请仅提供 generation_id、url 或 data 三者之一。 + 对图像或视频的引用。用于风格/内容引导、引导式生成、video-edit/video-reframe 来源以及引导关键帧。必须且只能提供 generation_id、url 或 data 中的一个。 @@ -243,11 +242,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 之前已完成生成的 UUID,可复用为来源。用于 ray-3.2 的 video_edit / video_reframe。 + 之前已完成生成的 UUID,可复用为来源。供 ray-3.2 video_edit / video_reframe 使用。 - MIME 类型。与 data 一起使用时必填(视频来源还需与 url 一起使用,例如 video_edit / video_reframe 上的 video/mp4)。 + MIME 类型。与 data 一起时为必填(视频来源与 url 一起时也为必填,例如 video_edit / video_reframe 上的 video/mp4)。 @@ -255,7 +254,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 中会被拒绝。 @@ -267,7 +266,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 引导帧图像(1–64),与 start_frame/end_frame 互斥。按请求的时长计费;keyframes 请求绝不会被视为单关键帧扩展。 + 引导帧图像(1–64),与 start_frame/end_frame 互斥。按请求的时长计费;keyframes 请求绝不会是单关键帧延长。 @@ -275,11 +274,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 之前已完成生成的 UUID,可复用为来源。用于 ray-3.2 的 video_edit / video_reframe。 + 之前已完成生成的 UUID,可复用为来源。供 ray-3.2 video_edit / video_reframe 使用。 - MIME 类型。与 data 一起使用时必填(视频来源还需与 url 一起使用,例如 video_edit / video_reframe 上的 video/mp4)。 + MIME 类型。与 data 一起时为必填(视频来源与 url 一起时也为必填,例如 video_edit / video_reframe 上的 video/mp4)。 @@ -287,7 +286,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 循环播放生成的片段。仅创建时可用(类型 video)。 + 循环播放已生成的片段。仅创建时可用(type 为 video)。 @@ -297,7 +296,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 对图像或视频的引用。用于风格/内容引导、引导式生成、video-edit/video-reframe 来源以及引导关键帧。请仅提供 generation_id、url 或 data 三者之一。 + 对图像或视频的引用。用于风格/内容引导、引导式生成、video-edit/video-reframe 来源以及引导关键帧。必须且只能提供 generation_id、url 或 data 中的一个。 @@ -305,11 +304,11 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 此前已完成的生成 UUID,可复用为来源。供 ray-3.2 的 video_edit / video_reframe 使用。 + 之前已完成的生成的 UUID,用于复用为来源。供 ray-3.2 video_edit / video_reframe 使用。 - MIME 类型。与 data 一同使用时为必填(对于视频来源还需与 url 一同使用,例如 video_edit / video_reframe 上的 video/mp4)。 + MIME 类型。与 data 一起使用时必填(对于视频来源,还需与 url 一起使用,例如在 video_edit / video_reframe 上的 video/mp4)。 @@ -317,10 +316,10 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 启用 Web 搜索接地 + 启用网络搜索基础 -由 Router 在 `GET /v2/models/luma_2/uni-1/openapi.json` 提供并据此生成的 schema,与它在请求到达提供商之前校验调用时所使用的是同一份文档。 +根据 Router 在 `GET /v2/models/luma_2/uni-1/openapi.json` 提供的 schema 生成,该文档也是它在请求到达提供商之前验证调用时所依据的同一份文档。 ### 输出 @@ -335,7 +334,7 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 人类可读的失败描述,仅在 FAILED 生成时填充。成功时为 `null`。 + 人类可读的失败描述,仅在生成失败时填充。成功时为 `null`。 @@ -347,15 +346,15 @@ curl https://api.comfy.org/v2/models/luma_2/uni-1/requests/$REQUEST_ID \ - 生成的输出条目 + 一个已生成的输出条目 - 媒体类型(例如 image) + 媒体类型(例如图像) - 预签名 URL(1 小时有效) + 预签名 URL(1 小时过期) diff --git a/zh/development/comfy-router/models/veed/fabric-1-0/code.mdx b/zh/development/comfy-router/models/veed/fabric-1-0/code.mdx index 33bf55a00e..b42998914a 100644 --- a/zh/development/comfy-router/models/veed/fabric-1-0/code.mdx +++ b/zh/development/comfy-router/models/veed/fabric-1-0/code.mdx @@ -2,14 +2,15 @@ title: "使用 Fabric 1.0 与 Comfy Router" description: "通过 Comfy Router 调用 veed/fabric-1.0:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Fabric 1.0" -translationSourceHash: 8e2360a2 +translationSourceHash: 0d5557e0 translationFrom: development/comfy-router/models/veed/fabric-1-0/code.mdx translationBlockHashes: "_intro": c0f6ceff "Quick start": 2856fd42 - "Schema": 9ea03528 + "Schema": 17071210 "Examples": 952acc85 --- + {/* GENERATED FILE. Generated from router-schemas/veed/fabric-1.0.json by `pnpm code-pages:gen`. */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -154,7 +155,7 @@ curl https://api.comfy.org/v2/models/veed/fabric-1.0/requests/$REQUEST_ID \ ### 输入 - 用于对口型同步的语音轨道的公开 http(s) URL。视频时长与音频相同。 + 用于对口型同步的语音轨道的公开 http(s) URL。视频时长与音频相同。当音频时长超过单次调用的输入上限时,会以 400 拒绝。 diff --git a/zh/development/comfy-router/models/veed/lipsync-2-0/code.mdx b/zh/development/comfy-router/models/veed/lipsync-2-0/code.mdx index 8096d48c4b..47b5ebcf83 100644 --- a/zh/development/comfy-router/models/veed/lipsync-2-0/code.mdx +++ b/zh/development/comfy-router/models/veed/lipsync-2-0/code.mdx @@ -2,14 +2,15 @@ title: "使用 Comfy Router 调用 Lipsync 2.0" description: "通过 Comfy Router 调用 veed/lipsync-2.0:端点、请求形状以及 Router 返回的响应。" sidebarTitle: "Lipsync 2.0" -translationSourceHash: 3d623f70 +translationSourceHash: 55607886 translationFrom: development/comfy-router/models/veed/lipsync-2-0/code.mdx translationBlockHashes: "_intro": 1fd676f1 "Quick start": 05550229 - "Schema": a26c8117 + "Schema": 24733e29 "Examples": 01527a02 --- + {/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/veed/lipsync-2.0.json 生成。 */} import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx"; @@ -150,7 +151,7 @@ curl https://api.comfy.org/v2/models/veed/lipsync-2.0/requests/$REQUEST_ID \ ### 输入 - 用于给视频对口型的新音频轨道的公开 http(s) URL。 + 用于给视频对口型的新音频轨道的公开 http(s) URL。当音频长度超过每次调用的输入上限时,请求会被拒绝并返回 400。 diff --git a/zh/development/comfy-router/reference.mdx b/zh/development/comfy-router/reference.mdx index 1caa523e99..80b74c6c40 100644 --- a/zh/development/comfy-router/reference.mdx +++ b/zh/development/comfy-router/reference.mdx @@ -2,17 +2,17 @@ title: "Comfy Router API 参考" description: "每个 Comfy Router 端点、参数、响应体和错误分类,均由 Comfy API 契约生成。" sidebarTitle: "API 参考" -translationSourceHash: 1b971d1c +translationSourceHash: 9a5e0219 translationFrom: development/comfy-router/reference.mdx translationBlockHashes: "_intro": 3f6e5d23 - "Endpoints": fbcaaf0e - "Error buckets": 36170340 + "Endpoints": 222fd740 + "Error buckets": 02a09cb4 "Response headers": 403c8bf5 - "Pre-flight cost estimates": 3ecabac6 - "Result assets": 65fc939b + "Pre-flight cost estimates": 862a49f8 + "Result assets": 18fe6dad "Per-model input and output schemas": 61c6bde8 - "Schemas": 77cfa4db + "Schemas": 0c65163b --- @@ -26,7 +26,6 @@ translationBlockHashes: - {/* 生成的文件:请勿手动编辑。 @@ -1021,6 +1020,8 @@ Router 在运行之前尚无法定价的模型列在[没有预检预估的模型 其他模型返回提供商资产引用或内联字节。提供商 URL 遵循提供商的过期时间,这可能比上述有效期短得多,且 Router 契约未对此作出规定。 +**BytePlus 原始 URL(Seedance 2.x,需开启)。** 对于 Comfy 已在服务端开启该功能的工作区,Seedance 2.x 的结果在复制后的 URL 之外,还会在 `content.upstream_video_url` 和 `content.upstream_last_frame_url` 中携带 BytePlus 自身的 URL,并附带 `content.upstream_expires_at`。没有对应的请求参数,默认没有任何工作区被开启。这些 URL 在生成后 24 小时过期,BytePlus 清除后即不存在;在 Seedance 2.5 上,BytePlus 限制每个 URL 最多下载 100 次,而 Router 自己的副本会占用其中一次。每个 URL 都是对应对象的 bearer 凭证:任何持有它的人都能在过期前下载该资产。 + 复制是按资产尽力而为的。如果某个复制失败,该条目会保留其提供商引用;响应可以同时包含 Comfy 和提供商 URL,且没有明确的按资产复制状态字段。生成仍会成功并计费。不要根据一个成功重新托管的资产来推断每个 URL 的有效期。 结果是否由 Comfy 托管也决定了已完成的调用以后是否仍能从其 `Idempotency-Key` 记录中重放;上面的 `Idempotency-Key` 参数说明了无法重放时重试会得到怎样的回应。 @@ -1033,6 +1034,24 @@ Router 在运行之前尚无法定价的模型列在[没有预检预估的模型 ## Schemas +### RouterBilledWorkspace + +被拒绝的调用本会扣费的钱包,出现在 `RouterErrorResponse.billed_workspace` 中。它回答的是「哪个钱包余额不足」,并不一定等于调用方 UI 当前选中的工作区:团队成员使用个人凭证时,即使当前打开的是一个有余额的团队,这里也会指向其个人钱包。仅与 `denied_reason` 一同出现。 + +**字段** + + + Cloud 工作区 ID。在旧计费通道上不存在。 + + + + `personal` 或 `team`。开放式字符串:其他任何值都按 `personal` 处理。 + + + + 当调用计费到调用方在工作区之前的 Metronome 客户而不是 Cloud 工作区时为 `legacy`;该客户没有工作区 ID。Cloud 工作区的情况下不存在。 + + ### RouterChargesOnPolicyRejection 内容政策拒绝是否会对该模型计费。请将未知值视为可能计费。 @@ -1145,6 +1164,20 @@ Router 在运行之前尚无法定价的模型列在[没有预检预估的模型 **字段** + + 合作伙伴节点支出被拒时,计费一侧的策略分支:`no_funds` 表示被计费的钱包余额不足,`unspecified` 表示调用被拒绝但资金读数没有说明原因。仅当 `error_type` 为 `insufficient_credits` 且部署上报钱包信息时存在;否则不存在。它是机器可读的代码,不是展示文本:展示 `detail`,按这个字段分支。 + + + + 被拒绝的调用本会扣费的钱包,出现在 `RouterErrorResponse.billed_workspace` 上。它回答「哪个钱包余额不足」:这不一定等于调用方 UI 当前选中的工作区,团队成员使用个人凭证时,即使当前打开的是一个有余额的团队,这里也是其个人钱包。仅与 `denied_reason` 一同出现。 + + Type: [`RouterBilledWorkspace`](#routerbilledworkspace) + + + + 被拒绝的请求是用哪种身份认证的:`personal_api_key`、`team_api_key`、`personal_session` 或 `team_session`。它回答「该换用哪种凭证来让另一个钱包计费」。它不是权限,也不授予任何东西。仅与 `denied_reason` 一同出现。 + + 模型以内容政策为由拒绝的调用,是否仍向调用方计费。各提供商的做法不尽相同,而这种差异在调用时无法察觉,因此用户即使同时看到同一次调用的错误与扣费,也无从事先得知。所以这里在调用之前按模型明确说明,而不是留待各提供商各自口口相传。 diff --git a/zh/tutorials/video/minimax/minimax-h3-fastvideo.mdx b/zh/tutorials/video/minimax/minimax-h3-fastvideo.mdx index f81cea9ddf..93eea89106 100644 --- a/zh/tutorials/video/minimax/minimax-h3-fastvideo.mdx +++ b/zh/tutorials/video/minimax/minimax-h3-fastvideo.mdx @@ -2,7 +2,7 @@ title: "FastVideo FastH3:ComfyUI 工作流示例" description: "FastVideo FastH3 在 ComfyUI 中以 8 个采样步数生成带同步音频的 MiniMax H3 视频,支持文生视频与首尾帧工作流。" sidebarTitle: "FastVideo FastH3" -translationSourceHash: 7cbe9703 +translationSourceHash: cb542dfa translationFrom: tutorials/video/minimax/minimax-h3-fastvideo.mdx translationBlockHashes: "_intro": 096c332e @@ -10,7 +10,7 @@ translationBlockHashes: "FastH3 Text to Video": 1c4cb909 "FastH3 Image to Video": ec7d82bf "Model downloads": b88037db - "Workflow structure notes": 0542b184 + "Workflow structure notes": 8f5d2153 --- [FastVideo FastH3](https://huggingface.co/FastVideo/FastVideo-FastH3-8-Step-V2) 是 FastVideo 团队基于 MiniMax H3 蒸馏得到的 DMD2 模型,能以 **8 个采样步数**生成带原生同步音频的视频,而不是基础模型的完整调度。它复用了 H3 的文本编码器、视频 VAE 和音频 VAE,因此输出设置与基础模型一致,而采样步数大幅减少。 @@ -133,11 +133,11 @@ ComfyUI/ ## 工作流结构说明 -两个 FastH3 工作流与基础版 H3 设置共用以下节点,并带有蒸馏相关的设置: +两个 FastH3 工作流与基础版 H3 设置共用以下节点,但采用蒸馏专用设置: -- **BlockSparseAttention**:以 VSA(Video Sparse Attention)运行,`keep_percent` 为 10,从调度的 20% 开始生效,在保持质量的同时降低注意力计算成本 -- **MiniMaxH3SigmaShift**:应用与蒸馏调度匹配的 H3 sigma shift(视频为 10,音频为 3) +- **BlockSparseAttention**:以 Video Sparse Attention(VSA)运行,`keep_percent` 设为 10,从调度的 20% 处开始生效,在保持质量的同时降低注意力计算成本 +- **MiniMaxH3SigmaShift**:应用与蒸馏调度相匹配的 H3 sigma shift(视频为 10,音频为 3) - **ComfyMathExpression**:将时长输入转换为 24fps 下 17k+5 网格上的有效帧 `length` -- **采样器**:`res_multistep` 采样器,`simple` 调度器,8 步 +- **采样器**:`res_multistep` 采样器搭配 `simple` 调度器,8 步 -FastH3 权重带有 `to_gate_compress` 门控层,VSA 的粗粒度分支读的就是它。基座 H3 检查点没有这些层。要比较两种方法,把 **Model Sparse Attention** 节点的 `method` 设为 `sol-attn`,并保持同一随机种子。`sol-attn` 不需要匹配权重,在任意 H3 检查点上按你设的 `tau` 运行。 +FastH3 权重包含 `to_gate_compress` 门控层,VSA 的粗粒度分支会读取这些图层。基础版 H3 模型没有这些图层。要比较两种方法,请将 **Model Sparse Attention** 节点的 `method` 设为 `sol-attn`,并保持相同的种子。`sol-attn` 无需匹配权重,可在任意 H3 模型上按你设定的 `tau` 运行。 diff --git a/zh/tutorials/video/minimax/minimax-h3-prompt-guide.mdx b/zh/tutorials/video/minimax/minimax-h3-prompt-guide.mdx index d6e31b9af0..85dd8b9b26 100644 --- a/zh/tutorials/video/minimax/minimax-h3-prompt-guide.mdx +++ b/zh/tutorials/video/minimax/minimax-h3-prompt-guide.mdx @@ -2,12 +2,12 @@ title: "ComfyUI MiniMax H3 提示词指南:官方指南、技巧与提示词嵌入" description: "在 ComfyUI 中写出更好的 MiniMax H3 提示词:MiniMax 官方提示词编写指南、通用提示词技巧、对白与说话人规则,以及风格嵌入。" sidebarTitle: "提示词指南" -translationSourceHash: 0d858ae8 +translationSourceHash: 0f1ded35 translationFrom: tutorials/video/minimax/minimax-h3-prompt-guide.mdx translationBlockHashes: "_intro": da22cc9d "Official guides": 3d762c67 - "General tips": 91822299 + "General tips": fab4ad35 "Shots and cuts": 8184dae6 "Dialogue and speakers": 4985438e "Prompt embeddings": 9c899169 @@ -24,9 +24,9 @@ H3 在单一提示词中承载镜头、运镜、对白与音效。本页汇总 各模板应用示例:[T2V/I2V](/zh/tutorials/video/minimax/minimax-h3-native)、[R2V](/zh/tutorials/video/minimax/minimax-h3-native#minimax-h3-参考转视频(r2v))、[多帧参考](/zh/tutorials/video/minimax/minimax-h3-multiframe#提示词编写指南)、[Fun ControlNet](/zh/tutorials/video/minimax/minimax-h3-fun-controlnet#提示技巧)。 -## 通用技巧 +## 常规技巧 -I2VA 首行为固定图像对齐句,空一行后接字段;FL2VA/L2VA 各有对齐句;T2VA 直接从字段开始: +I2VA 以固定的图像对齐句开头,空一行后接正文字段。FL2VA/L2VA 使用各自的对齐句;T2VA 直接从字段开始: ```text integrated_multimodal_description: [Shot 1] ... @@ -34,19 +34,19 @@ overall_soundscape: ... non_diegetic_music: ... ``` -提示词用**英文**;对白/歌词在 `` 内;屏幕文字保留原文。 +提示词使用**英文**。对白/歌词放在 `` 标签内;屏幕文字逐字保留其原始语言。 -1. **先场景**:总述后写 `[Shot 1]` 内分镜 -2. **一块写完**:镜头、运镜、音频 -3. **分辨率**:16:9 原生 **1344×768**;**32** 倍数 -4. **长度**:`length` 为 24fps 帧数(默认 **124** ≈ 5s),吸附 **17k+5** -5. **屏幕文字**:英文双引号、逐条原文(如 `A red neon sign reading "营业中"`);对白用 `` -6. **R2V 音频标记**:`fully_copy`、`partially_copy`、`reference`、`weak_reference`(见官方 ref 表) -7. **音频字段**:`overall_soundscape` 写环境/动作/非语言(1–4 句;真静音才 `N/A`)。对白与画内音乐写在分镜里。`non_diegetic_music` 写配乐(1–3 句;无则 `N/A`) -8. **无负向**:`BasicGuider` 在 `cfg` 1 无负面分支。写「不要什么」反而引入概念;改写正面描述或 R2V 保留字段 -9. **多格参考图(R2V)**:一张图多视角/分镜格时单独 ``(不要只写在 `` 内),在镜头中指名某一格(如 `` 的正面全身格) +1. **场景优先**:先写整体场景,然后在 `integrated_multimodal_description` 的 `[Shot 1]` 内写按时间排列的镜头 +2. **一个区块**:将镜头、运镜和音频写在一起 +3. **分辨率**:16:9 下原生 **1344×768**;需为 **32** 的倍数 +4. **长度**:`length` 是以 24fps 计的帧数(默认 **124** ≈ 5s),会吸附到 **17k+5** +5. **屏幕文字**:每个字符串用英文双引号,逐字保留(例如 `A red neon sign reading "营业中"`)。台词使用 ``,不要用引号 +6. **R2V 音频标记**:在保留分析中,按片段的使用方式,将每个音频参考标记为 `fully_copy`、`partially_copy`、`reference` 或 `weak_reference`(参见官方参考指南表格) +7. **音频字段**:`overall_soundscape` = 环境声/音效/非语言声音(1–4 句;仅在真正静音时用 `N/A`)。对白和画内音乐仍写在镜头中。`non_diegetic_music` = 仅配乐(1–3 句;没有则用 `N/A`)。如果出现不想要的语音,请明确填写这两个字段 +8. **无负面提示**:`BasicGuider` 以 `cfg` 1 运行,没有负面分支。禁止列表会引入不希望出现的概念。应说明希望出现的内容(或使用 R2V 保留字段:`fully_preserved`、`partially_preserved` 等) +9. **参考图版(R2V)**:一张图像可以包含多个分格。为整张图版单独设置 ``(不要只写在 `` 内),描述各分格,并在镜头中指向某个分格(例如 `` 的正面全身视图)。清晰标注各分格 -工作流专属标签见各工作流页。 +各工作流专属的标签和控制项位于对应的工作流页面。 ## 镜头与切换