@@ -144,7 +146,7 @@ Actualmente, el modelo Hunyuan Image-to-Video tiene dos versiones:
Guardar en ComfyUI/models/clip_vision
-### Flujo de trabajo imagen a video V1 "concat"
+### Flujo de trabajo de imagen a video V1 "concat"
#### 1. Flujo de trabajo y recursos
@@ -158,7 +160,7 @@ Descarga la imagen del flujo de trabajo que aparece a continuación y arrástral
-Descarga la imagen a continuación y úsala como fotograma inicial para la generación de imagen a video:
+Descarga la imagen que aparece a continuación y úsala como fotograma inicial para la generación de imagen a video:
Guárdala y úsala como imagen de entrada para la generación I2V
@@ -166,7 +168,7 @@ Descarga la imagen a continuación y úsala como fotograma inicial para la gener
#### 2. Instalación manual de los modelos relacionados
- Guarda en ComfyUI/models/diffusion_models
+ Guárdalo en ComfyUI/models/diffusion_models
Asegúrate de tener todos estos archivos de modelo en las ubicaciones correctas:
@@ -174,14 +176,14 @@ Asegúrate de tener todos estos archivos de modelo en las ubicaciones correctas:
ComfyUI/
├── models/
│ ├── clip_vision/
-│ │ └── llava_llama3_vision.safetensors // Modelo compartido de I2V
+│ │ └── llava_llama3_vision.safetensors // modelo compartido para I2V
│ ├── text_encoders/
-│ │ ├── clip_l.safetensors // Modelo compartido
-│ │ └── llava_llama3_fp8_scaled.safetensors // Modelo compartido
+│ │ ├── clip_l.safetensors // modelo compartido
+│ │ └── llava_llama3_fp8_scaled.safetensors // modelo compartido
│ ├── vae/
-│ │ └── hunyuan_video_vae_bf16.safetensors // Modelo compartido
+│ │ └── hunyuan_video_vae_bf16.safetensors // modelo compartido
│ └── diffusion_models/
-│ └── hunyuan_video_image_to_video_720p_bf16.safetensors // Modelo de la versión I2V v1 "concat"
+│ └── hunyuan_video_image_to_video_720p_bf16.safetensors // modelo de la versión v1 "concat" de I2V
```
#### 3. Pasos para ejecutar el flujo de trabajo
@@ -199,11 +201,11 @@ ComfyUI/
### Flujo de trabajo de imagen a video v2 "replace"
-El flujo de trabajo v2 es esencialmente el mismo que el del v1. Solo necesitas descargar el modelo **replace** y usarlo en el nodo `Load Diffusion Model`.
+El flujo de trabajo v2 es esencialmente el mismo que el flujo de trabajo v1. Solo necesitas descargar el modelo **replace** y usarlo en el nodo `Load Diffusion Model`.
#### 1. Flujo de trabajo y recursos
-Descarga la imagen del flujo de trabajo de abajo y arrástrala a ComfyUI para cargarlo:
+Descarga la imagen del flujo de trabajo que aparece a continuación y arrástrala a ComfyUI para cargarlo:

@@ -213,12 +215,12 @@ Descarga la imagen del flujo de trabajo de abajo y arrástrala a ComfyUI para ca
-Descarga la imagen de abajo y úsala como fotograma inicial para la generación de imagen a video:
+Descarga la imagen que aparece a continuación y úsala como fotograma inicial para la generación de imagen a video:
- Guarda y usa como imagen de entrada para la generación I2V
+ Guárdala y úsala como imagen de entrada para la generación I2V
-#### 2. Instalación manual de modelos relacionados
+#### 2. Instalación manual de los modelos relacionados
Guárdalo en ComfyUI/models/diffusion_models
@@ -229,14 +231,14 @@ Asegúrate de tener todos estos archivos de modelo en las ubicaciones correctas:
ComfyUI/
├── models/
│ ├── clip_vision/
-│ │ └── llava_llama3_vision.safetensors // Modelo compartido de I2V
+│ │ └── llava_llama3_vision.safetensors // Modelo compartido para I2V
│ ├── text_encoders/
│ │ ├── clip_l.safetensors // Modelo compartido
│ │ └── llava_llama3_fp8_scaled.safetensors // Modelo compartido
│ ├── vae/
│ │ └── hunyuan_video_vae_bf16.safetensors // Modelo compartido
│ └── diffusion_models/
-│ └── hunyuan_video_v2_replace_image_to_video_720p_bf16.safetensors // Modelo de la versión v2 "replace"
+│ └── hunyuan_video_v2_replace_image_to_video_720p_bf16.safetensors // Modelo de la versión "replace" de V2
```
#### 3. Pasos para ejecutar el flujo de trabajo
@@ -256,7 +258,7 @@ ComfyUI/
Aquí tienes algunas imágenes y prompts que proporcionamos. Úsalos tal cual o ajústalos para crear tu propio video.
-
+
```
Futuristic robot dancing ballet, dynamic motion, fast motion, fast shot, moving scene
@@ -264,7 +266,7 @@ Futuristic robot dancing ballet, dynamic motion, fast motion, fast shot, moving
---
-
+
```
Samurai waving sword and hitting the camera. camera angle movement, zoom in, fast scene, super fast, dynamic
@@ -272,7 +274,7 @@ Samurai waving sword and hitting the camera. camera angle movement, zoom in, fas
---
-
+
```
flying car fastly moving and flying through the city
@@ -280,7 +282,7 @@ flying car fastly moving and flying through the city
---
-
+
```
cyberpunk car race in night city, dynamic, super fast, fast shot
diff --git a/es/tutorials/video/kandinsky/kandinsky-5.mdx b/es/tutorials/video/kandinsky/kandinsky-5.mdx
index 0c36c06627..2e35c90a72 100644
--- a/es/tutorials/video/kandinsky/kandinsky-5.mdx
+++ b/es/tutorials/video/kandinsky/kandinsky-5.mdx
@@ -2,33 +2,36 @@
title: "Kandinsky 5.0 en ComfyUI: texto a video e imagen a video"
description: "Usa Kandinsky 5.0 Video Lite en ComfyUI: texto a video de hasta 10 segundos e imagen a video de 5 segundos, con variantes SFT de 2B, no-CFG y destilada."
sidebarTitle: "Kandinsky 5.0"
-translationSourceHash: 0766e01c
+translationSourceHash: e0a46d75
translationFrom: tutorials/video/kandinsky/kandinsky-5.mdx
translationBlockHashes:
"_intro": cd71d0f9
"Overview": dead89b1
"Model variants": 3bdbc0cb
+ "Text-to-Video workflow": 8641d2fb
+ "Image-to-Video workflow": b945bc9a
"Resources": fa8f3352
---
+
import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx";
-[Kandinsky 5.0](https://huggingface.co/kandinskylab/Kandinsky-5.0-I2V-Lite-5s) es una familia de modelos de difusión para la generación de video e imágenes desarrollada por [Kandinsky Lab](https://huggingface.co/kandinskylab). Kandinsky 5.0 T2V Lite es un modelo ligero de 2B parámetros que se ubica entre los mejores modelos de generación de video de código abierto, capaz de generar videos de hasta 10 segundos de duración.
+[Kandinsky 5.0](https://huggingface.co/kandinskylab/Kandinsky-5.0-I2V-Lite-5s) es una familia de modelos de difusión para la generación de video e imágenes desarrollada por [Kandinsky Lab](https://huggingface.co/kandinskylab). El Kandinsky 5.0 T2V Lite es un modelo ligero de 2000 millones de parámetros que se encuentra entre los mejores modelos de generación de video de código abierto, capaz de generar videos de hasta 10 segundos de duración.
## Descripción general
-Kandinsky 5.0 usa un pipeline de difusión latent con Flow Matching e incluye:
+Kandinsky 5.0 usa un pipeline de difusión latente con Flow Matching e incluye:
- **Diffusion Transformer (DiT):** Arquitectura generativa principal con atención cruzada a los embeddings de texto
-- **Qwen2.5-VL y CLIP:** Proporciona embeddings de texto de alta calidad
-- **HunyuanVideo 3D VAE:** Codifica y decodifica el video en un espacio latent
+- **Qwen2.5-VL y CLIP:** Proporcionan embeddings de texto de alta calidad
+- **HunyuanVideo 3D VAE:** Codifica y decodifica el video en un espacio latente
La familia de modelos incluye varias variantes optimizadas para diferentes casos de uso:
- **Modelo SFT:** Máxima calidad de generación
- **CFG-distilled:** Inferencia 2× más rápida
- **Diffusion-distilled:** 6× más rápida con una pérdida mínima de calidad (16 pasos)
-- **Modelo preentrenado:** Diseñado para fine-tuning
+- **Modelo de preentrenamiento:** Diseñado para fine-tuning
Todos los modelos están disponibles en versiones de generación de video de 5 y 10 segundos.
@@ -43,18 +46,18 @@ Todos los modelos están disponibles en versiones de generación de video de 5 y
## Flujo de trabajo de texto a video
-### Kandinsky 5.0 Video Lite Text to Video {#video_kandinsky5_t2v}
+### Kandinsky 5.0 Video Lite texto a video {#video_kandinsky5_t2v}
Un modelo ligero de 2B que genera videos a partir de prompts en inglés y ruso con alta calidad visual.
-
+
Abrir en Comfy Cloud
- Descarga el JSON o busca "Kandinsky 5.0 Video Lite Text to Video" en la Biblioteca de plantillas
+ Descarga el JSON o busca "Kandinsky 5.0 Video Lite Text to Video" en la biblioteca de plantillas
@@ -74,7 +77,7 @@ Un modelo ligero de 2B que genera videos a partir de prompts en inglés y ruso c
**Modelo de difusión**
- Modelo de difusión Kandinsky 5.0 T2V Lite SFT (5 s). Colócalo en ComfyUI/models/diffusion_models/
+ Modelo de difusión Kandinsky 5.0 T2V Lite SFT (5s). Colócalo en ComfyUI/models/diffusion_models/
**VAE**
@@ -92,14 +95,13 @@ ComfyUI/
│ └── 📂 vae/
│ └── hunyuan_video_vae_bf16.safetensors
```
-
## Flujo de trabajo de imagen a video
### Kandinsky 5.0 Video Lite Image to Video {#video_kandinsky5_i2v}
Un modelo ligero de 2B que genera videos a partir de prompts en inglés y ruso con alta calidad visual.
-
+
@@ -129,18 +131,18 @@ Sube este archivo al nodo `LoadImage` correspondiente:
**Codificadores de texto**
-
+
Codificador de texto Qwen2.5-VL 7B (FP8). Colócalo en ComfyUI/models/text_encoders/
-
+
Codificador de texto CLIP-L. Colócalo en ComfyUI/models/text_encoders/
**Modelo de difusión**
-
- Modelo de difusión Kandinsky 5.0 I2V Lite (5 s). Colócalo en ComfyUI/models/diffusion_models/
+
+ Modelo de difusión Kandinsky 5.0 I2V Lite (5s). Colócalo en ComfyUI/models/diffusion_models/
**VAE**
@@ -158,7 +160,6 @@ ComfyUI/
│ └── 📂 vae/
│ └── hunyuan_video_vae_bf16.safetensors
```
-
## Recursos
- [Colección de modelos de Hugging Face](https://huggingface.co/collections/kandinskylab/kandinsky-50-video-lite)
diff --git a/es/tutorials/video/ltx/ltx-2-3.mdx b/es/tutorials/video/ltx/ltx-2-3.mdx
index 4d7e6dcbea..c459ffc765 100644
--- a/es/tutorials/video/ltx/ltx-2-3.mdx
+++ b/es/tutorials/video/ltx/ltx-2-3.mdx
@@ -2,18 +2,20 @@
title: "LTX-2.3 en ComfyUI: flujos de video y audio"
description: "Usa LTX-2.3 en ComfyUI con flujos nativos para texto a video, imagen a video, FLF2V, video controlado por audio, control IC-LoRA y personalización ID-LoRA."
sidebarTitle: "LTX-2.3"
-translationSourceHash: 0519dac5
+translationSourceHash: 2e21405a
translationFrom: tutorials/video/ltx/ltx-2-3.mdx
translationBlockHashes:
"_intro": 2afce33d
"Key features": 3ddea9bd
"Getting started": 8bd36b77
+ "ComfyUI Native Workflows": fb09a224
"Prompting tips": f92227b7
"Resources": 3f045765
---
+
import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx";
-[LTX-2.3](https://huggingface.co/Lightricks/LTX-2.3) es la última evolución del modelo de generación de audio y video de código abierto de Lightricks, ahora compatible de forma nativa con ComfyUI. Sobre la base de LTX-2, esta versión ofrece mejoras importantes de calidad en detalles finos, video de retratos, calidad de audio, consistencia de imagen a video, comprensión de prompts y renderizado de texto.
+[LTX-2.3](https://huggingface.co/Lightricks/LTX-2.3) es la última evolución del modelo de generación de audio y video de código abierto de Lightricks, ahora compatible de forma nativa con ComfyUI. Sobre la base de LTX-2, esta versión ofrece mejoras significativas de calidad en los detalles finos, el video de retratos, la calidad de audio, la consistencia de imagen a video, la comprensión de prompts y el renderizado de texto.
ComfyUI incluye seis flujos de trabajo nativos para LTX-2.3, cada uno diseñado para un modo de generación específico:
@@ -30,10 +32,10 @@ ComfyUI incluye seis flujos de trabajo nativos para LTX-2.3, cada uno diseñado
- **Detalles más finos**: nuevo espacio latente y VAE actualizado para texturas más nítidas, bordes más limpios y visuales más precisos
- **Soporte para formato vertical 9:16**: calidad muy mejorada en videos verticales
-- **Mejor audio**: sonido más limpio con menos ruido y diálogos mejorados
+- **Mejor audio**: sonido más limpio, con menos ruido y diálogos mejorados
- **Imagen a video mejorado**: movimiento más consistente y menos fallos
- **Comprensión de prompts más inteligente**: codificador de texto mejorado para una interpretación más precisa
-- **Soporte nativo en ComfyUI**: todos los flujos de trabajo son integrados, no se requieren Nodos personalizados
+- **Soporte nativo en ComfyUI**: todos los flujos de trabajo están integrados, no se requieren nodos personalizados
## Primeros pasos
@@ -47,18 +49,18 @@ LTX-2.3 es compatible de forma nativa con ComfyUI. Para empezar:
### LTX-2.3 Texto a video (T2V)
-Genera videos a partir de prompts de texto con mejor comprensión de prompts y mejor renderizado de texto.
+Genera videos a partir de prompts de texto con una mejor comprensión de los prompts y un mejor renderizado de texto.
-### LTX-2.3 Texto a video {#video_ltx2_3_t2v}
+### LTX-2.3 Text to Video {#video_ltx2_3_t2v}
-Genera videos a partir de prompts de texto con mejor comprensión de prompts y mejor renderizado de texto.
+Genera videos a partir de prompts de texto con mejor comprensión de las instrucciones y renderizado de texto.
-
+
-
+
Abrir en Comfy Cloud
@@ -66,7 +68,7 @@ Genera videos a partir de prompts de texto con mejor comprensión de prompts y m
-#### Descarga de modelos
+#### Descargas de modelos
@@ -78,7 +80,7 @@ Genera videos a partir de prompts de texto con mejor comprensión de prompts y m
Colócalo en ComfyUI/models/loras/
-
+
Colócalo en ComfyUI/models/text_encoders/
@@ -102,13 +104,11 @@ ComfyUI/
│ └── ltx-2.3-spatial-upscaler-x2-1.1.safetensors
```
-#### Consejos para escribir prompts
+#### Consejos para los prompts
-1. **Acciones principales**: Describe los eventos y las acciones tal como ocurren a lo largo del tiempo
-2. **Detalles visuales**: Describe todos los detalles visuales que quieres que aparezcan en el video
-3. **Audio**: Describe los sonidos y el diálogo que necesita la escena
-
----
+1. **Acciones principales**: describe los eventos y las acciones tal como ocurren a lo largo del tiempo
+2. **Detalles visuales**: describe todos los detalles visuales que quieres que aparezcan en el video
+3. **Audio**: describe los sonidos y los diálogos que necesita la escena
### LTX-2.3 Imagen a video (I2V)
@@ -116,11 +116,11 @@ Genera videos a partir de una imagen de entrada con un movimiento más consisten
-### LTX-2.3 Imagen a video {#video_ltx2_3_i2v}
+### LTX-2.3 de imagen a video {#video_ltx2_3_i2v}
Genera videos a partir de una imagen de entrada con una consistencia de movimiento mejorada.
-
+
@@ -137,25 +137,25 @@ Genera videos a partir de una imagen de entrada con una consistencia de movimien
-#### Descarga de modelos
+#### Descargas de modelos
El flujo de trabajo I2V usa el mismo conjunto de modelos que el de texto a video.
- Colócalo en ComfyUI/models/checkpoints/
+ Coloca en ComfyUI/models/checkpoints/
- Colócalo en ComfyUI/models/loras/
+ Coloca en ComfyUI/models/loras/
- Colócalo en ComfyUI/models/loras/
+ Coloca en ComfyUI/models/loras/
-
- Colócalo en ComfyUI/models/text_encoders/
+
+ Coloca en ComfyUI/models/text_encoders/
- Colócalo en ComfyUI/models/latent_upscale_models/
+ Coloca en ComfyUI/models/latent_upscale_models/
@@ -179,15 +179,15 @@ ComfyUI/
### LTX-2.3 FLF2V
-Interpola entre una imagen inicial y una imagen final para generar una transición de video fluida.
+Interpola entre una imagen inicial y una imagen final para generar una transición de video suave.
-### LTX-2.3 Primer y último fotograma a video {#video_ltx2_3_flf2v}
+### LTX-2.3 First-Last Frame to Video {#video_ltx2_3_flf2v}
Interpola entre una imagen inicial y una final.
-
+
@@ -207,15 +207,15 @@ Interpola entre una imagen inicial y una final.
-#### Descarga de modelos
+#### Descargas de modelos
-El flujo de trabajo FLF2V usa el checkpoint distilled en lugar del checkpoint dev.
+El flujo de trabajo FLF2V usa el checkpoint destilado en lugar del checkpoint dev.
Colócalo en ComfyUI/models/checkpoints/
-
+
Colócalo en ComfyUI/models/text_encoders/
@@ -231,19 +231,17 @@ ComfyUI/
│ └── gemma_3_12B_it_fp4_mixed.safetensors
```
----
-
### LTX-2.3 Imagen y audio a video (IA2V)
-Sube una imagen y un archivo de audio para generar un video de alta calidad con movimientos labiales sincronizados.
+Sube una imagen y un archivo de audio para generar un video de alta calidad con movimientos de labios sincronizados.
### LTX-2.3 Imagen y audio a video {#video_ltx2_3_ia2v}
-Genera videos con sincronización labial a partir de una imagen y audio.
+Genera videos con sincronización labial a partir de una imagen y un audio.
-
+
@@ -263,9 +261,9 @@ Genera videos con sincronización labial a partir de una imagen y audio.
-#### Descarga de modelos
+#### Descargas de modelos
-El flujo de trabajo IA2V usa el mismo conjunto de modelos que el de texto a video.
+El flujo de trabajo IA2V usa el mismo conjunto de modelos que texto a video.
@@ -277,10 +275,10 @@ El flujo de trabajo IA2V usa el mismo conjunto de modelos que el de texto a vide
Colócalo en ComfyUI/models/loras/
-
+
Colócalo en ComfyUI/models/text_encoders/
-
+
Colócalo en ComfyUI/models/latent_upscale_models/
@@ -305,12 +303,12 @@ ComfyUI/
### LTX-2.3 IC-LoRA Union Control
-Genera videos con LTX-2.3 e IC-LoRA usando entradas de control alineadas como profundidad, pose o bordes. IC-LoRA es un LoRA in-context entrenado sobre LTX-2.3 que aplica la guía estructural de un video de referencia. Acepta señales de control de varios preprocesadores, incluidos mapas de profundidad, bordes de Canny y esqueletos de pose. Este flujo de trabajo usa un Subgraph para el procesamiento modular.
+Genera videos LTX-2.3 con IC-LoRA usando entradas de control alineadas como profundidad, pose o bordes. IC-LoRA es un LoRA en contexto entrenado sobre LTX-2.3 que aplica orientación estructural a partir de un video de referencia. Acepta señales de control de distintos preprocesadores, incluidos mapas de profundidad, bordes Canny y esqueletos de pose. Este flujo de trabajo usa un subgrafo para el procesamiento modular.

-
+
Abrir en Comfy Cloud
@@ -318,7 +316,7 @@ Genera videos con LTX-2.3 e IC-LoRA usando entradas de control alineadas como pr
-
+
Este flujo de trabajo usa un nodo Subgraph para el procesamiento modular. Consulta la documentación de Subgraph para aprender a personalizar y ampliar el flujo de trabajo.
@@ -326,14 +324,14 @@ Genera videos con LTX-2.3 e IC-LoRA usando entradas de control alineadas como pr
- Video guía del que se extrae la señal de control.
+ Video guía para extraer la señal de control.
Imagen de referencia para el estilo y el contenido.
-#### Descarga de modelos
+#### Descargas de modelos
@@ -371,15 +369,15 @@ ComfyUI/
---
-### Edición de video con IC-LoRA
+### Editar video con IC-LoRA
-Los pesos IC-LoRA no se limitan al control de la generación. La Biblioteca de plantillas incluye flujos de trabajo IC-LoRA de LTX-2.3 ya preparados para editar material existente, y cada uno se ejecuta en Comfy Cloud o de forma local en ComfyUI. Los checkpoints IC-LoRA de la comunidad entrenados sobre LTX-2.3 (por ejemplo, la familia [LTX2.3-ICEdit-Insight](https://huggingface.co/joyfox/LTX2.3-ICEdit-Insight)) también son compatibles con el modelo nativo LTX-2.3.
+Los pesos IC-LoRA no se limitan al control de la generación. La Biblioteca de plantillas incluye flujos de trabajo LTX-2.3 IC-LoRA listos para editar material existente, y cada uno se ejecuta en Comfy Cloud o de forma local en ComfyUI. Los checkpoints IC-LoRA de la comunidad entrenados sobre LTX-2.3 (por ejemplo, la familia [LTX2.3-ICEdit-Insight](https://huggingface.co/joyfox/LTX2.3-ICEdit-Insight)) también son compatibles con el modelo LTX-2.3 nativo.
#### Eliminar subtítulos de un video
Elimina subtítulos, rótulos, marcas de agua u otras superposiciones de texto de un video:
-
+
@@ -397,16 +395,16 @@ Descarga este video de entrada de ejemplo para probar el flujo de trabajo:
- Descarga el video de entrada de ejemplo
+ Descargar video de entrada de ejemplo
#### Eliminar un objeto de un video
-Elimina un objeto concreto del primer plano de un video describiéndolo en el prompt:
+Elimina un objeto específico del primer plano de un video describiéndolo en el prompt:
-
+
@@ -424,7 +422,7 @@ Descarga este video de entrada de ejemplo para probar el flujo de trabajo:
- Descarga el video de entrada de ejemplo
+ Descargar video de entrada de ejemplo
@@ -433,7 +431,7 @@ Descarga este video de entrada de ejemplo para probar el flujo de trabajo:
Restaura material de archivo antiguo o degradado:
-
+
@@ -451,16 +449,16 @@ Descarga este video de entrada de ejemplo para probar el flujo de trabajo:
- Descarga el video de entrada de ejemplo
+ Descargar video de entrada de ejemplo
#### Outpainting de video
-Amplía un video en cualquier dirección con el IC-LoRA Video Outpainting de LTX-2.3:
+Expande un video en cualquier dirección con el IC-LoRA Video Outpainting de LTX-2.3:
-
+
@@ -478,39 +476,38 @@ Descarga este video de entrada de ejemplo para probar el flujo de trabajo:
- Descarga el video de entrada de ejemplo
+ Descargar video de entrada de ejemplo
#### Googly Eyes
-Aplica el LoRA Googlyeyes de LTX-2.3 a un video de entrada para poner ojos saltones a todas las personas del fotograma:
+Aplica el LoRA Googlyeyes de LTX-2.3 a un video de entrada para darle ojos saltones a todos los que aparecen en el encuadre:
-
+
Abrir en Comfy Cloud
-
- Descarga el JSON o busca "Googly Eyes" en la Biblioteca de plantillas
+ Descargar JSON o buscar "Googly Eyes" en la Biblioteca de plantillas
Materiales de entrada
-Descarga este video de entrada de ejemplo para probar el flujo de trabajo:
+Descarga este video de entrada de muestra para probar el flujo de trabajo:
- Descarga el video de entrada de ejemplo
+ Descargar video de entrada de muestra
-Para los IC-LoRA de la comunidad, coloca el LoRA de edición en `ComfyUI/models/loras/` y cárgalo con un cargador de LoRA junto al checkpoint de LTX-2.3; después ejecuta el flujo de trabajo con tu video como entrada y un prompt como:
+Para IC-LoRAs de la comunidad, coloca el LoRA de edición en `ComfyUI/models/loras/` y cárgalo con un cargador de LoRA junto al checkpoint LTX-2.3; luego ejecuta el flujo de trabajo con tu video como entrada y un prompt como:
```text
Remove subtitles, captions, and related text occlusions from the video, restoring a clean and natural underlying image.
@@ -528,7 +525,7 @@ Genera videos personalizados con audio sincronizado a partir de un prompt de tex
Genera videos personalizados con audio sincronizado a partir de una imagen de referencia y un clip de audio.
-
+
@@ -548,7 +545,7 @@ Genera videos personalizados con audio sincronizado a partir de una imagen de re
-#### Descarga de modelos
+#### Descargas de modelos
@@ -560,7 +557,7 @@ Genera videos personalizados con audio sincronizado a partir de una imagen de re
Colócalo en ComfyUI/models/loras/
-
+
Colócalo en ComfyUI/models/text_encoders/
@@ -583,18 +580,17 @@ ComfyUI/
│ └── 📂 latent_upscale_models/
│ └── ltx-2.3-spatial-upscaler-x2-1.1.safetensors
```
+## Consejos para los prompts
-## Consejos para escribir prompts
-
-Cuando escribas prompts para LTX-2.3, céntrate en descripciones detalladas y cronológicas de acciones y escenas:
+Al escribir prompts para LTX-2.3, céntrate en descripciones detalladas y cronológicas de acciones y escenas:
-1. **Acciones principales**: Describe los eventos y las acciones tal como ocurren a lo largo del tiempo
-2. **Detalles visuales**: Describe todos los detalles visuales que quieres que aparezcan en el video
-3. **Audio**: Describe los sonidos y el diálogo que necesita la escena
+1. **Acciones principales**: describe los eventos y las acciones tal como ocurren a lo largo del tiempo
+2. **Detalles visuales**: describe todos los detalles visuales que quieres que aparezcan en el video
+3. **Audio**: describe los sonidos y el diálogo que necesita la escena
## Recursos
-- [Modelo de Hugging Face](https://huggingface.co/Lightricks/LTX-2.3)
-- [Repositorio de GitHub](https://github.com/Lightricks/LTX-2)
+- [Modelo en Hugging Face](https://huggingface.co/Lightricks/LTX-2.3)
+- [Repositorio en GitHub](https://github.com/Lightricks/LTX-2)
- [ComfyUI-LTXVideo](https://github.com/Lightricks/ComfyUI-LTXVideo/)
- [Modelo IC-LoRA](https://huggingface.co/Lightricks/LTX-2.3-22b-IC-LoRA-Union-Control)
diff --git a/es/tutorials/video/ltx/ltx-2-5-dfr.mdx b/es/tutorials/video/ltx/ltx-2-5-dfr.mdx
index 14cd89b24d..4faa0969f3 100644
--- a/es/tutorials/video/ltx/ltx-2-5-dfr.mdx
+++ b/es/tutorials/video/ltx/ltx-2-5-dfr.mdx
@@ -2,15 +2,17 @@
title: "LTX-2.5 DFR en ComfyUI: imagen a video con audio"
description: "Ejecuta el flujo de trabajo LTX-2.5 DFR en ComfyUI: tres etapas Diffusion Fidelity Rendering que generan video con audio sincronizado desde una imagen."
sidebarTitle: "LTX-2.5 DFR"
-translationSourceHash: 525f6be2
+translationSourceHash: 6958a6c7
translationFrom: tutorials/video/ltx/ltx-2-5-dfr.mdx
translationBlockHashes:
"_intro": 950d68f0
"The three stages": 1ccaf9c8
"Model downloads": c2c37fb4
+ "Model storage": d7c0900c
"Workflow controls": 2cf64b86
"Prompting tips": c40b888a
---
+
Genera un video con audio sincronizado a partir de una sola imagen mediante la ruta Diffusion Fidelity Rendering de LTX-2.5. DFR es la receta con calidad de producción: un transformer destilado combinado con un IC-LoRA de detallado, con keyframes generados dentro del clip y reutilizados como guías por las pasadas posteriores. Activa `Switch to T2V` para ejecutar el mismo pipeline solo desde texto.
Para los demás flujos de trabajo de LTX-2.5, consulta la [descripción general de LTX-2.5](/es/tutorials/video/ltx/ltx-2-5).
@@ -36,17 +38,17 @@ Para los demás flujos de trabajo de LTX-2.5, consulta la [descripción general
| Etapa | Se ejecuta a | Pasos | Qué hace |
| :---- | :------ | :---- | :----------- |
-| 1. Generar | La mitad del tamaño de salida | 8 | Aplica denoising al video, con un fotograma clave de detalle por segundo, y al audio juntos en una sola pasada |
-| 2. Espacial x2 | El tamaño de salida | 3 | Aplica upscale al latent de la etapa 1 y lo vuelve a muestrear con el IC-LoRA de detalle espacial de píxeles, usando el latent de media resolución como referencia |
-| 3. Temporal x2 | 241 fotogramas a 48 fps | 4 | Duplica la frecuencia de fotogramas en la misma duración, con los fotogramas clave de la etapa 2 fijados como guías |
+| 1. Generar | La mitad del tamaño de salida | 8 | Aplica denoising al video, con un fotograma clave de detalle por segundo, y al audio, todo en una sola pasada |
+| 2. Espacial x2 | El tamaño de salida | 3 | Aplica upscale al latente de la etapa 1 y lo vuelve a muestrear con el IC-LoRA de detalle espacial de píxeles, usando el latente de media resolución como referencia |
+| 3. Temporal x2 | 241 fotogramas a 48 fps | 4 | Duplica la frecuencia de cuadros en la misma duración, con los fotogramas clave de la etapa 2 fijados como guías |
-Todas las etapas muestrean con el sampler `euler`, `cfg` 1.0 y una programación fija de `ManualSigmas`. El checkpoint está destilado, así que el número de pasos y las programaciones son parte de la receta: cambiarlos cambia el aspecto del resultado.
+Todas las etapas hacen el muestreo con el sampler `euler`, `cfg` 1.0 y una programación fija de `ManualSigmas`. El checkpoint está destilado, así que el número de pasos y las programaciones forman parte de la receta: cambiarlos cambia el aspecto del resultado.
-La tercera etapa es opcional. Desactiva `Run 3rd stage - Temporal Upscale` para saltarla y obtener en su lugar un clip con la frecuencia de fotogramas de la etapa 2. El audio se arrastra desde la etapa 1 por todo el pipeline, así que el sonido no cambia cuando se ejecuta la pasada temporal.
+La tercera etapa es opcional. Desactiva `Run 3rd stage - Temporal Upscale` para saltarla y obtener en su lugar un clip con la frecuencia de cuadros de la etapa 2. El audio se conserva desde la etapa 1 a lo largo de todo el pipeline, así que el sonido no cambia cuando se ejecuta la pasada temporal.
## Descargas de modelos
-El flujo de trabajo DFR carga el codificador de texto de precisión completa y añade el IC-LoRA de detallado más el escalador temporal, por lo que su conjunto de modelos difiere del de los demás flujos de trabajo de LTX-2.5.
+El flujo de trabajo DFR carga el codificador de texto de precisión completa y agrega el IC-LoRA de detallado además del escalador temporal, por lo que su conjunto de modelos difiere del de los demás flujos de trabajo de LTX-2.5.
@@ -94,18 +96,17 @@ ComfyUI/
│ ├── ltx-2.5-latent-spatial-upscaler-x2-bf16-1.0.safetensors
│ └── ltx-2.5-latent-temporal-upscaler-x2-bf16-1.0.safetensors
```
-
## Controles del flujo de trabajo
- `Start image (I2V)`: el primer fotograma. Se ignora mientras `Switch to T2V` esté activado
- `Output size (aspect / megapixels)`: la relación de aspecto y el presupuesto de píxeles objetivo, redondeados a múltiplos de 32. La etapa 1 se ejecuta a la mitad de este tamaño
-- `Switch to T2V`: ejecuta el pipeline solo a partir de texto, sin una imagen inicial
-- `Float (fps)` y `Float (Duration)`: 24 fps durante 5 segundos por defecto, lo que da 121 fotogramas
+- `Switch to T2V`: ejecuta el pipeline solo a partir de texto, sin imagen inicial
+- `Float (fps)` y `Float (Duration)`: 24 fps durante 5 segundos de forma predeterminada, lo que equivale a 121 fotogramas
- `Enable Prompt Enhancer`: reescribe y amplía el prompt con el pequeño codificador Gemma 4 antes del muestreo
-- `Enable Tiled Decode`: decodifica el VAE en mosaicos para reducir el uso de VRAM, con un pequeño costo en el detalle fino
+- `Enable Tiled Decode`: decodifica el VAE por mosaicos para reducir el uso de VRAM, con un pequeño costo en el detalle fino
## Consejos para escribir prompts
-1. **Escribe para un solo plano continuo**: DFR construye el clip a partir de fotogramas clave generados, así que describe una escena que se desarrolla en una sola toma en lugar de una secuencia de cortes
-2. **Audio en la misma pasada**: pon las líneas habladas entre comillas y describe el ambiente y los efectos; el modelo genera el audio junto con el video
-3. **Mantén los movimientos de cámara suaves**: los movimientos rápidos sobre texturas con ruido y degradados suaves son donde el pipeline tiene más probabilidades de mostrar ebullición o banding
+1. **Escribe para un plano continuo**: DFR construye el clip en torno a los fotogramas clave generados, así que describe una escena que se desarrolla en una sola toma en lugar de una secuencia de cortes
+2. **El audio en la misma pasada**: pon las líneas habladas entre comillas y describe el ambiente y los efectos; el modelo genera el audio junto con el video
+3. **Mantén los movimientos de cámara suaves**: los movimientos rápidos sobre texturas con ruido y degradados suaves son donde el pipeline es más propenso a mostrar boiling o banding
diff --git a/es/tutorials/video/ltxv.mdx b/es/tutorials/video/ltxv.mdx
index 21999ebd3e..fc51f7319e 100644
--- a/es/tutorials/video/ltxv.mdx
+++ b/es/tutorials/video/ltxv.mdx
@@ -2,13 +2,14 @@
title: "LTX-Video 0.9.5 en ComfyUI: T2V, I2V, control de múltiples fotogramas"
sidebarTitle: "LTX-0.9.5"
description: "Ejecuta LTX-Video 0.9.5 en ComfyUI para texto a video, imagen a video y control multifotograma desde imágenes inicial y final, con descarga y configuración."
-translationSourceHash: b2aad3a7
+translationSourceHash: b4e3cee7
translationFrom: tutorials/video/ltxv.mdx
translationBlockHashes:
"_intro": 354083fd
"Multi Frame Control": 0fe2f937
"Image to Video": 1072ef32
"Text to Video": 664fc166
+ "Requirements": 4d0884e2
---
import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx";
@@ -89,10 +90,10 @@ Descarga los siguientes modelos y colócalos en las ubicaciones que se indican a
- Descarga y guárdalo en ComfyUI/models/checkpoints/
+ Descarga y coloca en ComfyUI/models/checkpoints/
- Descarga y guárdalo en ComfyUI/models/text_encoders/
+ Descarga y coloca en ComfyUI/models/text_encoders/
```
diff --git a/es/tutorials/video/minimax/minimax-h3-fastvideo.mdx b/es/tutorials/video/minimax/minimax-h3-fastvideo.mdx
index 0dadd530c0..378176e5bd 100644
--- a/es/tutorials/video/minimax/minimax-h3-fastvideo.mdx
+++ b/es/tutorials/video/minimax/minimax-h3-fastvideo.mdx
@@ -2,25 +2,27 @@
title: "FastVideo FastH3: ejemplos de flujos de trabajo de ComfyUI"
description: "FastVideo FastH3 genera video MiniMax H3 con audio sincronizado en 8 pasos de muestreo en ComfyUI, para flujos de texto a video y de primer/último fotograma."
sidebarTitle: "FastVideo FastH3"
-translationSourceHash: c9534724
+translationSourceHash: cb542dfa
translationFrom: tutorials/video/minimax/minimax-h3-fastvideo.mdx
translationBlockHashes:
"_intro": 096c332e
"Requirements": bcdeb37e
- "FastH3 Text to Video": e9a7420a
+ "FastH3 Text to Video": 1c4cb909
"FastH3 Image to Video": ec7d82bf
- "Workflow structure notes": 77b7c476
+ "Model downloads": b88037db
+ "Workflow structure notes": 8f5d2153
---
-[FastVideo FastH3](https://huggingface.co/FastVideo/FastVideo-FastH3-8-Step-V2) es un checkpoint de MiniMax H3 destilado con DMD2 por el equipo de FastVideo que genera video con audio nativo sincronizado en **8 pasos de muestreo** en lugar de la programación completa del modelo base. Reutiliza el codificador de texto de H3, el VAE de video y el VAE de audio, así que el resultado coincide con la configuración del modelo base mientras el muestreo termina en una fracción de los pasos.
-El trabajo de la versión de vista previa de FastH3 se desarrolló en colaboración con Nuva Lab y el equipo de NVIDIA FastGen; consulta el [anuncio de FastH3](https://haoailab.com/blogs/fasth3-preview/) para conocer los detalles de la destilación. ComfyUI incluye el checkpoint V2 de 8 pasos, reempaquetado por Comfy-Org en el [repositorio FastVideo-FastH3-Comfy](https://huggingface.co/FastVideo/FastVideo-FastH3-Comfy).
+[FastVideo FastH3](https://huggingface.co/FastVideo/FastVideo-FastH3-8-Step-V2) es un checkpoint de MiniMax H3 destilado con DMD2 por el equipo de FastVideo que genera video con audio nativo sincronizado en **8 pasos de muestreo** en lugar de la programación completa del modelo base. Reutiliza el codificador de texto de H3, el VAE de video y el VAE de audio, así que la salida coincide con la configuración del modelo base mientras el muestreo termina en una fracción de los pasos.
+
+El trabajo de la vista previa de FastH3 se desarrolló en colaboración con Nuva Lab y el equipo de NVIDIA FastGen; consulta el [anuncio de FastH3](https://haoailab.com/blogs/fasth3-preview/) para conocer los detalles de la destilación. ComfyUI incluye el checkpoint V2 de 8 pasos, reempaquetado por Comfy-Org en el [repositorio FastVideo-FastH3-Comfy](https://huggingface.co/FastVideo/FastVideo-FastH3-Comfy).
FastH3 sacrifica algo de fidelidad de movimiento y audio a cambio de velocidad. Úsalo para borradores, iteración y entregas rápidas; usa los flujos de trabajo base de MiniMax H3 cuando la máxima calidad sea lo importante.
-El checkpoint destilado solo admite texto a video e imagen a video con primer y último fotograma. Ref2VA (conditioning con múltiples referencias) no se destiló; usa los [flujos de trabajo base de MiniMax H3](/es/tutorials/video/minimax/minimax-h3-native) para la generación basada en referencias.
+El checkpoint destilado solo admite texto a video e imagen a video con primer y último fotograma. Ref2VA (acondicionamiento con múltiples referencias) no se destiló; usa los [flujos de trabajo base de MiniMax H3](/es/tutorials/video/minimax/minimax-h3-native) para la generación basada en referencias.
## Requisitos
@@ -39,7 +41,9 @@ Genera video y audio sincronizados a partir de un prompt de texto en 8 pasos.
Abrir en Comfy Cloud
-*/}
+
+
+*/}
@@ -49,11 +53,11 @@ Genera video y audio sincronizados a partir de un prompt de texto en 8 pasos.
### Consejos para escribir prompts
-1. **Describe toda la escena**: Indica primero la escena general (lugar, personaje, qué ocurre) y luego divídela en tomas con duración
+1. **Describe toda la escena**: Indica primero la escena general (lugar, personaje, qué ocurre) y luego divídela en tomas con tiempos definidos
2. **Tomas, cámara y audio**: Describe las tomas, los movimientos de cámara y el audio que las acompaña (diálogo, SFX, música) en un solo bloque de prompt
-3. **Resolución**: El lienzo nativo de H3 tiene un borde corto de 768px y un área de 768×1344, y las resoluciones se redondean a un múltiplo de 32. El nodo acepta tamaños mayores, pero se renderizan más lento sin añadir detalle
+3. **Resolución**: El lienzo nativo de H3 tiene un borde corto de 768px y un área de 768×1344, y las resoluciones se redondean a un múltiplo de 32. El nodo acepta tamaños más grandes, pero el renderizado es más lento y no añade detalle
4. **Duración**: La entrada de duración se ajusta a la cuadrícula del modelo de 17 fotogramas por bloque (17k+5) a 24fps
-5. **Los pasos son fijos en 8**: El checkpoint destilado está entrenado para exactamente 8 pasos; cambiar la cantidad de pasos en el scheduler degrada la calidad
+5. **Los pasos son fijos en 8**: El checkpoint destilado está entrenado para exactamente 8 pasos; cambiar el número de pasos en el scheduler degrada la calidad
Para obtener recursos sobre cómo escribir prompts, consulta la [guía de prompts](/es/tutorials/video/minimax/minimax-h3-prompt-guide).
@@ -68,7 +72,9 @@ Anima una imagen fija con audio sincronizado y con control opcional de primer y
Abrir en Comfy Cloud
-*/}
+
+
+*/}
@@ -92,13 +98,13 @@ Conecta imágenes a `first_frame` y/o `last_frame` en el nodo `MiniMaxH3ImageToV
### Consejos para el prompt
-1. **Describe el movimiento y el audio**: Como la imagen ya aporta la apariencia, el prompt debe centrarse en el movimiento, la cámara y el audio que lo acompaña
-2. **Duración**: La entrada de duración se ajusta a la cuadrícula del modelo de 17 fotogramas por bloque (17k+5) a 24fps
-3. **Los pasos están fijos en 8**: Mantén el scheduler en 8 pasos; el checkpoint está destilado para esa programación
+1. **Describe el movimiento y el audio**: Como la imagen ya aporta la apariencia, el prompt debe centrarse en el movimiento, la cámara y el audio que lo acompaña.
+2. **Duración**: El valor de duración se ajusta a la cuadrícula de 17 fotogramas por bloque (17k+5) del modelo a 24fps.
+3. **Los pasos están fijos en 8**: Mantén el scheduler en 8 pasos; el checkpoint está destilado para esa programación.
-## Descarga de modelos
+## Descargas de modelos
-El modelo de difusión viene del repositorio de FastVideo; el codificador de texto y los VAE se comparten con el modelo base MiniMax H3.
+El modelo de diffusion proviene del repositorio de FastVideo; el text encoder y los VAE son compartidos con el modelo base MiniMax H3.
@@ -128,14 +134,13 @@ ComfyUI/
│ ├── minimax_h3_video_vae_int8_convrot.safetensors
│ └── minimax_h3_audio_vae_fp32.safetensors
```
-
## Notas sobre la estructura del flujo de trabajo
-Ambos flujos de trabajo FastH3 comparten estos nodos con la configuración base de H3, con configuraciones específicas de destilación:
+Ambos flujos de trabajo FastH3 comparten estos nodos con la configuración base de H3, con configuraciones específicas de la destilación:
-- **BlockSparseAttention**: ejecuta Video Sparse Attention (VSA) con `keep_percent` 10, iniciando al 20% de la programación, lo que reduce el costo de atención mientras preserva la calidad
+- **BlockSparseAttention**: ejecuta Video Sparse Attention (VSA) con `keep_percent` 10, comenzando en el 20% de la programación, lo que reduce el costo de atención sin perder calidad
- **MiniMaxH3SigmaShift**: aplica el desplazamiento sigma de H3 (10 para video, 3 para audio) que coincide con la programación destilada
-- **ComfyMathExpression**: convierte la entrada de duración en una `length` de fotogramas válida en la cuadrícula de 17k+5 a 24fps
-- **Sampler**: sampler `res_multistep` con el scheduler `simple` a 8 pasos
+- **ComfyMathExpression**: convierte la entrada de duración en una `length` de fotogramas válida en la cuadrícula 17k+5 a 24fps
+- **Sampler**: sampler `res_multistep` con el scheduler `simple` en 8 pasos
-Los pesos de FastH3 incluyen capas de compuerta `to_gate_compress`, que VSA lee para su rama gruesa. Los checkpoints base de H3 no las tienen. Para comparar métodos, establece `method` en `sol-attn` en el nodo **Model Sparse Attention** y mantén la misma seed. `sol-attn` no necesita pesos coincidentes y se ejecuta en cualquier checkpoint H3 con el `tau` que establezcas.
+Los pesos de FastH3 incluyen capas de compuerta `to_gate_compress`, que VSA lee para su rama gruesa. Los checkpoints base de H3 no las tienen. Para comparar métodos, establece `method` en `sol-attn` en el nodo **Model Sparse Attention** y mantén la misma semilla. `sol-attn` no necesita pesos coincidentes y se ejecuta en cualquier checkpoint de H3 con el `tau` que establezcas.
diff --git a/es/tutorials/video/minimax/minimax-h3-fun-controlnet.mdx b/es/tutorials/video/minimax/minimax-h3-fun-controlnet.mdx
index 273cef655d..29f871d168 100644
--- a/es/tutorials/video/minimax/minimax-h3-fun-controlnet.mdx
+++ b/es/tutorials/video/minimax/minimax-h3-fun-controlnet.mdx
@@ -2,14 +2,16 @@
title: "ComfyUI MiniMax H3 Fun ControlNet Union: video con control de pose, profundidad y Canny"
description: "Guía el movimiento de video de MiniMax H3 en ComfyUI con videos de control Canny, Depth, HED, MLSD o Pose, además de relleno inteligente con máscaras usando el parche Fun ControlNet Union."
sidebarTitle: "Fun ControlNet Union"
-translationSourceHash: d4c42cef
+translationSourceHash: e9538916
translationFrom: tutorials/video/minimax/minimax-h3-fun-controlnet.mdx
translationBlockHashes:
"_intro": a84faa25
"Model downloads": 5310815d
+ "Model storage": b507229f
"Prompting tips": 39f67d41
---
-Controla el movimiento de un video de MiniMax H3 con un video de control en lugar de solo texto. El parche Fun ControlNet Union ([alibaba-pai/MiniMax-H3-Fun-Controlnet-Union](https://huggingface.co/alibaba-pai/MiniMax-H3-Fun-Controlnet-Union), empaquetado en [Comfy-Org/MiniMax-H3](https://huggingface.co/Comfy-Org/MiniMax-H3)) es un único checkpoint que condiciona H3 con videos de control Canny, Profundidad, HED, MLSD o Pose, y también ejecuta relleno inteligente de video con una máscara. Funciona con ambos archivos transformer `fl2va` y `ref2va`.
+
+Controla el movimiento de un video de MiniMax H3 con un video de control en lugar de solo texto. El parche Fun ControlNet Union ([alibaba-pai/MiniMax-H3-Fun-Controlnet-Union](https://huggingface.co/alibaba-pai/MiniMax-H3-Fun-Controlnet-Union), empaquetado en [Comfy-Org/MiniMax-H3](https://huggingface.co/Comfy-Org/MiniMax-H3)) es un solo checkpoint que condiciona H3 con videos de control de Canny, Profundidad, HED, MLSD o Pose, y además ejecuta relleno inteligente de video con una máscara. Funciona tanto con el archivo transformer `fl2va` como con el `ref2va`.

@@ -28,38 +30,38 @@ Sube este archivo al nodo `Load Video` correspondiente:
- Video de control de pose que usa el flujo de trabajo de ejemplo, o usa el tuyo.
+ Video de control de pose que usa el flujo de trabajo de ejemplo, o usa el tuyo propio.
-Esta plantilla requiere ComfyUI 0.35.0 o una versión posterior. El ejemplo usa un video de control de pose: un subgrafo SDPose integrado extrae el esqueleto de la pose del video de entrada, por lo que la salida reproduce el movimiento del bailarín. También puedes conectar cualquier video de control preprocesado directamente a la entrada `control_video` del nodo `Apply MiniMax H3 Fun ControlNet`.
+Esta plantilla requiere ComfyUI 0.35.0 o una versión posterior. El ejemplo usa un video de control de pose: un subgrafo SDPose integrado extrae el esqueleto de la pose del video de entrada, así que la salida reproduce el movimiento del bailarín. También puedes conectar cualquier video de control preprocesado directamente a la entrada `control_video` del nodo `Apply MiniMax H3 Fun ControlNet`.
## Descargas de modelos
- Coloca en ComfyUI/models/diffusion_models/
+ Colócalo en ComfyUI/models/diffusion_models/
- Coloca en ComfyUI/models/model_patches/
+ Colócalo en ComfyUI/models/model_patches/
- Coloca en ComfyUI/models/text_encoders/
+ Colócalo en ComfyUI/models/text_encoders/
- Coloca en ComfyUI/models/vae/
+ Colócalo en ComfyUI/models/vae/
- Coloca en ComfyUI/models/vae/
+ Colócalo en ComfyUI/models/vae/
- Habilita el modo turbo opcional con el Lightning LoRA. Coloca en ComfyUI/models/loras/
+ Activa el modo turbo opcional del Lightning LoRA. Colócalo en ComfyUI/models/loras/
- Extractor de pose que usa el subgrafo SDPose integrado. Coloca en ComfyUI/models/checkpoints/
+ Extractor de poses que usa el subgrafo SDPose integrado. Colócalo en ComfyUI/models/checkpoints/
- Detector de personas que usa el subgrafo SDPose integrado. Coloca en ComfyUI/models/diffusion_models/
+ Detector de personas que usa el subgrafo SDPose integrado. Colócalo en ComfyUI/models/diffusion_models/
@@ -83,11 +85,10 @@ ComfyUI/
│ └── 📂 checkpoints/
│ └── sdpose_wholebody_fp16.safetensors
```
+## Consejos para el prompt
-## Consejos para los prompts
-
-1. **Duración del video**: El video objetivo dura de 5 a 15 segundos en la cuadrícula de fotogramas 17n+5 a 24fps (124 fotogramas = 5 segundos). Un video de control más largo que el objetivo se recorta a sus primeros fotogramas; uno más corto mantiene su último fotograma. Para igualar exactamente la duración del video de control, conecta la salida `batch_size` calculada del ejemplo con la entrada de longitud del nodo `MiniMax H3 Reference to Video`
-2. **Orientación y strength**: Mantén `guidance_scale` en 1.0. Aumenta el `strength` del patch por encima de 1 solo si el resultado se aleja del control
-3. **Relleno inteligente de video**: Conecta una máscara a la entrada `mask`: las regiones marcadas con `1` se regeneran bajo el control de la entrada opcional `source_video`, mientras el resto del fotograma permanece fijo
-4. **Modo turbo (opcional)**: Activa la casilla **Lightning LoRA** para usar el LoRA turbo de 4 pasos y generar mucho más rápido, con una calidad de audio y movimiento ligeramente inferior
-5. **Preparar los videos de control**: ComfyUI incluye nodos de preprocesamiento integrados para cada tipo de control. Consulta el [nodo Detect Edges (Canny)](https://docs.comfy.org/built-in-nodes/Canny) para bordes y el [tutorial Depth Anything 3](https://docs.comfy.org/tutorials/utility/depth-anything-3) para mapas de profundidad
+1. **Duración del video**: El video objetivo dura de 5 a 15 segundos en la cuadrícula de fotogramas 17n+5 a 24fps (124 fotogramas = 5 segundos). Un video de control más largo que el objetivo se recorta a sus primeros fotogramas; uno más corto mantiene su último fotograma. Para igualar exactamente la duración del video de control, conecta la salida `batch_size` calculada del ejemplo a la entrada de longitud del nodo `MiniMax H3 Reference to Video`
+2. **Orientación y fuerza**: Mantén `guidance_scale` en 1.0. Aumenta la `strength` del parche por encima de 1 solo si la salida se aleja del control
+3. **Relleno inteligente de video**: Conecta una máscara a la entrada `mask`: las regiones marcadas con `1` se regeneran bajo el control de la entrada opcional `source_video`, mientras que el resto del fotograma permanece fijo
+4. **Modo turbo (opcional)**: Activa la casilla **Lightning LoRA** para usar el LoRA turbo de 4 pasos y obtener una generación mucho más rápida, con una calidad de audio y movimiento ligeramente inferior
+5. **Preparar videos de control**: ComfyUI incluye nodos de preprocesamiento integrados para cada tipo de control. Consulta el [nodo Detect Edges (Canny)](https://docs.comfy.org/built-in-nodes/Canny) para bordes y el [tutorial de Depth Anything 3](https://docs.comfy.org/tutorials/utility/depth-anything-3) para mapas de profundidad
diff --git a/es/tutorials/video/minimax/minimax-h3-multiframe.mdx b/es/tutorials/video/minimax/minimax-h3-multiframe.mdx
index 79e7241a9d..9bde8fa5c6 100644
--- a/es/tutorials/video/minimax/minimax-h3-multiframe.mdx
+++ b/es/tutorials/video/minimax/minimax-h3-multiframe.mdx
@@ -2,14 +2,16 @@
title: "Flujo de trabajo de referencia multifotograma de MiniMax H3 en ComfyUI"
description: "Crea continuaciones de video y escenas de varias tomas con MiniMax H3 en ComfyUI fijando fotogramas de referencia en la línea de tiempo con nodos Add Guide."
sidebarTitle: "Referencia multifotograma"
-translationSourceHash: 456918f4
+translationSourceHash: 92c8dde7
translationFrom: tutorials/video/minimax/minimax-h3-multiframe.mdx
translationBlockHashes:
"_intro": 3a03ecf1
"Model downloads": 263666fa
+ "Model storage": 17ed75e6
"Prompting tips": 12a34e31
"Prompt writing guide": 4f808c3a
---
+
Genera continuaciones de video y escenas de varios planos anclando fotogramas de referencia en puntos específicos a lo largo de la línea de tiempo de salida. El flujo de trabajo combina el nodo Reference to Video con nodos Add Guide encadenados: cada Add Guide fija una imagen estática (más audio opcional) a un índice de fotograma, de modo que el video pasa por esa composición exacta en ese momento.

@@ -54,7 +56,7 @@ Genera continuaciones de video y escenas de varios planos anclando fotogramas de
Colócalo en ComfyUI/models/vae/
- Habilita el modo turbo opcional con el Lightning LoRA. Colócalo en ComfyUI/models/loras/
+ Impulsa el modo turbo opcional del Lightning LoRA. Colócalo en ComfyUI/models/loras/
@@ -73,15 +75,14 @@ ComfyUI/
│ └── 📂 loras/
│ └── minimax_h3_ref2v_turbo_4step_v0.1_comfyui_bf16.safetensors
```
-
## Consejos para el prompt
-1. **Haz referencia por etiqueta**: `` es la imagen conectada a la primera ranura de `ref_images`, `` a la segunda, y así sucesivamente. En este flujo de trabajo, `` es tanto el bloqueo de identidad como el primer fotograma del video
-2. **Anclajes de la línea de tiempo frente a referencias**: las imágenes conectadas solo a nodos Add Guide anclan composiciones en fotogramas específicos, pero no son visibles para el codificador de texto. Conéctalas también a ranuras `ref_images` adicionales si quieres que el prompt las vea como ``
-3. **Índice de fotograma**: cada Add Guide toma `frame_idx` en fotogramas a 24 fps; la plantilla lo calcula a partir de segundos con `round(seconds * 24)`. Los valores negativos cuentan desde el final del video. El índice más la longitud de la guía deben quedar dentro de la duración generada
-4. **Añade más fotogramas clave**: copia un bloque de guía (Load Image + Frame Index + Math Expression + Add Guide for MiniMax H3) y mantén las salidas `positive` encadenadas en serie hacia el Basic Guider
-5. **Modo turbo (opcional)**: activa la casilla **Lightning LoRA** para usar el LoRA turbo de 4 pasos y lograr una generación mucho más rápida, con una calidad de audio y movimiento ligeramente inferior
+1. **Referencia por etiqueta**: `` es la imagen conectada al primer slot de `ref_images`, `` al segundo, y así sucesivamente. En este flujo de trabajo, `` es a la vez el bloqueo de identidad y el primer fotograma del video
+2. **Anclajes de línea de tiempo vs. referencias**: las imágenes conectadas solo a nodos Añadir guía anclan composiciones en fotogramas concretos, pero el codificador de texto no las ve. Conéctalas también a slots `ref_images` adicionales si quieres que el prompt las vea como ``
+3. **Índice de fotograma**: cada nodo Añadir guía toma `frame_idx` en fotogramas a 24 fps; la plantilla lo calcula a partir de los segundos con `round(seconds * 24)`. Los valores negativos cuentan desde el final del video. El índice más la longitud de la guía deben quedar dentro de la duración generada
+4. **Añade más fotogramas clave**: copia un bloque de guía (Cargar imagen + Frame Index + Expresión matemática + Añadir guía para MiniMax H3) y mantén las salidas `positive` encadenadas en serie hacia la Guía básica
+5. **Modo turbo (opcional)**: activa la casilla **Lightning LoRA** para usar el LoRA turbo de 4 pasos, que genera mucho más rápido con una calidad de audio y movimiento algo menor
## Guía para escribir prompts
-El prompt de la plantilla sigue la [guía de prompts del modo de referencia completa](https://huggingface.co/MiniMaxAI/MiniMax-H3/blob/main/docs/VIDEO_PROMPT_WRITING_GUIDE_ref_en.md): define cada sujeto, asigna cada `` al primer fotograma o fotograma clave de un plano y corta entre planos en marcas de tiempo explícitas. Usa la misma estructura cuando escribas tus propios prompts de varios planos. La guía está resumida en la [guía de prompts](/es/tutorials/video/minimax/minimax-h3-prompt-guide).
+El prompt de la plantilla sigue la [guía de prompts del modo de referencia completa](https://huggingface.co/MiniMaxAI/MiniMax-H3/blob/main/docs/VIDEO_PROMPT_WRITING_GUIDE_ref_en.md): define cada sujeto, asigna cada `` al primer fotograma o al fotograma clave de un plano y corta entre planos en marcas de tiempo explícitas. Usa la misma estructura cuando escribas tus propios prompts de varios planos. La guía está resumida en la [guía de prompts](/es/tutorials/video/minimax/minimax-h3-prompt-guide).
diff --git a/es/tutorials/video/minimax/minimax-h3-prompt-guide.mdx b/es/tutorials/video/minimax/minimax-h3-prompt-guide.mdx
index 2a9accf37c..cbaaad36f2 100644
--- a/es/tutorials/video/minimax/minimax-h3-prompt-guide.mdx
+++ b/es/tutorials/video/minimax/minimax-h3-prompt-guide.mdx
@@ -2,16 +2,17 @@
title: "Guía de prompts de ComfyUI MiniMax H3: guías oficiales, consejos y embeddings de prompt"
description: "Escribe mejores prompts de MiniMax H3 en ComfyUI: guías oficiales, consejos generales, reglas de diálogo y hablantes, y embeddings de estilo."
sidebarTitle: "Guía de prompts"
-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
---
+
H3 espera planos, cámara, diálogo y SFX en un solo prompt multimodal. Esta página reúne guías oficiales, consejos entre flujos de trabajo, reglas de planos y diálogo, y embeddings de estilo.
## Guías oficiales
@@ -21,7 +22,7 @@ H3 espera planos, cámara, diálogo y SFX en un solo prompt multimodal. Esta pá
El paquete instalable de [habilidades H3](https://github.com/MiniMax-AI/MiniMax-H3/tree/main/skills) reúne estos contenidos para los agentes.
-Aplicado por plantilla: [T2V/I2V](/es/tutorials/video/minimax/minimax-h3-native), [R2V](/es/tutorials/video/minimax/minimax-h3-native#minimax-h3-referencia-a-video-r2v), [Multiframe](/es/tutorials/video/minimax/minimax-h3-multiframe#guía-para-escribir-prompts), [Fun ControlNet](/es/tutorials/video/minimax/minimax-h3-fun-controlnet#consejos-para-los-prompts).
+Aplicado por plantilla: [T2V/I2V](/es/tutorials/video/minimax/minimax-h3-native), [R2V](/es/tutorials/video/minimax/minimax-h3-native#minimax-h3-referencia-a-video-r2v), [Multiframe](/es/tutorials/video/minimax/minimax-h3-multiframe#guía-para-escribir-prompts), [Fun ControlNet](/es/tutorials/video/minimax/minimax-h3-fun-controlnet#consejos-para-el-prompt).
## Consejos generales
@@ -37,7 +38,7 @@ Escribe los prompts en **inglés**. Los diálogos y las letras de canciones van
1. **Primero la escena**: la escena general, luego los planos cronometrados dentro de `[Shot 1]` de `integrated_multimodal_description`
2. **Un solo bloque**: planos, cámara y audio juntos
-3. **Resolución**: nativa **1344×768** en 16:9; múltiplos de **32**
+3. **Resolución**: nativa de **1344×768** en 16:9; múltiplos de **32**
4. **Longitud**: `length` son fotogramas a 24fps (predeterminado **124** ≈ 5s), ajustado a **17k+5**
5. **Texto en pantalla**: comillas dobles en inglés para cada cadena, literal (p. ej., `A red neon sign reading "营业中"`). Las líneas habladas usan ``, no comillas
6. **Marcadores de audio de R2V**: en el análisis de retención, marca cada referencia de audio como `fully_copy`, `partially_copy`, `reference` o `weak_reference` según cómo se use el clip (consulta la tabla de la guía oficial de referencias)
diff --git a/es/tutorials/video/wan/fun-camera.mdx b/es/tutorials/video/wan/fun-camera.mdx
index 44669c4aad..7cab5d60fe 100644
--- a/es/tutorials/video/wan/fun-camera.mdx
+++ b/es/tutorials/video/wan/fun-camera.mdx
@@ -2,15 +2,17 @@
title: "Ejemplos oficiales de ComfyUI Wan2.1 Fun Camera"
description: "Esta guía muestra cómo usar Wan2.1 Fun Camera en ComfyUI para generar video"
sidebarTitle: "Wan2.1 Fun Camera"
-translationSourceHash: 6173f2a1
+translationSourceHash: f2b906a8
translationFrom: tutorials/video/wan/fun-camera.mdx
translationBlockHashes:
"_intro": 59d5e57d
"About Wan2.1 Fun Camera": 98c0ae00
+ "Model Installation": 65ab0da5
"ComfyUI Wan2.1 Fun Camera 1.3B Workflow": 4ddf8882
"ComfyUI Wan2.1 Fun Camera 14B Workflow": ea99a5f1
"Performance Reference": 2dc2f8f0
---
+
import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"
Wan2.1 Fun Camera es un modelo de generación de video con movimiento de cámara del proyecto VideoX-Fun de Alibaba, con soporte nativo en ComfyUI. Genera videos cuyo movimiento de cámara sigue tus condiciones de control, así puedes dirigir cómo se mueve la cámara en el resultado en lugar de describir cada plano en el prompt.
@@ -19,9 +21,9 @@ El modelo forma parte de la familia Wan2.1-Fun y se distribuye en dos tamaños:
## Acerca de Wan2.1 Fun Camera
-**Wan2.1 Fun Camera** es un proyecto de generación de video lanzado por el equipo de Alibaba, centrado en controlar los efectos de generación de video mediante el movimiento de cámara.
+**Wan2.1 Fun Camera** es un proyecto de generación de video lanzado por el equipo de Alibaba, centrado en controlar los efectos de la generación de video mediante el movimiento de cámara.
-**Descargar los pesos del modelo**:
+**Descarga de los pesos del modelo**:
- [Versión 14B](https://huggingface.co/alibaba-pai/Wan2.1-Fun-V1.1-14B-Control-Camera)
- [Versión 1.3B](https://huggingface.co/alibaba-pai/Wan2.1-Fun-V1.1-1.3B-Control-Camera)
@@ -33,9 +35,9 @@ El modelo forma parte de la familia Wan2.1-Fun y se distribuye en dos tamaños:
## Instalación de modelos
-Estos modelos solo hay que instalarlos una vez. Además, la información de descarga de los modelos está incluida en las imágenes de los flujos de trabajo correspondientes, así que puedes elegir la forma de descarga que prefieras.
+Estos modelos solo necesitan instalarse una vez. Además, la información de descarga de los modelos se incluye en las imágenes del flujo de trabajo correspondiente, así que puedes elegir la forma que prefieras para descargar los modelos.
-Todos los modelos siguientes están disponibles en [Wan_2.1_ComfyUI_repackaged](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged)
+Todos los modelos siguientes se encuentran en [Wan_2.1_ComfyUI_repackaged](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged)
### Modelos de difusión
@@ -50,7 +52,7 @@ Elige entre 1.3B o 14B:
-Si ya has usado modelos de Wan2.1, deberías tener ya los siguientes modelos. Si no es así, descárgalos:
+Si ya has usado modelos relacionados con Wan2.1, deberías tener los siguientes modelos. Si no es así, descárgalos:
### Codificadores de texto
@@ -61,7 +63,7 @@ Elige uno de los siguientes:
Codificador de texto de precisión completa
- Codificador de texto cuantizado FP8 (recomendado para menos VRAM)
+ Codificador de texto cuantizado FP8 (recomendado para VRAM baja)
@@ -77,7 +79,7 @@ Elige uno de los siguientes:
- Codificador CLIP Vision
+ Codificador de visión CLIP
@@ -96,25 +98,24 @@ Ubicación de almacenamiento de archivos:
│ └── 📂 clip_vision/
│ └── clip_vision_h.safetensors
```
-
-## Flujo de trabajo ComfyUI Wan2.1 Fun Camera 1.3B
+## Flujo de trabajo de ComfyUI Wan2.1 Fun Camera 1.3B
### Wan 2.1 Fun Camera 1.3B {#video_wan2.1_fun_camera_v1.1_1.3B}
Genera videos dinámicos con movimientos de cámara cinematográficos usando el modelo Wan 2.1 Fun Camera 1.3B.
-
+
Abrir en Comfy Cloud
- Descarga el JSON o busca "Wan 2.1 Fun Camera 1.3B" en la biblioteca de plantillas
+ Descarga el JSON o busca "Wan 2.1 Fun Camera 1.3B" en la Biblioteca de plantillas
-Descarga el video de abajo y arrástralo a ComfyUI para cargar el flujo de trabajo correspondiente:
+Descarga el video a continuación y arrástralo a ComfyUI para cargar el flujo de trabajo correspondiente:
@@ -168,7 +169,7 @@ Genera videos de alta calidad con control de cámara avanzado usando el modelo c
Abrir en Comfy Cloud
- Descarga el JSON o busca "Wan 2.1 Fun Camera 14B" en la Biblioteca de plantillas
+ Descarga el JSON o busca "Wan 2.1 Fun Camera 14B" en la biblioteca de plantillas
@@ -184,7 +185,7 @@ Sube este archivo al nodo `LoadImage` correspondiente:
- nodo `LoadImage` 52 · `video_wan2.1_fun_camera_v1.1_14B_start_image.jpg`
+ Nodo `LoadImage` 52 · `video_wan2.1_fun_camera_v1.1_14B_start_image.jpg`
@@ -195,7 +196,7 @@ Sube este archivo al nodo `LoadImage` correspondiente:
## Referencia de rendimiento
**Versión 1.3B**:
-- A 512x512 de resolución, una RTX 4090 tarda unos 72 segundos en generar 81 frames
+- La resolución de 512x512 en una RTX 4090 tarda aproximadamente 72 segundos en generar 81 fotogramas
**Versión 14B**:
-- Una RTX 4090 de 24 GB de VRAM puede quedarse sin memoria al generar a 512x512 de resolución, y también han aparecido problemas de memoria en una A100 al usar tamaños mayores
+- Una RTX4090 de 24 GB de VRAM puede experimentar memoria insuficiente al generar una resolución de 512x512, y también se han producido problemas de memoria en una A100 al usar tamaños mayores
diff --git a/es/tutorials/video/wan/fun-control.mdx b/es/tutorials/video/wan/fun-control.mdx
index fc40179236..bdbe7953dc 100644
--- a/es/tutorials/video/wan/fun-control.mdx
+++ b/es/tutorials/video/wan/fun-control.mdx
@@ -2,28 +2,30 @@
title: "Ejemplos de video con Wan2.1 Fun Control en ComfyUI"
description: "Esta guía muestra cómo usar Wan2.1 Fun Control en ComfyUI para generar videos con videos de control"
sidebarTitle: "Wan2.1 Fun Control"
-translationSourceHash: 2ce972d6
+translationSourceHash: 8b293934
translationFrom: tutorials/video/wan/fun-control.mdx
translationBlockHashes:
"_intro": b7cb8b6d
"About Wan2.1-Fun-Control": 2e562079
+ "Model Installation": 6ee9c5c6
"ComfyUI Native Workflow": 01fc65b5
"Workflow Using Custom Nodes": 8f081a21
"Usage Tips": 9e74c201
---
+
import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx";
Wan2.1-Fun-Control es un modelo de generación de video de código abierto del proyecto VideoX-Fun de Alibaba que sigue condiciones de control predefinidas en lugar de depender únicamente del texto del prompt. Puedes guiar la salida con mapas de bordes Canny, mapas de profundidad, esqueletos OpenPose, bordes geométricos MLSD o trayectorias de puntos.
-El modelo está disponible en dos tamaños: la versión de 1.3B (unos 19 GB) para un despliegue local ligero con menores requisitos de VRAM, y la versión de 14B (unos 47 GB de almacenamiento total del modelo, con los pesos de difusión en unos 32.8 GB) para resultados de mayor calidad. Ambas admiten predicción de video multirresolución a 512, 768 y 1024 píxeles, generan hasta 81 fotogramas (unos 5 segundos) a 16 fotogramas por segundo y aceptan prompts multilingües. ComfyUI ofrece soporte nativo para Wan2.1-Fun-Control.
+El modelo está disponible en dos tamaños: la versión de 1.3B (unos 19 GB) para un despliegue local ligero con requisitos de VRAM más bajos, y la versión de 14B (unos 47 GB de almacenamiento total del modelo, con los pesos de difusión en unos 32.8 GB) para resultados de mayor calidad. Ambas admiten predicción de video multirresolución a 512, 768 y 1024 píxeles, generan hasta 81 fotogramas (unos 5 segundos) a 16 fotogramas por segundo y aceptan prompts multilingües. ComfyUI ofrece soporte nativo para Wan2.1-Fun-Control.
## Acerca de Wan2.1-Fun-Control
**Wan2.1-Fun-Control** es un proyecto de generación y control de video de código abierto desarrollado por el equipo de Alibaba.
Introduce mecanismos innovadores de códigos de control (Control Codes) combinados con aprendizaje profundo y entradas condicionales multimodales para generar videos de alta calidad que cumplen con condiciones de control predefinidas. El proyecto se centra en guiar con precisión el contenido del video generado mediante condiciones de control multimodales.
-Actualmente, el modelo Fun Control admite diversas condiciones de control, como **Canny (arte lineal), Depth, OpenPose (postura humana), MLSD (bordes geométricos) y control de trayectoria.**
-El modelo también admite predicción de video multirresolución con opciones de 512, 768 y 1024 de resolución a 16 fotogramas por segundo, generando videos de hasta 81 fotogramas (aproximadamente 5 segundos) de duración.
+Actualmente, el modelo Fun Control admite diversas condiciones de control, como **Canny (arte lineal), Profundidad, OpenPose (postura humana), MLSD (bordes geométricos) y control de trayectoria.**
+El modelo también admite la predicción de video en múltiples resoluciones, con opciones de 512, 768 y 1024 a 16 fotogramas por segundo, y genera videos de hasta 81 fotogramas (aproximadamente 5 segundos) de duración.
Versiones del modelo:
- **1.3B** Ligero: ideal para el despliegue local y la inferencia rápida con **requisitos de VRAM más bajos**
@@ -55,33 +57,33 @@ Sin embargo, hemos comprobado que ofrecer una buena experiencia de usuario para
-## Instalación de modelos
+## Instalación del modelo
-Solo tienes que instalar estos modelos una vez. Las imágenes de los flujos de trabajo también contienen la información de descarga de los modelos, así que puedes elegir el método de descarga que prefieras.
+Solo necesitas instalar estos modelos una vez. Las imágenes del flujo de trabajo también contienen la información de descarga de los modelos, así que puedes elegir el método de descarga que prefieras.
-Los siguientes modelos están disponibles en [Wan_2.1_ComfyUI_repackaged](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged) y [Wan2.1-Fun](https://huggingface.co/collections/alibaba-pai/wan21-fun-67e4fb3b76ca01241eb7e334)
+Puedes encontrar los siguientes modelos en [Wan_2.1_ComfyUI_repackaged](https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged) y [Wan2.1-Fun](https://huggingface.co/collections/alibaba-pai/wan21-fun-67e4fb3b76ca01241eb7e334)
-Haz clic en los enlaces correspondientes para descargar. Si ya has usado flujos de trabajo de Wan, solo necesitas descargar los **modelos de difusión**.
+Haz clic en los enlaces correspondientes para descargarlos. Si ya has usado flujos de trabajo relacionados con Wan, solo necesitas descargar los **modelos de difusión**.
-**Modelos de difusión** -- elige 1.3B o 14B. La versión 14B tiene un tamaño de archivo mayor (32 GB) y requiere más VRAM:
+**Modelos de difusión**: elige 1.3B o 14B. La versión 14B tiene un tamaño de archivo mayor (32GB) y requiere más VRAM:
- Modelo de difusión Wan2.1 Fun Control 1.3B -- ligero, requiere menos VRAM
+ Modelo de difusión Wan2.1 Fun Control 1.3B: ligero, con menores requisitos de VRAM
- Modelo de difusión Wan2.1 Fun Control 14B. Cámbiale el nombre a Wan2.1-Fun-14B-Control.safetensors después de descargarlo. Archivo de 32 GB o más, requiere más VRAM
+ Modelo de difusión Wan2.1 Fun Control 14B. Cambia el nombre a Wan2.1-Fun-14B-Control.safetensors después de descargarlo. Tamaño de archivo de 32GB o más, mayores requisitos de VRAM
-**Codificadores de texto** -- elige uno de los siguientes modelos (la precisión fp16 tiene un tamaño mayor y requiere más rendimiento):
+**Codificadores de texto**: elige uno de los siguientes modelos (la precisión fp16 tiene un tamaño mayor y requisitos de rendimiento más altos):
- Codificador de texto UMT5 XXL -- precisión fp16, tamaño mayor, mayor rendimiento
+ Codificador de texto UMT5 XXL: precisión fp16, mayor tamaño, mayores requisitos de rendimiento
- Codificador de texto UMT5 XXL -- precisión fp8, tamaño menor, requiere menos rendimiento
+ Codificador de texto UMT5 XXL: precisión fp8, menor tamaño, menores requisitos de rendimiento
@@ -95,7 +97,7 @@ Haz clic en los enlaces correspondientes para descargar. Si ya has usado flujos
Modelo CLIP Vision para procesar imágenes de referencia
-Ubicación de almacenamiento de archivos:
+Ubicación de almacenamiento de los archivos:
```
📂 ComfyUI/
├── 📂 models/
@@ -109,15 +111,14 @@ Ubicación de almacenamiento de archivos:
│ └── 📂 clip_vision/
│ └── clip_vision_h.safetensors
```
-
## Flujo de trabajo nativo de ComfyUI
-En este flujo de trabajo usamos videos convertidos a **formato WebP**, ya que el nodo `Load Image` no admite actualmente el formato mp4. También usamos **Canny Edge** para preprocesar el video original.
-Como muchos usuarios se topan con fallos de instalación y problemas de entorno al instalar nodos personalizados, esta versión del flujo de trabajo usa solo nodos nativos para garantizar una experiencia más fluida.
+En este flujo de trabajo, usamos videos convertidos a **formato WebP**, ya que el nodo `Load Image` no admite actualmente el formato mp4. También usamos **Canny Edge** para preprocesar el video original.
+Como muchos usuarios encuentran fallas de instalación y problemas de entorno al instalar nodos personalizados, esta versión del flujo de trabajo usa solo nodos nativos para garantizar una experiencia más fluida.
-Gracias a nuestros potentes autores de ComfyUI, que ofrecen nodos con muchas funciones. Si quieres consultar directamente la versión relacionada, mira [Flujo de trabajo con nodos personalizados](#flujo-de-trabajo-con-nodos-personalizados).
+Gracias a nuestros grandes autores de ComfyUI, que ofrecen nodos con muchas funciones. Si quieres consultar directamente la versión relacionada, mira [Flujo de trabajo con nodos personalizados](#flujo-de-trabajo-con-nodos-personalizados).
-### 1. Descarga del archivo del flujo de trabajo
+### 1. Descargar el archivo del flujo de trabajo

@@ -125,23 +126,23 @@ Gracias a nuestros potentes autores de ComfyUI, que ofrecen nodos con muchas fun
Abrir en Comfy Cloud
-
- Descarga la imagen del flujo de trabajo y arrástrala a ComfyUI para cargarlo
+
+ Descarga la imagen del flujo de trabajo y arrástrala a ComfyUI para cargar el flujo de trabajo
**Materiales de entrada**
-
+
Fotograma inicial de entrada para el flujo de trabajo nativo. Descarga y usa esta imagen, o reemplázala por la tuya.
- Video de control de entrada en formato WebP para el flujo de trabajo nativo. El flujo de trabajo nativo requiere formato WebP porque Load Image no admite mp4.
+ Video de control de entrada en formato WebP para el flujo de trabajo nativo. El flujo de trabajo nativo requiere el formato WebP, ya que Load Image no admite mp4.
-### 2. Completa el flujo de trabajo paso a paso
+### 2. Completar el flujo de trabajo paso a paso

@@ -149,38 +150,38 @@ Gracias a nuestros potentes autores de ComfyUI, que ofrecen nodos con muchas fun
2. Asegúrate de que el nodo `Load CLIP` haya cargado `umt5_xxl_fp8_e4m3fn_scaled.safetensors`
3. Asegúrate de que el nodo `Load VAE` haya cargado `wan_2.1_vae.safetensors`
4. Asegúrate de que el nodo `Load CLIP Vision` haya cargado `clip_vision_h.safetensors`
-5. Sube el fotograma inicial al nodo `Load Image` (renombrado como `Start_image`)
-6. Sube el video de control al segundo nodo `Load Image`. Nota: este nodo actualmente no admite mp4, solo videos WebP
-7. (Opcional) Modifica el prompt (se admite inglés y chino)
+5. Sube el fotograma inicial al nodo `Load Image` (renombrado a `Start_image`)
+6. Sube el video de control al segundo nodo `Load Image`. Nota: este nodo no admite actualmente mp4, solo videos WebP
+7. (Opcional) Modifica el prompt (puedes usar inglés o chino)
8. (Opcional) Ajusta el tamaño del video en `WanFunControlToVideo`, evitando dimensiones demasiado grandes
9. Haz clic en el botón `Run` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de video
### 3. Notas de uso
-- Como debemos introducir en el nodo `WanFunControlToVideo` el mismo número de fotogramas que tiene el video de control, si el número de fotogramas especificado supera los fotogramas reales del video de control, los fotogramas sobrantes pueden mostrar escenas que no se ajustan a las condiciones de control. Abordaremos este problema en [Flujo de trabajo con nodos personalizados](#flujo-de-trabajo-con-nodos-personalizados)
-- Evita establecer dimensiones demasiado grandes, ya que esto puede hacer que el muestreo sea muy lento. Prueba primero con imágenes más pequeñas y luego haz upscale
-- Usa tu imaginación para ampliar este flujo de trabajo añadiendo flujos de texto a imagen u otros tipos, y lograr así generación directa de texto a video o transferencia de estilo
-- Usa herramientas como [ComfyUI-comfyui_controlnet_aux](https://github.com/Fannovel16/comfyui_controlnet_aux) para obtener opciones de control más ricas
+- Como debemos introducir en el nodo `WanFunControlToVideo` el mismo número de fotogramas que el video de control, si el número de fotogramas especificado supera los fotogramas reales del video de control, los fotogramas sobrantes pueden mostrar escenas que no cumplen con las condiciones de control. Abordaremos este problema en [Flujo de trabajo con nodos personalizados](#flujo-de-trabajo-con-nodos-personalizados)
+- Evita establecer dimensiones demasiado grandes, ya que esto puede hacer que el proceso de muestreo tarde mucho. Intenta generar imágenes más pequeñas primero y luego aplica upscale
+- Usa tu imaginación para ampliar este flujo de trabajo añadiendo flujos de trabajo de texto a imagen u otros tipos, y lograr así la generación directa de texto a video o la transferencia de estilo
+- Usa herramientas como [ComfyUI-comfyui_controlnet_aux](https://github.com/Fannovel16/comfyui_controlnet_aux) para obtener opciones de control más completas
## Flujo de trabajo con nodos personalizados
Necesitaremos instalar los siguientes dos nodos personalizados:
-- [ComfyUI-VideoHelperSuite](https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite)
+- [ComfyUI-VideoHelperSuite](https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite)
- [ComfyUI-comfyui_controlnet_aux](https://github.com/Fannovel16/comfyui_controlnet_aux)
Puedes usar [ComfyUI Manager](https://github.com/Comfy-Org/ComfyUI-Manager) para instalar los nodos faltantes o seguir las instrucciones de instalación de cada paquete de nodos personalizados.
-### 1. Descargar el archivo del flujo de trabajo
+### 1. Descarga del archivo del flujo de trabajo
-
+
Abrir en Comfy Cloud
- Descarga el JSON o busca "Wan 2.1 ControlNet" en la biblioteca de plantillas
+ Descarga el JSON o busca "Wan 2.1 ControlNet" en la Biblioteca de plantillas
@@ -188,27 +189,27 @@ Puedes usar [ComfyUI Manager](https://github.com/Comfy-Org/ComfyUI-Manager) para
- Fotograma inicial de entrada para el flujo de trabajo con nodos personalizados. Descarga y usa esta imagen, o reemplázala por una propia.
+ Fotograma inicial de entrada para el flujo de trabajo con nodos personalizados. Descarga y usa esta imagen, o reemplázala por la tuya.
Video de control de entrada en formato MP4 para el flujo de trabajo con nodos personalizados. El nodo personalizado Load Video admite el formato mp4.
-### 2. Completar el flujo de trabajo paso a paso
+### 2. Completa el flujo de trabajo paso a paso
-
+
> La parte del modelo es esencialmente la misma. Si ya probaste el flujo de trabajo solo con nodos nativos, puedes subir directamente las imágenes correspondientes y ejecutarlo.
-1. Asegúrate de que el nodo `Load Diffusion Model` haya cargado `wan2.1_fun_control_1.3B_bf16.safetensors`
-2. Asegúrate de que el nodo `Load CLIP` haya cargado `umt5_xxl_fp8_e4m3fn_scaled.safetensors`
-3. Asegúrate de que el nodo `Load VAE` haya cargado `wan_2.1_vae.safetensors`
-4. Asegúrate de que el nodo `Load CLIP Vision` haya cargado `clip_vision_h.safetensors`
+1. Asegúrate de que el nodo `Load Diffusion Model` tenga cargado `wan2.1_fun_control_1.3B_bf16.safetensors`
+2. Asegúrate de que el nodo `Load CLIP` tenga cargado `umt5_xxl_fp8_e4m3fn_scaled.safetensors`
+3. Asegúrate de que el nodo `Load VAE` tenga cargado `wan_2.1_vae.safetensors`
+4. Asegúrate de que el nodo `Load CLIP Vision` tenga cargado `clip_vision_h.safetensors`
5. Sube el fotograma inicial al nodo `Load Image`
6. Sube un video en formato mp4 al nodo personalizado `Load Video(Upload)`. Ten en cuenta que el flujo de trabajo ha ajustado el `frame_load_cap` predeterminado
-7. Para la imagen actual, el `DWPose Estimator` solo usa la opción `detect_face`
-8. (Opcional) Modifica el prompt (se admiten tanto inglés como chino)
+7. Para la imagen actual, `DWPose Estimator` solo usa la opción `detect_face`
+8. (Opcional) Modifica el prompt (se admiten inglés y chino)
9. (Opcional) Ajusta el tamaño del video en `WanFunControlToVideo`, evitando dimensiones demasiado grandes
10. Haz clic en el botón `Run` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de video
@@ -216,7 +217,7 @@ Puedes usar [ComfyUI Manager](https://github.com/Comfy-Org/ComfyUI-Manager) para
Gracias a los autores de la comunidad de ComfyUI por sus paquetes de nodos personalizados:
- Este ejemplo usa `Load Video(Upload)` para admitir videos mp4
-- El `video_info` que se obtiene de `Load Video(Upload)` nos permite mantener los mismos `fps` en el video de salida
+- El `video_info` que se obtiene de `Load Video(Upload)` nos permite mantener el mismo `fps` en el video de salida
- Puedes reemplazar `DWPose Estimator` por otros preprocesadores del paquete de nodos `ComfyUI-comfyui_controlnet_aux`
- Los prompts admiten varios idiomas
@@ -224,10 +225,10 @@ Gracias a los autores de la comunidad de ComfyUI por sus paquetes de nodos perso

-- Un consejo útil es que puedes combinar varias técnicas de preprocesamiento de imágenes y luego usar el nodo `Image Blend` para lograr el objetivo de aplicar varios métodos de control al mismo tiempo.
+- Un consejo útil: puedes combinar varias técnicas de preprocesamiento de imágenes y luego usar el nodo `Image Blend` para lograr aplicar varios métodos de control al mismo tiempo.
- Puedes usar el nodo `Video Combine` de `ComfyUI-VideoHelperSuite` para guardar videos en formato mp4
-- Usamos `SaveAnimatedWEBP` porque actualmente no admitimos incrustar el flujo de trabajo en **mp4** y algunos Nodos personalizados también pueden no admitir la incrustación del flujo de trabajo. Para conservar el flujo de trabajo en el video, elegimos el nodo `SaveAnimatedWEBP`.
-- En el nodo `WanFunControlToVideo`, `control_video` no es obligatorio, así que a veces puedes Saltar el uso de un video de control, primero Generar un video de tamaño muy pequeño como 320x320 y luego usarlo como Entrada de video de control para lograr resultados consistentes.
+- Usamos `SaveAnimatedWEBP` porque actualmente no admitimos incrustar el flujo de trabajo en **mp4**, y puede que algunos otros nodos personalizados tampoco admitan incrustar el flujo de trabajo. Para conservar el flujo de trabajo en el video, elegimos el nodo `SaveAnimatedWEBP`.
+- En el nodo `WanFunControlToVideo`, `control_video` no es obligatorio, así que a veces puedes saltarte el uso de un video de control: primero genera un video de tamaño muy pequeño, como 320x320, y luego úsalo como entrada de video de control para lograr resultados consistentes.
- [ComfyUI-WanVideoWrapper](https://github.com/kijai/ComfyUI-WanVideoWrapper)
- [ComfyUI-KJNodes](https://github.com/kijai/ComfyUI-KJNodes)
diff --git a/es/tutorials/video/wan/wan-animate-2.mdx b/es/tutorials/video/wan/wan-animate-2.mdx
index 07a6b5786a..742c6c9994 100644
--- a/es/tutorials/video/wan/wan-animate-2.mdx
+++ b/es/tutorials/video/wan/wan-animate-2.mdx
@@ -2,17 +2,19 @@
title: "Wan Animate 2: transferencia de movimiento"
description: "Anima un personaje estático con Wan Animate 2 en ComfyUI: transfiere el movimiento desde un video guía directamente, sin extracción de poses ni preprocesamiento de esqueleto."
sidebarTitle: "Wan Animate 2"
-translationSourceHash: ae4a191b
+translationSourceHash: 3eded645
translationFrom: tutorials/video/wan/wan-animate-2.mdx
translationBlockHashes:
"_intro": 358b6914
"Model Highlights": ab20a214
+ "Wan Animate 2 workflow": c684e48e
---
+
import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx";
-Wan Animate 2 es un framework de animación de personajes de extremo a extremo del equipo de Wan que consume directamente videos guía en un Diffusion Transformer rediseñado. Logra una generación de movimiento de alta fidelidad y una fuerte preservación de la identidad al eliminar los extractores de movimiento intermedios: no se necesita extracción de pose ni preprocesamiento de esqueletos.
+Wan Animate 2 es un framework de animación de personajes de extremo a extremo del equipo de Wan que consume directamente videos guía en un Diffusion Transformer rediseñado. Logra una generación de movimiento de alta fidelidad y una fuerte preservación de la identidad al eliminar los extractores de movimiento intermedios: no hace falta extraer poses ni preprocesar esqueletos.
-El modelo también añade control de perspectiva impulsado por texto, lo que desacopla la perspectiva de la cámara de salida del video de conducción. Esto te permite animar a un personaje estático usando un video de conducción mientras controlas la cámara de forma independiente, e incluso generar un fondo nuevo a partir de tu prompt de texto.
+El modelo también agrega control del punto de vista impulsado por texto, lo que desacopla la perspectiva de la cámara de salida del video guía. Esto te permite animar a un personaje estático con un video guía mientras controlas la cámara de forma independiente, e incluso generar un fondo nuevo a partir de tu prompt de texto.
@@ -20,13 +22,13 @@ El modelo también añade control de perspectiva impulsado por texto, lo que des
- **Transferencia directa de movimiento**: Anima a un personaje estático a partir de un video guía sin extracción de pose ni preprocesamiento de esqueleto
- **Preservación de la identidad**: Mantiene intactas la identidad, la apariencia y los detalles del personaje de referencia
-- **Control de cámara por texto**: Desacopla la perspectiva de la cámara de salida respecto del video guía
+- **Control de cámara mediante texto**: Desacopla la perspectiva de la cámara de salida con respecto al video guía
- **Fondos nuevos**: Genera un fondo nuevo a partir de tu prompt de texto en lugar de copiar el fondo del video guía
- **Movimiento de alta fidelidad**: Replica movimientos y expresiones complejas del video guía
-## Flujo de trabajo de Wan Animate 2
+## Flujo de trabajo Wan Animate 2
-Anima un personaje estático con un video guía, transfiriendo el movimiento directamente desde los fotogramas del video. La salida conserva la identidad del personaje de referencia y, al mismo tiempo, genera un fondo nuevo y un movimiento de cámara a partir de tu prompt de texto.
+Anima un personaje inmóvil con un video de control, transfiriendo el movimiento directamente desde los fotogramas del video. El resultado conserva la identidad del personaje de referencia mientras genera un fondo nuevo y un movimiento de cámara a partir de tu prompt de texto.
@@ -35,7 +37,7 @@ Anima un personaje estático con un video guía, transfiriendo el movimiento dir
Abrir en Comfy Cloud
- Descarga el JSON o busca "Wan Animate 2" en la Biblioteca de plantillas
+ Descarga el JSON o busca "Wan Animate 2" en la biblioteca de plantillas
@@ -45,38 +47,38 @@ Sube estos archivos a los nodos correspondientes:
- Nodo `LoadImage`: pink_hair_mech_arms_ref.png (el personaje que se va a animar)
+ Nodo `LoadImage`: pink_hair_mech_arms_ref.png (el personaje que vas a animar)
-
+
Nodo `LoadVideo`: street_dance_drive.mp4 (la fuente del movimiento)
-### Descarga de modelos
+### Descargas de modelos
-Este flujo de trabajo usa el modelo de difusión `wan_animate_2_int8_convrot.safetensors`. El repositorio también incluye variantes BF16 y destiladas; si prefieres usarlas, cambia la selección de modelo en el nodo `UNETLoader`. Todos los archivos están disponibles en el repositorio [Comfy-Org/Wan-Animate-2](https://huggingface.co/Comfy-Org/Wan-Animate-2):
+Este flujo de trabajo usa el modelo de difusión `wan_animate_2_int8_convrot.safetensors`. El repositorio también incluye variantes BF16 y destiladas; si prefieres usar esas, cambia la selección de modelo en el nodo `UNETLoader`. Todos los archivos están disponibles en el repositorio [Comfy-Org/Wan-Animate-2](https://huggingface.co/Comfy-Org/Wan-Animate-2):
-
- wan_animate_2_int8_convrot.safetensors: Modelo de difusión cuantizado INT8 convrot que usa este flujo de trabajo
+
+ wan_animate_2_int8_convrot.safetensors: modelo de difusión cuantizado INT8 convrot que usa este flujo de trabajo
- wan_animate_2_bf16.safetensors: Modelo base de precisión completa. Requiere cambiar la selección de modelo en UNETLoader.
+ wan_animate_2_bf16.safetensors: modelo base de precisión completa. Requiere cambiar la selección de modelo en UNETLoader.
-
- wan_animate_2_distill_int8_convrot.safetensors: Variante INT8 destilada. Requiere cambiar la selección de modelo en UNETLoader.
+
+ wan_animate_2_distill_int8_convrot.safetensors: variante INT8 destilada. Requiere cambiar la selección de modelo en UNETLoader.
-
- wan_animate_2_distill_bf16.safetensors: Variante BF16 destilada. Requiere cambiar la selección de modelo en UNETLoader.
+
+ wan_animate_2_distill_bf16.safetensors: variante BF16 destilada. Requiere cambiar la selección de modelo en UNETLoader.
lightx2v_I2V_14B_480p_cfg_step_distill_rank64_bf16.safetensors: LoRA de aceleración LightX2V
- umt5_xxl_fp8_e4m3fn_scaled.safetensors: Codificador de texto UMT5-XXL FP8
+ umt5_xxl_fp8_e4m3fn_scaled.safetensors: codificador de texto UMT5-XXL FP8
- clip_vision_h.safetensors: Codificador CLIP Vision
+ clip_vision_h.safetensors: codificador CLIP Vision
Wan2_1_VAE_bf16.safetensors: VAE de Wan2.1 para codificar y decodificar
@@ -105,20 +107,20 @@ Coloca los archivos en los siguientes directorios:
### Instrucciones del flujo de trabajo
-1. Asegúrate de que todos los modelos se cargan correctamente
+1. Asegúrate de que todos los modelos estén cargados correctamente
2. Sube la imagen de referencia: el personaje de esta imagen es el personaje objetivo que se va a animar
-3. Sube el video guía: su movimiento se transfiere al personaje de referencia
+3. Sube el video de conducción: su movimiento se transfiere al personaje de referencia
4. Actualiza el prompt para describir la escena, el fondo y el movimiento de cámara que quieres
5. Haz clic en `Run` o usa el atajo `Ctrl(cmd) + Enter` para generar el video
### Extender a videos más largos
-Los videos más largos se gestionan dentro del flujo de trabajo: el Subgraph `Motion Transfer (Wan Animate 2)` itera (`StartLoop` / `EndLoop`) y sigue generando hasta cubrir todo el video guía, así que con un solo Subgraph es suficiente. No hay que duplicar ni recablear nada.
+Los videos más largos se manejan dentro del flujo de trabajo: el subgrafo `Motion Transfer (Wan Animate 2)` hace un bucle (`StartLoop` / `EndLoop`) y sigue generando hasta cubrir todo el video de conducción, así que con un solo subgrafo es suficiente. No hay que duplicar ni recablear nada.
-Cada iteración del bucle genera 81 fotogramas, unos 3.4 segundos a 24 fps. Ese es el valor `Int (fragment_length)` dentro del Subgraph. Puedes aumentarlo, pero debe mantenerse en una longitud válida de Wan: 81, 85, 89, etcétera, es decir, `4n + 1`.
+Una iteración del bucle genera 81 fotogramas, unos 3.4 segundos a 24 fps. Ese es el valor de `Int (fragment_length)` dentro del subgrafo. Puedes aumentarlo, pero debe seguir siendo una longitud válida de Wan: 81, 85, 89, etcétera, es decir, `4n + 1`.
-El cálculo del bucle lee el número de fotogramas del video guía, determina cuántas continuaciones hacen falta y recorta el final para que la salida tenga exactamente los mismos fotogramas que el video guía. Cada continuación repite el último fotograma del segmento anterior y ese duplicado se elimina, así que cada segmento adicional añade `fragment_length - 1` fotogramas nuevos.
+El cálculo del bucle lee el número de fotogramas del video de conducción, determina cuántas continuaciones se necesitan y recorta el final para que la salida tenga exactamente la misma cantidad de fotogramas que el video de conducción. Cada continuación repite el último fotograma del segmento anterior y ese duplicado se elimina, así que cada segmento adicional añade `fragment_length - 1` fotogramas nuevos.
-El bucle usa los nodos de bucle del núcleo, así que el flujo de trabajo necesita ComfyUI 0.36.0 o superior.
+El bucle usa los nodos de bucle del núcleo, así que el flujo de trabajo necesita ComfyUI 0.36.0 o una versión más reciente.
-El Subgraph `Video Stitch` es la vista previa comparativa: coloca el video generado junto al video guía. No forma parte de la ruta de extensión.
+El subgrafo `Video Stitch` es la vista previa de comparación: coloca el video generado junto al video de conducción. No forma parte de la ruta de extensión.
diff --git a/es/tutorials/video/wan/wan-causal-forcing.mdx b/es/tutorials/video/wan/wan-causal-forcing.mdx
index 342ce69dae..80e0e5ac4e 100644
--- a/es/tutorials/video/wan/wan-causal-forcing.mdx
+++ b/es/tutorials/video/wan/wan-causal-forcing.mdx
@@ -2,17 +2,19 @@
title: "Causal Forcing en ComfyUI: imagen a video con Wan2.1 en 1 a 4 pasos"
description: "Genera video temporalmente consistente desde una sola imagen en ComfyUI con Causal Forcing o Causal Forcing++ sobre Wan2.1, usando tan solo 1 a 4 pasos."
sidebarTitle: "Causal Forcing I2V"
-translationSourceHash: 4cd31faf
+translationSourceHash: e94bf5dc
translationFrom: tutorials/video/wan/wan-causal-forcing.mdx
translationBlockHashes:
"_intro": 3da76367
"How it works": a3348b35
"Using the workflow": 5e6245a2
"Steps to run": 3202924b
+ "Model downloads": c6ce079e
---
-import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"
-**Causal Forcing** es una técnica de generación de video que aplica **conditioning recurrente** durante la inferencia, en la que cada fotograma generado se devuelve al modelo para predecir el siguiente fotograma. Así se obtienen videos suaves y coherentes en el tiempo a partir de una sola imagen inicial en tan solo **1 a 4 pasos de inferencia**.
+import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx'
+
+**Causal Forcing** es una técnica de generación de video que aplica **acondicionamiento recurrente** durante la inferencia: cada fotograma generado se retroalimenta al modelo para predecir el siguiente fotograma. Así se obtienen videos suaves y coherentes en el tiempo a partir de una sola imagen inicial con tan solo **1 a 4 pasos de inferencia**.
Este flujo de trabajo usa **Wan2.1** y admite tanto el modo **Causal Forcing** (estándar) como **Causal Forcing++** (mejorado).
@@ -33,7 +35,7 @@ Este flujo de trabajo usa **Wan2.1** y admite tanto el modo **Causal Forcing** (
- Imagen de entrada para el primer fotograma. Descárgala y úsala, o reemplázala por una tuya.
+ Imagen de entrada para el primer fotograma. Descarga esta imagen y úsala, o reemplázala con una tuya.
@@ -55,8 +57,8 @@ Este enfoque recurrente crea una **fuerte consistencia temporal**: cada fotogram
| Modo | Descripción |
|---|---|
-| **Causal Forcing** | conditioning recurrente estándar. Buena calidad con 2–4 pasos. |
-| **Causal Forcing++** | Modo mejorado que aplica conditioning adicional para una mejor coherencia temporal. Funciona bien con solo 1–2 pasos. |
+| **Causal Forcing** | Acondicionamiento recurrente estándar. Buena calidad con 2–4 pasos. |
+| **Causal Forcing++** | Modo mejorado que aplica acondicionamiento adicional para una mejor coherencia temporal. Funciona bien con solo 1–2 pasos. |
## Usar el flujo de trabajo
@@ -67,34 +69,34 @@ El flujo de trabajo acepta una sola imagen de entrada (el primer fotograma) y un
| Ajuste | Descripción |
|---|---|
| **first_frame** (requerido) | La imagen inicial del video. Carga un PNG/JPG con el nodo **LoadImage**. |
-| **positive_prompt** (opcional) | Una descripción de texto del contenido de video deseado. Déjalo vacío para no aplicar conditioning. |
-| **duration** (opcional) | El número de fotogramas a generar. Predeterminado: el número de fotogramas de la salida esperada del modelo. |
+| **positive_prompt** (opcional) | Una descripción de texto del contenido de video deseado. Déjalo vacío para no aplicar acondicionamiento. |
+| **duration** (opcional) | El número de fotogramas que se van a generar. Predeterminado: el número de fotogramas de la salida esperada del modelo. |
### Parámetros del subgrafo WAN I2V
-Se exponen como controles en el nodo del subgrafo del plano:
+Estos aparecen como controles en el nodo del subgrafo del plano:
| Parámetro | Predeterminado | Descripción |
|---|---|---|
| `unet_name` | - | El checkpoint del modelo Wan2.1 I2V que se va a usar |
| `clip_name` | - | El modelo CLIP / codificador de texto para el prompt |
-| `vae_name` | - | El modelo VAE para codificar/decodificar |
+| `vae_name` | - | El modelo VAE para codificar y decodificar |
| `width` | - | Ancho del video de salida |
| `height` | - | Alto del video de salida |
-| `noise_seed` | - | Semilla para la reproducibilidad |
+| `noise_seed` | - | Semilla para reproducibilidad |
## Pasos para ejecutar
1. **Carga una imagen**: usa el nodo **LoadImage** para cargar tu fotograma inicial
-2. **Escribe un prompt** (opcional): describe el contenido de video que deseas
+2. **Escribe un prompt** (opcional): describe el contenido de video deseado
3. **Establece la duración**: cuántos fotogramas generar
-4. **Selecciona los modelos**: elige el checkpoint, CLIP y VAE de Wan2.1 I2V
-5. **Elige el modo**: Causal Forcing o Causal Forcing++ (configúralo mediante la configuración interna del subgrafo o una entrada específica de Causal Forcing si está disponible)
+4. **Selecciona los modelos**: elige el checkpoint Wan2.1 I2V, CLIP y VAE
+5. **Elige el modo**: Causal Forcing o Causal Forcing++ (ajústalo con la configuración interna del subgrafo o con una entrada específica de Causal Forcing si está disponible)
6. **Ejecuta**: los fotogramas se generarán de forma secuencial y se guardarán en `ComfyUI/output/`
-## Descarga de modelos
+## Descargas de modelos
-Descarga el modelo Wan2.1 I2V y los archivos necesarios. Colócalos en los subdirectorios correspondientes de `models/`.
+Descarga el modelo Wan2.1 I2V y los archivos requeridos. Colócalos en las subcarpetas correspondientes de `models/`.
### Wan2.1 I2V
@@ -103,7 +105,7 @@ Descarga el modelo Wan2.1 I2V y los archivos necesarios. Colócalos en los subdi
wan2.1_i2v_480p_14B_fp16.safetensors - checkpoint Wan2.1 I2V 14B
- wan2.1_t2v_1.3B_fp16.safetensors - checkpoint Wan2.1 1.3B (8 GB de VRAM como mínimo)
+ wan2.1_t2v_1.3B_fp16.safetensors - checkpoint Wan2.1 1.3B (mínimo 8 GB de VRAM)
@@ -118,7 +120,7 @@ Descarga el modelo Wan2.1 I2V y los archivos necesarios. Colócalos en los subdi
-### Ubicación de almacenamiento de modelos
+### Ubicación de almacenamiento de los modelos
```
📂 ComfyUI/
diff --git a/es/tutorials/video/wan/wan-move.mdx b/es/tutorials/video/wan/wan-move.mdx
index 205659fc86..80c48e62dc 100644
--- a/es/tutorials/video/wan/wan-move.mdx
+++ b/es/tutorials/video/wan/wan-move.mdx
@@ -2,28 +2,30 @@
title: "Ejemplo de flujo de trabajo Wan-Move en ComfyUI"
description: "Genera video con movimiento controlable usando Wan-Move en ComfyUI: guía el movimiento de objetos con trayectorias de puntos para imagen a video."
sidebarTitle: "Wan-Move"
-translationSourceHash: 78cfc130
+translationSourceHash: 6e632abd
translationFrom: tutorials/video/wan/wan-move.mdx
translationBlockHashes:
"_intro": 67a26359
"Wan-Move image-to-video workflow": 78aef00b
+ "Model links": 8e0ef166
---
-import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"
+
+import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx'
**Wan-Move** es un framework de generación de video con control de movimiento desarrollado por Tongyi Lab de Alibaba. Permite controlar el movimiento de los objetos en los videos generados especificando trayectorias de puntos sobre la imagen de entrada, lo que hace que la generación de imagen a video sea más precisa y controlable.
**Características principales**:
- **Control de movimiento en 480p y 5 s de alta calidad**: genera videos de 5 segundos en 480p con una controlabilidad de movimiento de grano fino
-- **Orientación por trayectorias latent**: representa las condiciones de movimiento propagando las características del primer fotograma a lo largo de las trayectorias
+- **Orientación por trayectorias latentes**: representa las condiciones de movimiento propagando las características del primer fotograma a lo largo de las trayectorias
- **Control de grano fino a nivel puntual**: los movimientos de los objetos se representan con trayectorias de puntos densas, lo que permite un control preciso a nivel de región
- **Sin cambios en la arquitectura**: se integra sin problemas en Wan-I2V-14B sin módulos de movimiento adicionales
**Enlaces relacionados**:
- [GitHub](https://github.com/ali-vilab/Wan-Move)
- [Hugging Face](https://huggingface.co/Ruihang/Wan-Move-14B-480P)
-- [Paper](https://arxiv.org/abs/2512.08765)
+- [Artículo](https://arxiv.org/abs/2512.08765)
-## Flujo de trabajo de imagen a video Wan-Move
+## Flujo de trabajo de imagen a video Wan-Move {#wan-move-image-to-video-workflow}
Vista previa del resultado del flujo de trabajo:
@@ -63,7 +65,7 @@ Sube este archivo al nodo `LoadImage` correspondiente:
Colócalo en ComfyUI/models/loras/
-
+
Colócalo en ComfyUI/models/text_encoders/
@@ -74,7 +76,7 @@ Sube este archivo al nodo `LoadImage` correspondiente:
-**Ubicación de almacenamiento de modelos**
+**Ubicación de almacenamiento de los modelos**
```
📂 ComfyUI/
diff --git a/es/tutorials/video/wan/wan2-2-animate.mdx b/es/tutorials/video/wan/wan2-2-animate.mdx
index 655eded00d..c1164ecf96 100644
--- a/es/tutorials/video/wan/wan2-2-animate.mdx
+++ b/es/tutorials/video/wan/wan2-2-animate.mdx
@@ -2,20 +2,22 @@
title: "Flujo de trabajo nativo de ComfyUI para Wan2.2 Animate"
description: "Marco unificado de animación y reemplazo de personajes con replicación precisa de movimiento y expresión."
sidebarTitle: "Wan2.2 Animate"
-translationSourceHash: f66a9a5c
+translationSourceHash: 081a4697
translationFrom: tutorials/video/wan/wan2-2-animate.mdx
translationBlockHashes:
"_intro": 96eb0424
"Model Highlights": fc4e7349
"ComfyOrg Wan2.2 Animate stream replay": a43ba31b
+ "About Wan2.2 Animate workflow": 71233e1e
---
+
import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"
-Wan-Animate es un marco unificado para animar y reemplazar personajes, desarrollado por el equipo de WAN.
+Wan-Animate es un marco unificado para la animación y el reemplazo de personajes, desarrollado por el equipo de WAN.
-El modelo puede animar cualquier personaje a partir del video de un intérprete, replicando con precisión sus expresiones faciales y sus movimientos para generar videos de personajes muy realistas.
+El modelo puede animar cualquier personaje a partir del video de un intérprete, replicando con precisión las expresiones faciales y los movimientos de esa persona para generar videos de personajes muy realistas.
-También puede reemplazar los personajes de un video por personajes animados, conservando sus expresiones y movimientos y replicando la iluminación y el tono de color originales para lograr una integración perfecta con el entorno.
+También puede reemplazar los personajes de un video por personajes animados, conservando sus expresiones y movimientos, y replicando la iluminación y el tono de color originales para lograr una integración perfecta con el entorno.
## Aspectos destacados del modelo
@@ -38,18 +40,18 @@ También puede reemplazar los personajes de un video por personajes animados, co
-## Acerca del flujo de trabajo de Wan2.2 Animate
+## Acerca del flujo de trabajo Wan2.2 Animate
-Este flujo de trabajo admite dos modos: Mix (reemplaza un personaje de un video por el personaje de una imagen de referencia) y Move (anima un personaje usando el movimiento de un video de entrada).
+Este flujo de trabajo admite dos modos: Mix (reemplaza un personaje de un video por un personaje de una imagen de referencia) y Move (anima un personaje usando el movimiento de un video de entrada).
-### Wan2.2 Animate, Character Animation and Replacement {#video_wan2_2_14B_animate}
+### Wan2.2 Animate, animación y reemplazo de personajes {#video_wan2_2_14B_animate}
-Marco unificado de animación y reemplazo de personajes, con replicación precisa del movimiento y de las expresiones.
+Marco unificado de animación y reemplazo de personajes con replicación precisa de movimiento y expresiones.
-
+
-
+
Abrir en Comfy Cloud
@@ -63,10 +65,10 @@ Sube estos archivos a los nodos correspondientes:
- `LoadImage` nodo 10 · `video_wan2_2_14B_animate_reference_image.png`
+ Nodo `LoadImage` 10 · `video_wan2_2_14B_animate_reference_image.png`
- `LoadVideo` nodo 145 · `video_wan2_2_14B_animate_original_video.mp4`
+ Nodo `LoadVideo` 145 · `video_wan2_2_14B_animate_original_video.mp4`
@@ -76,23 +78,23 @@ Sube estos archivos a los nodos correspondientes:
### 2. Enlaces de modelos
-Todos los modelos que se usan en esta guía están [aquí](https://huggingface.co/Comfy-Org/Wan_2.2_ComfyUI_Repackaged/tree/main/split_files).
+Todos los modelos que se usan en esta guía están disponibles [aquí](https://huggingface.co/Comfy-Org/Wan_2.2_ComfyUI_Repackaged/tree/main/split_files).
**Modelos de difusión**
- Wan2_2-Animate-14B_fp8_e4m3fn_scaled_KJ.safetensors: Versión FP8 escalada del repositorio de Kijai
+ Wan2_2-Animate-14B_fp8_e4m3fn_scaled_KJ.safetensors: versión FP8 escalada del repositorio de Kijai
- wan2.2_animate_14B_bf16.safetensors: Pesos originales del modelo en bf16
+ wan2.2_animate_14B_bf16.safetensors: pesos originales del modelo en bf16
**CLIP Vision**
- clip_vision_h.safetensors: Codificador CLIP Vision
+ clip_vision_h.safetensors: codificador CLIP Vision
**LoRAs**
@@ -107,7 +109,7 @@ Todos los modelos que se usan en esta guía están [aquí](https://huggingface.c
**Codificadores de texto**
- umt5_xxl_fp8_e4m3fn_scaled.safetensors: Codificador de texto FP8 escalado
+ umt5_xxl_fp8_e4m3fn_scaled.safetensors: codificador de texto FP8 escalado
```
ComfyUI/
@@ -125,9 +127,9 @@ ComfyUI/
│ └── wan_2.1_vae.safetensors
```
-### 3. Instala los nodos personalizados
+### 3. Instalar nodos personalizados
-Descarga el siguiente archivo de flujo de trabajo y arrástralo a ComfyUI para cargarlo; si tienes instalado [ComfyUI-Manager](https://github.com/Comfy-Org/ComfyUI-Manager), basta con hacer clic en el botón `Install missing nodes` para instalar los nodos que falten.
+Descarga el siguiente archivo de flujo de trabajo y arrástralo a ComfyUI para cargarlo. Si tienes [ComfyUI-Manager](https://github.com/Comfy-Org/ComfyUI-Manager) instalado, puedes hacer clic en el botón `Install missing nodes` para instalar los nodos faltantes.
Necesitamos instalar los siguientes nodos personalizados:
@@ -138,30 +140,30 @@ Si no sabes cómo instalar nodos personalizados, consulta [Cómo instalar nodos
### 4. Instrucciones del flujo de trabajo
-Wan2.2 Animate tiene dos modos: Mix y Move
-- Mix: usa la imagen de referencia para reemplazar el personaje del video
-- Move: usa el movimiento del personaje del video de entrada para animar el personaje de la imagen de referencia (como en Wan2.2 Fun Control)
+Wan2.2 animate tiene dos modos: Mix y Move.
+- Mix: usa la imagen de referencia para reemplazar el personaje del video.
+- Move: usa el movimiento del personaje del video de entrada para animar el personaje de la imagen de referencia (como Wan2.2 Fun Control).
#### 4.1 Modo Mix
-
-
-0. Si es la primera vez que ejecutas este flujo de trabajo, usa un tamaño pequeño para la generación de video, por si no tienes suficiente VRAM para ejecutarlo; además, por la limitación de `WanAnimateToVideo`, el ancho y el alto del video deben ser múltiplos de 16.
-1. Asegúrate de que todos los modelos se cargan correctamente
-2. Actualiza el prompt si quieres
-3. Sube la imagen de referencia: el personaje de esta imagen será el personaje objetivo
-4. La primera vez puedes usar los videos que proporcionamos como videos de entrada; el nodo **DWPose Estimator** de [comfyui_controlnet_aux](https://github.com/Fannovel16/comfyui_controlnet_aux) preprocesará el video de entrada para obtener videos de control de pose y de rostro
-5. El nodo `Points Editor` viene de [KJNodes](https://github.com/kijai/ComfyUI-KJNodes/); por defecto no carga el primer fotograma del video de entrada, así que debes ejecutar el flujo de trabajo una vez o subir el primer fotograma manualmente
- - Debajo del nodo `Points Editor` hemos añadido una nota sobre cómo funciona este nodo y cómo editarlo. Consúltala
-6. El grupo "Video Extend" sirve para ampliar la duración del video de salida
- - Cada `Video Extend` amplía otros 77 fotogramas (alrededor de 4.8125 segundos)
- - Si tu video de entrada dura menos de 5 s, puede que no lo necesites
- - Si quieres ampliar más, tienes que copiar y pegar varias veces y enlazar el `batch_images` del último Video Extend con el siguiente, y también el `video_frame_offset` del último Video Extend con el siguiente
-7. Haz clic en el botón `Run` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación del video
+
+
+0. Si ejecutas este flujo de trabajo por primera vez, usa un tamaño pequeño para generar el video, por si no tienes suficiente VRAM para ejecutar el flujo de trabajo, y debido a la limitación de `WanAnimateToVideo`, el ancho o alto del video debe ser múltiplo de 16.
+1. Asegúrate de que todos los modelos estén cargados correctamente.
+2. Actualiza el prompt si quieres.
+3. Sube la imagen de referencia; el personaje de esta imagen será el personaje objetivo.
+4. La primera vez, puedes usar los videos que proporcionamos como videos de entrada; el nodo **DWPose Estimator** en [comfyui_controlnet_aux](https://github.com/Fannovel16/comfyui_controlnet_aux) preprocesará el video de entrada para obtener videos de control de pose y rostro.
+5. El `Points Editor` es de [KJNodes](https://github.com/kijai/ComfyUI-KJNodes/). Por defecto, este nodo no cargará el primer fotograma del video de entrada; debes ejecutar el flujo de trabajo una vez o subir manualmente el primer fotograma.
+ - Debajo del nodo `Points Editor`, hemos añadido una nota sobre cómo funciona este nodo y cómo editarlo. Consúltala.
+6. El grupo "Video Extend" sirve para extender la duración del video de salida.
+ - Cada `Video Extend` extenderá otros 77 fotogramas (alrededor de 4.8125 segundos).
+ - Si tu video de entrada dura menos de 5 s, es posible que no lo necesites.
+ - Si quieres extenderlo más, debes copiar y pegar varias veces; debes conectar el `batch_images` del último Video Extend al siguiente, y también el `video_frame_offset` del último Video Extend al siguiente.
+7. Haz clic en el botón `Run` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de video.
#### 4.2 Modo Move
-Usamos [Subgraph](/es/interface/features/subgraph) en el flujo de trabajo de Wan2.2 Animate; así es como se cambia al modo Move:
+Usamos un [subgrafo](/es/interface/features/subgraph) en el flujo de trabajo Wan2.2 animate; así puedes cambiar al modo Move:
-
+
Si quieres cambiar al modo Move, puedes desconectar las entradas `background_video` y `character_mask` del nodo `Video Sampling and output(Subgraph)`.
diff --git a/es/tutorials/video/wan/wan2-2-fun-control.mdx b/es/tutorials/video/wan/wan2-2-fun-control.mdx
index 3947252f37..deacaf9e8d 100644
--- a/es/tutorials/video/wan/wan2-2-fun-control.mdx
+++ b/es/tutorials/video/wan/wan2-2-fun-control.mdx
@@ -2,27 +2,29 @@
title: "Wan2.2 Fun Control en ComfyUI: generación de video con control"
description: "Ejecuta el flujo de trabajo Wan2.2 Fun Control 14B en ComfyUI para generar video guiado por un video de control, con modelos de alto y bajo ruido y LoRAs de 4 pasos."
sidebarTitle: "Wan2.2 Fun Control"
-translationSourceHash: 5fe96707
+translationSourceHash: 713ec1d8
translationFrom: tutorials/video/wan/wan2-2-fun-control.mdx
translationBlockHashes:
"_intro": 239e24b6
"ComfyOrg Wan2.2 Fun InP & Control Youtube Live Stream Replay": 22557a2e
+ "Wan2.2 Fun Control Video Generation Workflow Example": 0a502468
---
+
import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"
-**Wan2.2-Fun-Control** es un modelo de generación y control de video de nueva generación lanzado por el equipo de Alibaba PAI. Mediante un innovador mecanismo de Control Codes combinado con aprendizaje profundo y entradas condicionales multimodales, puede generar videos de alta calidad que cumplen con condiciones de control predefinidas. El modelo se publica bajo la **licencia Apache 2.0** y admite uso comercial.
+**Wan2.2-Fun-Control** es un modelo de generación y control de video de nueva generación lanzado por el equipo de Alibaba PAI. Gracias a un innovador mecanismo de Control Codes combinado con aprendizaje profundo y entradas condicionales multimodales, puede generar videos de alta calidad que cumplen con condiciones de control predefinidas. El modelo se publica bajo la **licencia Apache 2.0** y admite uso comercial.
**Características principales**:
- **Control multimodal**: admite varias condiciones de control, como **Canny (arte lineal)**, **Profundidad**, **OpenPose (pose humana)**, **MLSD (bordes geométricos)** y **control de trayectoria**
- **Generación de video de alta calidad**: basado en la arquitectura Wan2.2, produce videos con calidad cinematográfica
- **Compatibilidad con varios idiomas**: admite prompts en varios idiomas, incluidos el chino y el inglés
-A continuación se muestran los pesos del modelo y los repositorios de código relevantes:
+A continuación encontrarás los pesos del modelo y los repositorios de código relevantes:
- [🤗Wan2.2-Fun-A14B-Control](https://huggingface.co/alibaba-pai/Wan2.2-Fun-A14B-Control)
- Repositorio de código: [VideoX-Fun](https://github.com/aigc-apps/VideoX-Fun)
-## Repetición de la transmisión en vivo de Wan2.2 Fun InP y Control de ComfyOrg en YouTube
+## Repetición de la transmisión en vivo de ComfyOrg Wan2.2 Fun InP y Control en YouTube
Este flujo de trabajo ofrece dos versiones:
-1. Una versión con el LoRA de 4 pasos [Wan2.2-Lightning](https://huggingface.co/lightx2v/Wan2.2-Lightning) de lightx2v: puede provocar cierta pérdida de dinamismo en el video, pero ofrece mayor velocidad
-2. Una versión fp8_scaled sin LoRA de aceleración
+1. Una versión que usa el LoRA de 4 pasos [Wan2.2-Lightning](https://huggingface.co/lightx2v/Wan2.2-Lightning) de lightx2v: puede causar cierta pérdida en la dinámica del video, pero ofrece mayor velocidad.
+2. Una versión fp8_scaled sin LoRA de aceleración.
-A continuación se muestran los resultados de las pruebas con una GPU RTX4090D de 24 GB de VRAM a una resolución de 640×640 con 81 fotogramas
+A continuación se muestran los resultados de las pruebas con una GPU RTX4090D de 24GB de VRAM a una resolución de 640×640 con 81 fotogramas.
-| Tipo de modelo | Uso de VRAM | Tiempo de la primera generación | Tiempo de la segunda generación |
-| ------------------------ | ---------- | -------------------- | --------------------- |
-| fp8_scaled | 83% | ≈ 524s | ≈ 520s |
-| fp8_scaled + 4-step LoRA | 89% | ≈ 138s | ≈ 79s |
+| Tipo de modelo | Uso de VRAM | Tiempo de primera generación | Tiempo de segunda generación |
+| ------------------------ | ----------- | ---------------------------- | ---------------------------- |
+| fp8_scaled | 83% | ≈ 524s | ≈ 520s |
+| fp8_scaled + 4-step LoRA | 89% | ≈ 138s | ≈ 79s |
-Como el LoRA de 4 pasos ofrece una mejor experiencia a quienes usan el flujo de trabajo por primera vez, aunque puede provocar cierta pérdida de dinamismo en el video, hemos activado por defecto la versión con LoRA de aceleración. Si quieres activar el otro flujo de trabajo, selecciónalo y usa **Ctrl+B** para habilitarlo.
+Dado que el LoRA de 4 pasos ofrece una mejor experiencia a quienes usan el flujo de trabajo por primera vez, pero puede causar cierta pérdida en la dinámica del video, hemos habilitado la versión con LoRA acelerado de forma predeterminada. Si quieres habilitar el otro flujo de trabajo, selecciónalo y usa **Ctrl+B** para activarlo.
-### 1. Descarga el flujo de trabajo y los materiales
+### 1. Descargar el flujo de trabajo y los materiales
-Actualiza tu ComfyUI a la última versión, luego descarga el archivo del flujo de trabajo y arrástralo a ComfyUI, o busca "Wan2.2 Fun Control" en la Biblioteca de plantillas en `Workflow` → `Browse Templates` → `Video`.
+Actualiza tu ComfyUI a la última versión; luego descarga y arrastra el archivo del flujo de trabajo a ComfyUI, o busca "Wan2.2 Fun Control" en la Biblioteca de plantillas, en `Workflow` → `Browse Templates` → `Video`.
-
+
@@ -70,18 +72,18 @@ Descarga las siguientes imágenes y videos como materiales de entrada.
- Fotograma inicial para la generación del video. Descarga y usa esta imagen, o reemplázala por la tuya.
+ Fotograma inicial para la generación de video. Descarga y usa esta imagen, o reemplázala por una propia.
- Video de control de pose ya preprocesado. Descarga y usa este video, o reemplázalo por el tuyo.
+ Video de control de pose preprocesado. Descarga y usa este video, o reemplázalo por uno propio.
-> Aquí usamos un video ya preprocesado.
+> Aquí usamos un video preprocesado.
### 2. Modelos
-Todos los modelos que se usan en esta guía están [aquí](https://huggingface.co/Comfy-Org/Wan_2.2_ComfyUI_Repackaged/tree/main/split_files).
+Puedes encontrar todos los modelos de esta guía [aquí](https://huggingface.co/Comfy-Org/Wan_2.2_ComfyUI_Repackaged/tree/main/split_files).
**Modelos de difusión**
@@ -97,10 +99,10 @@ Todos los modelos que se usan en esta guía están [aquí](https://huggingface.c
**LoRA Wan2.2-Lightning (opcional, para acelerar)**
-
+
wan2.2_i2v_lightx2v_4steps_lora_v1_high_noise.safetensors: LoRA de aceleración de 4 pasos para alto ruido
-
+
wan2.2_i2v_lightx2v_4steps_lora_v1_low_noise.safetensors: LoRA de aceleración de 4 pasos para bajo ruido
@@ -108,7 +110,7 @@ Todos los modelos que se usan en esta guía están [aquí](https://huggingface.c
**VAE**
- wan_2.1_vae.safetensors: VAE de Wan2.1 para codificar y decodificar
+ wan_2.1_vae.safetensors: VAE de Wan2.1 para codificar/decodificar
**Codificador de texto**
@@ -132,27 +134,27 @@ ComfyUI/
### 3. Guía del flujo de trabajo
-
+
- Este flujo de trabajo usa LoRA. Asegúrate de que el modelo de difusión y el LoRA correspondientes estén emparejados: los modelos y LoRA de alto ruido y de bajo ruido deben usarse de forma correspondiente.
+ Este flujo de trabajo usa LoRA. Asegúrate de que el modelo de difusión y la LoRA correspondientes estén emparejados: los modelos y las LoRA de ruido alto y ruido bajo deben usarse de forma correspondiente.
-1. Carga del modelo de **alto ruido** y del **LoRA**
+1. Carga del modelo de **ruido alto** y de **LoRA**
- Asegúrate de que el nodo `Load Diffusion Model` cargue el modelo `wan2.2_fun_control_high_noise_14B_fp8_scaled.safetensors`
- - Asegúrate de que el nodo `LoraLoaderModelOnly` cargue el `wan2.2_i2v_lightx2v_4steps_lora_v1_high_noise.safetensors`
-2. Carga del modelo de **bajo ruido** y del **LoRA**
+ - Asegúrate de que el nodo `LoraLoaderModelOnly` cargue `wan2.2_i2v_lightx2v_4steps_lora_v1_high_noise.safetensors`
+2. Carga del modelo de **ruido bajo** y de **LoRA**
- Asegúrate de que el nodo `Load Diffusion Model` cargue el modelo `wan2.2_fun_control_low_noise_14B_fp8_scaled.safetensors`
- - Asegúrate de que el nodo `LoraLoaderModelOnly` cargue el `wan2.2_i2v_lightx2v_4steps_lora_v1_low_noise.safetensors`
+ - Asegúrate de que el nodo `LoraLoaderModelOnly` cargue `wan2.2_i2v_lightx2v_4steps_lora_v1_low_noise.safetensors`
3. Asegúrate de que el nodo `Load CLIP` cargue el modelo `umt5_xxl_fp8_e4m3fn_scaled.safetensors`
4. Asegúrate de que el nodo `Load VAE` cargue el modelo `wan_2.1_vae.safetensors`
5. Sube el fotograma inicial en el nodo `Load Image`
-6. En el segundo nodo `Load video`, carga el video de control de pose. El video que se proporciona ya está preprocesado y puedes usarlo directamente
-7. Como proporcionamos un video de pose ya preprocesado, hay que desactivar el nodo de preprocesamiento de imagen de video correspondiente. Puedes seleccionarlo y usar `Ctrl + B` para desactivarlo
+6. En el segundo nodo `Load video`, carga el video de control de pose. El video proporcionado ya está preprocesado y puedes usarlo directamente
+7. Como proporcionamos un video de pose preprocesado, debes desactivar el nodo de preprocesamiento de imágenes de video correspondiente. Puedes seleccionarlo y usar `Ctrl + B` para desactivarlo
8. Modifica el prompt: puedes usar tanto chino como inglés
-9. En `Wan22FunControlToVideo`, modifica las dimensiones del video. Por defecto se usa una resolución de 640×640 para evitar tiempos de procesamiento excesivos en equipos con poca VRAM
-10. Haz clic en el botón `Run`, o usa el atajo `Ctrl(cmd) + Enter`, para ejecutar la generación del video
+9. En `Wan22FunControlToVideo`, modifica las dimensiones del video. El valor predeterminado es una resolución de 640×640 para evitar tiempos de procesamiento excesivos en usuarios con poca VRAM
+10. Haz clic en el botón `Run` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de video
### Notas adicionales
-Como los nodos integrados de ComfyUI solo incluyen el preprocesador Canny, puedes usar herramientas como [ComfyUI-comfyui_controlnet_aux](https://github.com/Fannovel16/comfyui_controlnet_aux) para aplicar otros tipos de preprocesamiento de imagen
+Dado que los nodos integrados de ComfyUI solo incluyen el preprocesador Canny, puedes usar herramientas como [ComfyUI-comfyui_controlnet_aux](https://github.com/Fannovel16/comfyui_controlnet_aux) para implementar otros tipos de preprocesamiento de imagen.
diff --git a/es/tutorials/video/wan/wan2-2-fun-inp.mdx b/es/tutorials/video/wan/wan2-2-fun-inp.mdx
index 8b198033cd..38eda24d2d 100644
--- a/es/tutorials/video/wan/wan2-2-fun-inp.mdx
+++ b/es/tutorials/video/wan/wan2-2-fun-inp.mdx
@@ -2,13 +2,15 @@
title: "Wan2.2 Fun InP en ComfyUI: video con fotograma inicial y final"
description: "Ejecuta el flujo de trabajo Wan2.2 Fun InP 14B en ComfyUI para generar video entre un fotograma inicial y uno final, con modelos de alto y bajo ruido y LoRAs Lightning."
sidebarTitle: "Wan2.2 Fun Inp"
-translationSourceHash: 16cf1b1c
+translationSourceHash: ff570640
translationFrom: tutorials/video/wan/wan2-2-fun-inp.mdx
translationBlockHashes:
"_intro": 7a3595d7
"ComfyOrg Wan2.2 Fun InP & Control Youtube Live Stream Replay": 22557a2e
+ "Wan2.2 Fun Inp Start-End Frame Video Generation Workflow Example": bc339657
---
-import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"
+
+import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx'
**Wan2.2-Fun-Inp** es un modelo de generación de video controlado por fotograma inicial y final, lanzado por el equipo de Alibaba PAI. Permite introducir **imágenes de fotograma inicial y final** para generar videos con la transición intermedia, lo que brinda a los creadores un mayor control creativo. El modelo se publica bajo la **licencia Apache 2.0** y admite uso comercial.
@@ -35,36 +37,36 @@ A continuación encontrarás los pesos del modelo y los repositorios de código
allowFullScreen
>
-## Ejemplo de flujo de trabajo de video con fotograma inicial y final de Wan2.2 Fun Inp
+## Ejemplo de flujo de trabajo de generación de video con fotogramas inicial y final de Wan2.2 Fun Inp
Este flujo de trabajo ofrece dos versiones:
-1. Una versión con el LoRA de 4 pasos [Wan2.2-Lightning](https://huggingface.co/lightx2v/Wan2.2-Lightning) de lightx2v para acelerar la generación de video
+1. Una versión que usa el LoRA de 4 pasos [Wan2.2-Lightning](https://huggingface.co/lightx2v/Wan2.2-Lightning) de lightx2v para acelerar la generación de video
2. Una versión fp8_scaled sin LoRA de aceleración
A continuación se muestran los resultados de las pruebas con una GPU RTX4090D de 24 GB de VRAM a una resolución de 640x640 con 81 fotogramas
-| Tipo de modelo | Uso de VRAM | Tiempo de la primera generación | Tiempo de la segunda generación |
-| ------------------------ | ---------- | -------------------- | --------------------- |
-| fp8_scaled | 83% | ≈ 524s | ≈ 520s |
-| fp8_scaled + 4-step LoRA | 89% | ≈ 138s | ≈ 79s |
+| Tipo de modelo | Uso de VRAM | Tiempo de primera generación | Tiempo de segunda generación |
+| ------------------------ | ----------- | ---------------------------- | ---------------------------- |
+| fp8_scaled | 83% | ≈ 524s | ≈ 520s |
+| fp8_scaled + LoRA de 4 pasos | 89% | ≈ 138s | ≈ 79s |
-Como la aceleración con LoRA es notable, pero se pierde dinamismo en el video, los flujos de trabajo incluidos activan por defecto la versión con LoRA de aceleración. Si quieres activar el otro flujo de trabajo, selecciónalo y usa **Ctrl+B** para habilitarlo.
+Como la aceleración con LoRA es significativa pero se pierde el dinamismo del video, los flujos de trabajo incluidos habilitan la versión con LoRA de aceleración de forma predeterminada. Si quieres habilitar el otro flujo de trabajo, selecciónalo y usa **Ctrl+B** para activarlo.
-### 1. Descarga el archivo del flujo de trabajo
+### 1. Descargar el archivo del flujo de trabajo
Actualiza tu ComfyUI a la última versión y busca "**Wan2.2 Fun Inp**" en el menú `Workflow` -> `Browse Templates` -> `Video` para cargar el flujo de trabajo.
-O bien, después de actualizar ComfyUI a la última versión, descarga el flujo de trabajo de abajo y arrástralo a ComfyUI para cargarlo.
+O bien, después de actualizar ComfyUI a la última versión, descarga el flujo de trabajo que aparece a continuación y arrástralo a ComfyUI para cargarlo.
-
+
Abrir en Comfy Cloud
-
+
Descarga el JSON o busca "Wan2.2 Fun Inp" en la Biblioteca de plantillas
@@ -75,29 +77,29 @@ Usa los siguientes materiales como fotogramas inicial y final
- Fotograma inicial para la generación del video. Descarga y usa esta imagen, o reemplázala por la tuya.
+ Fotograma inicial para la generación de video. Descarga y usa esta imagen, o reemplázala por la tuya.
- Fotograma final para la generación del video. Descarga y usa esta imagen, o reemplázala por la tuya.
+ Fotograma final para la generación de video. Descarga y usa esta imagen, o reemplázala por la tuya.
### 2. Modelos
-Todos los modelos que se usan en esta guía están [aquí](https://huggingface.co/Comfy-Org/Wan_2.2_ComfyUI_Repackaged/tree/main/split_files).
+Puedes encontrar todos los modelos que se usan en esta guía [aquí](https://huggingface.co/Comfy-Org/Wan_2.2_ComfyUI_Repackaged/tree/main/split_files).
**Modelos de difusión**
- wan2.2_fun_inpaint_high_noise_14B_fp8_scaled.safetensors: Modelo de difusión de alto ruido para inpainting entre fotograma inicial y final
+ wan2.2_fun_inpaint_high_noise_14B_fp8_scaled.safetensors: modelo de difusión de alto ruido para inpainting de fotogramas de inicio y fin
- wan2.2_fun_inpaint_low_noise_14B_fp8_scaled.safetensors: Modelo de difusión de bajo ruido para inpainting entre fotograma inicial y final
+ wan2.2_fun_inpaint_low_noise_14B_fp8_scaled.safetensors: modelo de difusión de bajo ruido para inpainting de fotogramas de inicio y fin
-**LoRA Lightning (opcional, para acelerar)**
+**Lightning LoRA (opcional, para acelerar)**
@@ -116,7 +118,7 @@ Todos los modelos que se usan en esta guía están [aquí](https://huggingface.c
**Codificador de texto**
- umt5_xxl_fp8_e4m3fn_scaled.safetensors: Codificador de texto FP8 escalado
+ umt5_xxl_fp8_e4m3fn_scaled.safetensors: codificador de texto FP8 escalado
```
ComfyUI/
@@ -138,20 +140,20 @@ ComfyUI/

- Este flujo de trabajo usa LoRA. Asegúrate de que el modelo de difusión y el LoRA correspondientes estén emparejados.
+ Este flujo de trabajo usa LoRA. Asegúrate de que el modelo de difusión y la LoRA correspondientes sean compatibles.
-1. Carga del modelo de **alto ruido** y del **LoRA**
+1. Carga del modelo de **alto ruido** y de la **LoRA**
- Asegúrate de que el nodo `Load Diffusion Model` cargue el modelo `wan2.2_fun_inpaint_high_noise_14B_fp8_scaled.safetensors`
- - Asegúrate de que el nodo `LoraLoaderModelOnly` cargue el `wan2.2_i2v_lightx2v_4steps_lora_v1_high_noise.safetensors`
-2. Carga del modelo de **bajo ruido** y del **LoRA**
+ - Asegúrate de que el nodo `LoraLoaderModelOnly` cargue `wan2.2_i2v_lightx2v_4steps_lora_v1_high_noise.safetensors`
+2. Carga del modelo de **bajo ruido** y de la **LoRA**
- Asegúrate de que el nodo `Load Diffusion Model` cargue el modelo `wan2.2_fun_inpaint_low_noise_14B_fp8_scaled.safetensors`
- - Asegúrate de que el nodo `LoraLoaderModelOnly` cargue el `wan2.2_i2v_lightx2v_4steps_lora_v1_low_noise.safetensors`
+ - Asegúrate de que el nodo `LoraLoaderModelOnly` cargue `wan2.2_i2v_lightx2v_4steps_lora_v1_low_noise.safetensors`
3. Asegúrate de que el nodo `Load CLIP` cargue el modelo `umt5_xxl_fp8_e4m3fn_scaled.safetensors`
4. Asegúrate de que el nodo `Load VAE` cargue el modelo `wan_2.1_vae.safetensors`
-5. Sube las imágenes de fotograma inicial y final como materiales
-6. Escribe tu prompt en el grupo Prompt
+5. Sube las imágenes del fotograma inicial y final como materiales
+6. Ingresa tu prompt en el grupo Prompt
7. Ajusta el tamaño y la duración del video en el nodo `WanFunInpaintToVideo`
- - Ajusta los parámetros `width` y `height`. El valor predeterminado es `640`. Nosotros hemos definido un tamaño más pequeño, pero puedes modificarlo según lo necesites.
- - Ajusta `length`, que es el número total de fotogramas. Los fps actuales del flujo de trabajo son 16. Por ejemplo, si quieres generar un video de 5 segundos, debes definirlo en 5*16 = 80.
-8. Haz clic en el botón `Run`, o usa el atajo `Ctrl(cmd) + Enter`, para ejecutar la generación del video
+ - Ajusta los parámetros `width` y `height`. El valor predeterminado es `640`. Nosotros usamos un tamaño más pequeño, pero puedes modificarlo según sea necesario.
+ - Ajusta el `length`, que es el número total de fotogramas. El fps del flujo de trabajo actual es 16. Por ejemplo, si quieres generar un video de 5 segundos, debes establecerlo en 5*16 = 80.
+8. Haz clic en el botón `Run`, o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de video
diff --git a/es/tutorials/video/wan/wan2_2.mdx b/es/tutorials/video/wan/wan2_2.mdx
index f86a0dbe4b..ec8f70dbda 100644
--- a/es/tutorials/video/wan/wan2_2.mdx
+++ b/es/tutorials/video/wan/wan2_2.mdx
@@ -2,7 +2,7 @@
title: "Ejemplo de flujo de trabajo nativo oficial de ComfyUI para generación de video con Wan2.2"
description: "Ejecuta flujos de video Wan2.2 en ComfyUI: modelo híbrido TI2V 5B y ejemplos 14B de texto a video, imagen a video y primer/último fotograma, con descargas."
sidebarTitle: Wan2.2
-translationSourceHash: bafc80f0
+translationSourceHash: 49dd13ed
translationFrom: tutorials/video/wan/wan2_2.mdx
translationBlockHashes:
"_intro": 3d02f6d3
@@ -10,11 +10,13 @@ translationBlockHashes:
"Wan2.2 Open Source Model Versions": 7ed2d913
"ComfyOrg Wan2.2 Live Streams": 48f6d6e0
"Wan2.2 TI2V 5B Hybrid Version Workflow Example": 927f40b9
+ "Wan2.2 14B T2V Text-to-Video Workflow Example": 339329e2
"Wan2.2 14B I2V Image-to-Video Workflow Example": c73a3ba4
"Wan2.2 14B FLF2V Workflow Example": 732db33d
"Community Resources": 7463b48b
---
-import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"
+
+import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx'
-Wan 2.2 es un nuevo modelo generativo multimodal de nueva generación lanzado por WAN AI. Este modelo adopta una innovadora arquitectura MoE (Mixture of Experts), compuesta por modelos expertos de alto ruido y de bajo ruido. Puede dividir los modelos expertos según los pasos de eliminación de ruido (timesteps), generando así contenido de video de mayor calidad.
+Wan 2.2 es un modelo generativo multimodal de nueva generación lanzado por WAN AI. Este modelo adopta una innovadora arquitectura MoE (Mixture of Experts), compuesta por modelos expertos de alto ruido y de bajo ruido. Puede dividir los modelos expertos según los pasos de eliminación de ruido (timesteps), generando así contenido de video de mayor calidad.
Wan 2.2 tiene tres características principales: control estético de nivel cinematográfico, que integra profundamente los estándares estéticos de la industria del cine profesional y admite control visual multidimensional como iluminación, color y composición; movimiento complejo a gran escala, que recrea con facilidad diversos movimientos complejos y mejora la fluidez y el control del movimiento; y cumplimiento semántico preciso, que destaca en escenas complejas y en la generación de múltiples objetos, reproduciendo mejor las intenciones creativas del usuario.
El modelo admite varios modos de generación, como texto a video e imagen a video, y es adecuado para la creación de contenido, la creación artística, la educación y la capacitación, entre otros escenarios de aplicación.
@@ -38,13 +40,13 @@ El modelo admite varios modos de generación, como texto a video e imagen a vide
- **Cumplimiento semántico preciso**: Comprensión de escenas complejas, generación de múltiples objetos, mejor restauración de las intenciones creativas
- **Tecnología de compresión eficiente**: Versión 5B con VAE de alta relación de compresión, optimización de memoria, admite entrenamiento mixto
-## Versiones de modelos de código abierto Wan2.2
+## Versiones de los modelos de código abierto Wan2.2
Los modelos de la serie Wan2.2 se basan en la licencia de código abierto Apache 2.0 y admiten el uso comercial. La licencia Apache 2.0 te permite usar, modificar y distribuir estos modelos libremente, incluso con fines comerciales, siempre que conserves el aviso de derechos de autor original y el texto de la licencia.
| Tipo de modelo | Nombre del modelo | Parámetros | Función principal | Repositorio del modelo |
|------------|------------|------------|---------------|-----------------|
-| Modelo híbrido | Wan2.2-TI2V-5B | 5B | Versión híbrida que admite tanto texto a video como imagen a video; un solo modelo cubre dos requisitos centrales de tareas | 🤗 [Wan2.2-TI2V-5B](https://huggingface.co/Wan-AI/Wan2.2-TI2V-5B) |
+| Modelo híbrido | Wan2.2-TI2V-5B | 5B | Versión híbrida que admite tanto texto a video como imagen a video; un solo modelo satisface los requisitos de dos tareas centrales | 🤗 [Wan2.2-TI2V-5B](https://huggingface.co/Wan-AI/Wan2.2-TI2V-5B) |
| Imagen a video | Wan2.2-I2V-A14B | 14B | Convierte imágenes estáticas en videos dinámicos, manteniendo la consistencia del contenido y un proceso dinámico suave | 🤗 [Wan2.2-I2V-A14B](https://huggingface.co/Wan-AI/Wan2.2-I2V-A14B) |
| Texto a video | Wan2.2-T2V-A14B | 14B | Genera videos de alta calidad a partir de descripciones de texto, con control estético de nivel cinematográfico y un cumplimiento semántico preciso | 🤗 [Wan2.2-T2V-A14B](https://huggingface.co/Wan-AI/Wan2.2-T2V-A14B) |
@@ -149,24 +151,24 @@ ComfyUI/
2. Asegúrate de que el nodo `Load CLIP` cargue el modelo `umt5_xxl_fp8_e4m3fn_scaled.safetensors`.
3. Asegúrate de que el nodo `Load VAE` cargue el modelo `wan2.2_vae.safetensors`.
4. (Opcional) Si necesitas generar imagen a video, puedes usar el atajo Ctrl+B para habilitar el nodo `Load image` y subir una imagen.
-5. (Opcional) En el nodo `Wan22ImageToVideoLatent`, puedes ajustar las configuraciones de tamaño y el número total de fotogramas del video (`length`).
+5. (Opcional) En el nodo `Wan22ImageToVideoLatent` puedes ajustar las configuraciones de tamaño y el número total de fotogramas del video (`length`).
6. (Opcional) Si necesitas modificar los prompts (positivo y negativo), hazlo en el nodo `CLIP Text Encoder` del paso 5.
7. Haz clic en el botón `Run` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de video.
-## Ejemplo de flujo de trabajo de texto a video T2V 14B de Wan2.2
+## Ejemplo de flujo de trabajo de texto a video con Wan2.2 14B T2V
-### Wan 2.2 14B de texto a video {#video_wan2_2_14B_t2v}
+### Texto a video con Wan 2.2 14B {#video_wan2_2_14B_t2v}
-Genera videos de alta calidad a partir de prompts de texto con control estético cinematográfico y generación de movimiento dinámico usando Wan 2.2.
+Genera videos de alta calidad a partir de indicaciones de texto con control estético cinematográfico y generación de movimiento dinámico usando Wan 2.2.
-
+
Abrir en Comfy Cloud
- Descarga el JSON o busca "Wan2.2 14B T2V" en la Biblioteca de plantillas
+ Descarga el JSON o busca "Wan2.2 14B T2V" en la biblioteca de plantillas
@@ -213,18 +215,18 @@ ComfyUI/
│ └── wan_2.1_vae.safetensors
```
-### 3. Sigue los pasos
+### 3. Seguir los pasos

1. Asegúrate de que el primer nodo `Load Diffusion Model` cargue el modelo `wan2.2_t2v_high_noise_14B_fp8_scaled.safetensors`.
2. Asegúrate de que el segundo nodo `Load Diffusion Model` cargue el modelo `wan2.2_t2v_low_noise_14B_fp8_scaled.safetensors`.
3. Asegúrate de que el nodo `Load CLIP` cargue el modelo `umt5_xxl_fp8_e4m3fn_scaled.safetensors`.
4. Asegúrate de que el nodo `Load VAE` cargue el modelo `wan_2.1_vae.safetensors`.
-5. (Opcional) En el nodo `EmptyHunyuanLatentVideo`, puedes ajustar las configuraciones de tamaño y el número total de fotogramas del video (`length`).
+5. (Opcional) En el nodo `EmptyHunyuanLatentVideo`, puedes ajustar las configuraciones de tamaño y el número total de fotogramas de video (`length`).
6. (Opcional) Si necesitas modificar los prompts (positivo y negativo), hazlo en el nodo `CLIP Text Encoder` del paso 5.
-7. Haz clic en el botón `Run`, o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de video.
+7. Haz clic en el botón `Run` o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de video.
-## Ejemplo de flujo de trabajo de imagen a video con Wan2.2 14B I2V
+## Ejemplo de flujo de trabajo de imagen a video I2V 14B de Wan2.2
### Wan 2.2 14B de imagen a video {#video_wan2_2_14B_i2v}
@@ -300,7 +302,7 @@ ComfyUI/
│ └───📂 vae/
│ └── wan_2.1_vae.safetensors
```
-### 3. Seguir los pasos
+### 3. Sigue los pasos

1. Asegúrate de que el primer nodo `Load Diffusion Model` cargue el modelo `wan2.2_t2v_high_noise_14B_fp8_scaled.safetensors`.
@@ -310,17 +312,17 @@ ComfyUI/
5. En el nodo `Load Image`, sube la imagen que se usará como fotograma inicial.
6. Si necesitas modificar los prompts (positivo y negativo), hazlo en el nodo `CLIP Text Encoder` del paso 6.
7. (Opcional) En `EmptyHunyuanLatentVideo`, puedes ajustar las configuraciones de tamaño y el número total de fotogramas del video (`length`).
-8. Haz clic en el botón `Run`, o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación del video.
+8. Haz clic en el botón `Run`, o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de video.
## Ejemplo de flujo de trabajo Wan2.2 14B FLF2V
-El flujo de trabajo de primer y último fotograma usa las mismas ubicaciones de modelo que la sección I2V.
+El flujo de trabajo de primer y último fotograma usa las mismas ubicaciones de modelos que la sección I2V.
-### Wan 2.2 14B primer-último fotograma a video {#video_wan2_2_14B_flf2v}
+### Wan 2.2 14B de primer y último fotograma a video {#video_wan2_2_14B_flf2v}
-Genera transiciones de video suaves definiendo los fotogramas inicial y final.
+Genera transiciones de video suaves definiendo los fotogramas de inicio y fin.
-
+
@@ -349,7 +351,7 @@ Sube estos archivos a los nodos `LoadImage` correspondientes:
-### 2. Sigue los pasos
+### 2. Seguir los pasos

@@ -358,8 +360,8 @@ Sube estos archivos a los nodos `LoadImage` correspondientes:
3. Ajusta las configuraciones de tamaño en el nodo `WanFirstLastFrameToVideo`.
- De forma predeterminada, se establece un tamaño relativamente pequeño para evitar que los usuarios con poca VRAM consuman demasiados recursos.
- Si tienes suficiente VRAM, puedes probar una resolución de alrededor de 720P.
-4. Escribe prompts adecuados según tus fotogramas inicial y final.
-5. Haz clic en el botón `Run`, o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación de video.
+4. Escribe los prompts adecuados según tus fotogramas de inicio y fin.
+5. Haz clic en el botón `Run`, o usa el atajo `Ctrl(cmd) + Enter` para ejecutar la generación del video.
## Recursos de la comunidad
diff --git a/es/tutorials/video/zai/scail2.mdx b/es/tutorials/video/zai/scail2.mdx
index 7e398aa607..2f3ecefc49 100644
--- a/es/tutorials/video/zai/scail2.mdx
+++ b/es/tutorials/video/zai/scail2.mdx
@@ -2,7 +2,7 @@
title: "Tutorial del flujo de trabajo de reemplazo de personaje con SCAIL-2 en ComfyUI"
description: "Anima una imagen de personaje de referencia con un video guía o reemplaza al personaje del video usando SCAIL-2."
sidebarTitle: "SCAIL-2"
-translationSourceHash: 2e9bdad8
+translationSourceHash: 2ebe58cb
translationFrom: tutorials/video/zai/scail2.mdx
translationBlockHashes:
"_intro": a41dfa9a
@@ -10,16 +10,18 @@ translationBlockHashes:
"How the Workflow Works": fad0cdce
"Two Modes": 639623de
"Inputs and Parameters": 5762889f
+ "Model Installation": afc8e5d3
---
-import UpdateReminder from "/snippets/es/tutorials/update-reminder.mdx"
-**SCAIL-2** es un modelo de animación de personajes de extremo a extremo construido sobre Wan2.1. Impulsa una imagen de referencia de un personaje con un video de conducción, lo que permite tanto la animación de personajes (hacer que un personaje ejecute el movimiento) como el reemplazo de personajes dentro del video (sustituir a una persona rastreada en un video por el personaje de referencia).
+import UpdateReminder from '/snippets/es/tutorials/update-reminder.mdx'
+
+**SCAIL-2** es un modelo de animación de personajes de extremo a extremo construido sobre Wan2.1. Controla una imagen de referencia de un personaje con un video guía, lo que permite tanto la animación de personajes (hacer que un personaje ejecute el movimiento) como el reemplazo de personajes dentro del video (sustituir a una persona rastreada en un video por el personaje de referencia).
**Características principales**:
-- **Animación de personajes de extremo a extremo**: Impulsa una imagen fija de un personaje con el movimiento de un video de conducción
+- **Animación de personajes de extremo a extremo**: controla una imagen fija de un personaje con el movimiento de un video guía
- **Dos modos**: Modo Animación (el personaje ejecuta el movimiento) y Modo Reemplazo (sustituye la persona rastreada por el personaje de referencia)
-- **Soporte para video largo**: Generación extendida basada en fragmentos con superposición de fotogramas entre segmentos
-- **Nodos integrados de ComfyUI**: Usa `WanSCAILToVideo`, `SCAIL2ColoredMask` y el seguimiento `SAM3` nativos. No se requieren nodos personalizados más allá de las descargas de modelos estándar.
+- **Soporte para video largo**: generación extendida basada en fragmentos con superposición de fotogramas entre segmentos
+- **Nodos integrados de ComfyUI**: usa `WanSCAILToVideo`, `SCAIL2ColoredMask` y el seguimiento `SAM3` nativos. No necesitas nodos personalizados más allá de las descargas de modelos estándar.
**Enlaces relacionados**:
- [Hugging Face: SCAIL-2](https://huggingface.co/zai-org/SCAIL-2)
@@ -96,7 +98,7 @@ Establece el parámetro `replace_mode` en ambos nodos del subgrafo.
| `width` / `height` | Resolución de salida, por ejemplo `896×512`. Debe ser divisible entre 16 |
| `frame_count` | Fotogramas por segmento (predeterminado: 81) |
| `previous_frame_count` | Fotogramas de superposición entre segmentos (predeterminado: 5) |
-| `pose_strength` / `pose_start` / `pose_end` | Intensidad y sincronización del conditioning de pose |
+| `pose_strength` / `pose_start` / `pose_end` | Intensidad y sincronización del acondicionamiento de pose |
### Seguimiento con SAM3 (dos entradas)
@@ -113,9 +115,9 @@ Las entradas `sam3_video_object` y `sam3_image_object` controlan el seguimiento
## Instalación de modelos
-Actualiza ComfyUI a la última versión para tener los nodos integrados WanSCAILToVideo y SCAIL2ColoredMask.
+Actualiza ComfyUI a la última versión antes que nada para contar con los nodos integrados WanSCAILToVideo y SCAIL2ColoredMask.
-### Modelos necesarios
+### Modelos requeridos
**diffusion_models**
- [wan2.1_14B_SCAIL_2_fp16.safetensors](https://huggingface.co/Comfy-Org/SCAIL-2/blob/main/diffusion_models/wan2.1_14B_SCAIL_2_fp16.safetensors)
diff --git a/ja/development/comfy-router/api.mdx b/ja/development/comfy-router/api.mdx
index c6f3fadec0..64274f7267 100644
--- a/ja/development/comfy-router/api.mdx
+++ b/ja/development/comfy-router/api.mdx
@@ -2,7 +2,7 @@
title: "Comfy Router API の概要"
sidebarTitle: "概要"
description: "Comfy Router API の仕組み: モデル ID ごとに 1 つのルート。検出、スキーマ、キュー中のリクエスト、エラー、課金に関するガイドを用意しています。"
-translationSourceHash: dac7e853
+translationSourceHash: cb493feb
translationFrom: development/comfy-router/api.mdx
---
@@ -45,4 +45,5 @@ translationFrom: development/comfy-router/api.mdx
- [クイックスタート](/ja/development/comfy-router/quickstart): インストール、呼び出し、画像の保存。
- [モデル](/ja/development/comfy-router/models): カタログをブラウズし、モデル固有のリクエスト例を確認します。
- [ヘッダー](/ja/development/comfy-router/headers): 認証、冪等性、リクエスト ID、リトライのペース配分。
-- [API リファレンス](/ja/development/comfy-router/reference): エンドポイントのパラメータ、スキーマ、レスポンスコード。
\ No newline at end of file
+- [API リファレンス](/ja/development/comfy-router/reference): エンドポイントのパラメータ、スキーマ、レスポンスコード。
+- [リアルタイム音声](/ja/development/comfy-router/realtime): Grok Voice WebSocket セッションを開きます。課金は秒単位で行われます。
\ No newline at end of file
diff --git a/ja/development/comfy-router/limitations.mdx b/ja/development/comfy-router/limitations.mdx
index e251530d59..382a56f031 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: 235802c5
+translationSourceHash: b4d8209c
translationFrom: development/comfy-router/limitations.mdx
translationBlockHashes:
"_intro": 6b871cf3
@@ -14,7 +14,7 @@ translationBlockHashes:
"Requests are rate limited per caller": 249d4d51
"No progress while a call runs": 75d42d8d
"Comfy charges and usage": cf6e2050
- "Models without a pre-flight estimate": 495bdb2b
+ "Models without a pre-flight estimate": f6dfd921
"Router does not cover every partner operation": 786c0fb2
"Model outputs and stored assets": 06c737c1
"Next": be85b789
@@ -28,6 +28,7 @@ translationBlockHashes:
+
Router はパートナーモデルを、1回の同期 HTTP 呼び出し、または送信して後で結果を取得するキュー中のリクエストを通じて実行します。アプリケーションが完了した結果を待つことができ、あるいは後で結果を取得でき、さらにモデル自身の入力フィールドと出力フィールドを処理できる場合に使用します。
## Router がサポートするもの
@@ -109,28 +110,24 @@ Router は最終レスポンスのみを返し、ストリーミングされる
## 事前見積もりのないモデル
-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/video-edit-v1`, `bfl/video-upscale-v1`, `bfl/vto-v1`
-- **byteplus**: `byteplus/seed-audio-1.0`, `byteplus/seed-audio-1.0-multilingual`
-- **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`
+- **fal**: `fal/fal-seedance-2.0`, `fal/fal-seedance-2.5`
- **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`
-- **meshy**: `meshy/animations`, `meshy/meshy-6`, `meshy/meshy-7`, `meshy/meshy-7.1`, `meshy/remesh`, `meshy/rigging`
+- **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4`
+- **kling**: `kling/kling-image-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync`, `kling/videos-video-extend`
- **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`
- **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`
- **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/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 */}
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 3a23417044..307173d070 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,13 +2,13 @@
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: 9604ca27
+translationSourceHash: 70ec471f
translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx
translationBlockHashes:
"_intro": 54eac94b
"Quick start": ca074ca5
"Serving providers": 74eb2a7c
- "Schema": 6c5da06a
+ "Schema": 8c0478c9
"Examples": 641c458b
---
@@ -16,6 +16,7 @@ translationBlockHashes:
+
{/* 生成済みファイル。router-schemas/byteplus/dreamina-seedance-2-0-260128.json から `pnpm code-pages:gen` によって生成されます。 */}
import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx";
@@ -197,7 +198,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128/reque
### 入力
- 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。結果を取得するには、代わりにタスクステータスのルートをポーリングしてください。
+ 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。結果の取得にはタスクステータスのルートをポーリングしてください。
形式: `uri`
@@ -207,23 +208,23 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128/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: オーディオ(wav、mp3)の公開 URL。
+ オーディオ URL、Base64 エンコーディング、またはアセット ID。
+オーディオ URL: オーディオの公開 URL(wav、mp3)。
Base64: 形式 data:audio/\;base64,\
アセット ID: 形式 asset://\
- Seedance 2.5 のみ。最終ビデオとしてレンダリングするドラフトタスク。コンテンツ項目として唯一のものである必要があります。
-最終ビデオはドラフトタスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用するため、これらを再度送信しないでください。解像度は既定値が 1080p で、1080p のみをサポートします。
+ Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。唯一のコンテンツ項目である必要があります。
+最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。解像度はデフォルトで 1080p となり、1080p のみをサポートします。
- `draft` を true に設定してドラフトビデオを作成したときに返されるタスク ID。
+ Draft ビデオを `draft` を true に設定して作成したときに返されるタスク ID。
@@ -231,8 +232,8 @@ Base64: 形式 data:audio/\;base64,\
- 画像から動画への生成のための画像コンテンツ(type が "image_url" の場合)
-画像 URL: 画像 URL にアクセス可能であることを確認してください。
+ 画像から動画への生成のための画像コンテンツ(type が "image_url" の場合)
+画像 URL: 画像 URL にアクセスできることを確認してください。
Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります
アセット ID: 形式 asset://\
@@ -240,36 +241,44 @@ 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`
+ 指定可能な値: `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 はテキスト長の制限を公開しておらず、テスト(2026-09-17)では 40,000 文字を受け付けました。
-バイト数ではなく文字数をカウントするため、マルチバイトのプロンプトは通信時にこのサイズの数倍になることがあります。これはこの 1 つのフィールドを制限するものであり、リクエスト全体を制限するものではありません。`content` は配列であり、ドキュメント全体を制限するのはリクエストごとの body 制限です。これを適用するのは 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 自身のバリデータが応答します。
+実際のトラフィックよりはるかに高く設定されているため、本物のプロンプトがこれで
+判定されることはありません。呼び出し側がより多くを必要とする場合は引き上げてください。
入力コンテンツの種類
- 指定可能な値: `text`, `image_url`, `video_url`, `audio_url`, `draft_task`
+ 指定可能な値: `text`、`image_url`、`video_url`、`audio_url`、`draft_task`
@@ -278,67 +287,68 @@ Comfy 側のガードレールであり、BytePlus の制約ではありませ
ビデオ URL またはアセット ID。
-ビデオ URL: ビデオ(mp4、mov)の公開 URL。
+ビデオ URL: ビデオの公開 URL(mp4、mov)。
アセット ID: 形式 asset://\
- Seedance 2.5 のみ。480p のドラフトビデオを生成します。解像度は 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.0、2.0 fast、2.0 mini: [4,15] または -1 (自動)。
- 範囲: `2` から `30`
+ 指定可能な値: `-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15`
- タスクのタイムアウトしきい値(秒)。既定値は 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 で拒否します。このスキーマの `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`
+ 指定可能な値: `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.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`
@@ -346,45 +356,45 @@ false: 生成されたビデオの最終フレーム画像を返しません。
処理のサービスティア。Seedance 2.5、2.0 & 2.0 fast は flex(オフライン推論)をサポートしません。
- 取り得る値: `default`, `flex`
+ 指定可能な値: `default`、`flex`
- 生成されたビデオにウォーターマークが含まれるかどうか。
+ 生成されたビデオにウォーターマークを含めるかどうか。
-`GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するのと同じドキュメントです。
+`GET /v2/models/byteplus/dreamina-seedance-2-0-260128/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に 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 自身のものです。Nullable です。BytePlus はタスクの 24 時間後に URL を消去するため、その後でポーリングした succeeded のドキュメントは `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 を保存するのではなくフレームをダウンロードしてください。
- BytePlus が `content` の中にネストして返す場合の、生成されたビデオのコンテナ形式(mp4 または mov)です。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` の寿命とは無関係です。
+ 上流の 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 で、再ホストされた `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 自身の再ホストが消費します。
+ 出力ビデオの 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 を保存するのではなくビデオをダウンロードしてください。
@@ -392,7 +402,7 @@ false: 生成されたビデオの最終フレーム画像を返しません。
- 生成されたビデオの再生時間(秒)。BytePlus がこの点で一貫していないため、整数ではなく数値として宣言されています。ビデオタスクが整数秒を返す一方、BytePlus の関連サーフェスでは小数の再生時間が報告されることが観測されており、クライアントは整数値を前提にしてはいけません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。
+ 生成されたビデオの再生時間(秒)です。BytePlus がこれについて一貫していないため、整数ではなく数値として宣言されています。ビデオタスクが整数の秒を返すことや、同系列の BytePlus の画面が小数の再生時間を報告することが観察されているため、クライアントは整数値を前提にしてはいけません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。
@@ -400,31 +410,27 @@ 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 の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの障害を上書きすることはありません。
エラーメッセージ
-
- ビデオ生成タスクのID
-
-
-
+
タスクで使用されたモデルの名前とバージョン
- 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟として最上位レベルで返されます。Seedanceのビデオタスククエリはここでこの値を返します。BytePlus独自のフィールドで、変更されずにそのまま転送されます。
+ 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここでこの値を返します。BytePlus 独自のフィールドであり、変更されずにそのまま転送されます。
- 生成済みビデオの解像度(例: `1080p`)。BytePlus独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。
+ 生成済みビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドであり、成功したビデオタスクで返され、変更されずにそのまま転送されます。
- タスクで実際に使用された生成シード。BytePlus独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。
+ タスクで実際に使用された生成シード。BytePlus 独自のフィールドであり、成功したビデオタスクで返され、変更されずにそのまま転送されます。
形式: `int64`
@@ -436,7 +442,7 @@ false: 生成されたビデオの最終フレーム画像を返しません。
- タスクが最後に更新された時間。値はUNIXタイムスタンプ(秒単位)です。
+ タスクが最後に更新された時間。値は UNIX タイムスタンプ(秒単位)です。
@@ -448,7 +454,7 @@ false: 生成されたビデオの最終フレーム画像を返しません。
- ビデオ生成モデルでは入力トークン数は計算されず、0が既定値となります。そのため、total_tokens = completion_tokens となります。
+ ビデオ生成モデルでは、入力トークン数は計算されず、0 がデフォルトになります。そのため、total_tokens = completion_tokens となります。
## 例
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 b33007d441..9f23f3146c 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,18 +2,19 @@
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: b02c6ed1
+translationSourceHash: 8036f4db
translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx
translationBlockHashes:
"_intro": e4deed0d
"Quick start": f5201dd4
- "Schema": e03c503a
+ "Schema": 90b60b2e
"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";
@@ -177,12 +178,12 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128/
-## スキーマ
+## Schema
### 入力
- 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。代わりにタスクステータスのルートをポーリングして結果を取得してください。
+ 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。代わりに結果を取得するにはタスクステータスのルートをポーリングしてください。
形式: `uri`
@@ -192,19 +193,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、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 を引き継ぎます。これらを再度送信しないでください。解像度のデフォルトは 1080p のみをサポートします。
@@ -216,117 +217,119 @@ 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。
+画像の場合: 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 は
テキスト長の制限を公開しておらず、テスト(2026-09-17)では 40,000 文字を受け付けました。
-バイト数ではなく文字数をカウントするため、マルチバイトのプロンプトは
-転送時にこのサイズの数倍になる可能性があります。これはこの 1 つのフィールドを制限するものであり、
-リクエスト全体ではありません。`content` は配列であり、リクエストごとのボディ制限が
-ドキュメント全体を制限します。これを適用するのは Comfy Router(/v2/models/byteplus/\{model})です。
-v1 /proxy を直接呼び出す場合は、代わりに BytePlus 自身のバリデータが応答します。
-実際のトラフィックよりはるかに高く設定されているため、正当なプロンプトがこれによって
-判定されることはありません。呼び出し元がより多くを必要とする場合は引き上げてください。
+文字数(バイト数ではない)でカウントするため、マルチバイトのプロンプトは
+送信時にこのサイズの数倍になる可能性があります。これはこの 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 ビデオを生成します。解像度は 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.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。
- 範囲: `2` から `30`
+ 指定可能な値: `-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15`
タスクのタイムアウトしきい値(秒)。デフォルト 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 で拒否します。このスキーマの `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.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 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最後のフレームを次のビデオタスクの最初のフレームとして使用し、複数の連続したビデオを迅速に生成できます。
-false: 生成されたビデオの最後のフレーム画像を返しません。
+ 生成されたビデオの最終フレーム画像を返すかどうか。
+true: 生成されたビデオの最終フレーム画像を返します。このパラメーターを true に設定すると、ビデオ生成タスクの情報を照会する呼び出しによって最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメーターを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最終フレームを次のビデオタスクの先頭フレームとして使用し、複数の連続したビデオを素早く生成できます。
+false: 生成されたビデオの最終フレーム画像を返しません。
@@ -336,7 +339,7 @@ false: 生成されたビデオの最後のフレーム画像を返しません
- 処理のサービスティア。Seedance 2.5、2.0、2.0 fast は flex(オフライン推論)をサポートしません。
+ 処理のサービスティア。Seedance 2.5、2.0 & 2.0 fast は flex (オフライン推論) をサポートしません。
指定可能な値: `default`、`flex`
@@ -345,46 +348,46 @@ false: 生成されたビデオの最後のフレーム画像を返しません
生成されたビデオにウォーターマークを含めるかどうか。
-Router が `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証するのと同じドキュメントです。
+`GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.json` で Router が配信するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用する同じドキュメントです。
### 出力
- ビデオ生成タスクの完了後の出力です。出力ビデオのダウンロード URL と、BytePlus が返す場合はその最終フレームのダウンロード URL を含みます。`video_url` と `last_frame_url` はどちらも Comfy のストレージへ再ホスト(RE-HOST)されます。ここにある他のフィールドはすべて BytePlus 自身のものです。Nullable: 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` の寿命とは無関係です。
+ 上流 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` の寿命とは無関係です。
- Format: `date-time`
+ 形式: `date-time`
- 最終フレームの BytePlus 自身のダウンロード URL で、再ホストされた `last_frame_url` の隣にバイト単位でそのまま返されます。条件は `upstream_video_url` と同じです。オプトインしたワークスペースのみ、Seedance 2.x のみ、BytePlus がクリアすると存在しなくなり、`upstream_expires_at` まではベアラー資格情報です。
+ 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 回に制限しており、そのうち 1 回は Router 自身の再ホストが消費します。
+ 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 がこれについて一貫していないためで、ビデオタスクが整数秒を返す一方、同様の BytePlus のサーフェスが小数の再生時間を報告することが観測されています。したがってクライアントは整数値を仮定してはなりません。BytePlus 自身のフィールドで、成功したビデオタスクで返され、そのまま転送されます。
@@ -392,15 +395,14 @@ Router が `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.js
- 上流の 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
+ビデオ生成タスクの ID
@@ -408,15 +410,15 @@ Router が `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.js
- 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedanceのビデオタスククエリはここに返します。BytePlus独自のフィールドで、変更されずにそのまま転送されます。
+ 生成されたビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここでこの値を返します。BytePlus 独自のフィールドであり、変更されずにそのまま転送されます。
- 生成済みビデオの解像度(例: `1080p`)。BytePlus独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。
+ 生成されたビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドであり、成功したビデオタスクで返され、変更されずにそのまま転送されます。
- タスクで実際に使用された生成シード。BytePlus独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。
+ タスクで実際に使用された生成シード。BytePlus 独自のフィールドであり、成功したビデオタスクで返され、変更されずにそのまま転送されます。
形式: `int64`
@@ -424,11 +426,11 @@ Router が `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.js
タスクの状態
- 指定可能な値: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired`
+ 指定可能な値: `queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired`
- タスクが最後に更新された時間。値は秒単位のUNIXタイムスタンプです。
+ タスクが最後に更新された時間。値は秒単位の UNIX タイムスタンプです。
@@ -440,7 +442,7 @@ Router が `GET /v2/models/byteplus/dreamina-seedance-2-0-fast-260128/openapi.js
- ビデオ生成モデルでは、入力トークン数は計算されず、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 1fc770ca00..e46e68f430 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,18 +2,19 @@
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: 28c5c053
+translationSourceHash: a1d75c67
translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx
translationBlockHashes:
"_intro": 45ff5bfd
"Quick start": b0374f7d
- "Schema": 3c26a330
+ "Schema": ebf1fc3a
"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";
@@ -182,7 +183,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-mini/request
### 入力
- 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。結果を取得するには、代わりにタスクステータス取得ルートをポーリングしてください。
+ 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクの送信前に削除されるため、コールバックが送信されることはありません。結果はタスクステータスのルートをポーリングして取得してください。
形式: `uri`
@@ -192,23 +193,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: オーディオの公開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 で、1080p のみをサポートします。
- Draft ビデオを `draft` を true に設定して作成したときに返されたタスク ID。
+ `draft` を true に設定して Draft ビデオを作成したときに返されるタスク ID。
@@ -217,9 +218,9 @@ Base64: 形式 data:audio/\;base64,\
画像から動画への生成に使用する画像コンテンツ(type が "image_url" の場合)
-画像URL: 画像URLにアクセス可能であることを確認してください。
-Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります
-アセット ID: 形式 asset://\
+画像 URL: 画像 URL にアクセスできることを確認してください。
+Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります。
+アセット ID: 形式は asset://\
@@ -228,7 +229,7 @@ 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`
@@ -236,7 +237,7 @@ 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)
@@ -249,90 +250,91 @@ Base64 エンコードされたコンテンツ: 形式は data:image/\;b
Comfy 側のガードレールであり、BytePlus の制約ではありません。BytePlus は
テキスト長の制限を公開しておらず、テスト(2026-09-17)では 40,000 文字を
-受け付けました。バイト数ではなく文字数をカウントするため、マルチバイトの
-プロンプトは通信時にこのサイズの数倍になることがあります。これはこの 1 つの
+受け付けました。カウント対象はバイト数ではなく文字数であるため、マルチバイトの
+プロンプトは通信時にこの数倍のサイズになることがあります。これはこの 1 つの
フィールドを制限するものであり、リクエスト全体を制限するものではありません:
`content` は配列であり、ドキュメント全体を制限するのはリクエストごとの
ボディ上限です。これを適用するのは Comfy Router(/v2/models/byteplus/\{model})
-であり、v1 /proxy への直接呼び出しでは BytePlus 自身のバリデータが代わりに
-応答します。実際のトラフィックよりはるかに高く設定されているため、正規の
-プロンプトがこれによって判断されることはありません。呼び出し元がより多くを
-必要とする場合は引き上げてください。
+であり、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://\
+ ビデオ URL またはアセット ID。
+ビデオ URL: ビデオの公開 URL(mp4、mov)。
+アセット ID: 形式は asset://\
Seedance 2.5 のみ。480p の Draft ビデオを生成します。解像度は 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 プロ: [4,12] または -1。Seedance 1.0: [2,12]。
+
+ ビデオの再生時間(秒)。Seedance 2.0、2.0 fast、2.0 mini: [4,15] または -1(自動)。
- 範囲: `2` 〜 `30`
+ 指定可能な値: `-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15`
- タスクのタイムアウトしきい値(秒)。デフォルト 172800(48 時間)。範囲: [3600, 259200]。
+ タスクのタイムアウトしきい値(秒)。デフォルトは 172800(48 時間)。範囲: [3600, 259200]。
範囲: `3600` 〜 `259200`
- Seedance 2.5、2.0、2.0 fast、2.0 mini、1.5 プロでサポートされています。生成されるビデオに映像と同期したオーディオを含めるかどうか。
+ 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 で拒否します。Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントから設定するため、このスキーマの `required` リストには含まれていません。そのため 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`
+ 指定可能な値: `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.0、2.0 fast & 2.0 mini は 1080p をサポートしません。Seedance 2.5 は 480p、720p、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 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークも含まれません。このパラメーターを使用すると、複数の連続したビデオを生成できます。先に生成したビデオの最終フレームを次のビデオタスクの先頭フレームとして使用することで、複数の連続したビデオを素早く生成できます。
+true: 生成されたビデオの最終フレーム画像を返します。このパラメータを true に設定すると、ビデオ生成タスクの情報の照会を呼び出すことで最終フレーム画像を取得できます。最終フレーム画像は PNG 形式で、ピクセル単位の幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。前に生成したビデオの最終フレームを次のビデオタスクの先頭フレームとして使用することで、複数の連続したビデオをすばやく生成できます。
false: 生成されたビデオの最終フレーム画像を返しません。
- ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 を指定するとランダムなシードを使用します。
+ ランダム性を制御するシード整数。範囲: [-1, 2^32-1]。-1 はランダムシードを使用します。
範囲: `-1` から `4294967295`
@@ -340,61 +342,61 @@ false: 生成されたビデオの最終フレーム画像を返しません。
処理のサービスティア。Seedance 2.5、2.0 & 2.0 fast は flex(オフライン推論)をサポートしません。
- 指定可能な値: `default`, `flex`
+ 指定可能な値: `default`、`flex`
- 生成されたビデオにウォーターマークを含めるかどうか。
+ 生成されたビデオにウォーターマークが含まれるかどうか。
-`GET /v2/models/byteplus/dreamina-seedance-2-0-mini/openapi.json` で Router が提供するスキーマから生成されたもので、リクエストがプロバイダーに届く前に Router が呼び出しを検証する際に使用するのと同じドキュメントです。
+`GET /v2/models/byteplus/dreamina-seedance-2-0-mini/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` の有効期間とは無関係です。
+ 上流の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で、再ホストされた `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自身の再ホストが消費します。
+ 出力ビデオの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時間のものが返ることがあります。再ホストを実行できなかった場合、このフィールドは代わりに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のようなドット区切りの理由が付く場合があります。これは列挙型ではなくオープンな文字列です。他のコードは検証とプロバイダーの失敗を説明します。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の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。
@@ -402,7 +404,7 @@ false: 生成されたビデオの最終フレーム画像を返しません。
- ビデオ生成タスクのID
+ 動画生成タスクの ID
@@ -410,15 +412,15 @@ false: 生成されたビデオの最終フレーム画像を返しません。
- 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟として最上位レベルで返されます。Seedance のビデオタスククエリはここでこの値を返します。BytePlus 独自のフィールドであり、変更されずにそのまま転送されます。
+ 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここでこの値を返します。BytePlus 独自のフィールドで、変更されずにそのまま転送されます。
- 生成済みビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドであり、成功したビデオタスクで返され、変更されずにそのまま転送されます。
+ 生成済みビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。
- タスクで実際に使用された生成シード。BytePlus 独自のフィールドであり、成功したビデオタスクで返され、変更されずにそのまま転送されます。
+ タスクで実際に使用された生成シード。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。
形式: `int64`
@@ -426,11 +428,11 @@ false: 生成されたビデオの最終フレーム画像を返しません。
タスクの状態
- 指定可能な値: `queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired`
+ 取り得る値: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired`
- タスクが最後に更新された日時。値は秒単位の UNIX タイムスタンプです。
+ タスクが最後に更新された時間。値は UNIX タイムスタンプ(秒)です。
@@ -442,7 +444,7 @@ false: 生成されたビデオの最終フレーム画像を返しません。
- ビデオ生成モデルでは入力トークン数は計算されず、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 32aea062d4..311f748975 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,19 +2,20 @@
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: 07fd9c64
+translationSourceHash: 3606fb83
translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx
translationBlockHashes:
"_intro": 4b5f4cec
"Quick start": a2bb8c28
"Serving providers": 197dd61a
- "Schema": 0a76af44
+ "Schema": d2c28a84
"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";
@@ -195,7 +196,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque
### 入力
- 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックは一切送信されません。結果を取得するには、代わりにタスクステータスルートをポーリングしてください。
+ 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックは送信されません。代わりにタスクステータスルートをポーリングして結果を取得してください。
形式: `uri`
@@ -205,23 +206,23 @@ 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://\
- Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。唯一のコンテンツ項目である必要があります。
-最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。再度送信しないでください。解像度はデフォルトで 1080p になり、1080p のみをサポートします。
+ Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスクです。これは唯一のコンテンツ項目である必要があります。
+最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。解像度はデフォルトで 1080p になり、1080p のみをサポートします。
- Draft ビデオを `draft` を true に設定して作成したときに返されるタスク ID。
+ `draft` を true に設定して Draft ビデオを作成したときに返されるタスク ID。
@@ -231,7 +232,7 @@ Base64: 形式 data:audio/\;base64,\
画像から動画への生成用の画像コンテンツ(type が "image_url" の場合)
画像 URL: 画像 URL にアクセスできることを確認してください。
-Base64 エンコーディングされたコンテンツ: 形式は data:image/\;base64,\ である必要があります
+Base64 エンコードされたコンテンツ: 形式は data:image/\;base64,\ である必要があります
アセット ID: 形式 asset://\
@@ -241,44 +242,36 @@ Base64 エンコーディングされたコンテンツ: 形式は data: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 自身の
-バリデータが応答します。実際のトラフィックをはるかに上回る値に設定されているため、
-本物のプロンプトが拒否されることはありません。呼び出し元がより多くを必要とする場合は引き上げてください。
+Comfy 側のガードレールであり、BytePlus の制約ではありません。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 のみがサポートします。
@@ -292,10 +285,10 @@ Comfy 側のガードレールであり、BytePlus の制約ではありませ
返されたタスク 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(自動)。
- 範囲: `2` から `30`
+ 取り得る値: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20`, `21`, `22`, `23`, `24`, `25`, `26`, `27`, `28`, `29`, `30`
@@ -305,40 +298,41 @@ Comfy 側のガードレールであり、BytePlus の制約ではありませ
- 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.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: 生成されたビデオの最終フレーム画像を返しません。
@@ -349,71 +343,71 @@ false: 生成されたビデオの最終フレーム画像を返しません。
- 処理のサービスティア。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/dreamina-seedance-2-5-260628/openapi.json` で提供するスキーマから生成されており、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するのと同じドキュメントです。
+Router が `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/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時間程度のものが返されることがあります。再ホストを実行できなかった場合は、代わりに 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を保存するのではなくフレームをダウンロードしてください。
- BytePlus が `content` の中に入れ子にしている場合の、生成されたビデオのコンテナ形式(mp4 または mov)です。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` の寿命とは無関係です。
+ 上流のURLが機能しなくなるRFC 3339時刻です。URL自体が持つ署名時刻と有効期間のうち最も早いもの、または `updated_at` が存在する場合はタスクの `updated_at` に24時間(BytePlusが文書化しているURLの寿命)を加えた時刻のいずれか早い方です。`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です。再ホストされた `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 自身の再ホストで消費されます。
+ 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時間程度のものが返されることがあります。再ホストを実行できなかった場合は、代わりに 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の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。
エラーメッセージ
-
- ビデオ生成タスクの ID
+
+ ビデオ生成タスクのID
@@ -421,15 +415,15 @@ 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`
@@ -441,7 +435,7 @@ Router が `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/openapi.json`
- タスクが最後に更新された時間。値は秒単位の UNIX タイムスタンプです。
+ タスクが最後に更新された時間。値は UNIX タイムスタンプ(秒単位)です。
@@ -453,7 +447,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 89d9be1b9f..f153a548cb 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,18 +2,19 @@
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: 450bbe6e
+translationSourceHash: 642f85ab
translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx
translationBlockHashes:
"_intro": e1a3501d
"Quick start": c762675f
- "Schema": fc979e05
+ "Schema": b57b84de
"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";
@@ -182,7 +183,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528/requests/$
### 入力
- 無視されます。BytePlusのリクエスト形状との互換性のために受け付けられますが、タスクの送信前に削除されるため、コールバックが送信されることはありません。結果はタスクステータスのルートをポーリングして取得してください。
+ 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。代わりに結果を取得するには、タスクステータスルートをポーリングしてください。
形式: `uri`
@@ -192,23 +193,23 @@ 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: オーディオ(wav、mp3)の公開URL。
+ オーディオURL、Base64 エンコード、またはアセット ID。
+オーディオURL: オーディオの公開 URL(wav、mp3)。
Base64: 形式 data:audio/\;base64,\
-アセットID: 形式 asset://\
+アセット ID: 形式 asset://\
- Seedance 2.5 のみ。最終ビデオとしてレンダリングするドラフトタスク。唯一のコンテンツ項目である必要があります。
-最終ビデオはドラフトタスクのプロンプト、入力アセット、再生時間、比率、シード、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。
@@ -216,15 +217,15 @@ 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。
+画像の場合: 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 のみ)。
@@ -234,28 +235,20 @@ Base64エンコードされたコンテンツ: 形式は data:image/\;ba
モデルへの入力テキスト情報。テキストプロンプトと任意のパラメータを含みます。
-テキストプロンプト(必須): 中国語および英語の文字を使用した、生成するビデオの説明。
+テキストプロンプト(必須): 生成するビデオの説明を中国語と英語の文字で記述します。
-パラメータ(任意): テキストプロンプトの後に --[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 自身のバリデータが
-代わりに応答します。実際のトラフィックよりはるかに高く設定されているため、正当なプロンプトを
-判定することはありません。呼び出し元がより多くを必要とする場合は引き上げてください。
+Comfy 側のガードレールであり、BytePlus の制約ではありません。BytePlus はテキスト長の制限を公表しておらず、テスト(2026-09-17)では 40,000 文字を受け付けました。文字数でカウントし、バイト数ではないため、マルチバイトのプロンプトは通信時にこのサイズの数倍になる可能性があります。これはこの 1 つのフィールドを制限するものであり、リクエストを制限するものではありません。`content` は配列であり、ドキュメント全体を制限するのはリクエストごとの body 制限です。これを適用するのは Comfy Router(/v2/models/byteplus/\{model})です。直接の v1 /proxy 呼び出しでは、代わりに BytePlus 自身のバリデータが応答します。実際のトラフィックをはるかに上回る値に設定されているため、正当なプロンプトを判定することはありません。呼び出し元がより多くを必要とする場合は引き上げてください。
@@ -265,134 +258,135 @@ 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: ビデオ(mp4、mov)の公開URL。
-アセットID: 形式 asset://\
+ ビデオ URL またはアセット ID。
+ビデオ URL: ビデオの公開 URL(mp4、mov)。
+アセット 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 1.0 pro と 1.0 pro fast: [2,12]。
- 範囲: `2` 〜 `30`
+ 指定可能な値: `2`、`3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`
- タスクのタイムアウトしきい値(秒)。デフォルト 172800(48時間)。範囲: [3600, 259200]。
+ タスクのタイムアウトしきい値(秒)。デフォルトは 172800(48h)。範囲: [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 で拒否します。このスキーマの `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.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 形式で、ピクセル幅と高さは生成されたビデオと一致し、ウォーターマークは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。先に生成されたビデオの最終フレームが次のビデオタスクの先頭フレームとして使用され、複数の連続したビデオをすばやく生成できます。
-false: 生成されたビデオの最終フレーム画像を返しません。
+ 生成されたビデオの最後のフレーム画像を返すかどうか。
+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`
- 生成されたビデオにウォーターマークを含めるかどうか。
+ 生成されたビデオにウォーターマークが含まれるかどうか。
-Router が `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` で提供するスキーマから生成されており、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するのと同じドキュメントです。
+Router が `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する対象となる同じドキュメントです。
### 出力
- ビデオ生成タスクの完了後の出力。出力ビデオのダウンロード 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独自のものです。nullable: BytePlusはタスクの24時間後にURLを消去するため、その後でポーリングした成功済みドキュメントでは `content` が存在しないかnullであることがあります。
- `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 を保存するのではなくフレームをダウンロードしてください。
+ 生成されたビデオの最終フレームのダウンロード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を保存するのではなくフレームをダウンロードしてください。
- BytePlus が `content` 内にネストして返す場合の、生成されたビデオのコンテナ形式(mp4 または mov)。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` の寿命とは無関係です。
+ 上流の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で、再ホストされた `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 自身の再ホストで消費されます。
+ 出力ビデオに対する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 時間しかないものが返ることがあります。再ホストを実行できなかった場合、このフィールドは代わりに 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 のようにドット区切りの理由が付くことがあります。これは列挙型ではなくオープンな文字列です。他のコードは検証やプロバイダーの失敗を表します。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の失敗タスク応答の両方でポリシーファミリーを認識しますが、トランスポート層の失敗を上書きすることはありません。
@@ -400,7 +394,7 @@ Router が `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` で提
- The ID of the video generation task
+ 動画生成タスクの ID
@@ -408,15 +402,15 @@ Router が `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` で提
- 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここで返します。BytePlus 自身のフィールドで、変更されずにそのまま転送されます。
+ 生成された動画のコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance の動画タスク照会が返す位置です。BytePlus 自身のフィールドで、変更されずに転送されます。
- 生成済みビデオの解像度。例えば `1080p` です。BytePlus 自身のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。
+ 生成された動画の解像度(例: `1080p`)。BytePlus 自身のフィールドで、成功した動画タスクで返され、変更されずに転送されます。
- タスクで実際に使用された生成シード。BytePlus 自身のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。
+ タスクで実際に使用された生成シード。BytePlus 自身のフィールドで、成功した動画タスクで返され、変更されずに転送されます。
形式: `int64`
@@ -424,11 +418,11 @@ Router が `GET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json` で提
タスクの状態
- 取りうる値: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired`
+ 指定可能な値: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired`
- タスクが最後に更新された時間。値は秒単位の UNIX タイムスタンプです。
+ タスクが最後に更新された時刻。値は UNIX タイムスタンプ(秒)です。
@@ -436,11 +430,11 @@ 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 0d3cd6f3c6..f8da5ea68f 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,18 +2,19 @@
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: 43683424
+translationSourceHash: 61dd0135
translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx
translationBlockHashes:
"_intro": 451ffa4b
"Quick start": ec2a21ac
- "Schema": a882b2d8
+ "Schema": dd74b012
"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";
@@ -182,7 +183,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-fast-251015/reque
### 入力
- 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。結果は代わりにタスクステータスのルートをポーリングして取得してください。
+ 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。代わりに結果はタスクステータスのルートをポーリングして取得してください。
形式: `uri`
@@ -192,19 +193,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://\
+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 を再利用するため、これらを再度送信しないでください。resolution はデフォルトで 1080p となり、1080p のみをサポートします。
@@ -216,10 +217,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://\
@@ -228,15 +229,15 @@ 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] を追加してビデオの仕様を制御します:
+パラメータ(任意): テキストプロンプトの後に --[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)
@@ -248,22 +249,22 @@ Base64 エンコードされたコンテンツ: 形式は data:image/\;b
例: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5"
Comfy 側のガードレールであり、BytePlus の制約ではありません。BytePlus は
-テキスト長の制限を公開しておらず、テスト(2026-09-17)では 40,000 文字を
+テキスト長の上限を公開しておらず、テスト(2026-09-17)では 40,000 文字を
受け付けました。バイト数ではなく文字数をカウントするため、マルチバイトの
-プロンプトはワイヤ上でこのサイズの数倍になる可能性があります。これはこの
-1 つのフィールドを制限するものであり、リクエスト全体ではありません。
+プロンプトは通信時にこのサイズの数倍になることがあります。これはこの 1 つの
+フィールドを制限するものであり、リクエストを制限するものではありません:
`content` は配列であり、リクエスト全体のドキュメントを制限するのは
-リクエストごとのボディ制限です。これを適用するのは Comfy Router
-(/v2/models/byteplus/\{model})であり、v1 /proxy を直接呼び出した場合は
+リクエストごとのボディ上限です。これを強制するのは 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`
@@ -273,136 +274,136 @@ BytePlus 自身のバリデータが応答します。実際のトラフィッ
ビデオ URL またはアセット ID。
ビデオ URL: ビデオの公開 URL(mp4、mov)。
-アセット ID: 形式 asset://\
+アセット ID: 形式は asset://\
- Seedance 2.5 のみ。480p の Draft ビデオを生成します。解像度は 480p である必要があります。
+ 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 1.0 pro および 1.0 pro fast: [2,12]。
- 範囲: `2` から `30`
+ 指定可能な値: `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`
- タスクのタイムアウトしきい値(秒)。デフォルト 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` を継承するため、代わりに `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)で、色精度が高く、ポストプロダクションに適しています。ファイルサイズは大きくなります。
+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`
- 生成されたビデオにウォーターマークが含まれるかどうか。
+ 生成されたビデオにウォーターマークを含めるかどうか。
-`GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用する同じドキュメントです。
+Generated from the schema Router serves at `GET /v2/models/byteplus/seedance-1-0-pro-fast-251015/openapi.json`, the same document it validates a call against before the request reaches the provider.
### 出力
- ビデオ生成タスクが完了した後の出力で、出力ビデオのダウンロード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として文書化しているが、ルーターは提供されたバイト列をそのまま再ホストし、上流のContent-Typeまたはコンテンツスニッフィングから型を判定する。`image/jpeg` は両方が失敗した場合の最後の手段のフォールバックにすぎない。ルーターは最終フレームを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` フィールドを参照)。ルーターは存在する方のフィールドを読み取る。
- 上流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` の寿命とは無関係です。
+ 上流の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。再ホストされた `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自身の再ホストで消費されます。
+ BytePlus自身の出力ビデオのダウンロードURL。再ホストされた `video_url` の隣にバイト単位でそのまま返される。Comfyがサーバー側でオプトインしたワークスペースがポーリングするSeedance 2.xのタスクに対してのみ存在する(リクエストパラメータはない)。それ以外のすべての場合には存在せず、ワークスペースに解決されない資格情報(ワークスペースにスコープされていないレガシーAPIキーなど)でも存在せず、またBytePlusが生成から24時間後にURLをクリアした後も存在しない。これは署名付きオブジェクトストレージのURLであるためベアラー資格情報であり、それを保持する誰もが有効期限までビデオをダウンロードできるので、シークレットと同様に扱うこと。有効期限は `upstream_expires_at` であり、Seedance 2.5 ではBytePlusがダウンロード回数を100回に制限しており、そのうち1回はルーター自身の再ホストで消費される。
- 出力ビデオのダウンロードURL。RouterはビデオをComfyのストレージへ再ホストしてこのフィールドを書き換えるため、通常は最大24時間有効なComfy署名付きURLになります。発行時に24時間で署名され、23時間のメモから再送されるため、後のポーリングでは残り1時間しかないURLが返ることがあります。再ホストを実行できなかった場合、このフィールドは代わりにBytePlus独自のURLを保持し、BytePlusはタスクの24時間後にそれを消去し、一部のモデルではダウンロード回数を100回に制限します。いずれの場合もリンクは期限切れになるため、URLを保存するのではなくビデオをダウンロードしてください。
+ 出力ビデオのダウンロードURL。ルーターはビデオを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 などです。これは列挙型ではなくオープンな文字列で、他のコードは検証やプロバイダーの失敗を表します。RouterはHTTP 400のエラーエンベロープとHTTP 200の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。
+ 上流のModelArkエラーコード。SensitiveContentDetected、InputTextSensitiveContentDetected、InputImageSensitiveContentDetected、InputVideoSensitiveContentDetected、InputAudioSensitiveContentDetected、OutputTextSensitiveContentDetected、OutputImageSensitiveContentDetected、OutputVideoSensitiveContentDetected、OutputAudioSensitiveContentDetected はコンテンツポリシーによる拒否を示す。ファミリーには、InputImageSensitiveContentDetected.PrivacyInformation、OutputVideoSensitiveContentDetected.PolicyViolation、OutputImageSensitiveContentDetected.DeepFake のように、ドット区切りの理由が付くことがある。これは列挙型ではなくオープンな文字列であり、他のコードは検証およびプロバイダーの失敗を表す。ルーターはHTTP 400のエラーエンベロープとHTTP 200の失敗タスク応答でポリシーファミリーを認識するが、トランスポートの失敗を上書きすることはない。
エラーメッセージ
-
- The ID of the video generation task
+ビデオ生成タスクのID
@@ -410,15 +411,15 @@ false: 生成されたビデオの最後のフレーム画像を返しません
- 生成済みビデオのコンテナ形式 (`mp4` または `mov`)。Seedance のビデオタスククエリが返す場所である、`content` の兄弟としてトップレベルで返されます。BytePlus 独自のフィールドで、変更されずにそのまま転送されます。
+ 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟として最上位レベルで返されます。Seedance のビデオタスククエリはここで返します。BytePlus 独自のフィールドで、変更されずに転送されます。
- 生成済みビデオの解像度 (例: `1080p`)。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。
+ 生成済みビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。
- タスクで実際に使用された生成シード。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずにそのまま転送されます。
+ タスクで実際に使用された生成シード。BytePlus 独自のフィールドで、成功したビデオタスクで返され、変更されずに転送されます。
形式: `int64`
@@ -426,11 +427,11 @@ false: 生成されたビデオの最後のフレーム画像を返しません
タスクの状態
- 取り得る値: `queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired`
+ 可能な値: `queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired`
- タスクが最後に更新された時間。値は UNIX タイムスタンプ (秒) です。
+ タスクが最後に更新された時間。値は UNIX タイムスタンプ(秒単位)です。
@@ -442,7 +443,7 @@ false: 生成されたビデオの最後のフレーム画像を返しません
- ビデオ生成モデルでは、入力トークン数は計算されず、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 7a54185e4e..01a260b876 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,18 +2,19 @@
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: 1d016721
+translationSourceHash: 2263b4cf
translationFrom: development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx
translationBlockHashes:
"_intro": 5f93a1f1
"Quick start": 71aafccf
- "Schema": 35f3b5dc
+ "Schema": f4d67fb6
"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";
@@ -182,7 +183,7 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-5-pro-251215/requests/$
### 入力
- 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。結果は代わりにタスクステータスのルートをポーリングして取得してください。
+ 無視されます。BytePlus のリクエスト形状との互換性のために受け付けられますが、タスクが送信される前に削除されるため、コールバックが送信されることはありません。代わりにタスクステータスのルートをポーリングして結果を取得してください。
形式: `uri`
@@ -192,7 +193,7 @@ 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 はオーディオのみの入力をサポートします。
@@ -204,7 +205,7 @@ Base64: 形式 data:audio/\;base64,\
Seedance 2.5 のみ。最終ビデオとしてレンダリングする Draft タスク。唯一のコンテンツ項目である必要があります。
-最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用するため、これらを再度送信しないでください。resolution のデフォルトは 1080p で、1080p のみをサポートします。
+最終ビデオは Draft タスクのプロンプト、入力アセット、再生時間、比率、シード、generate_audio、omni_reference_task_type を再利用します。これらを再度送信しないでください。解像度はデフォルトで 1080p になり、1080p のみをサポートします。
@@ -217,55 +218,56 @@ Base64: 形式 data:audio/\;base64,\
画像から動画への生成用の画像コンテンツ(type が "image_url" の場合)
-画像 URL: 画像 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 のみ)。
- 指定可能な値: `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)
+- --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 は
-テキスト長の上限を公開しておらず、テスト(2026-09-17)では 40,000 文字を受け付けました。
-文字数(バイト数ではない)でカウントするため、マルチバイトのプロンプトは
-転送上でこのサイズの数倍になることがあります。これはこの 1 つのフィールドを制限するものであり、
-リクエスト全体ではありません。`content` は配列であり、リクエスト全体のボディ上限が
-ドキュメント全体を制限します。これを適用するのは Comfy Router(/v2/models/byteplus/\{model})であり、
-v1 /proxy を直接呼び出した場合は BytePlus 自身のバリデータが代わりに応答します。
-実際のトラフィックよりはるかに高く設定されているため、正当なプロンプトが
-これによって判定されることはありません。呼び出し元がより多くを必要とする場合は引き上げてください。
+テキスト長の制限を公開しておらず、テストでは 40,000 文字を受け付けました(2026-09-17)。
+バイト数ではなく文字数をカウントするため、マルチバイトのプロンプトは通信時に
+このサイズの数倍になる可能性があります。これはリクエスト全体ではなく、この 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 のみがビデオ入力をサポートします。
@@ -275,58 +277,60 @@ v1 /proxy を直接呼び出した場合は BytePlus 自身のバリデータが
- 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 1.5 pro: [4,12] または -1(auto)。
- 範囲: `2` から `30`
+ 可能な値: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`
- タスクのタイムアウトしきい値(秒)。デフォルト 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 で拒否します。このスキーマの `required` リストに含まれていないのは、Comfy Router が /v2/models/byteplus/\{model} の `{model}` パスセグメントから補完するためで、Router の呼び出し元は省略します。
+
+The ID of the model to call. サポートされているモデル: 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`
+ 指定可能な値: `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 に設定すると、ビデオ生成タスクの情報を照会する API を呼び出すことで最後のフレーム画像を取得できます。最後のフレーム画像は PNG 形式で、ピクセル幅と高さは生成済みビデオと一致し、透かしは含まれません。このパラメータを使用すると、複数の連続したビデオを生成できます。つまり、前の生成済みビデオの最後のフレームを次のビデオタスクの最初のフレームとして使用でき、複数の連続したビデオを素早く生成できます。
+false: 生成済みビデオの最後のフレーム画像を返しません。
@@ -336,63 +340,63 @@ false: 生成されたビデオの最後のフレーム画像を返しません
- 処理に使用するサービスティア。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/seedance-1-5-pro-251215/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証するのと同じドキュメントです。
+Router が `GET /v2/models/byteplus/seedance-1-5-pro-251215/openapi.json` で提供するスキーマから生成されたもので、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるのと同じドキュメントです。
### 出力
- ビデオ生成タスクの完了後の出力です。出力ビデオのダウンロード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時間しかないものが返ることがあります。再ホストを実行できなかった場合、このフィールドは 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を保存するのではなくフレームをダウンロードしてください。
- BytePlus が `content` の中にネストして返す場合の、生成されたビデオのコンテナ形式 (mp4 または mov) です。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` の寿命とは無関係です。
+ 上流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です。再ホストされた `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 自身の再ホストが消費します。
+ 出力ビデオの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時間しかないものが返ることがあります。再ホストを実行できなかった場合、このフィールドは 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 のように、ドットで区切られた理由が付くことがあります。これは列挙型ではなくオープンな文字列です。他のコードは検証やプロバイダーの失敗を表します。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の失敗タスク応答でポリシーファミリーを認識しますが、トランスポートの失敗を上書きすることはありません。
@@ -400,7 +404,7 @@ false: 生成されたビデオの最後のフレーム画像を返しません
- ビデオ生成タスクのID
+ 動画生成タスクの ID
@@ -408,15 +412,15 @@ false: 生成されたビデオの最後のフレーム画像を返しません
- 生成済みビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてTOP LEVELで返されます。Seedanceのビデオタスククエリがこの位置で返すためです。BytePlus自身のフィールドであり、変更されずに転送されます。
+ 生成されたビデオのコンテナ形式(mp4 または mov)。`content` の兄弟としてトップレベルで返されます。Seedance のビデオタスククエリはここでこれを返します。BytePlus 独自のフィールドであり、そのまま転送されます。
- 生成済みビデオの解像度(例: `1080p`)。BytePlus自身のフィールドであり、成功したビデオタスクで返され、変更されずに転送されます。
+ 生成されたビデオの解像度(例: `1080p`)。BytePlus 独自のフィールドであり、成功したビデオタスクで返され、そのまま転送されます。
- タスクで実際に使用された生成シード。BytePlus自身のフィールドであり、成功したビデオタスクで返され、変更されずに転送されます。
+ タスクで実際に使用された生成シード。BytePlus 独自のフィールドであり、成功したビデオタスクで返され、そのまま転送されます。
形式: `int64`
@@ -424,11 +428,11 @@ false: 生成されたビデオの最後のフレーム画像を返しません
タスクの状態
- 取り得る値: `queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired`
+ 取り得る値: `queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired`
- タスクが最後に更新された時間。値は秒単位のUNIXタイムスタンプです。
+ タスクが最後に更新された時間。値は UNIX タイムスタンプ(秒)です。
@@ -440,7 +444,7 @@ false: 生成されたビデオの最後のフレーム画像を返しません
- ビデオ生成モデルでは入力トークン数は計算されず、0が既定値です。したがって、total_tokens = completion_tokens となります。
+ ビデオ生成モデルでは、入力トークン数は計算されず、0 がデフォルトです。したがって、total_tokens = completion_tokens となります。
## 例
diff --git a/ja/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx b/ja/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx
index e387986e28..a707c7f8ca 100644
--- a/ja/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx
+++ b/ja/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx
@@ -2,18 +2,19 @@
title: "Comfy Router で Kling 3.0 Turbo を使用する"
description: "Comfy Router 経由で kling/kling-3.0-turbo を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。"
sidebarTitle: "Kling 3.0 Turbo"
-translationSourceHash: 301a1ee1
+translationSourceHash: d09b3876
translationFrom: development/comfy-router/models/kling/kling-3-0-turbo/code.mdx
translationBlockHashes:
"_intro": 5a8c5f4b
"Quick start": a2145573
"Serving providers": 7ec93d4f
- "Schema": 1f5f61c1
- "Examples": 0a9a8bbe
+ "Schema": 992b8da2
+ "Examples": 5ce1484a
---
+
{/* 生成済みファイル。`pnpm code-pages:gen` によって router-schemas/kling/kling-3.0-turbo.json から生成されました。 */}
import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx";
@@ -181,13 +182,13 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID
ビデオのアスペクト比
- 指定可能な値: `16:9`, `9:16`, `1:1`
+ 指定可能な値: `16:9`、`9:16`、`1:1`
- ビデオの長さ(秒)
+ ビデオの再生時間(秒)
- 指定可能な値: `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`
+ 指定可能な値: `3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15`
@@ -195,11 +196,11 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID
- タスク結果のコールバック通知 URL。タスクのステータスが変化したときにサーバーが通知します。
+ タスク結果を受け取るためのコールバック通知 URL。タスクのステータスが変化するとサーバーが通知します。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。
- カスタムタスク ID。システムが生成したタスク ID を上書きすることはありませんが、クエリに使用できます。1 つのユーザーアカウント内で一意である必要があります。
+ カスタムタスク ID。システムが生成したタスク ID は上書きされませんが、クエリに使用できます。単一のユーザーアカウント内で一意である必要があります。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。
@@ -207,11 +208,11 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID
- true の場合はウォーターマーク付きの結果を生成し、false の場合は生成しません。デフォルトは false。
+ true はウォーターマーク付きの結果を生成する、false は生成しないことを意味します。デフォルトは false です。
- ポジティブとネガティブの両方の記述を含めることができるプロンプト。推奨の長さは 2500 文字以下です。マルチショットビデオでは "shot n, m, words; shot n, m, words;" の形式を使用します。
+ ポジティブとネガティブの両方の記述を含められるプロンプト。推奨長は 2500 文字以内です。マルチショットビデオでは "shot n, m, words; shot n, m, words;" という形式を使用します。
@@ -219,24 +220,24 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID
- 生成されるフレームのアスペクト比(幅:高さ)。"16:9"、"9:16"、"1:1" のいずれか。デフォルトは "16:9"。
+ 生成されるフレームのアスペクト比(幅:高さ)。"16:9"、"9:16"、"1:1" のいずれか。デフォルトは "16:9" です。
- 指定可能な値: `16:9`, `9:16`, `1:1`
+ 指定可能な値: `16:9`、`9:16`、`1:1`
- ビデオの長さ(秒)。対応する値は 3 から 15 です。デフォルトは 5。
+ ビデオの再生時間(秒)。3 から 15 の値に対応しています。デフォルトは 5 です。
範囲: `3` から `15`
- 生成されるビデオの鮮明さ。"720p" または "1080p" のいずれか。デフォルトは "720p"。
+ 生成されるビデオの鮮明さ。"720p" または "1080p" のいずれか。デフォルトは "720p" です。
- 指定可能な値: `720p`, `1080p`
+ 指定可能な値: `720p`、`1080p`
-Router が `GET /v2/models/kling/kling-3.0-turbo/openapi.json` で提供するスキーマから生成されており、これはリクエストがプロバイダーに到達する前に Router が呼び出しを検証するのと同じドキュメントです。
+`GET /v2/models/kling/kling-3.0-turbo/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用するものと同じドキュメントです。
### 出力
@@ -256,18 +257,30 @@ Router が `GET /v2/models/kling/kling-3.0-turbo/openapi.json` で提供する
消費量。小数点以下 2 桁まで正確です。
+
+ 料金の引き落とし元となる現金アカウント(charge_type が "cash" の場合のみ存在)。例: "balance"。タスクによっては返され、省略される場合もあります。
+
+
- 消費アカウントの種類。残高の場合は "cash"、リソースパッケージの場合は "unit"。
+ 消費アカウントの種類。"cash" は残高、"unit" はリソースパッケージです。
+
+
+
+ `amount` と `list_price` の ISO 4217 通貨コード。例: "USD"。タスクによっては返され、省略される場合もあります。
+
+
+
+ 割引前のタスクの定価(小数の文字列)。タスクによっては返され、省略される場合もあります。
- 消費可能なリソースバンドルの種類(charge_type が "unit" の場合のみ存在)。"video"、"image"、"audio" のいずれか。
+ 消費可能なリソースバンドルの種類(charge_type が "unit" の場合のみ存在)。"video"、"image"、"audio" のいずれかです。
- タスクの作成時刻。ミリ秒単位の Unix タイムスタンプ。
+ タスクの作成時間。ミリ秒単位の Unix タイムスタンプ。
- フォーマット: `int64`
+ 形式: `int64`
@@ -287,7 +300,7 @@ Router が `GET /v2/models/kling/kling-3.0-turbo/openapi.json` で提供する
- 生成されるビデオの再生時間(秒)。
+ 生成されたビデオの再生時間(秒)。
@@ -299,15 +312,15 @@ Router が `GET /v2/models/kling/kling-3.0-turbo/openapi.json` で提供する
- 生成される MP3 オーディオの再生時間(秒)。
+ 生成された MP3 オーディオの再生時間(秒)。
- 生成されるオーディオの MP3 URL(直リンク防止あり)。
+ 生成されたオーディオの MP3 URL(直リンク保護あり)。
- 生成されるマテリアルの名前。
+ 生成されたマテリアルの名前。
@@ -315,37 +328,37 @@ Router が `GET /v2/models/kling/kling-3.0-turbo/openapi.json` で提供する
- マテリアルのステータス。"succeeded" または "deleted" のいずれか。
+ マテリアルのステータス。"succeeded" または "deleted" のいずれかです。
- 出力コンテンツの種類。"video"、"image"、"audio"、"voice"、"element" のいずれか。
+ 出力コンテンツの種類。"video"、"image"、"audio"、"voice"、"element" のいずれかです。
- 生成された結果の URL(直リンク防止あり)。30 日後にクリアされます。
+ 生成された結果の URL(直リンク保護あり)。30 日後にクリアされます。
- ウォーターマーク付きの結果の URL(直リンク防止あり)。
+ ウォーターマーク付き結果の URL(直リンク保護あり)。
- 生成される WAV オーディオの再生時間(秒)。
+ 生成された WAV オーディオの再生時間(秒)。
- 生成されるオーディオの WAV URL(直リンク防止あり)。
+ 生成されたオーディオの WAV URL(直リンク保護あり)。
- タスクのステータス。"submitted"、"processing"、"succeeded"、"failed" のいずれか。
+ タスクのステータス。"submitted"、"processing"、"succeeded"、"failed" のいずれかです。
- タスクの更新時刻。ミリ秒単位の Unix タイムスタンプ。
+ タスクの更新時間。ミリ秒単位の Unix タイムスタンプ。
- フォーマット: `int64`
+ 形式: `int64`
@@ -386,7 +399,7 @@ Router が `GET /v2/models/kling/kling-3.0-turbo/openapi.json` で提供する
"duration": "5",
"id": "kling-v2-output-2b1a0f9e8d7c",
"type": "video",
- "url": "https://example.invalid/kling/kling-3.0-turbo/generated.mp4"
+ "url": "https://example.invalid/kling/v2/generated.mp4"
}
],
"status": "succeeded",
diff --git a/ja/development/comfy-router/models/kling/kling-image-o1/code.mdx b/ja/development/comfy-router/models/kling/kling-image-o1/code.mdx
index 1dfb6f8731..cffa2335db 100644
--- a/ja/development/comfy-router/models/kling/kling-image-o1/code.mdx
+++ b/ja/development/comfy-router/models/kling/kling-image-o1/code.mdx
@@ -2,16 +2,17 @@
title: "Comfy Router で Kling Image O1 を使用する"
description: "Comfy Router を通じて kling/kling-image-o1 を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。"
sidebarTitle: "Kling Image O1"
-translationSourceHash: cf053382
+translationSourceHash: ca32c929
translationFrom: development/comfy-router/models/kling/kling-image-o1/code.mdx
translationBlockHashes:
"_intro": 513c65df
"Quick start": 6256a30d
- "Schema": d18a5393
+ "Schema": 60d9f6fd
"Examples": 826db173
---
+
{/* GENERATED FILE. Generated from router-schemas/kling/kling-image-o1.json by `pnpm code-pages:gen`. */}
import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx";
@@ -166,7 +167,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \
- このタスクの結果を受け取るコールバック通知先アドレス。設定すると、タスクステータスが変化したときにサーバーから能動的に通知されます。
+ このタスクの結果を受け取るコールバック通知先アドレス。設定すると、タスクステータスが変化したときにサーバーから能動的に通知されます。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router が代わりにポーリングします。
形式: `uri`
@@ -182,7 +183,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \
- カスタムタスク ID。単一のユーザーアカウント内で一意である必要があります。
+ カスタムタスク ID。単一のユーザーアカウント内で一意である必要があります。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router が代わりにポーリングします。
@@ -214,7 +215,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \
- 単一の画像を生成するか、一連の画像を生成するかを制御します。
+ 単一の画像を生成するか、一連の画像を生成するかを制御します。series は kling-image-o1 ではサポートされません (v1 プロキシが model_name を省略した場合に使用する値でもあります)。そのようなリクエストは HTTP 400 で拒否されます。
指定可能な値: `single`, `series`
diff --git a/ja/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx b/ja/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx
index a69f9bf8a4..d0152494e8 100644
--- a/ja/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx
+++ b/ja/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx
@@ -2,16 +2,17 @@
title: "Kling V2.5 Turbo を Comfy Router で使用する"
description: "Comfy Router 経由で kling/kling-v2-5-turbo を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。"
sidebarTitle: "Kling V2.5 Turbo"
-translationSourceHash: 1a5ec6e5
+translationSourceHash: 1671e7b6
translationFrom: development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx
translationBlockHashes:
"_intro": 2495a4d3
"Quick start": dc63b3ac
- "Schema": 68d50e72
+ "Schema": 3bcb036e
"Examples": 8623c725
---
+
{/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/kling/kling-v2-5-turbo.json から生成されました。 */}
import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx";
@@ -160,13 +161,13 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID
### 入力
- ビデオのアスペクト比
+ 動画のアスペクト比
- 指定可能な値: `16:9`、`9:16`、`1:1`
+ 可能な値: `16:9`, `9:16`, `1:1`
- コールバック通知先アドレス
+ コールバック通知の送信先アドレス。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。
形式: `uri`
@@ -180,132 +181,132 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID
- カメラの水平軸(x軸)に沿った移動を制御します。負の値は左、正の値は右を示します。
+ カメラの水平軸(x軸)に沿った動きを制御します。負の値は左、正の値は右を示します。
- 範囲: `-10` ~ `10`
+ 範囲: `-10` から `10`
垂直面内でのカメラの回転(x軸)を制御します。負の値は下向きの回転、正の値は上向きの回転を示します。
- 範囲: `-10` ~ `10`
+ 範囲: `-10` から `10`
カメラのロール量(z軸)を制御します。負の値は反時計回り、正の値は時計回りを示します。
- 範囲: `-10` ~ `10`
+ 範囲: `-10` から `10`
- 水平面内でのカメラの回転(y軸)を制御します。負の値は左への回転、正の値は右への回転を示します。
+ 水平面内でのカメラの回転(y軸)を制御します。負の値は左回転、正の値は右回転を示します。
- 範囲: `-10` ~ `10`
+ 範囲: `-10` から `10`
- カメラの垂直軸(y軸)に沿った移動を制御します。負の値は下向き、正の値は上向きを示します。
+ カメラの垂直軸(y軸)に沿った動きを制御します。負の値は下、正の値は上を示します。
- 範囲: `-10` ~ `10`
+ 範囲: `-10` から `10`
カメラの焦点距離の変化を制御します。負の値は画角が狭くなること、正の値は画角が広くなることを示します。
- 範囲: `-10` ~ `10`
+ 範囲: `-10` から `10`
- 定義済みのカメラワークの種類。simple: カスタマイズ可能なカメラワーク。down_back: カメラが下降しながら後退します。forward_up: カメラが前進しながら上にチルトします。right_turn_forward: 右に回転して前進します。left_turn_forward: 左に回転して前進します。
+ 定義済みのカメラワークの種類。simple: カスタマイズ可能なカメラワーク。down_back: カメラが下降しながら後退します。forward_up: カメラが前進しながら上方向にチルトします。right_turn_forward: 右に回転して前進します。left_turn_forward: 左に回転して前進します。
- 指定可能な値: `simple`、`down_back`、`forward_up`、`right_turn_forward`、`left_turn_forward`
+ 可能な値: `simple`, `down_back`, `forward_up`, `right_turn_forward`, `left_turn_forward`
ビデオ生成における柔軟性。値が高いほどモデルの柔軟性が低くなり、ユーザーのプロンプトとの関連性が強くなります。
- 範囲: `0` ~ `1`
+ 範囲: `0` から `1`
形式: `float`
- ビデオの長さ(秒)
+ ビデオの再生時間(秒)
- 指定可能な値: `3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15`
+ 可能な値: `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`
- カスタムタスクID
+ カスタムタスク ID。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。
- ビデオ生成モード。std: コスト効率の良いスタンダードモード。pro: プロフェッショナルモードで、より長い再生時間と高品質な出力のビデオを生成します。
+ ビデオ生成モード。std: スタンダードモード。コスト効率に優れています。pro: プロフェッショナルモード。より長い再生時間で、より高品質な出力のビデオを生成します。
- 指定可能な値: `std`、`pro`
+ 可能な値: `std`, `pro`
- モデル名。Comfy Router を使用する場合は省略するか null を送信してください。モデルはリクエストパスによって選択されます。名前を指定する場合は、そのパスと一致している必要があります。
+ モデル名。Comfy Router を使用する場合は省略するか null を送信します。モデルはリクエストパスによって選択されます。名前を指定する場合は、そのパスと一致している必要があります。
- 各ストーリーボードに関する情報(プロンプトや再生時間など)。最大6つのストーリーボードをサポートし、最低1つ必要です。multi_shot が true かつ shot_type が customize の場合に必須です。
+ 各ストーリーボードのプロンプトや再生時間などの情報。最大 6 つのストーリーボードをサポートし、最小は 1 です。multi_shot が true かつ shot_type が customize の場合に必須です。
- このストーリーボードの再生時間(秒)。タスク全体の再生時間を超えてはならず、1未満にもできません。すべてのストーリーボードの再生時間の合計は、タスク全体の再生時間と等しくなります。
+ このストーリーボードの再生時間(秒)。タスク全体の再生時間を超えてはならず、1 未満にもできません。すべてのストーリーボードの再生時間の合計がタスク全体の再生時間と等しくなります。
- ショットの順番
+ ショットの順序番号
- このストーリーボードのプロンプト。最大長は512文字です。
+ このストーリーボードのプロンプト。最大長は 512 文字です。
- マルチショットビデオを生成するかどうか。true の場合、prompt パラメータは無効になります。false の場合、shot_type および multi_prompt パラメータは無効になります。
+ マルチショットビデオを生成するかどうか。true の場合、prompt パラメータは無効になります。false の場合、shot_type と multi_prompt パラメータは無効になります。
- ネガティブテキストプロンプト。ネガティブプロンプトの情報は、ポジティブプロンプト内に直接ネガティブな文を追加して補うことを推奨します。
+ ネガティブテキストプロンプト。ネガティブプロンプトの情報は、ポジティブプロンプト内に直接ネガティブな文で補足することを推奨します。
- ポジティブテキストプロンプト。\<\<\>> を使用して、voice_list パラメータの順序に対応するボイスを指定します。1つのタスクで最大2つの音声トーンを参照できます。トーンを指定する場合、sound パラメータの値は on にする必要があります。
+ ポジティブテキストプロンプト。voice_list パラメータの順序に対応する音声を指定するには \<\<\>> を使用します。1 つのタスクで最大 2 つの音声を参照できます。音声を指定する場合、sound パラメータの値は on である必要があります。
ストーリーボードの方法。multi_shot パラメータが true に設定されている場合に必須です。
- 指定可能な値: `customize`、`intelligence`
+ 可能な値: `customize`, `intelligence`
- ビデオ生成時に同時にサウンドを生成するかどうか。このパラメータはモデルの V2.6 以降のバージョンのみがサポートします。
+ ビデオ生成時に同時にサウンドを生成するかどうか。このパラメータをサポートするのは V2.6 以降のバージョンのモデルのみです。
- 指定可能な値: `on`、`off`
+ 可能な値: `on`, `off`
- 動画生成時に参照するボイスのリストです。最大 2 つのボイスに対応し、`prompt` 内でリスト順に \<\<\>> と \<\<\>> として参照します。`sound` を "on" にする必要があり、これに対応するのは V2.6 以降のモデルのみです。それより前のモデル、または `sound` が既定値の "off" のままの場合、ボイスは適用されません。
+ ビデオ生成時に参照する音声のリスト。最大 2 つの音声をサポートし、リストの順序に従って `prompt` 内で \<\<\>> と \<\<\>> として参照します。`sound` を "on" に設定する必要があり、これをサポートするのは V2.6 以降のバージョンのモデルのみです。それより前のモデル、または `sound` がデフォルトの "off" のままの場合は、音声は適用されません。
- ボイスカスタマイズ API が返すボイス ID、またはシステムのプリセットボイス ID。
+ 音声カスタマイズ API から返される音声 ID、またはシステムプリセットの音声 ID。
- 透かし入りの結果を同時に生成するかどうか。現時点ではカスタム透かしはサポートされていません。
+ 透かし入りの結果を同時に生成するかどうか。カスタム透かしは現在サポートされていません。
- true は透かしを生成することを意味し、false は生成しないことを意味します。
+ true はウォーターマークを生成することを意味し、false は生成しないことを意味します。
-`GET /v2/models/kling/kling-v2-5-turbo/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるドキュメントと同じものです。
+`GET /v2/models/kling/kling-v2-5-turbo/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用する同じドキュメントです。
### 出力
@@ -318,7 +319,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID
- タスク作成時間、Unix タイムスタンプ(ミリ秒)
+ タスク作成時間。Unix タイムスタンプ(ミリ秒)
@@ -356,27 +357,27 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID
生成されたビデオの URL
- フォーマット: `uri`
+ 形式: `uri`
- ウォーターマーク付きの生成されたビデオの URL、直リンク防止形式
+ ウォーターマーク付きの生成ビデオの URL(直リンク保護形式)
- フォーマット: `uri`
+ 形式: `uri`
タスクステータス
- 有効な値: `submitted`、`processing`、`succeed`、`failed`
+ 取り得る値: `submitted`、`processing`、`succeed`、`failed`
- タスクステータス情報。タスクが失敗した場合は失敗理由を表示します
+ タスクステータスの情報。タスクが失敗した場合は失敗理由を表示します
- タスク更新時間、Unix タイムスタンプ(ミリ秒)
+ タスク更新時間。Unix タイムスタンプ(ミリ秒)
diff --git a/ja/development/comfy-router/models/kling/kling-v2-6/code.mdx b/ja/development/comfy-router/models/kling/kling-v2-6/code.mdx
index 86f2e928dc..2728637bb7 100644
--- a/ja/development/comfy-router/models/kling/kling-v2-6/code.mdx
+++ b/ja/development/comfy-router/models/kling/kling-v2-6/code.mdx
@@ -2,16 +2,17 @@
title: "Comfy Router で Kling V2.6 を使用する"
description: "Comfy Router 経由で kling/kling-v2-6 を呼び出します。endpoint、リクエストの形状、Router が返すレスポンスについて説明します。"
sidebarTitle: "Kling V2.6"
-translationSourceHash: 1e64e957
+translationSourceHash: c445a7bd
translationFrom: development/comfy-router/models/kling/kling-v2-6/code.mdx
translationBlockHashes:
"_intro": 04868509
"Quick start": 48a3d970
- "Schema": 9d23ff94
+ "Schema": a61a551f
"Examples": 8623c725
---
+
{/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/kling/kling-v2-6.json から生成されました。 */}
import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx";
@@ -162,11 +163,11 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \
ビデオのアスペクト比
- 指定可能な値: `16:9`、`9:16`、`1:1`
+ 指定可能な値: `16:9`, `9:16`, `1:1`
- コールバック通知先アドレス
+ コールバック通知先のアドレス。無視されます: comfy-api は転送前にこのフィールドを削除します。Comfy Router がユーザーに代わってポーリングします。
形式: `uri`
@@ -180,49 +181,49 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \
- カメラの水平軸 (x軸) に沿った移動を制御します。負の値は左、正の値は右を示します。
+ カメラの水平軸(x軸)に沿った動きを制御します。負の値は左、正の値は右を示します。
範囲: `-10` から `10`
- 垂直面内でのカメラの回転 (x軸) を制御します。負の値は下向きの回転、正の値は上向きの回転を示します。
+ 垂直面内でのカメラの回転(x軸)を制御します。負の値は下向きの回転、正の値は上向きの回転を示します。
範囲: `-10` から `10`
- カメラのロール量 (z軸) を制御します。負の値は反時計回り、正の値は時計回りを示します。
+ カメラのロール量(z軸)を制御します。負の値は反時計回り、正の値は時計回りを示します。
範囲: `-10` から `10`
- 水平面内でのカメラの回転 (y軸) を制御します。負の値は左回転、正の値は右回転を示します。
+ 水平面内でのカメラの回転(y軸)を制御します。負の値は左への回転、正の値は右への回転を示します。
範囲: `-10` から `10`
- カメラの垂直軸 (y軸) に沿った移動を制御します。負の値は下、正の値は上を示します。
+ カメラの垂直軸(y軸)に沿った動きを制御します。負の値は下、正の値は上を示します。
範囲: `-10` から `10`
- カメラの焦点距離の変化を制御します。負の値は画角が狭くなること、正の値は画角が広がることを示します。
+ カメラの焦点距離の変化を制御します。負の値は画角が狭くなること、正の値は画角が広くなることを示します。
範囲: `-10` から `10`
- 定義済みのカメラの動きの種類。simple: カスタマイズ可能なカメラの動き。down_back: カメラが下降しながら後退します。forward_up: カメラが前進しながら上を向きます。right_turn_forward: 右に回転して前進します。left_turn_forward: 左に回転して前進します。
+ 定義済みのカメラワークの種類。simple: カスタマイズ可能なカメラワーク。down_back: カメラが下降しながら後退します。forward_up: カメラが前進しながら上にチルトします。right_turn_forward: 右に回転して前進します。left_turn_forward: 左に回転して前進します。
- 指定可能な値: `simple`、`down_back`、`forward_up`、`right_turn_forward`、`left_turn_forward`
+ 指定可能な値: `simple`, `down_back`, `forward_up`, `right_turn_forward`, `left_turn_forward`
- ビデオ生成における柔軟性。値が高いほどモデルの柔軟性の度合いが低くなり、ユーザーのプロンプトとの関連性が強くなります。
+ ビデオ生成における柔軟性。値が高いほどモデルの柔軟性が低くなり、ユーザーのプロンプトへの関連性が強くなります。
範囲: `0` から `1`
@@ -230,31 +231,31 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \
- ビデオの長さ (秒)
+ ビデオの長さ(秒)
- 指定可能な値: `3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15`
+ 指定可能な値: `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`
- カスタムタスク ID
+ カスタムタスク ID。無視されます: comfy-api は転送前にこのフィールドを削除します。Comfy Router がユーザーに代わってポーリングします。
- ビデオ生成モード。std: スタンダードモード。コスト効率に優れています。pro: プロフェッショナルモード。より長い再生時間で、より高品質な出力のビデオを生成します。
+ ビデオ生成モード。std: コスト効率の良いスタンダードモード。pro: プロフェッショナルモード。より長い再生時間で、より高品質な出力のビデオを生成します。
- 指定可能な値: `std`、`pro`
+ 指定可能な値: `std`, `pro`
- モデル名。Comfy Router を使用する場合は省略するか null を送信してください。モデルはリクエストパスによって選択されます。名前を指定する場合は、そのパスと一致している必要があります。
+ モデル名。Comfy Router を使用する場合は省略するか null を送信します。モデルはリクエストパスによって選択されます。名前を指定する場合は、そのパスと一致している必要があります。
- 各ストーリーボードに関する情報 (プロンプトや再生時間など)。最大 6 つのストーリーボードをサポートし、最小は 1 です。multi_shot が true かつ shot_type が customize の場合に必須です。
+ 各ストーリーボードのプロンプトや再生時間などの情報。最大 6 つのストーリーボードをサポートし、最小 1 つです。multi_shot が true かつ shot_type が customize の場合に必須です。
- このストーリーボードの再生時間 (秒)。タスク全体の再生時間を超えてはならず、1 未満にもできません。すべてのストーリーボードの再生時間の合計は、タスク全体の再生時間と等しくなります。
+ このストーリーボードの再生時間(秒)。タスク全体の再生時間を超えてはならず、1 未満にもできません。すべてのストーリーボードの再生時間の合計が、タスク全体の再生時間と等しくなります。
@@ -266,35 +267,35 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \
- マルチショットビデオを生成するかどうか。true の場合、prompt パラメータは無効です。false の場合、shot_type および multi_prompt パラメータは無効です。
+ マルチショットビデオを生成するかどうか。true の場合、prompt パラメータは無効です。false の場合、shot_type と multi_prompt パラメータは無効です。
- ネガティブテキストプロンプト。ネガティブプロンプトの情報は、ポジティブプロンプト内に直接ネガティブな文として補足することを推奨します。
+ ネガティブテキストプロンプト。ネガティブプロンプトの情報は、ポジティブプロンプト内に直接ネガティブな文で補足することを推奨します。
- ポジティブテキストプロンプト。\<\<\>> を使用して、voice_list パラメータの順序に対応するボイスを指定します。1 つのタスクで最大 2 つのトーンを参照できます。トーンを指定する場合、sound パラメータの値は on である必要があります。
+ ポジティブテキストプロンプト。\<\<\>> を使用して、voice_list パラメータの順序に対応する音声を指定します。1 つのタスクで最大 2 つの音声を参照できます。音声を指定する場合、sound パラメータの値は on である必要があります。
ストーリーボードの方法。multi_shot パラメータが true に設定されている場合に必須です。
- 指定可能な値: `customize`、`intelligence`
+ 指定可能な値: `customize`, `intelligence`
- ビデオ生成時に同時にサウンドを生成するかどうか。このパラメータをサポートするのは V2.6 以降のバージョンのモデルのみです。
+ ビデオ生成時に同時にサウンドを生成するかどうか。このパラメータは V2.6 以降のモデルのみがサポートします。
- 指定可能な値: `on`、`off`
+ 指定可能な値: `on`, `off`
- 動画生成時に参照するボイスのリストです。最大 2 つのボイスに対応し、`prompt` 内でリスト順に \<\<\>> と \<\<\>> として参照します。`sound` を "on" にする必要があり、これに対応するのは V2.6 以降のモデルのみです。それより前のモデル、または `sound` が既定値の "off" のままの場合、ボイスは適用されません。
+ ビデオ生成時に参照する音声のリスト。最大 2 つの音声をサポートし、`prompt` 内でリストの順序に従って \<\<\>> および \<\<\>> として参照します。`sound` を "on" に設定する必要があり、これは V2.6 以降のモデルのみがサポートします。それ以前のモデルの場合、または `sound` がデフォルトの "off" のままの場合は、音声は適用されません。
- ボイスカスタマイズ API が返すボイス ID、またはシステムのプリセットボイス ID。
+ 音声カスタマイズ API から返される音声 ID、またはシステムプリセットの音声 ID。
@@ -302,10 +303,10 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \
- true はウォーターマークを生成することを意味し、false は生成しないことを意味します。
+ true は透かしを生成することを意味し、false は生成しないことを意味します。
-Router が `GET /v2/models/kling/kling-v2-6/openapi.json` で提供するスキーマから生成されており、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるドキュメントと同じものです。
+`GET /v2/models/kling/kling-v2-6/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に参照するドキュメントと同じものです。
### 出力
@@ -318,15 +319,15 @@ Router が `GET /v2/models/kling/kling-v2-6/openapi.json` で提供するスキ
- タスク作成時間。Unix タイムスタンプ(ミリ秒)
+ タスクの作成時間、Unixタイムスタンプ(ミリ秒)
- タスクの消費ユニット数
+ タスクの控除ユニット数
- タスク ID
+ タスクID
@@ -350,33 +351,33 @@ Router が `GET /v2/models/kling/kling-v2-6/openapi.json` で提供するスキ
- 生成されたビデオの ID
+ 生成済みビデオのID
- 生成されたビデオの URL
+ 生成済みビデオのURL
形式: `uri`
- ウォーターマーク付きの生成ビデオの URL。直リンク防止形式
+ 透かし付きの生成済みビデオのURL、ホットリンク保護形式
形式: `uri`
- タスクのステータス
+ タスクステータス
- 指定可能な値: `submitted`、`processing`、`succeed`、`failed`
+ 取り得る値: `submitted`、`processing`、`succeed`、`failed`
- タスクのステータス情報。タスクが失敗した場合は失敗理由を表示します
+ タスクステータス情報。タスクが失敗した場合は失敗理由を表示します
- タスク更新時間。Unix タイムスタンプ(ミリ秒)
+ タスクの更新時間、Unixタイムスタンプ(ミリ秒)
@@ -392,7 +393,7 @@ Router が `GET /v2/models/kling/kling-v2-6/openapi.json` で提供するスキ
- リクエスト ID
+ リクエストID
## 例
diff --git a/ja/development/comfy-router/models/kling/kling-v3-omni/code.mdx b/ja/development/comfy-router/models/kling/kling-v3-omni/code.mdx
index d6e09f2638..a4fff59474 100644
--- a/ja/development/comfy-router/models/kling/kling-v3-omni/code.mdx
+++ b/ja/development/comfy-router/models/kling/kling-v3-omni/code.mdx
@@ -2,16 +2,17 @@
title: "Kling V3 Omni を Comfy Router で使用する"
description: "Comfy Router 経由で kling/kling-v3-omni を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。"
sidebarTitle: "Kling V3 Omni"
-translationSourceHash: 226ee8a6
+translationSourceHash: 29d1799c
translationFrom: development/comfy-router/models/kling/kling-v3-omni/code.mdx
translationBlockHashes:
"_intro": 98827333
"Quick start": 3a226de2
- "Schema": f9b37353
+ "Schema": 68bd0500
"Examples": 6c2642d6
---
+
{/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/kling/kling-v3-omni.json から生成されました。 */}
import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx";
@@ -160,67 +161,67 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \
### 入力
- 生成されるビデオフレームのアスペクト比(幅:高さ)。先頭フレーム参照またはビデオ編集機能を使用しない場合に必須です。
+ 生成されるビデオフレームのアスペクト比(幅:高さ)。最初のフレーム参照機能またはビデオ編集機能を使用しない場合に必須です。
- 取り得る値: `16:9`, `9:16`, `1:1`
+ 指定可能な値: `16:9`, `9:16`, `1:1`
- このタスクの結果を受け取るコールバック通知先アドレス。設定すると、タスクのステータスが変化した際にサーバーが能動的に通知します。
+ このタスクの結果を受け取るコールバック通知アドレス。設定すると、タスクのステータスが変更されたときにサーバーから能動的に通知されます。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。
- フォーマット: `uri`
+ 形式: `uri`
ビデオの長さ(秒)。ビデオ編集機能(refer_type: base)を使用する場合、出力の再生時間は入力ビデオと同じになり、このパラメータは無効です。
- 取り得る値: `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`
+ 指定可能な値: `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`
- エレメントIDの設定に基づく参照エレメントリスト。
+ 要素IDの設定に基づく参照要素リスト。
- エレメントID
+ 要素ID
- フォーマット: `int64`
+ 形式: `int64`
- カスタムタスクID。単一のユーザーアカウント内で一意である必要があります。
+ カスタマイズされたタスクID。単一のユーザーアカウント内で一意である必要があります。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。
- 参照画像リスト。エレメント、シーン、スタイルなどの参照画像を含めることができ、また先頭または最後のフレームとしてビデオを生成するために使用できます。
+ 参照画像リスト。要素、シーン、スタイルなどの参照画像を含めることができ、ビデオを生成するための最初または最後のフレームとして使用することもできます。
- 画像のBase64エンコードまたは画像URL(アクセス可能であることを確認してください)。サポートされるフォーマットには .jpg/.jpeg/.png が含まれます。ファイルサイズは10MBを超えることはできません。幅と高さの寸法は300px以上、アスペクト比は1:2.5~2.5:1の範囲である必要があります。
+ 画像の Base64 エンコーディングまたは画像URL(アクセス可能であることを確認)。サポートされる形式には .jpg/.jpeg/.png が含まれます。ファイルサイズは 10MB を超えることはできません。幅と高さは 300px 以上である必要があり、アスペクト比は 1:2.5 ~ 2.5:1 の範囲です。
- 画像が先頭フレームか最後のフレームかを示します。first_frame は先頭フレーム、end_frame は最後のフレームです。現在、最後のフレームのみはサポートされていません。
+ 画像が最初のフレームか最後のフレームかを指定します。first_frame は最初のフレーム、end_frame は最後のフレームです。現在、最後のフレームのみの指定はサポートされていません。
- 取り得る値: `first_frame`, `end_frame`
+ 指定可能な値: `first_frame`, `end_frame`
- ビデオ生成モード。std: スタンダードモード、720Pビデオを生成、コスト効率が良い。pro: プロフェッショナルモード、1080Pビデオを生成、より高品質なビデオ出力。
+ ビデオ生成モード。std: スタンダードモードで、720P ビデオを生成し、コスト効率に優れます。pro: プロフェッショナルモードで、1080P ビデオを生成し、より高品質なビデオ出力が得られます。
- 取り得る値: `pro`, `std`
+ 指定可能な値: `pro`, `std`
- モデル名。Comfy Routerを使用する場合は省略するかnullを送信してください。モデルはリクエストパスによって選択されます。名前を指定する場合は、そのパスと一致する必要があります。
+ モデル名。Comfy Router を使用する場合は省略するか null を送信してください。モデルはリクエストパスによって選択されます。指定された名前はそのパスと一致している必要があります。
- 各ストーリーボードに関する情報(プロンプトや再生時間など)。最大6つのストーリーボードをサポートし、最小1つです。multi_shot が true で shot_type が customize の場合に必須です。
+ 各ストーリーボードに関する情報(プロンプトや再生時間など)。最大 6 個のストーリーボードをサポートし、最小は 1 です。multi_shot が true で shot_type が customize の場合に必須です。
- このストーリーボードの再生時間(秒)。タスク全体の再生時間を超えてはならず、1未満であってはなりません。すべてのストーリーボードの再生時間の合計は、タスク全体の再生時間と等しくなります。
+ このストーリーボードの再生時間(秒)。タスク全体の再生時間を超えてはならず、1 未満であってはなりません。すべてのストーリーボードの再生時間の合計は、タスク全体の再生時間と等しくなります。
@@ -228,7 +229,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \
- このストーリーボードのプロンプトワード。最大長512文字。
+ このストーリーボードのプロンプト。最大長は 512 文字です。
@@ -236,39 +237,39 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \
- テキストプロンプトワード。ポジティブおよびネガティブな記述を含めることができます。2,500文字を超えてはなりません。\<\<\<>>> の形式でエレメント、画像、ビデオを指定できます。例: \<\>、\<\<\>>、\<\<\>>。
+ テキストプロンプト。ポジティブおよびネガティブな説明を含めることができます。2,500 文字を超えてはなりません。要素、画像、またはビデオを \<\<\<>>> 形式で指定できます。例: \<\>、\<\<\>>、\<\<\>>。
ストーリーボード方法。multi_shot パラメータが true に設定されている場合に必須です。
- 取り得る値: `customize`, `intelligence`
+ 指定可能な値: `customize`, `intelligence`
- ビデオ生成時に同時にサウンドを生成するかどうか。
+ ビデオ生成時にサウンドを同時に生成するかどうか。
- 取り得る値: `on`, `off`
+ 指定可能な値: `on`, `off`
- 参照ビデオリスト。特徴の参照ビデオとして、または編集対象のビデオとして使用できます。デフォルトでは編集対象のビデオです。
+ 参照ビデオリスト。feature 用の参照ビデオとして、または編集対象のビデオとして使用できます。デフォルトは編集対象のビデオです。
ビデオのオリジナルサウンドを保持するかどうか。yes は保持、no は保持しないことを示します。
- 取り得る値: `yes`, `no`
+ 指定可能な値: `yes`, `no`
- 参照ビデオタイプ。feature は特徴参照ビデオ、base は編集対象のビデオです。
+ 参照ビデオの種類。feature は機能参照ビデオ、base は編集対象のビデオです。
- 取り得る値: `feature`, `base`
+ 指定可能な値: `feature`, `base`
- アップロードされたビデオのURL。.mp4/.mov フォーマットのみサポートされます。再生時間は3~10秒。解像度は720px~2160pxである必要があります。24~60 fpsのフレームレートをサポートします。アップロードできるビデオは1つだけで、サイズは200MBを超えてはなりません。
+ アップロードするビデオの URL。サポートされるのは .mp4/.mov 形式のみです。再生時間は 3~10 秒です。解像度は 720px~2160px の範囲である必要があります。24~60 fps のフレームレートをサポートします。アップロードできるビデオは 1 本のみで、サイズは 200MB を超えてはなりません。
@@ -276,10 +277,10 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \
- true はウォーターマークを生成、false は生成しないことを意味します。
+ true はウォーターマークを生成することを意味し、false は生成しないことを意味します。
-Routerが `GET /v2/models/kling/kling-v3-omni/openapi.json` で提供するスキーマから生成されており、これはリクエストがプロバイダーに到達する前に呼び出しを検証する際に使用する同じドキュメントです。
+Router が `GET /v2/models/kling/kling-v3-omni/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用する同じドキュメントです。
### 出力
@@ -292,11 +293,11 @@ Routerが `GET /v2/models/kling/kling-v3-omni/openapi.json` で提供するス
- タスク作成時間、Unixタイムスタンプ(ミリ秒)
+ タスクの作成時間、Unixタイムスタンプ(ミリ秒)
- タスクの消費ユニット数
+ タスクの控除ユニット
@@ -324,17 +325,17 @@ Routerが `GET /v2/models/kling/kling-v3-omni/openapi.json` で提供するス
- 生成されたビデオのID
+ 生成済みビデオID
- 生成されたビデオのURL
+ 生成済みビデオのURL
形式: `uri`
- ウォーターマーク付きの生成されたビデオのURL、直リンク防止形式
+ ウォーターマーク付きの生成済みビデオのURL(ホットリンク保護形式)
形式: `uri`
@@ -342,15 +343,15 @@ Routerが `GET /v2/models/kling/kling-v3-omni/openapi.json` で提供するス
タスクステータス
- 取り得る値: `submitted`、`processing`、`succeed`、`failed`
+ 可能な値: `submitted`, `processing`, `succeed`, `failed`
- タスクステータス情報。タスクが失敗した場合は失敗理由が表示されます
+ タスクステータス情報。タスクが失敗した場合は失敗理由を表示します
- タスク更新時間、Unixタイムスタンプ(ミリ秒)
+ タスクの更新時間、Unixタイムスタンプ(ミリ秒)
diff --git a/ja/development/comfy-router/models/kling/kling-v3/code.mdx b/ja/development/comfy-router/models/kling/kling-v3/code.mdx
index bd8c4f29cf..d58d60fa1d 100644
--- a/ja/development/comfy-router/models/kling/kling-v3/code.mdx
+++ b/ja/development/comfy-router/models/kling/kling-v3/code.mdx
@@ -2,17 +2,18 @@
title: "Comfy Router で Kling V3 を使用する"
description: "Comfy Router 経由で kling/kling-v3 を呼び出します。エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。"
sidebarTitle: "Kling V3"
-translationSourceHash: ecfa3f9b
+translationSourceHash: e07d4035
translationFrom: development/comfy-router/models/kling/kling-v3/code.mdx
translationBlockHashes:
"_intro": 74a12e0f
"Quick start": 09c0a41a
"Serving providers": a8b20c72
- "Schema": 77550c0a
+ "Schema": 8e8b04e6
"Examples": 8623c725
---
+
{/* GENERATED FILE. Generated from router-schemas/kling/kling-v3.json by `pnpm code-pages:gen`. */}
import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx";
@@ -173,11 +174,11 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \
ビデオのアスペクト比
- 指定可能な値: `16:9`, `9:16`, `1:1`
+ 可能な値: `16:9`, `9:16`, `1:1`
- コールバック通知先アドレス
+ コールバック通知先のアドレス。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。
形式: `uri`
@@ -191,45 +192,45 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \
- 水平軸(x軸)に沿ったカメラの移動を制御します。負の値は左、正の値は右を示します。
+ カメラの水平軸 (x軸) に沿った移動を制御します。負の値は左、正の値は右を示します。
範囲: `-10` から `10`
- 垂直面内でのカメラの回転(x軸)を制御します。負の値は下向きの回転、正の値は上向きの回転を示します。
+ 垂直面内でのカメラの回転 (x軸) を制御します。負の値は下向きの回転、正の値は上向きの回転を示します。
範囲: `-10` から `10`
- カメラのロール量(z軸)を制御します。負の値は反時計回り、正の値は時計回りを示します。
+ カメラのロール量 (z軸) を制御します。負の値は反時計回り、正の値は時計回りを示します。
範囲: `-10` から `10`
- 水平面内でのカメラの回転(y軸)を制御します。負の値は左回転、正の値は右回転を示します。
+ 水平面内でのカメラの回転 (y軸) を制御します。負の値は左への回転、正の値は右への回転を示します。
範囲: `-10` から `10`
- 垂直軸(y軸)に沿ったカメラの移動を制御します。負の値は下、正の値は上を示します。
+ カメラの垂直軸 (y軸) に沿った移動を制御します。負の値は下、正の値は上を示します。
範囲: `-10` から `10`
- カメラの焦点距離の変化を制御します。負の値は画角が狭くなり、正の値は画角が広がることを示します。
+ カメラの焦点距離の変化を制御します。負の値は画角が狭くなること、正の値は画角が広くなることを示します。
範囲: `-10` から `10`
- 定義済みのカメラ動作タイプ。simple: カスタマイズ可能なカメラ動作。down_back: カメラが下降しながら後退します。forward_up: カメラが前進しながら上方向に傾きます。right_turn_forward: 右に回転して前進します。left_turn_forward: 左に回転して前進します。
+ 定義済みのカメラの動きの種類。simple: カスタマイズ可能なカメラの動き。down_back: カメラが下降しながら後退します。forward_up: カメラが前進しながら上を向きます。right_turn_forward: 右に回転して前進します。left_turn_forward: 左に回転して前進します。
- 指定可能な値: `simple`, `down_back`, `forward_up`, `right_turn_forward`, `left_turn_forward`
+ 可能な値: `simple`, `down_back`, `forward_up`, `right_turn_forward`, `left_turn_forward`
@@ -241,39 +242,39 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \
- ビデオの長さ(秒)
+ ビデオの再生時間 (秒)
- 指定可能な値: `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`
+ 可能な値: `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`
- カスタムタスクID
+ カスタムタスク ID。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。
- ビデオ生成モード。std: スタンダードモード。コスト効率に優れています。pro: プロフェッショナルモード。より長い再生時間のビデオを生成しますが、出力品質は高くなります。
+ ビデオ生成モード。std: スタンダードモード。コスト効率に優れています。pro: プロフェッショナルモード。より長い再生時間で、より高品質なビデオを生成します。
- 指定可能な値: `std`, `pro`
+ 可能な値: `std`, `pro`
- モデル名。Comfy Router を使用する場合は省略するか null を送信してください。モデルはリクエストパスによって選択されます。名前を指定する場合は、そのパスと一致している必要があります。
+ モデル名。Comfy Router を使用する場合は省略するか null を送信します。モデルはリクエストパスによって選択されます。名前を指定する場合は、そのパスと一致している必要があります。
- 各ストーリーボードの情報(プロンプトや再生時間など)。最大 6 つのストーリーボードをサポートし、最小は 1 です。multi_shot が true かつ shot_type が `customize` の場合に必須です。
+ 各ストーリーボードの情報 (プロンプトや再生時間など)。最大 6 つのストーリーボードをサポートし、最小 1 つです。multi_shot が true かつ shot_type が customize の場合に必須です。
- このストーリーボードの再生時間(秒)。タスク全体の再生時間を超えてはならず、1 未満にもできません。すべてのストーリーボードの再生時間の合計は、タスク全体の再生時間と等しくなります。
+ このストーリーボードの再生時間 (秒)。タスク全体の再生時間を超えてはならず、1 未満であってはなりません。すべてのストーリーボードの再生時間の合計は、タスク全体の再生時間と等しくなります。
- ショットの連番
+ ショットの順序番号
- このストーリーボードのプロンプトワード。最大長 512 文字。
+ このストーリーボードのプロンプト。最大長は 512 文字です。
@@ -281,42 +282,42 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \
- ネガティブテキストプロンプト。ネガティブプロンプトの情報は、ポジティブプロンプト内に直接ネガティブな文を加えて補足することを推奨します。
+ ネガティブテキストプロンプト。ネガティブプロンプトの情報は、ポジティブプロンプト内に直接ネガティブな文を書いて補足することが推奨されます。
- ポジティブテキストプロンプト。voice_list パラメータの順序に対応する音声を指定するには、\<\<\>> を使用します。1 つのタスクで参照できるトーンは最大 2 つです。トーンを指定する場合、sound パラメータの値は on である必要があります。
+ ポジティブテキストプロンプト。voice_list パラメータの順序に対応する音声を指定するには、\<\<\>> を使用します。1 つのタスクで最大 2 つの音声を参照できます。音声を指定する場合、sound パラメータの値は on である必要があります。
- ストーリーボード方法。multi_shot パラメータが true に設定されている場合に必須です。
+ ストーリーボードの方法。multi_shot パラメータが true に設定されている場合に必須です。
- 指定可能な値: `customize`, `intelligence`
+ 可能な値: `customize`, `intelligence`
- ビデオ生成時に同時にサウンドを生成するかどうか。このパラメータをサポートするのは V2.6 以降のモデルのみです。
+ ビデオ生成時に同時にサウンドを生成するかどうか。V2.6 以降のバージョンのモデルのみがこのパラメータをサポートします。
- 指定可能な値: `on`, `off`
+ 可能な値: `on`, `off`
- 動画生成時に参照するボイスのリストです。最大 2 つのボイスに対応し、`prompt` 内でリスト順に \<\<\>> と \<\<\>> として参照します。`sound` を "on" にする必要があり、これに対応するのは V2.6 以降のモデルのみです。それより前のモデル、または `sound` が既定値の "off" のままの場合、ボイスは適用されません。
+ ビデオ生成時に参照する音声のリスト。最大 2 つの音声をサポートし、リストの順に `prompt` 内で \<\<\>> および \<\<\>> として参照します。`sound` を "on" に設定する必要があり、これは V2.6 以降のバージョンのモデルのみがサポートします。それより前のモデルでは、または `sound` をデフォルトの "off" のままにした場合は、音声は適用されません。
- ボイスカスタマイズ API が返すボイス ID、またはシステムのプリセットボイス ID。
+ 音声カスタマイズ API から返された音声 ID、またはシステムプリセットの音声 ID。
- ウォーターマーク付きの結果を同時に生成するかどうか。現時点ではカスタムウォーターマークはサポートされていません。
+ 透かし入りの結果を同時に生成するかどうか。現時点ではカスタム透かしはサポートされていません。
- true はウォーターマークを生成することを意味し、false は生成しないことを意味します。
+ true は透かしを生成することを意味し、false は生成しないことを意味します。
-Router が `GET /v2/models/kling/kling-v3/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に Router が使用するドキュメントと同じです。
+`GET /v2/models/kling/kling-v3/openapi.json` で Router が提供するスキーマから生成済みです。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用する同じドキュメントです。
### 出力
@@ -329,11 +330,11 @@ Router が `GET /v2/models/kling/kling-v3/openapi.json` で提供するスキー
- タスク作成時間、Unix タイムスタンプ(ミリ秒)
+ タスクの作成時間。Unix タイムスタンプ(ミリ秒)
- タスクの消費ユニット数
+ タスクの控除ユニット数
@@ -361,33 +362,33 @@ Router が `GET /v2/models/kling/kling-v3/openapi.json` で提供するスキー
- 生成済みビデオ ID
+ 生成されたビデオ ID
- 生成済みビデオの URL
+ 生成されたビデオの URL
- フォーマット: `uri`
+ 形式: `uri`
- ウォーターマーク付き生成済みビデオの URL、直リンク防止フォーマット
+ ウォーターマーク付きの生成されたビデオの URL(ホットリンク防止形式)
- フォーマット: `uri`
+ 形式: `uri`
タスクステータス
- 取り得る値: `submitted`、`processing`、`succeed`、`failed`
+ 指定可能な値: `submitted`、`processing`、`succeed`、`failed`
- タスクステータス情報。タスク失敗時に失敗理由を表示します
+ タスクステータス情報。タスクが失敗した場合は失敗理由を表示します
- タスク更新時間、Unix タイムスタンプ(ミリ秒)
+ タスクの更新時間。Unix タイムスタンプ(ミリ秒)
diff --git a/ja/development/comfy-router/models/kling/kling-video-o1/code.mdx b/ja/development/comfy-router/models/kling/kling-video-o1/code.mdx
index 1bc4fa1c1c..2495f2759e 100644
--- a/ja/development/comfy-router/models/kling/kling-video-o1/code.mdx
+++ b/ja/development/comfy-router/models/kling/kling-video-o1/code.mdx
@@ -2,16 +2,17 @@
title: "Kling Video O1 を Comfy Router で使用する"
description: "Comfy Router 経由で kling/kling-video-o1 を呼び出します。エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。"
sidebarTitle: "Kling Video O1"
-translationSourceHash: 3c228231
+translationSourceHash: 892ccf77
translationFrom: development/comfy-router/models/kling/kling-video-o1/code.mdx
translationBlockHashes:
"_intro": a36df86f
"Quick start": 2dd48300
- "Schema": 6f4cf55b
+ "Schema": f693e2ef
"Examples": 6c2642d6
---
+
{/* 生成済みファイル。`pnpm code-pages:gen` により router-schemas/kling/kling-video-o1.json から生成されています。 */}
import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx";
@@ -160,13 +161,13 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \
### 入力
- 生成されるビデオフレームのアスペクト比(幅:高さ)。先頭フレーム参照またはビデオ編集機能を使用しない場合に必須です。
+ 生成されるビデオフレームのアスペクト比(幅:高さ)。ファーストフレーム参照機能またはビデオ編集機能を使用しない場合に必須です。
- 指定可能な値: `16:9`, `9:16`, `1:1`
+ 指定可能な値: `16:9`、`9:16`、`1:1`
- このタスクの結果を受け取るコールバック通知先アドレス。設定すると、タスクのステータスが変化した際にサーバーから能動的に通知されます。
+ このタスクの結果を受け取るコールバック通知アドレス。設定すると、タスクステータスが変更されたときにサーバーが能動的に通知します。無視されます: comfy-api は転送前にこのフィールドを削除し、Comfy Router がユーザーに代わってポーリングします。
形式: `uri`
@@ -174,11 +175,11 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \
ビデオの長さ(秒)。ビデオ編集機能(refer_type: base)を使用する場合、出力の再生時間は入力ビデオと同じになり、このパラメータは無効です。
- 指定可能な値: `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`
+ 指定可能な値: `3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15`
- element ID の設定に基づく参照エレメントリスト。
+ エレメントIDに基づいて設定する参照エレメントのリスト。
@@ -188,87 +189,87 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \
- カスタムタスクID。1 つのユーザーアカウント内で一意である必要があります。
+ カスタマイズされたタスクID。単一のユーザーアカウント内で一意である必要があります。無視されます: comfy-api は転送前にこのフィールドを削除し、Comfy Router がユーザーに代わってポーリングします。
- 参照画像リスト。エレメント、シーン、スタイルなどの参照画像を含めることも、ビデオを生成するための先頭フレームまたは終了フレームとして使用することもできます。
+ 参照画像リスト。エレメント、シーン、スタイルなどの参照画像を含めることも、ビデオ生成の最初または最後のフレームとして使用することもできます。
- 画像の Base64 エンコードまたは画像URL(アクセス可能であることを確認してください)。サポートされる形式は .jpg/.jpeg/.png です。ファイルサイズは 10MB を超えることはできません。幅と高さの寸法は 300px 以上である必要があり、アスペクト比は 1:2.5 ~ 2.5:1 の範囲です。
+ 画像のBase64エンコードまたは画像URL(アクセス可能であることを確認してください)。サポートされる形式は.jpg/.jpeg/.pngです。ファイルサイズは10MBを超えることはできません。幅と高さの寸法は300px以上、アスペクト比率は1:2.5~2.5:1の範囲である必要があります。
- 画像が先頭フレームか終了フレームかを指定します。first_frame は先頭フレーム、end_frame は終了フレームです。現時点では終了フレームのみを指定することはサポートされていません。
+ 画像が最初のフレームか最後のフレームかを指定します。first_frameは最初のフレーム、end_frameは最後のフレームです。現在、最後のフレームのみの指定はサポートされていません。
- 指定可能な値: `first_frame`, `end_frame`
+ 指定可能な値: `first_frame`、`end_frame`
- ビデオ生成モード。std: スタンダードモード。720P のビデオを生成し、コスト効率に優れます。pro: プロフェッショナルモード。1080P のビデオを生成し、より高品質なビデオを出力します。
+ ビデオ生成モード。std: スタンダードモード。720Pのビデオを生成し、コスト効率に優れます。pro: プロフェッショナルモード。1080Pのビデオを生成し、より高品質なビデオを出力します。
- 指定可能な値: `pro`, `std`
+ 指定可能な値: `pro`、`std`
- モデル名。Comfy Router を使用する場合は省略するか null を送信してください。モデルはリクエストパスによって選択されます。名前を指定する場合は、そのパスと一致している必要があります。
+ モデル名。Comfy Routerを使用する場合は省略するかnullを送信します。モデルはリクエストパスによって選択されます。名前を指定する場合は、そのパスと一致している必要があります。
- 各ストーリーボードに関する情報(プロンプトや再生時間など)。最大 6 個のストーリーボードをサポートし、最低 1 個必要です。multi_shot が true かつ shot_type が customize の場合に必須です。
+ 各ストーリーボードの情報(プロンプトや再生時間など)。最大6つのストーリーボードをサポートし、最低1つ必要です。multi_shotがtrueかつshot_typeがcustomizeの場合に必須です。
- このストーリーボードの長さ(秒)。タスク全体の長さを超えることはできず、1 未満にすることもできません。すべてのストーリーボードの長さの合計は、タスク全体の長さと等しくなります。
+ このストーリーボードの再生時間(秒)。タスク全体の再生時間を超えることはできず、1未満にすることもできません。すべてのストーリーボードの再生時間の合計は、タスク全体の再生時間と等しくなります。
- ショットの連番
+ ショットの順序番号
- このストーリーボードのプロンプト。最大長は 512 文字です。
+ このストーリーボードのプロンプト。最大長は512文字です。
- マルチショットビデオを生成するかどうか。true の場合、prompt パラメータは無効です。false の場合、shot_type および multi_prompt パラメータは無効です。
+ マルチショットビデオを生成するかどうか。trueの場合、promptパラメータは無効です。falseの場合、shot_typeとmulti_promptパラメータは無効です。
- テキストプロンプト。ポジティブおよびネガティブな記述を含めることができます。2,500 文字を超えることはできません。エレメント、画像、ビデオを \<\<\<>>> の形式で指定できます。例: \<\>, \<\<\>>, \<\<\>>。
+ テキストプロンプト。ポジティブおよびネガティブな記述を含めることができます。2,500文字を超えることはできません。`\<\>`、`\<\<\>>`、`\<\<\>>` のように `\<\<\<>>>` 形式でエレメント、画像、ビデオを指定できます。
- ストーリーボード方式。multi_shot パラメータが true に設定されている場合に必須です。
+ ストーリーボード方式。multi_shotパラメータがtrueに設定されている場合に必須です。
- 指定可能な値: `customize`, `intelligence`
+ 指定可能な値: `customize`、`intelligence`
- ビデオ生成時にサウンドを同時に生成するかどうか。
+ ビデオ生成時に同時にサウンドを生成するかどうか。
- 指定可能な値: `on`, `off`
+ 指定可能な値: `on`、`off`
- 参照ビデオのリスト。feature の参照ビデオとして、または編集対象のビデオとして使用できます。デフォルトは編集対象のビデオです。
+ 参照ビデオのリスト。機能の参照ビデオとして、または編集対象のビデオとして使用でき、デフォルトでは編集対象のビデオになります。
- ビデオのオリジナルサウンドを保持するかどうか。yes は保持、no は保持しないことを示します。
+ ビデオのオリジナルサウンドを保持するかどうか。yesは保持、noは保持しないことを示します。
- 指定可能な値: `yes`, `no`
+ 指定可能な値: `yes`、`no`
- 参照ビデオのタイプ。feature は feature 参照ビデオ、base は編集対象のビデオです。
+ 参照ビデオのタイプ。featureは機能参照ビデオ、baseは編集対象のビデオです。
- 指定可能な値: `feature`, `base`
+ 指定可能な値: `feature`、`base`
- アップロードするビデオの URL。.mp4/.mov 形式のみサポートされます。再生時間は 3~10 秒です。解像度は 720px 以上 2160px 以下である必要があります。フレームレートは 24~60 fps をサポートします。アップロードできるビデオは 1 本のみで、サイズは 200MB を超えることはできません。
+ アップロードするビデオのURL。.mp4/.mov形式のみサポートされています。再生時間は3~10秒です。解像度は720px~2160pxの範囲である必要があります。フレームレートは24~60 fpsをサポートしています。アップロードできるビデオは1つのみで、サイズは200MBを超えることはできません。
@@ -276,10 +277,10 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \
- true はウォーターマークを生成、false は生成しないことを意味します。
+ trueはウォーターマークを生成する、falseは生成しないことを示します。
-`GET /v2/models/kling/kling-video-o1/openapi.json` で Router が提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用されるものと同じドキュメントです。
+`GET /v2/models/kling/kling-video-o1/openapi.json` でRouterが提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に呼び出しを検証する際に使用するのと同じドキュメントです。
### 出力
@@ -292,11 +293,11 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \
- タスク作成時間、Unix タイムスタンプ(ミリ秒)
+ タスク作成時間、Unix タイムスタンプ(ミリ秒)
- タスクの控除ユニット数
+ タスクの控除単位
@@ -320,11 +321,11 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \
- ビデオの合計再生時間(秒)
+ ビデオの総再生時間(秒)
- 生成済みビデオ ID
+ 生成済みビデオの ID
@@ -334,7 +335,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \
- ウォーターマーク付きの生成済みビデオの URL(直リンク防止形式)
+ ウォーターマーク付きの生成済みビデオの URL(ホットリンク保護形式)
形式: `uri`
@@ -342,7 +343,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \
タスクステータス
- 有効な値: `submitted`、`processing`、`succeed`、`failed`
+ 取り得る値: `submitted`、`processing`、`succeed`、`failed`
@@ -350,7 +351,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \
- タスク更新時間、Unix タイムスタンプ(ミリ秒)
+ タスク更新時間、Unix タイムスタンプ(ミリ秒)
diff --git a/ja/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx b/ja/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx
index 46daa06fdf..0a697ac2cd 100644
--- a/ja/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx
+++ b/ja/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx
@@ -2,16 +2,17 @@
title: "Comfy Router で Videos Avatar Image 2video を使用する"
description: "Comfy Router 経由で kling/videos-avatar-image2video を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。"
sidebarTitle: "Videos Avatar Image 2video"
-translationSourceHash: 444b1395
+translationSourceHash: 5181e917
translationFrom: development/comfy-router/models/kling/videos-avatar-image2video/code.mdx
translationBlockHashes:
"_intro": baca1542
"Quick start": 5605d33f
- "Schema": eeb06fe1
+ "Schema": 073bf8b2
"Examples": ce6803dd
---
+
{/* GENERATED FILE. Generated from router-schemas/kling/videos-avatar-image2video.json by `pnpm code-pages:gen`. */}
import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx";
@@ -164,13 +165,13 @@ curl https://api.comfy.org/v2/models/kling/videos-avatar-image2video/requests/$R
- このタスクの結果を受け取るコールバック通知アドレス。
+ このタスクの結果を受け取るコールバック通知アドレス。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーの代わりにポーリングします。
形式: `uri`
- カスタムタスク ID。単一のユーザーアカウント内で一意である必要があります。
+ カスタムタスク ID。単一のユーザーアカウント内で一意である必要があります。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーの代わりにポーリングします。
diff --git a/ja/development/comfy-router/models/kling/videos-lip-sync/code.mdx b/ja/development/comfy-router/models/kling/videos-lip-sync/code.mdx
index 80a7965e28..314362e9dd 100644
--- a/ja/development/comfy-router/models/kling/videos-lip-sync/code.mdx
+++ b/ja/development/comfy-router/models/kling/videos-lip-sync/code.mdx
@@ -2,16 +2,17 @@
title: "Comfy Router で Videos Lip Sync を使う"
description: "Comfy Router 経由で kling/videos-lip-sync を呼び出します: エンドポイント、リクエスト形状、Router が返すレスポンスについて。"
sidebarTitle: "Videos Lip Sync"
-translationSourceHash: ddd2a405
+translationSourceHash: 6103bea9
translationFrom: development/comfy-router/models/kling/videos-lip-sync/code.mdx
translationBlockHashes:
"_intro": 0477697a
"Quick start": e13a4628
- "Schema": 90571e9f
+ "Schema": 4fb7c777
"Examples": d1dd6ed8
---
+
{/* GENERATED FILE. Generated from router-schemas/kling/videos-lip-sync.json by `pnpm code-pages:gen`. */}
import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx";
@@ -176,7 +177,7 @@ curl https://api.comfy.org/v2/models/kling/videos-lip-sync/requests/$REQUEST_ID
### 入力
- コールバック通知アドレス。タスクのステータスが変更されるとサーバーから通知されます。
+ コールバック通知アドレス。タスクのステータスが変更されるとサーバーから通知されます。無視されます: comfy-api は転送前にこのフィールドを破棄します。Comfy Router がユーザーに代わってポーリングします。
形式: `uri`
@@ -246,7 +247,7 @@ Router が `GET /v2/models/kling/videos-lip-sync/openapi.json` で提供する
- タスク作成時間、Unix タイムスタンプ(ミリ秒)
+ タスク作成時間
@@ -300,7 +301,7 @@ Router が `GET /v2/models/kling/videos-lip-sync/openapi.json` で提供する
- タスク更新時間、Unix タイムスタンプ(ミリ秒)
+ タスク更新時間
diff --git a/ja/development/comfy-router/models/runway/gen4-image/code.mdx b/ja/development/comfy-router/models/runway/gen4-image/code.mdx
index 02df1cab50..c90c83b9f5 100644
--- a/ja/development/comfy-router/models/runway/gen4-image/code.mdx
+++ b/ja/development/comfy-router/models/runway/gen4-image/code.mdx
@@ -2,16 +2,17 @@
title: "Comfy Router で Gen 4 Image を使用する"
description: "Comfy Router 経由で runway/gen4_image を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて説明します。"
sidebarTitle: "Gen 4 Image"
-translationSourceHash: c5792f5c
+translationSourceHash: 51dc9815
translationFrom: development/comfy-router/models/runway/gen4-image/code.mdx
translationBlockHashes:
"_intro": f3b89ce9
"Quick start": 82a202eb
- "Schema": d889abf3
+ "Schema": 1160ec6d
"Examples": 291dbf54
---
+
{/* GENERATED FILE. Generated from router-schemas/runway/gen4_image.json by `pnpm code-pages:gen`. */}
import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx";
@@ -168,7 +169,7 @@ curl https://api.comfy.org/v2/models/runway/gen4_image/requests/$REQUEST_ID \
- エンコードされた画像を含む HTTPS URL またはデータ URI
+ エンコードされた画像を含む HTTPS URL、Runway のアップロード URI(runway://)、またはデータ URI
Router が `GET /v2/models/runway/gen4_image/openapi.json` で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する対象となるドキュメントと同じものです。
@@ -186,7 +187,7 @@ Router が `GET /v2/models/runway/gen4_image/openapi.json` で提供するスキ
- 完了した生成のアセット URL。`runway/gen4_image` の場合、各要素は画像 URL です。タスクが正常に終了すると含まれます。このリストが結果そのものです。
+ 完了した生成のアセット URL。`runway/gen4_image` の場合、各要素は画像URL です。タスクが正常に終了すると含まれます。このリストが結果そのものです。
diff --git a/ja/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx b/ja/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx
index b0b1763d17..1b71dd32b0 100644
--- a/ja/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx
+++ b/ja/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx
@@ -2,16 +2,17 @@
title: "Comfy Router で Grok Imagine Image 2.0 を使用する"
description: "Comfy Router 経由で xai/grok-imagine-image-2.0 を呼び出します: endpoint、リクエスト形状、Router が返すレスポンスについて説明します。"
sidebarTitle: "Grok Imagine Image 2.0"
-translationSourceHash: 83fe91a1
+translationSourceHash: e062dc40
translationFrom: development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx
translationBlockHashes:
"_intro": 614e2e15
"Quick start": ff9945c8
- "Schema": faf9e081
+ "Schema": cb29dfae
"Examples": 3222291b
---
+
{/* GENERATED FILE. Generated from router-schemas/xai/grok-imagine-image-2.0.json by `pnpm code-pages:gen`. */}
import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx";
@@ -172,9 +173,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-2.0/requests/$REQUES
- 出力画像の品質。grok-imagine-image-2.0 では価格ティアを選択します(low/medium。デフォルトは medium)。その他のモデルは現在これを無視します。
+ 出力画像の品質。grok-imagine-image-2.0 では価格ティアを選択します(low、medium、または auto。省略時は xAI のデフォルトとなり、auto は生成時には low、編集時には medium として扱われます)。その他のモデルはこれを無視します。
- 指定可能な値: `low`, `medium`, `high`
+ 指定可能な値: `low`, `medium`, `high`, `auto`
diff --git a/ja/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx b/ja/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx
index ea409df086..253d97c259 100644
--- a/ja/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx
+++ b/ja/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx
@@ -2,16 +2,17 @@
title: "Grok Imagine Image Pro を Comfy Router で使用する"
description: "Comfy Router 経由で xai/grok-imagine-image-pro を呼び出す: エンドポイント、リクエストの形状、Router が返すレスポンス。"
sidebarTitle: "Grok Imagine Image Pro"
-translationSourceHash: 7932bb72
+translationSourceHash: 773b1560
translationFrom: development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx
translationBlockHashes:
"_intro": 97d341e4
"Quick start": 3a4bd585
- "Schema": 5d56d158
+ "Schema": 805c771c
"Examples": 3222291b
---
+
{/* GENERATED FILE. Generated from router-schemas/xai/grok-imagine-image-pro.json by `pnpm code-pages:gen`. */}
import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx";
@@ -172,9 +173,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-pro/requests/$REQUES
- 出力画像の品質。grok-imagine-image-2.0 では価格ティアを選択します(low/medium、デフォルトは medium)。その他のモデルでは現在無視されます。
+ 出力画像の品質。grok-imagine-image-2.0 では価格ティアを選択します: low、medium、または auto(省略時の xAI のデフォルト。auto は生成時には low、編集時には medium として提供されます)。その他のモデルでは無視されます。
- 指定可能な値: `low`, `medium`, `high`
+ 指定可能な値: `low`, `medium`, `high`, `auto`
diff --git a/ja/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx b/ja/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx
index 5f7d233efb..7e70c49bfd 100644
--- a/ja/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx
+++ b/ja/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx
@@ -2,16 +2,17 @@
title: "Comfy Router で Grok Imagine Image Quality を使用する"
description: "Comfy Router 経由で xai/grok-imagine-image-quality を呼び出します: エンドポイント、リクエストの形状、Router が返すレスポンスについて。"
sidebarTitle: "Grok Imagine Image Quality"
-translationSourceHash: 923968d2
+translationSourceHash: 9f6e16d5
translationFrom: development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx
translationBlockHashes:
"_intro": 72081c22
"Quick start": 799275b8
- "Schema": e0fcef44
+ "Schema": e2c96ff6
"Examples": 3222291b
---
+
{/* GENERATED FILE. Generated from router-schemas/xai/grok-imagine-image-quality.json by `pnpm code-pages:gen`. */}
import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx";
@@ -172,9 +173,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-quality/requests/$RE
- 出力画像の品質。grok-imagine-image-2.0 では価格ティア(low/medium。デフォルトは medium)を選択します。その他のモデルは現在この項目を無視します。
+ 出力画像の品質。grok-imagine-image-2.0 では価格ティアを選択します: low、medium、または auto(省略時は xAI のデフォルト。auto は生成時には low、編集時には medium を提供します)。その他のモデルはこの項目を無視します。
- 指定可能な値: `low`、`medium`、`high`
+ 指定可能な値: `low`、`medium`、`high`、`auto`
diff --git a/ja/development/comfy-router/models/xai/grok-imagine-image/code.mdx b/ja/development/comfy-router/models/xai/grok-imagine-image/code.mdx
index 92b8b1dfc1..0fefac3e30 100644
--- a/ja/development/comfy-router/models/xai/grok-imagine-image/code.mdx
+++ b/ja/development/comfy-router/models/xai/grok-imagine-image/code.mdx
@@ -2,16 +2,17 @@
title: "Comfy Router で Grok Imagine Image を使う"
description: "Comfy Router 経由で xai/grok-imagine-image を呼び出す: エンドポイント、リクエスト形状、Router が返すレスポンスについて説明します。"
sidebarTitle: "Grok Imagine Image"
-translationSourceHash: 9cfb938a
+translationSourceHash: 2e5c55ad
translationFrom: development/comfy-router/models/xai/grok-imagine-image/code.mdx
translationBlockHashes:
"_intro": a2e97c88
"Quick start": a5495331
- "Schema": 1d17b83a
+ "Schema": 171da7d5
"Examples": 3222291b
---
+
{/* GENERATED FILE. Generated from router-schemas/xai/grok-imagine-image.json by `pnpm code-pages:gen`. */}
import RouterCodeFooter from "/snippets/ja/comfy-router/model-code-footer.mdx";
@@ -172,9 +173,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image/requests/$REQUEST_ID
- 出力画像の品質。grok-imagine-image-2.0 では、これが価格ティアを選択します(low/medium。デフォルトは medium)。その他のモデルは現在のところこれを無視します。
+ 出力画像の品質。grok-imagine-image-2.0 では、これが価格ティアを選択します: low、medium、または auto(省略時は xAI のデフォルト。auto は生成時には low、編集時には medium として扱われます)。その他のモデルはこれを無視します。
- 取り得る値: `low`、`medium`、`high`
+ 取り得る値: `low`、`medium`、`high`、`auto`
diff --git a/ja/development/comfy-router/realtime.mdx b/ja/development/comfy-router/realtime.mdx
new file mode 100644
index 0000000000..81773cdef5
--- /dev/null
+++ b/ja/development/comfy-router/realtime.mdx
@@ -0,0 +1,223 @@
+---
+title: "Comfy Router リアルタイム音声セッション"
+sidebarTitle: "リアルタイム音声"
+description: "Comfy Router 経由で Grok Voice のリアルタイム WebSocket セッションを開きます。エンドポイント、認証、秒単位の料金、セッション制限、発生する可能性のあるエラーとクローズコードについて説明します。"
+translationSourceHash: e4024a38
+translationFrom: development/comfy-router/realtime.mdx
+translationBlockHashes:
+ "_intro": a85f88e5
+ "Endpoint": 2ae36abf
+ "Authentication": 582120fe
+ "Connect": b61ae8c6
+ "Events": a3ac8c47
+ "Pricing": 25d35f6c
+ "Limits": 85e21dff
+ "Errors": 3085ba65
+ "Next": 3e8c1bd8
+---
+Comfy Routerは、falが提供するxAIのGrok Voiceとのリアルタイム音声対音声セッションを中継します。Comfy APIキーを使ってRouterへのWebSocketを1本開きます。Routerはアカウントとクレジットを確認し、上流でセッションを開いてから、イベントを双方向に中継します。セッションの秒数に応じてComfyクレジットから支払います。
+
+## エンドポイント
+
+```text
+wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime
+```
+
+リクエストは WebSocket アップグレードです(`GET` に `Connection: Upgrade` と `Upgrade: websocket` を指定)。それ以外のリクエストは `426` で拒否されます。
+
+## 認証
+
+アップグレードリクエストのヘッダーで、`X-API-Key: comfyui-...` または `Authorization: Bearer comfyui-...` のいずれかの形式で Comfy APIキーを送信してください。Router はクエリ文字列や WebSocket サブプロトコルからキーを読み取りません。
+
+
+ブラウザは WebSocket にヘッダーを設定できず、Comfy APIキーがブラウザに渡っては決してなりません。サーバーからセッションを開き、オーディオを自身でブラウザへ中継してください。
+
+
+## 接続
+
+アップグレードが成功したら、xAI が Grok Voice 向けにドキュメント化しているリアルタイムイベントを送受信します。この例ではセッションを設定し、1 回のテキストターンを送信して、受信した各イベントタイプを出力します。
+
+
+
+```python Python
+# pip install websockets msgpack
+import asyncio
+import os
+
+import msgpack
+import websockets
+
+URL = "wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime"
+
+
+async def send(ws, event):
+ await ws.send(msgpack.packb(event))
+
+
+async def main():
+ async with websockets.connect(
+ URL,
+ additional_headers={"X-API-Key": os.environ["COMFY_API_KEY"]},
+ ) as ws:
+ await send(ws, {
+ "type": "session.update",
+ "session": {
+ "voice": "eve",
+ "instructions": "You are a helpful assistant.",
+ "turn_detection": {"type": "server_vad"},
+ },
+ })
+ await send(ws, {
+ "type": "conversation.item.create",
+ "item": {
+ "type": "message",
+ "role": "user",
+ "content": [{"type": "input_text", "text": "Hello!"}],
+ },
+ })
+ await send(ws, {"type": "response.create"})
+
+ async for message in ws:
+ if isinstance(message, str):
+ continue # fal 独自の x-fal-message フレーム
+ event = msgpack.unpackb(message)
+ print(event["type"])
+ if event["type"] == "response.done":
+ break
+
+
+asyncio.run(main())
+```
+
+```javascript Node.js
+// npm install ws @msgpack/msgpack
+import WebSocket from "ws";
+import { encode, decode } from "@msgpack/msgpack";
+
+const ws = new WebSocket(
+ "wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime",
+ { headers: { "X-API-Key": process.env.COMFY_API_KEY } },
+);
+
+ws.on("unexpected-response", (req, res) => {
+ // アップグレードは拒否されました。JSON ボディに理由が示されます。
+ let body = "";
+ res.on("data", (chunk) => (body += chunk));
+ res.on("end", () => console.error(res.statusCode, body));
+});
+
+const send = (event) => ws.send(encode(event));
+
+ws.on("open", () => {
+ send({
+ type: "session.update",
+ session: {
+ voice: "eve",
+ instructions: "You are a helpful assistant.",
+ turn_detection: { type: "server_vad" },
+ },
+ });
+ send({
+ type: "conversation.item.create",
+ item: {
+ type: "message",
+ role: "user",
+ content: [{ type: "input_text", text: "Hello!" }],
+ },
+ });
+ send({ type: "response.create" });
+});
+
+ws.on("message", (data, isBinary) => {
+ if (!isBinary) return; // fal 独自の x-fal-message フレーム
+ const event = decode(data);
+ console.log(event.type);
+ if (event.type === "response.done") ws.close();
+});
+
+ws.on("close", (code) => console.log("closed", code));
+```
+
+
+
+終わったらすぐにソケットを閉じてください。課金は最後のレスポンスまでではなく、セッションが閉じるまで続きます。
+
+## イベント
+
+Router は独自のイベントプロトコルを定義していません。サーバーイベントは fal が送信するそのままの形で届き、Router が受け付けるクライアントイベントは変更されずに転送されます。イベント一覧、セッションフィールド、ボイス、オーディオ形式については、次を参照してください:
+
+- [xAI Speech to Speech](https://docs.x.ai/developers/model-capabilities/audio/speech-to-speech) および xAI の [realtime イベントスキーマ](https://docs.x.ai/voice-realtime.ws.json)
+- fal の [Grok Voice realtime モデルページ](https://fal.ai/models/xai/grok-voice/realtime) とその [API ページ](https://fal.ai/models/xai/grok-voice/realtime/api)
+
+各クライアントイベントは、例のように 1 つの msgpack バイナリメッセージとして送信してください。これは fal の realtime クライアントが使用するフレーミングであり、モデルのイベントも同じ方法で、`session.created` で始まる msgpack バイナリメッセージとして返されます。fal はさらに、タイプ `x-fal-message` の独自の JSON テキストメッセージ(タイミング情報)も送信します。これらはスキップできます。Router のチェックでは、クライアントイベントを 1 つの JSON テキストメッセージとして受け取ることもできますが、クライアントで JSON をテストしていない限り msgpack を使用してください。
+
+Router は転送する前に各クライアントイベントをチェックします:
+
+- **イベントタイプ:** `session.update`、`input_audio_buffer.append`、`input_audio_buffer.commit`、`input_audio_buffer.clear`、`conversation.item.create`、`conversation.item.delete`、`conversation.item.truncate`、`response.create`、`response.cancel`、および fal の `x-fal-session.configure`。
+- **モデル:** `session.update` 内の `model` は `grok-voice-latest`、`grok-voice-3.0`、または `grok-voice-2.0` でなければなりません。
+- **ツール:** クライアントが実行する関数ツールは許可されます。サーバー側ツール(Web 検索、X 検索、ファイル検索、MCP)は拒否されます。
+- **メディア:** 画像およびビデオ入力は拒否されます。セッションは音声とテキストのみです。
+- **サイズ:** 1 つのクライアントメッセージは最大 1 MiB です。
+
+拒否されたイベントは転送されず、Router はクローズコード `1008` でセッションを閉じます。
+
+## 料金
+
+セッションの料金は**1秒あたり$0.0011869**です(1分あたり約$0.0712、または1秒あたり0.2504クレジット、1分あたり約15.0クレジット、211クレジット = 1米ドルの場合)。セッションが開いている間は15秒単位で課金され、最後の端数分は秒単位で切り上げて課金されます。課金はアップグレード時点からソケットが閉じるまで継続し、オーディオが流れているかどうかは関係ありません。
+
+## 制限
+
+| 制限 | 値 |
+| --- | --- |
+| アカウントあたりのセッション数 | 同時に開けるセッションは 1 つです。2 つ目を開くと、`router.realtime.session_already_live` を伴う `429` が返されます。 |
+| セッションの長さ | 最大 30 分で、接続時点であなたのクレジット残高が賄える時間を超えることはありません。 |
+| セッション中のクレジット | Router は 15 秒ごとにあなたの残高を再確認し、残高が次の 1 秒分を賄えなくなるとセッションを終了します。 |
+| 接続レート | 各アップグレード試行は、あなたの[呼び出し元ごとのリクエストレート](/ja/development/comfy-router/limitations#リクエストは呼び出し元ごとにレート制限される)にカウントされ、他の Router 呼び出しと共有されます。 |
+
+セッションが時間制限に達した場合、またはクレジットが不足した場合、接続はクローズフレームなしで閉じられることがあります(多くの場合、クローズコード `1006` として現れます)。クレジットを追加した後にのみ再接続するか、より長い時間が必要な場合は新しいセッションを開始してください。
+
+## エラー
+
+### アップグレード前
+
+Router が接続を拒否した場合、プロトコルを切り替えずに HTTP ステータスと JSON ボディで応答します:
+
+```json
+{
+ "detail": "Insufficient credits to open a realtime session.",
+ "error_type": "insufficient_credits",
+ "code": "router.realtime.insufficient_credits"
+}
+```
+
+分岐には `code` を使用してください。`detail` は人間向けです。
+
+| ステータス | `code` | 原因 | 対処 |
+| --- | --- | --- | --- |
+| `426` | `router.realtime.upgrade_required` | リクエストが WebSocket のアップグレードではありませんでした。 | WebSocket クライアントで接続してください。 |
+| `401` | `router.realtime.unauthorized` | APIキーが不足しているか、無効です。 | 有効なキーを `X-API-Key` または `Authorization: Bearer` で送信してください。 |
+| `402` | `router.realtime.insufficient_credits` | 残高がセッションの最低1秒分にも満たない状態です。 | クレジットを追加してから再接続してください。 |
+| `402` | `router.realtime.spend_denied` | セッションの課金対象となるウォレットに資金がありません。ボディ内の `denied_reason` と `billed_workspace` がどのウォレットかを示します。 | そのワークスペースにクレジットを追加してから再接続してください。 |
+| `403` | `router.realtime.provider_disabled` | ワークスペースのパートナープロバイダーポリシーがこのプロバイダーを許可していません。 | ワークスペースの管理者に許可を依頼してください。 |
+| `404` | `router.realtime.model_not_allowed` | URL 内のモデルはリアルタイムでは利用不可です。 | URL を確認してください。 |
+| `429` | `router.realtime.rate_limited` | リクエストレートを超過しました。 | `Retry-After` の時間だけ待ってから再試行してください。 |
+| `429` | `router.realtime.session_already_live` | アカウントで既に別のセッションが開かれています。 | 先にそのセッションを閉じてください。 |
+| `429` | `router.realtime.concurrency_limit` | パートナーモデルの同時呼び出し数が多すぎます。 | 同時実行数を減らしてから再試行してください。 |
+| `502` | `router.realtime.upstream_refused`, `router.realtime.token_mint_failed` | 上流プロバイダーがセッションを開きませんでした。 | バックオフを伴って再試行してください。 |
+| `503` | その他の `router.realtime.*` コード | リアルタイムセッションが一時的に利用できません。 | バックオフを伴って再試行してください。 |
+
+### アップグレード後
+
+| クローズコード | 意味 | 対処 |
+| --- | --- | --- |
+| `1008` | クライアントイベントが拒否されました([イベント](#イベント) を参照)。 | イベントを修正してください。セッションは終了します。 |
+| `1012` | Router が再起動中です。 | 再接続してください。新しいセッションが開始され、新しいアップグレード時点から課金されます。 |
+| `1006`(クローズフレームなし) | セッションが時間制限に達した、またはクレジットが不足した際にクライアントが報告する値としてよく見られます。ネットワーク切断も同じように見えます。 | クレジットを追加するか、新しいセッションを開始してください。 |
+
+その他のクローズコードは fal または xAI からのものです。[イベント](#イベント) でリンクされている各社のドキュメントを参照してください。
+
+## 次のステップ
+
+- [課金](/ja/development/comfy-router/billing): Router の課金方法と利用量の照合方法。
+- [エラーとリトライ](/ja/development/comfy-router/errors): 他の Router 呼び出しが返すエラーの分類。
+- [制限事項](/ja/development/comfy-router/limitations): リクエストレートやその他の制限。
diff --git a/ja/development/comfy-router/reference.mdx b/ja/development/comfy-router/reference.mdx
index fd47f1f242..6e131f4990 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: a6f99965
+translationSourceHash: aee933a1
translationFrom: development/comfy-router/reference.mdx
translationBlockHashes:
"_intro": 3f6e5d23
- "Endpoints": 222fd740
+ "Endpoints": e0879d3c
"Error buckets": 02a09cb4
"Response headers": 403c8bf5
- "Pre-flight cost estimates": 5952af3f
- "Result assets": 18fe6dad
+ "Pre-flight cost estimates": f0ba96a1
+ "Result assets": 5936427c
"Per-model input and output schemas": 61c6bde8
- "Schemas": 984bd216
+ "Schemas": c1245cc9
---
@@ -29,6 +29,7 @@ translationBlockHashes:
+
{/*
生成済みファイル: 手動で編集しないでください。
@@ -51,7 +52,7 @@ Comfy API キーは Bearer トークンとして送信することもできま
### `GET /v2/models`
-**Comfy Router で実行できるモデルを一覧表示します。**
+**Comfy Router が実行できるモデルを一覧表示します。**
利用可能なモデル ID と課金情報を一覧表示します。`has_more` が true の間は `next_cursor` を使用します。
@@ -60,7 +61,7 @@ Comfy API キーは Bearer トークンとして送信することもできま
不透明なページネーションカーソル。
- 型: [`RouterPageCursor`](#routerpagecursor):`next_cursor` として返される不透明なカーソル、1~512 文字
+ 型: [`RouterPageCursor`](#routerpagecursor)。`next_cursor` として返される不透明なカーソル。1–512 文字
@@ -76,13 +77,13 @@ Comfy API キーは Bearer トークンとして送信することもできま
**レスポンス**
- OK - モデルカタログの 1 ページ。
+ OK。モデルカタログの 1 ページ。
- ボディ: [`RouterModelListResponse`](#routermodellistresponse)、ヘッダー: `X-Comfy-Request-Id`、`ETag`、`Cache-Control`
+ 本文: [`RouterModelListResponse`](#routermodellistresponse)。ヘッダー: `X-Comfy-Request-Id`、`ETag`、`Cache-Control`
- Not Modified - 呼び出し元が `If-None-Match` で送信した `ETag` 以降、ページは変更されていません。
+ Not Modified。呼び出し元が `If-None-Match` で送信した `ETag` 以降、ページは変更されていません。
ヘッダー: `X-Comfy-Request-Id`、`ETag`、`Cache-Control`
@@ -90,49 +91,49 @@ Comfy API キーは Bearer トークンとして送信することもできま
無効なリクエストです。エラータイプとリクエストボディを確認してください。
- ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 本文: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
認証情報が不足しているか無効です。
- ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 本文: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
- この呼び出し元またはモデルでは、このリクエストは許可されていません。
+ この呼び出し元またはモデルに対して、リクエストは許可されていません。
- ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 本文: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
- Router は一時的に利用できません。バックオフして再試行してください。
+ ルーターは一時的に利用できません。バックオフを伴って再試行してください。
- ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 本文: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
### `GET /v2/models/{provider}/{model}`
-**正規のモデル ID で 1 つのパートナーモデルのカタログエントリを取得します。**
+**正規のモデルIDでパートナーモデルのカタログエントリを1件取得します。**
-カタログ全体を一覧せずに、1 つのモデルの詳細を取得します。
+カタログ全体を一覧表示せずに、1つのモデルの詳細を取得します。
**パラメータ**
- 正規の `{provider}/{model}` モデル ID のプロバイダー部分。
+ 正規の `{provider}/{model}` モデルIDのプロバイダー部分。
- 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字のスラッグ(例: `anthropic`)、最大 64 文字
+ 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字スラッグ(例: `anthropic`)、最大64文字
- 正規の `{provider}/{model}` モデル ID のモデル部分。
+ 正規の `{provider}/{model}` モデルIDのモデル部分。
- 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字のスラッグ(例: `claude-opus-4-6`)、最大 128 文字
+ 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字スラッグ(例: `claude-opus-4-6`)、最大128文字
- 呼び出し元が以前の `200` から保持している `ETag`。
+ 呼び出し元が以前の `200` 応答から保持している `ETag`。
**レスポンス**
@@ -140,81 +141,81 @@ Comfy API キーは Bearer トークンとして送信することもできま
OK - モデルのカタログエントリ。
- ボディ: [`RouterModelDetail`](#routermodeldetail) -- ヘッダー: `X-Comfy-Request-Id`、`ETag`、`Cache-Control`
+ ボディ: [`RouterModelDetail`](#routermodeldetail) -- ヘッダー: `X-Comfy-Request-Id`, `ETag`, `Cache-Control`
- Not Modified - `If-None-Match` で呼び出し元が送信した `ETag` 以降、エントリは変更されていません。
+ Not Modified - 呼び出し元が `If-None-Match` で送信した `ETag` 以降、エントリは変更されていません。
- ヘッダー: `X-Comfy-Request-Id`、`ETag`、`Cache-Control`
+ ヘッダー: `X-Comfy-Request-Id`, `ETag`, `Cache-Control`
認証情報が不足しているか無効です。
- ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
- この呼び出し元またはモデルでは、このリクエストは許可されていません。
+ この呼び出し元またはモデルに対してリクエストは許可されていません。
- ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
- モデル ID が見つかりませんでした。
+ モデルIDが見つかりませんでした。
- ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
- Router は一時的に利用できません。バックオフして再試行してください。
+ Routerは一時的に利用できません。バックオフして再試行してください。
- ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
### `POST /v2/models/{provider}/{model}`
-**正規のモデル ID を指定してパートナーモデルを同期的に実行します。**
+**正規のモデル ID でパートナーモデルを同期的に実行します。**
-モデルを実行し、完了した結果を同じレスポンスで受け取ります。
+モデルを実行し、同じレスポンスで完了した結果を受け取ります。
**パラメータ**
正規の `{provider}/{model}` モデル ID のプロバイダー部分。
- 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字スラッグ(例: `anthropic`)、最大 64 文字
+ 型: [`RouterProviderSegment`](#routerprovidersegment)(英数字スラッグ、例: `anthropic`、最大 64 文字)
正規の `{provider}/{model}` モデル ID のモデル部分。
- 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字スラッグ(例: `claude-opus-4-6`)、最大 128 文字
+ 型: [`RouterModelSegment`](#routermodelsegment)(英数字スラッグ、例: `claude-opus-4-6`、最大 128 文字)
- 呼び出し元が生成するキーで、1 つの論理的な呼び出しの再試行を安全にします。
+ 1 つの論理的な呼び出しを安全に再試行できるようにする、呼び出し元が生成するキー。
1〜255 文字
- このモデルを現在のデフォルトの代わりに処理する代替プロバイダーを選択します。`fal`、`wavespeed`、`runware`、`higgsfield` が代替プロバイダーであり、`GET /v2/models/{provider}/{model}` は、あるモデルがそのうちどれをサポートしているかを報告します。拒否は固定された順序でチェックされ、前段のチェックは後段のチェックの結果に関係なく応答します。未認識の値、つまり登録済みプロバイダーでないものは `400` で拒否されます。次に、ボディがマルチパート操作(編集)を選択するリクエストで代替プロバイダーを指定した場合、`detail` が「this request's `image` selects the edit operation」で始まる `409` で拒否されます。ただし、そのプロバイダーのこのモデル用トランスレーターがその操作を処理できない場合に限ります。メディアを扱えるトランスレーターを持つレッグは通常どおり処理されます。次に、bring-your-own-key 認証情報が解決されたリクエストでは、そのプロバイダーがこのモデルを処理するかどうかに関係なく、代替プロバイダーは `detail` が `this request resolved a BYOK credential` で始まる `409` で拒否されます(そのレスポンスを参照)。次に、指定されたプロバイダー自身のゲートがあり、そのプロバイダーがあなたに対して有効化されていない場合は `error_type: not_enabled` を伴う `403` で、ゲートを評価できない場合は `error_type: service_unavailable` を伴う `503` で拒否します。そして、これら 4 つすべてを通過した後にのみ、このモデル用のレッグを持たない実在のプロバイダーが `error_type: invalid_input` を伴う `400` で拒否されます。これは未認識の値と同じ応答です。`fallback_provider` は、bring-your-own-key リクエスト、ボディがマルチパート操作を選択するリクエスト、および `strict_mode=true` の場合には、拒否されるのではなく無効になります。
+ このモデルを提供する代替プロバイダーを、現在のデフォルトの代わりに選択します。代替プロバイダーは `fal`、`wavespeed`、`runware`、`higgsfield` で、あるモデルがそのうちどれをサポートしているかは `GET /v2/models/{provider}/{model}` が報告します。拒否は固定の順序でチェックされ、先のものは後のものが該当するかどうかに関係なく応答します。認識できない値(登録済みプロバイダーではないもの)は `400` で拒否されます。次に、ボディがマルチパート操作(編集)を選択するリクエストで代替プロバイダーを指定した場合、そのプロバイダーのこのモデル用トランスレーターがその操作を処理できないときに限り、`detail` が「this request's `image` selects the edit operation」で始まる `409` で拒否されます(メディアを扱えるトランスレーターを持つ leg は通常どおり処理されます)。次に、BYOK 認証情報を解決したリクエストでは、そのプロバイダーがこのモデルを提供しているかどうかに関係なく、`detail` が `this request resolved a BYOK credential` で始まる `409` で拒否されます(そのレスポンスを参照)。次に、指定されたプロバイダー自身のゲートがあり、そのプロバイダーが有効になっていない場合は `error_type: not_enabled` を伴う `403`、ゲートを評価できない場合は `error_type: service_unavailable` を伴う `503` で拒否します。そしてこの 4 つすべてを通過した後にのみ、このモデル用の leg を持たない実在のプロバイダーが `error_type: invalid_input` を伴う `400` で拒否されます。これは認識できない値の場合と同じ応答です。`fallback_provider` は、BYOK リクエスト、ボディがマルチパート操作を選択するリクエスト、および `strict_mode=true` では、拒否されるのではなく無効になります。
- `model_provider` と組み合わせた場合にのみ意味を持ちます。
+ `model_provider` と併用した場合にのみ意味を持ちます。
デフォルト: False
- 最初の試行が Router または試行したプロバイダーに起因する理由で失敗した場合に、Router がこの呼び出しをモデルの他の登録済みプロバイダーに対して再試行するかどうかを制御します。省略した場合、または `false` 以外の値の場合はフォールバックが有効のままです。`false` で無効になります。フォールバックが成功したレスポンスには `X-Comfy-Router-Fallback-Provider` が付与されます。bring-your-own-key 認証情報が解決されたリクエストでは、このパラメータの値に関係なくフォールバックは利用できません。試行は単に行われず、最初の失敗がそのまま返されます。これは拒否ではなく無効であり、ここから `409` が発生することはありません。同じ理由で、ボディがマルチパート操作を選択するリクエストおよび `strict_mode=true` の場合も同様です。いずれも呼び出しを 1 つのプロバイダーに結び付け、別のプロバイダーに対して忠実に再生することはできないため、フォールバックは拒否されるのではなく単にスキップされます。その `409` で拒否されるのは明示的な `model_provider` のみであり、この無条件のスキップとは異なり、マルチパートの `409` はトランスレーターがその操作を処理できないレッグにのみ適用されます。
+ 最初の試行が Router または試行したプロバイダーに起因する理由で失敗したときに、Router がこの呼び出しをモデルの他の登録済みプロバイダーに対して再試行するかどうかを制御します。省略した場合、または `false` 以外の値の場合はフォールバックは有効のままです。`false` を指定すると無効になります。フォールバックに成功したレスポンスには `X-Comfy-Router-Fallback-Provider` が付与されます。BYOK 認証情報を解決したリクエストでは、このパラメータの値に関係なくフォールバックは利用できません。試行自体が行われず、最初の失敗がそのまま返されます。これは拒否ではなく無効化であり、ここから `409` が発生することはありません。同じ理由で、ボディがマルチパート操作を選択するリクエストおよび `strict_mode=true` の場合も同様です。いずれも呼び出しを 1 つのプロバイダーに束縛し、別のプロバイダーに対して忠実に再現することはできないため、フォールバックは拒否されるのではなく単にスキップされます。この `409` で拒否されるのは明示的な `model_provider` のみで、この無条件のスキップとは異なり、そのマルチパート `409` はトランスレーターがその操作を処理できない leg にのみ適用されます。
- このモデルの入力スキーマが宣言していないトップレベルのリクエストボディフィールドを、受け入れるのではなく拒否することをオプトインします。ネストされたフィールドはチェックされません。スキーマが未宣言のフィールドを許可しているモデル、または作成済みのスキーマを持たないモデルでは何も拒否されず、`strict_mode=true` で送信されたキュー中の送信でも同様です。
+ このモデルの入力スキーマが宣言していないトップレベルのリクエストボディフィールドを、受け入れるのではなく拒否することをオプトインします。ネストされたフィールドはチェックされず、スキーマが未宣言のフィールドを許可しているモデル、または作成済みスキーマを持たないモデルの場合、あるいは `strict_mode=true` で送信されたキュー中の送信では、何も拒否されません。
デフォルト: False
@@ -223,122 +224,120 @@ Comfy API キーは Bearer トークンとして送信することもできま
`application/json` -- [`RouterModelInput`](#routermodelinput)(必須)
-パートナーモデルのネイティブ JSON 入力です。`model_provider` を指定しない場合、リクエストはモデルのデフォルトプロバイダー上でネイティブディスパッチを実行し、このボディはモデル自身のネイティブスキーマとなって、そのまま転送されます(`strict_mode` はそこでは意味を持たず、何も変わりません)。`model_provider` が代替プロバイダーを選択し、`strict_mode=false`(デフォルト)の場合、ボディは送信前にそのプロバイダーの実際のスキーマへ変換されます。正確に表現できないネイティブフィールドはドロップされ、レスポンスの `X-Comfy-Router-Dropped-Params` ヘッダーで開示されます。暗黙に破棄されることはありません。`model_provider` が代替プロバイダーを選択し、`strict_mode=true` の場合、変換は実行されません。ボディはすでにその代替プロバイダー自身の実際のスキーマである必要があり(このモデルのネイティブなものではありません。`strict_mode` を参照)、そのまま転送されます。ボディのフィールド自体も、複数の操作をサポートするモデルで Router が実行する操作を選択します。編集可能な画像モデルの場合、入力画像を含めるとテキストから画像への操作から画像から画像へ(編集)の操作に切り替わり、これには独自のレートが適用される場合があります。Seedance ビデオモデルの場合、`content[].role` が操作を選択します(最初のフレーム画像は画像から動画へを選択し、参照画像またはクリップは参照から動画を選択します)。ネイティブディスパッチでは、Seedance の課金は役割ではなく `content` 内のメディア種別に従います。動画入力が含まれるリクエストは動画から動画へとして課金され、そうでなければ画像が含まれるものは画像から動画へとして、それ以外はテキストから動画へとして課金されます。ただし、`draft_task` アイテムからの最終レンダーは、それがレンダリングする Draft の操作として課金されます。一部のモデルではテキストから動画へと画像から動画へが同じレートで課金されます。`model_provider` が代替プロバイダーを選択する場合、条件付けされた各操作にはそのプロバイダー独自のレートが適用される場合があります。
+パートナーモデルのネイティブ JSON 入力。`model_provider` を指定しない場合、リクエストはモデルのデフォルトプロバイダー上でネイティブディスパッチを実行し、このボディはモデル自身のネイティブスキーマであり、変更されずに転送されます(`strict_mode` はそこでは意味を持たず、何も変わりません)。`model_provider` で代替プロバイダーを選択し、`strict_mode=false`(デフォルト)の場合は、送信前にボディがそのプロバイダーの実際のスキーマに変換されます。正確に表現できないネイティブフィールドは削除され、レスポンスの `X-Comfy-Router-Dropped-Params` ヘッダーで開示されます。暗黙に処理されることはありません。`model_provider` で代替プロバイダーを選択し、`strict_mode=true` の場合は変換が行われません。ボディはすでにその代替プロバイダー自身の実際のスキーマである必要があり(このモデルのネイティブスキーマではありません。`strict_mode` を参照)、変更されずに転送されます。ボディのフィールド自体が、複数の操作をサポートするモデルで Router が実行する操作も選択します。編集可能な画像モデルの場合、入力画像を含めるとテキストから画像への操作から画像から画像へ(編集)操作に切り替わり、独自のレートで課金される場合があります。Seedance ビデオモデルの場合、`content[].role` が操作を選択します(先頭フレームの画像は画像から動画へ、参照画像またはクリップは参照から動画を選択します)。ネイティブディスパッチでは、Seedance の課金は役割ではなく `content` 内のメディア種別に従います。ビデオ入力が 1 つでもあるリクエストは動画から動画へとして課金され、そうでなければ画像が 1 つでもあれば画像から動画へ、それ以外はテキストから動画へとして課金されます。ただし `draft_task` 項目からの最終レンダーは、それがレンダリングする Draft の操作として課金されます。一部のモデルはテキストから動画へと画像から動画へで同じレートを課金します。`model_provider` で代替プロバイダーを選択する場合、条件付けされた各操作はそのプロバイダー自身のレートで課金される場合があります。
-**レスポンス**
-
-
- OK - `model_provider` なしの場合、または `model_provider` ありで `strict_mode=false`(デフォルト。可能な場合はこのモデルのネイティブな契約に変換して返し、変換に失敗した場合は代替プロバイダー自身の生のレスポンスにフォールバックします。ログに記録され、サイレントにはなりません)の場合、形状はこのモデル自身のネイティブな出力です。`strict_mode=true` の場合は、代替プロバイダーのレスポンスが変更されずにそのまま返されます。パートナーが生成結果をバイト列として直接返すモデルでは、ボディは `application/json` ではなく、パートナー自身の `Content-Type` に基づくそのバイト列になります。レスポンスの `Content-Type` で分岐し、JSON ドキュメントであると想定しないでください。
+**レスポンス**
+ OK - `model_provider` なしの場合、または `model_provider` ありかつ `strict_mode=false`(デフォルト。可能な場合はこのモデルのネイティブな契約に翻訳し直され、翻訳に失敗した場合は代替プロバイダー自身の生のレスポンスにフォールバックします。ログに記録され、サイレントにはなりません)の場合、形状はこのモデル自身のネイティブな出力です。`strict_mode=true` の場合は、代替プロバイダーのレスポンスがそのまま返されます。パートナーが生成結果をバイト列として直接返すモデルの場合、ボディは `application/json` ではなくパートナー自身の `Content-Type` の下にあるバイト列になります。レスポンスの `Content-Type` で分岐し、JSON ドキュメントであると仮定しないでください。
- Body: [`RouterModelOutput`](#routermodeloutput) または生のバイト列 (`*/*`) -- ヘッダー: `X-Comfy-Request-Id`, `X-Content-Type-Options`, `X-Comfy-Router-Fallback-Provider`, `X-Comfy-Router-Provider`, `X-Comfy-Router-Dropped-Params`, `X-Comfy-Credits-Used`, `Idempotent-Replayed`, `X-Committed-Spend-Limit`, `X-Committed-Spend-Current`, `X-Committed-Spend-Remaining`
+ ボディ: [`RouterModelOutput`](#routermodeloutput) または生のバイト列 (`*/*`) -- ヘッダー: `X-Comfy-Request-Id`, `X-Content-Type-Options`, `X-Comfy-Router-Fallback-Provider`, `X-Comfy-Router-Provider`, `X-Comfy-Router-Dropped-Params`, `X-Comfy-Credits-Used`, `Idempotent-Replayed`, `X-Committed-Spend-Limit`, `X-Committed-Spend-Current`, `X-Committed-Spend-Remaining`
無効なリクエストです。エラータイプとリクエストボディを確認してください。
- Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status`, `X-Comfy-Upstream-Detail`, `X-Comfy-Refusal-Subject`, `X-Comfy-Credits-Used`, `Idempotent-Replayed`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status`, `X-Comfy-Upstream-Detail`, `X-Comfy-Refusal-Subject`, `X-Comfy-Credits-Used`, `Idempotent-Replayed`
- 認証情報が不足しているか、無効です。
+ 認証情報が不足しているか無効です。
- Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
- Router のリクエストレベルの失敗です。リクエストがモデルに到達しなかったか、モデル自体が報告しなかった理由で失敗しました。
+ Router のリクエストレベルでの失敗です。リクエストがモデルに到達しなかったか、モデル自身が報告しなかった理由で失敗しました。
- Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
- この呼び出し元またはモデルに対して、このリクエストは許可されていません。
+ この呼び出し元またはモデルに対して、リクエストは許可されていません。
- Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
モデル ID が見つかりませんでした。
- Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
- `X-Comfy-Error-Type` を確認してください。`concurrency_limit_exceeded` はオリジナルの呼び出しがまだ実行中であることを意味するため、`Retry-After` を待って同じキーを再利用してください。`invalid_input` は新しいキーが必要です。このルートにおける 2 つの `invalid_input` 競合はキーに関するものではなく、新しいキーでもどちらも解消されません。`model_provider` が代替プロバイダーを指定している場合、リクエストボディが、そのプロバイダーのこのモデル用トランスレーターでは対応できないマルチパート操作(編集)を選択しているときに拒否され、その `detail` は「this request's `image` selects the edit operation」で始まります。また、その後にチェックされるものとして、リクエストがパス内のプロバイダーに対する BYOK 認証情報をすでに解決している場合にも拒否され、その `detail` は `this request resolved a BYOK credential` で始まります。`model_provider` を削除するか、BYOK 認証情報なしで(マルチパートの場合は編集もなしで)リクエストを送信してください。
+ `X-Comfy-Error-Type` を確認してください。`concurrency_limit_exceeded` は元の呼び出しがまだ実行中であることを意味するため、`Retry-After` を待って同じキーを再利用します。`invalid_input` の場合は新しいキーが必要です。このルートでの 2 つの `invalid_input` 競合はキーに関するものではなく、新しいキーでもどちらも解消されません。1 つ目は、`model_provider` が代替プロバイダーを指定している場合に、リクエストボディがそのプロバイダーのこのモデル用トランスレーターでは処理できないマルチパート操作(編集)を選択していると拒否されるもので、`detail` は "this request's `image` selects the edit operation" で始まります。2 つ目はその後チェックされるもので、リクエストがパス内のプロバイダーに対して bring-your-own-key 認証情報をすでに解決している場合に発生し、`detail` は `this request resolved a BYOK credential` で始まります。`model_provider` を削除するか、BYOK 認証情報なしで(マルチパートの場合は編集もなしで)リクエストを送信してください。
- Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (`concurrency_limit_exceeded` の場合)
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After`(`concurrency_limit_exceeded` の場合)
リクエストボディが大きすぎます。
- Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
リクエストの内容がモデルのスキーマに照らして拒否されました。
- Body: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Idempotent-Replayed`
+ ボディ: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Idempotent-Replayed`
- `X-Comfy-Error-Type` を確認してください。`concurrency_limit_exceeded` は実行中の呼び出しを減らすことを意味し、`rate_limited` は許容量のウィンドウが経過するまで待つことを意味します。
+ `X-Comfy-Error-Type` を確認してください。`concurrency_limit_exceeded` は実行中の呼び出しを減らすことを意味し、`rate_limited` は許容量のウィンドウを待つことを意味します。
- Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Committed-Spend-Limit`, `X-Committed-Spend-Current`, `X-Committed-Spend-Remaining`, `X-Model-Concurrency-Limit`, `X-Model-Concurrency-Current`, `X-Model-Concurrency-Remaining`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Committed-Spend-Limit`, `X-Committed-Spend-Current`, `X-Committed-Spend-Remaining`, `X-Model-Concurrency-Limit`, `X-Model-Concurrency-Current`, `X-Model-Concurrency-Remaining`
- プロバイダー自身のレスポンスを結果に変換できませんでした (`provider_error`)。
+ プロバイダー自身のレスポンスを結果に変換できませんでした(`provider_error`)。
- Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status`
- Router は一時的に利用できません。バックオフしながら再試行してください。
+ Router は一時的に利用できません。バックオフを伴って再試行してください。
- Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (容量拒否の場合のみ)
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After`(容量拒否の場合のみ)
リクエストが期限を超過しました。再試行する前にエラータイプを確認してください。
- Body: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status`, `Retry-After`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `X-Comfy-Upstream-Status`, `Retry-After`
### `POST /v2/models/{provider}/{model}/estimate`
**モデル呼び出しを実行する前に、実行せずに価格を見積もります。**
-このボディをこのモデルで実行した場合のコストを米ドルで示す事前見積もりを返します。価格は、実行時の請求に使われるのと同じレートカードから算出されます(ベンダーが報告するコストで課金されるモデルの場合は、代わりにベンダーの公開価格表から見積もられます)。これは見積もりであり、最終的な請求額ではありません。実際に支払うのは、ワークスペースの利用状況および請求記録に確定した請求額です。ボディはまずモデルの入力スキーマに対して検証されます。デフォルトの実行(`strict_mode` なし、`reject_unknown_fields` なし)が検証するのと同じ方法です。そのため、モデルのスキーマに適合しないボディは、実行時と同じ `422` になります。プロバイダーには何もディスパッチされず、課金も発生しません。この応答は価格の固定ではありません。`pricing_as_of` の時点で有効な料率で価格が算出され、実行はレーティング時点で有効な料率で課金されます。この機能のロールアウト中は、このルートは `403` を返し、`error_type: not_enabled` となります。
+このモデルでこのボディを実行した場合のコストを、米ドルで事前に見積もって返します。価格は、実行時の請求に使われるのと同じレートカードから算出されます(ベンダーが報告するコストで請求されるモデルは、代わりにベンダーの公開価格表から見積もられます)。これは見積もりであり、最終的な請求額ではありません。実際に支払うのは、ワークスペースの使用状況および請求記録に確定した請求額です。ボディはまずモデルの入力スキーマに対して検証されます。デフォルトの実行(`strict_mode` なし、`reject_unknown_fields` なし)が行うのと同じ方法で検証されるため、モデルのスキーマに適合しないボディは、実行時と同じ `422` になります。プロバイダーへのディスパッチも課金も行われません。この応答は価格の固定ではありません。`pricing_as_of` の時点で有効なレートで算出され、実行は評価時点で有効なレートで請求されます。機能のロールアウト中は、このルートは `error_type: not_enabled` を伴う `403` を返します。Router がまだ実行できないモデルは、実行ルート自身の `detail` を伴う同じ `403` を返すため、両者を区別するには `detail` を参照してください。
**パラメータ**
- 正規の `{provider}/{model}` モデル ID の小文字プロバイダーセグメント。実行対象のモデルを持つパートナーです。
+ 正規の `{provider}/{model}` モデル ID の小文字のプロバイダーセグメント。実行対象のモデルを持つパートナーです。
- 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字のスラッグ(例: `anthropic`)、最大 64 文字
+ 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字スラッグ(例: `anthropic`)、最大 64 文字
- 正規の `{provider}/{model}` モデル ID の小文字モデルセグメント。そのプロバイダー内で実行するモデルです。
+ 正規の `{provider}/{model}` モデル ID の小文字のモデルセグメント。そのプロバイダー内で実行するモデルです。
- 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字のスラッグ(例: `claude-opus-4-6`)、最大 128 文字
+ 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字スラッグ(例: `claude-opus-4-6`)、最大 128 文字
- 現在のデフォルトの代わりに、このモデルを提供する別のプロバイダーを選択します。
+ このモデルを提供する代替プロバイダーを、現在のデフォルトの代わりに選択します。
**リクエストボディ**
`application/json` -- [`RouterModelInput`](#routermodelinput)(必須)
-パートナーモデルのネイティブな JSON 入力で、このモデルに対して同期ルートが受け付けるボディと同じものです。デフォルトの実行が検証するのと同様に、モデル自身の入力スキーマに対して検証され(このルートは `strict_mode` や `reject_unknown_fields` を受け付けません)、そのボディ自身のフィールド(出力数、入力画像が選択する操作)が何の価格を算出するかを決めます。
+パートナーモデル固有の JSON 入力で、このモデルに対して同期ルートが受け付けるボディと同じです。デフォルトの実行が行うのと同じ方法で、モデル自身の入力スキーマに対して検証され(このルートは `strict_mode` や `reject_unknown_fields` を受け付けません)、その固有のフィールド(出力数、入力画像が選択する操作)が価格の対象を決定します。
**レスポンス**
- 見積もり結果。
+ 見積もり結果です。
ボディ: [`RouterCostEstimate`](#routercostestimate) -- ヘッダー: `X-Comfy-Request-Id`
@@ -346,63 +345,63 @@ Comfy API キーは Bearer トークンとして送信することもできま
無効なリクエストです。エラータイプとリクエストボディを確認してください。
- ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
認証情報が不足しているか無効です。
- ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
- この呼び出し元またはモデルに対してリクエストは許可されていません。
+ この呼び出し元またはモデルに対してリクエストが許可されていません。
- ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
モデル ID が見つかりませんでした。
- ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
リクエストボディが大きすぎます。
- ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
- 見積もりのボディがモデルのスキーマに対して拒否されたか、パスとは異なるモデルが指定されました。
+ 見積もりのボディがモデルのスキーマに対して拒否されたか、パスとは異なるモデルを指定しました。
- ボディ: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ ボディ: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
- Router は一時的に利用できません。バックオフを伴って再試行してください。
+ Router は一時的に利用できません。バックオフして再試行してください。
- ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(容量拒否の場合のみ)
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After`(容量不足による拒否のみ)
### `GET /v2/models/{provider}/{model}/openapi.json`
-**1つのパートナーモデルの入力スキーマと出力スキーマを OpenAPI ドキュメントとして読み取ります。**
+**パートナーモデル 1 件の入力スキーマと出力スキーマを OpenAPI ドキュメントとして取得します。**
-1つのモデルの入力スキーマと出力スキーマを、単体の OpenAPI ドキュメントとして読み取ります。
+1 つのモデルの入力スキーマと出力スキーマを、単体の OpenAPI ドキュメントとして取得します。
**パラメータ**
正規の `{provider}/{model}` モデル ID のプロバイダー部分。
- 型: [`RouterProviderSegment`](#routerprovidersegment)(英数字のスラッグ、例: `anthropic`、最大64文字)
+ 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字のスラッグ(例: `anthropic`)、最大 64 文字
正規の `{provider}/{model}` モデル ID のモデル部分。
- 型: [`RouterModelSegment`](#routermodelsegment)(英数字のスラッグ、例: `claude-opus-4-6`、最大128文字)
+ 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字のスラッグ(例: `claude-opus-4-6`)、最大 128 文字
@@ -414,7 +413,7 @@ Comfy API キーは Bearer トークンとして送信することもできま
OK - モデルの入力スキーマと出力スキーマを、単体の OpenAPI ドキュメントとして返します。
- 本文: [`RouterModelInputSchemaDocument`](#routermodelinputschemadocument) -- ヘッダー: `X-Comfy-Request-Id`、`ETag`、`Cache-Control`
+ ボディ: [`RouterModelInputSchemaDocument`](#routermodelinputschemadocument) -- ヘッダー: `X-Comfy-Request-Id`、`ETag`、`Cache-Control`
@@ -426,259 +425,258 @@ Comfy API キーは Bearer トークンとして送信することもできま
認証情報が不足しているか、無効です。
- 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
この呼び出し元またはモデルに対して、リクエストは許可されていません。
- 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
モデル ID が見つかりませんでした。
- 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
- Router はリクエストを完了できませんでした。
+ Router がリクエストを完了できませんでした。
- 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
- Router は一時的に利用できません。バックオフを伴って再試行してください。
+ Router は一時的に利用できません。バックオフしながら再試行してください。
- 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
### `POST /v2/models/{provider}/{model}/requests`
-**パートナーモデルの実行をキューに送信し、すぐに戻ります。**
+**パートナーモデルの実行をキューに送信し、すぐに応答を返します。**
-Comfy Router のキュー配信モードです。リクエストボディは、`POST /v2/models/{provider}/{model}` がこのモデルに対して受け付けるものと同じパートナーネイティブの JSON 入力です(1つのボディ形状、モデルごとに1つのスキーマ、2つの配信モード)。ただし、このルートは結果のために接続を保持しません。実行を受け付け、ハンドルとともに `201` を返し、呼び出し元は後で以下の3つの読み取りによって結果を取得します。
+Comfy Router のキュー配送モードです。リクエストボディは、`POST /v2/models/{provider}/{model}` がこのモデルに対して受け付けるパートナーネイティブの JSON 入力と同じものです。ボディの形状は 1 つ、モデルごとのスキーマも 1 つで、配送モードが 2 つあります。ただしこのルートは結果を待つ間コネクションを保持しません。実行を受け入れてハンドル付きで `201` を返し、呼び出し元は後述の 3 つの読み取り操作で後から結果を取得します。
**パラメータ**
- 正規の `{provider}/{model}` モデル ID の小文字のプロバイダーセグメント。実行対象のモデルを持つパートナーです。
+ 正規の `{provider}/{model}` モデル ID のうち小文字のプロバイダーセグメント。実行対象のモデルを提供するパートナーです。
- 型: [`RouterProviderSegment`](#routerprovidersegment)、英数字スラッグ(例: `anthropic`)、最大64文字
+ 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字のスラッグ(例: `anthropic`)、最大 64 文字
- 正規の `{provider}/{model}` モデル ID の小文字のモデルセグメント。そのプロバイダー内で実行するモデルです。
+ 正規の `{provider}/{model}` モデル ID のうち小文字のモデルセグメント。そのプロバイダー内で実行するモデルです。
- 型: [`RouterModelSegment`](#routermodelsegment)、英数字スラッグ(例: `claude-opus-4-6`)、最大128文字
+ 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字のスラッグ(例: `claude-opus-4-6`)、最大 128 文字
- 現在のデフォルトの代わりに、このモデルを提供する代替プロバイダーを選択します。
+ このモデルの現在のデフォルトの代わりに、このモデルを提供する別のプロバイダーを選択します。
- `model_provider` と併用した場合のみ意味を持ちます。
+ `model_provider` と組み合わせた場合にのみ意味があります。
デフォルト: False
- 1つの論理的な呼び出しを安全に再試行できるようにする、呼び出し元が生成するキー。
+ 呼び出し元が生成するキーで、1 つの論理呼び出しの再試行を安全にします。
- 1〜255文字
+ 1〜255 文字
- このモデルの入力スキーマが宣言していないトップレベルのリクエストボディフィールドを受け入れるのではなく、拒否することを選択します。ネストされたフィールドはチェックされず、宣言されていないフィールドを許可するスキーマを持つモデル、または作成されたスキーマを持たないモデルの場合、および `strict_mode=true` で送信されたキューへの送信では、何も拒否されません。
+ このモデルの入力スキーマが宣言していないトップレベルのリクエストボディフィールドを、受け入れるのではなく拒否することを選択します。ネストされたフィールドはチェックされず、スキーマが未宣言のフィールドを許可しているモデル、またはスキーマが作成されていないモデルの場合は何も拒否されません。また、`strict_mode=true` を指定して送信されたキューへの送信でも何も拒否されません。
デフォルト: False
**リクエストボディ**
-`application/json`: [`RouterModelInput`](#routermodelinput)(必須)
+`application/json` -- [`RouterModelInput`](#routermodelinput)(必須)
-パートナーモデルのネイティブ JSON 入力で、同期ルートがこのモデルに対して受け付けるボディと同じものです。また、操作を選択し、同じ方法で課金されます。ボディ自身のフィールドが、複数の操作をサポートするモデルで Router が実行する操作を選択します(入力画像は編集可能な画像モデルを画像から画像へ切り替え、それには独自のレートで課金される場合があります。Seedance の最初のフレーム画像は画像から動画へを選択し、参照画像またはクリップは参照から動画を選択します)。ネイティブディスパッチでは、Seedance リクエストはロールではなく `content` 内のメディア種別で課金されます。ビデオ入力があれば動画から動画へとして課金され、そうでなければ画像があれば画像から動画へ、それもなければテキストから動画へとして課金されます。ただし、`draft_task` 項目からの最終レンダーは、それがレンダリングする Draft の操作として課金されます。一部のモデルではテキストから動画へと画像から動画へに同じレートを請求します。`model_provider` で代替プロバイダーを選択する場合、条件付けされた各操作はそのプロバイダー独自のレートで課金される場合があります。同じプロバイダー選択の契約がディスパッチ時に適用されます。`model_provider` を指定しない場合、または `model_provider` を指定して `strict_mode=false`(デフォルト)の場合、ボディはモデルのネイティブドキュメントであり、実行が受け付けられる前にモデル自身の入力スキーマに対して検証されます。そのため、モデルが拒否するようなボディは、数分後に失敗するキュー中のリクエストではなく、ここで `422` になります。非厳格な代替プロバイダーのボディは、さらにディスパッチ時にそのプロバイダーの実際のスキーマへ変換されます。`strict_mode=true` の場合、ボディはすでに代替プロバイダー自身のスキーマである必要があり、変更されずに転送されます。ネイティブスキーマの検証は、同期ルートとまったく同じようにスキップされます(`model_provider` と `strict_mode` を参照)。
+パートナーモデルのネイティブ JSON 入力です。同期ルートがこのモデルに対して受け付けるボディと同一であり、操作の選択方法も課金方法も同じです。ボディ自体のフィールドが、複数の操作をサポートするモデルで Router が実行する操作を決めます(入力画像があると編集可能な画像モデルは画像から画像へ切り替わり、独自のレートで課金される場合があります。Seedance では先頭フレーム画像が画像から動画へを選択し、参照画像またはクリップが参照から動画を選択します)。ネイティブディスパッチでは、Seedance リクエストはロールではなく `content` 内のメディア種別で課金されます。つまり、ビデオ入力があれば動画から動画へとして、そうでなければ画像があれば画像から動画へとして、それ以外はテキストから動画へとして課金されます。ただし、`draft_task` アイテムからの最終レンダーは、それがレンダリングする Draft の操作として課金されます。また一部のモデルでは、テキストから動画へと画像から動画へが同じレートで課金されます。`model_provider` が代替プロバイダーを選択している場合、条件付けされた各操作はそのプロバイダー独自のレートで課金される場合があります。プロバイダー選択の契約はディスパッチ時にも同じように適用されます。`model_provider` がない場合、または `model_provider` があり `strict_mode=false`(デフォルト)の場合、ボディはモデルのネイティブドキュメントであり、実行が受け入れられる前にモデル自身の入力スキーマに対して検証されます。そのため、モデルが拒否するボディは、数分後に失敗するキュー中のリクエストになるのではなく、ここで `422` になります。さらに、非 strict の代替プロバイダーのボディは、ディスパッチ時にそのプロバイダーの実際のスキーマへ変換されます。`strict_mode=true` の場合、ボディはすでに代替プロバイダー自身のスキーマでなければならず、そのまま転送されます。ネイティブスキーマの検証は、同期ルートとまったく同じようにスキップされます(`model_provider` と `strict_mode` を参照)。
**レスポンス**
- 作成済み。実行がキューに受け付けられました。
+ 作成済み - 実行がキューに受け入れられました。
- ボディ: [`RouterQueueSubmitResponse`](#routerqueuesubmitresponse)、ヘッダー: `X-Comfy-Request-Id`、`Idempotent-Replayed`
+ ボディ: [`RouterQueueSubmitResponse`](#routerqueuesubmitresponse) -- ヘッダー: `X-Comfy-Request-Id`、`Idempotent-Replayed`
認証情報が不足しているか無効です。
- ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
無効なリクエストです。エラータイプとリクエストボディを確認してください。
- ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
リクエストボディが大きすぎます。
- ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
Router のリクエストレベルの失敗です。リクエストがモデルに到達しなかったか、モデル自体が報告しなかった理由で失敗しました。
- ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
この呼び出し元またはモデルに対してリクエストは許可されていません。パートナーが生成結果を直接バイトとして返すモデルはまだキューに投入できず、`not_enabled` で拒否されます。代わりに同期ルートで実行してください。
- ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
モデル ID が見つかりませんでした。
- ボディ: [`RouterErrorResponse`](#routererrorresponse)、ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
-
-`X-Comfy-Error-Type` を確認してください。`concurrency_limit_exceeded` はオリジナルの呼び出しがまだ実行中であることを意味するため、`Retry-After` を待って同じキーを再利用してください。`invalid_input` の場合は新しいキーが必要です。このルートにおける 2 つの `invalid_input` 競合はキーとはまったく関係がなく、新しいキーでもどちらも解消されません。1 つ目は `model_provider` で代替プロバイダーを指定した場合で、リクエストボディが、このモデルに対するそのプロバイダーのトランスレーターでは処理できないマルチパート操作(編集)を選択していると拒否され、その `detail` は「this request's `image` selects the edit operation」で始まります。2 つ目はその後チェックされるもので、リクエストがすでにパス内のプロバイダーに対する BYOK 認証情報を解決済みの場合に拒否され、その `detail` は `this request resolved a BYOK credential` で始まります。`model_provider` を削除するか、BYOK 認証情報なしで(マルチパートの場合は編集もなしで)リクエストを送信してください。
+`X-Comfy-Error-Type` を確認してください。`concurrency_limit_exceeded` はオリジナルの呼び出しがまだ実行中であることを意味するため、`Retry-After` を待って同じキーを再利用してください。`invalid_input` は新しいキーが必要です。このルート上の 2 つの `invalid_input` 競合はキーとはまったく関係がなく、新しいキーでもどちらも解消されません。`model_provider` で代替プロバイダーを指定していても、リクエスト本文が、このモデル用のそのプロバイダーのトランスレーターでは処理できないマルチパート操作(編集)を選択している場合は拒否され、その `detail` は "this request's `image` selects the edit operation" で始まります。また、その後チェックされる条件として、リクエストがパス内のプロバイダー用の BYOK 認証情報をすでに解決している場合も拒否され、その `detail` は `this request resolved a BYOK credential` で始まります。`model_provider` を削除するか、BYOK 認証情報を付けずに、かつ(マルチパートの場合は)編集を伴わずにリクエストを送信してください。
- ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(`concurrency_limit_exceeded` の場合)
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (`concurrency_limit_exceeded` の場合)
- リクエストの内容がモデルのスキーマに対して拒否されました。
+ リクエストの内容はモデルのスキーマに照らして拒否されました。
- ボディ: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Idempotent-Replayed`
+ ボディ: [`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Idempotent-Replayed`
- `X-Comfy-Error-Type` を確認してください。`queue_backlog_full` は、許可されている数まで未完了のキュー中リクエストをすでに保持していることを意味するため、そのうちの 1 つが完了したら再度送信してください。`rate_limited` は許可ウィンドウを待つことを意味します。
+ `X-Comfy-Error-Type` を確認してください。`queue_backlog_full` は、許可されている上限まで未完了のキュー中リクエストをすでに保持していることを意味するため、そのうち 1 つが完了したら再度送信してください。`rate_limited` は許容ウィンドウを待つことを意味します。
- ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
- ルーターは一時的に利用できません。バックオフしながら再試行してください。
+ Router は一時的に利用できません。バックオフしながら再試行してください。
- ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(容量拒否の場合のみ)
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`, `Retry-After` (容量拒否の場合のみ)
### `GET /v2/models/{provider}/{model}/requests/{request_id}`
-**送信された 1 件のリクエストの結果を取得します。**
+**送信した1件のリクエストの結果を収集します。**
-結果収集エンドポイントです。正常に完了したリクエストに対しては、パートナーモデル自身のネイティブ出力を、同じモデル・同じ入力に対して同期ルートの `200` が返す内容とバイト単位で同一のまま返します。これにより 2 つの配信モードは 1 つの結果形状を生成し、呼び出し元は別のパーサーを用意することなく両者を切り替えられます。
+収集エンドポイントです。正常に完了したリクエストに対しては、パートナーモデル自身のネイティブ出力を返します。これは、同じモデルと同じ入力に対して同期ルートの `200` が返す内容とバイト単位で同一です。つまり、2つの配信モードは1つの結果形状を生成し、呼び出し元は2つ目のパーサーを用意せずに両者を行き来できます。
**パラメータ**
正規の `{provider}/{model}` モデル ID の小文字プロバイダーセグメント。実行対象のモデルを持つパートナーです。
- 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字スラッグ(例: `anthropic`)、最大 64 文字
+ Type: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字スラッグ(例: `anthropic`)、最大64文字
正規の `{provider}/{model}` モデル ID の小文字モデルセグメント。そのプロバイダー内で実行するモデルです。
- 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字スラッグ(例: `claude-opus-4-6`)、最大 128 文字
+ Type: [`RouterModelSegment`](#routermodelsegment) -- 英数字スラッグ(例: `claude-opus-4-6`)、最大128文字
- 対象となるキュー中のリクエスト。送信時にレスポンス本文で返された `request_id` です。
+ 対象となるキュー中のリクエスト。送信時にボディで返された `request_id` です。
- 型: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`, uuid, 最大 36 文字
+ Type: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`、uuid、最大36文字
**レスポンス**
- OK: 結果を生成したリクエストに対して保存された結果です。正常に完了したリクエスト、または記録済みの課金と保存済みの結果の両方を持つターミナル状態のリクエストが該当します。パートナー自身のメディアタイプのまま、同期ルートの `200` が返すのとまったく同じ形で、また送信時に受け入れたのと同じプロバイダー選択契約のもとで、変更されずに返されます。`model_provider` がない場合、または `model_provider` があり `strict_mode=false`(デフォルト。可能な場合はこのモデルのネイティブ契約に変換され、変換に失敗した場合は代替プロバイダー自身の生のレスポンスにフォールバックします。ログに記録され、決して黙って処理されることはありません)の場合は、形状はこのモデル自身のネイティブ出力です。`strict_mode=true` の場合は、代替プロバイダーのレスポンスが変更されずにそのまま返されます。パートナーが生成結果を直接バイトとして返すモデルの場合、本文は `application/json` ではなくパートナー自身の `Content-Type` を持つそれらのバイト列です。レスポンスの `Content-Type` で分岐し、JSON ドキュメントであると決めつけないでください。
+ OK: 結果を生成したリクエスト、つまり正常に完了したリクエスト、または記録された課金と保存された結果の両方を持つターミナルなリクエストに対して保存された結果を返します。これはパートナー自身のメディアタイプでそのまま返され、同期ルートの `200` が返すものとまったく同じです。また、送信時に受け入れたプロバイダー選択の契約にも従います。`model_provider` を指定しない場合、または `model_provider` を指定して `strict_mode=false`(デフォルト)の場合、形状はこのモデル自身のネイティブ出力です。`strict_mode=false` では、可能な場合はこのモデルのネイティブ契約に翻訳され、翻訳に失敗した場合は代替プロバイダー自身の生のレスポンスにフォールバックします(ログに記録され、サイレントにはなりません)。`strict_mode=true` の場合は、代替プロバイダーのレスポンスがそのまま返されます。パートナーが生成結果を直接バイトとして返すモデルでは、ボディは `application/json` ではなく、パートナー自身の `Content-Type` を持つそれらのバイトです。レスポンスの `Content-Type` で分岐し、JSON ドキュメントを想定しないでください。
- 本文: [`RouterModelOutput`](#routermodeloutput) または生のバイト列(`*/*`) -- ヘッダー: `X-Comfy-Request-Id`, `X-Content-Type-Options`, `X-Comfy-Credits-Used`
+ ボディ: [`RouterModelOutput`](#routermodeloutput) または生のバイト (`*/*`) -- ヘッダー: `X-Comfy-Request-Id`, `X-Content-Type-Options`, `X-Comfy-Credits-Used`
- 受理済み: リクエストはまだ完了していません。
+ Accepted: リクエストはまだ完了していません。
- 本文: [`RouterQueueStatusResponse`](#routerqueuestatusresponse) -- ヘッダー: `X-Comfy-Request-Id`, `Retry-After`
+ ボディ: [`RouterQueueStatusResponse`](#routerqueuestatusresponse) -- ヘッダー: `X-Comfy-Request-Id`, `Retry-After`
認証情報が不足しているか無効です。
- 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
この呼び出し元またはモデルに対して、リクエストは許可されていません。
- 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
モデル ID が見つかりませんでした。
- 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
- Router のリクエストレベルの失敗です。リクエストがモデルに到達しなかったか、モデル自身が報告しなかった理由で失敗しました。
+ Router のリクエストレベルの失敗。リクエストがモデルに到達しなかったか、モデル自身が報告しなかった理由で失敗しました。
- 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
- Router は一時的に利用できません。バックオフを伴って再試行してください。
+ Router は一時的に利用できません。バックオフしながら再試行してください。
- 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
- リクエストは操作と競合する状態にあります。エラータイプを確認してください。
+ リクエストが操作と競合する状態にあります。エラータイプを確認してください。
- 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
リクエストが期限を超過しました。再試行する前にエラータイプを確認してください。
- 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
- Router のリクエストレベルの失敗です。リクエストがモデルに到達しなかったか、モデル自身が報告しなかった理由で失敗しました。
+ Router のリクエストレベルの失敗。リクエストがモデルに到達しなかったか、モデル自身が報告しなかった理由で失敗しました。
- 本文: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`, `X-Comfy-Request-Id`
### `PUT /v2/models/{provider}/{model}/requests/{request_id}/cancel`
-**送信済みのリクエストを 1 件キャンセルするよう要求します。**
+**送信済みのリクエストを 1 つキャンセルするよう要求します。**
-まだ完了していないリクエストを停止するよう Comfy に要求します。これは要求であり保証ではないため、`202` はまさにそのことを示します。`CANCELLATION_REQUESTED` は要求が受け付けられたという意味であり、実行が停止したという意味ではありません。パートナー側ですでに送信済みの実行はそのまま完了する可能性があります。そして完了したパートナーでの生成は、誰が結果を取得したかに関係なく課金されます。そのため、実際に何が起きたかを知る必要がある呼び出し元は、後からステータスエンドポイントを参照します。そこでは、有効になったキャンセルは他のすべての終端結果と同様に `COMPLETED` となり、`error_type` を持ちます。
+まだ完了していないリクエストを停止するよう Comfy に要求します。これは要求であり保証ではないため、`202` はまさにそのことを示します。`CANCELLATION_REQUESTED` は要求が受け付けられたことを意味し、実行が停止したことを意味するものではありません。パートナー側ですでに送信中の実行はそのまま完了する可能性があります。また、完了したパートナーでの生成は、誰かが結果を取得したかどうかにかかわらず課金されます。そのため実際に何が起きたかを知る必要がある呼び出し元は、後でステータスエンドポイントを参照してください。そこでは、有効になったキャンセルは他のすべての最終結果と同様に、`error_type` を持つ `COMPLETED` として示されます。
**パラメータ**
- 正規の `{provider}/{model}` モデル ID のうち、小文字のプロバイダーセグメント。実行するモデルを提供するパートナーです。
+ 正規の `{provider}/{model}` モデル ID の小文字のプロバイダーセグメント - モデルを実行しているパートナーです。
- 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字のスラッグ(例: `anthropic`)、最大 64 文字
+ 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字スラッグ(例: `anthropic`)、最大 64 文字
- 正規の `{provider}/{model}` モデル ID のうち、小文字のモデルセグメント。そのプロバイダー内で実行するモデルです。
+ 正規の `{provider}/{model}` モデル ID の小文字のモデルセグメント - そのプロバイダー内で実行するモデルです。
- 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字のスラッグ(例: `claude-opus-4-6`)、最大 128 文字
+ 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字スラッグ(例: `claude-opus-4-6`)、最大 128 文字
- 対象とするキュー中のリクエスト。送信時にレスポンスボディで返された `request_id` です。
+ 対象となるキュー中のリクエスト - 送信時にレスポンスボディで返された `request_id` です。
型: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`、uuid、最大 36 文字
@@ -686,7 +684,7 @@ Comfy Router のキュー配信モードです。リクエストボディは、`
**レスポンス**
- 受け付け済み - `CANCELLATION_REQUESTED`。
+ 受理済み - `CANCELLATION_REQUESTED`。
ボディ: [`RouterQueueCancelResponse`](#routerqueuecancelresponse) -- ヘッダー: `X-Comfy-Request-Id`
@@ -710,7 +708,7 @@ Comfy Router のキュー配信モードです。リクエストボディは、`
- この呼び出し元またはモデルでは、そのリクエストは許可されていません。
+ この呼び出し元またはモデルに対してリクエストは許可されていません。
ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
@@ -722,13 +720,13 @@ Comfy Router のキュー配信モードです。リクエストボディは、`
- Router は一時的に利用できません。バックオフしながらリトライしてください。
+ Router は一時的に利用できません。バックオフを伴って再試行してください。
ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
- Router のリクエストレベルの失敗。リクエストがモデルに到達しなかったか、モデル自身が報告しなかった理由で失敗しました。
+ Router のリクエストレベルの失敗 - リクエストがモデルに到達しなかったか、モデル自体が報告しなかった理由で失敗しました。
ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
@@ -737,73 +735,73 @@ Comfy Router のキュー配信モードです。リクエストボディは、`
**送信済みの1件のリクエストのキュー状態を読み取ります。**
-ポーリング用のエンドポイントです。リクエストの現在の状態を返し、結果は決して返しません。そのためクライアントは、ポーリングのたびに出力を転送することなく、長時間の生成を監視できます。結果は、ここで `COMPLETED` が返されたときに、後述の読み取りから一度だけ取得します。
+ポーリング用のエンドポイントです。リクエストの現在の状態を返し、結果は返しません。そのためクライアントは、ポーリングのたびに出力を転送することなく、長い生成を監視できます。結果は、これが `COMPLETED` になったときに、下記の読み取りから一度だけ取得します。
**パラメータ**
- 正規の `{provider}/{model}` モデル ID のうち、小文字のプロバイダーセグメント。実行対象のモデルを持つパートナーです。
+ 正規の `{provider}/{model}` モデル ID の小文字のプロバイダーセグメント。実行対象のモデルを持つパートナーです。
- 型: [`RouterProviderSegment`](#routerprovidersegment)。英数字のスラッグ(例: `anthropic`)、最大64文字
+ 型: [`RouterProviderSegment`](#routerprovidersegment) -- 英数字のスラッグ(例: `anthropic`)、最大64文字
- 正規の `{provider}/{model}` モデル ID のうち、小文字のモデルセグメント。そのプロバイダー内で実行するモデルです。
+ 正規の `{provider}/{model}` モデル ID の小文字のモデルセグメント。そのプロバイダー内で実行するモデルです。
- 型: [`RouterModelSegment`](#routermodelsegment)。英数字のスラッグ(例: `claude-opus-4-6`)、最大128文字
+ 型: [`RouterModelSegment`](#routermodelsegment) -- 英数字のスラッグ(例: `claude-opus-4-6`)、最大128文字
- 対象とするキュー中のリクエスト。送信時にレスポンスボディで返された `request_id` です。
+ 対象とするキュー中のリクエスト。送信時にボディで返された `request_id` です。
- 型: [`RouterQueueRequestId`](#routerqueuerequestid)。`pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`、uuid、最大36文字
+ 型: [`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`、uuid、最大36文字
**レスポンス**
- OK - リクエストの現在のキュー状態。
+ OK。リクエストの現在のキュー状態です。
- ボディ: [`RouterQueueStatusResponse`](#routerqueuestatusresponse)。ヘッダー: `X-Comfy-Request-Id`、`Retry-After`、`X-Comfy-Credits-Used`、`X-Comfy-Estimated-Duration-Seconds`、`X-Comfy-Estimated-Duration-P90-Seconds`、`X-Comfy-Estimate-Source`
+ ボディ: [`RouterQueueStatusResponse`](#routerqueuestatusresponse) -- ヘッダー: `X-Comfy-Request-Id`、`Retry-After`、`X-Comfy-Credits-Used`、`X-Comfy-Estimated-Duration-Seconds`、`X-Comfy-Estimated-Duration-P90-Seconds`、`X-Comfy-Estimate-Source`
- 認証情報が不足しているか、無効です。
+ 認証情報が不足しているか無効です。
- ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
この呼び出し元またはモデルに対して、このリクエストは許可されていません。
- ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
モデル ID が見つかりませんでした。
- ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
Router のリクエストレベルの失敗。リクエストがモデルに到達しなかったか、モデル自体が報告しなかった理由で失敗しました。
- ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
- Router は一時的に利用できません。バックオフしながら再試行してください。
+ Router は一時的に利用できません。バックオフを伴って再試行してください。
- ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
Router のリクエストレベルの失敗。リクエストがモデルに到達しなかったか、モデル自体が報告しなかった理由で失敗しました。
- ボディ: [`RouterErrorResponse`](#routererrorresponse)。ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ ボディ: [`RouterErrorResponse`](#routererrorresponse) -- ヘッダー: `X-Comfy-Error-Type`、`X-Comfy-Request-Id`
-ここでの説明は簡潔にしています。モデルの選択、検証、再試行、課金については [Comfy Router API の使用](/ja/development/comfy-router/api) を、ヘッダーの動作については [ヘッダー](/ja/development/comfy-router/headers) を参照してください。
+ここでの説明は簡潔です。モデルの選択、検証、再試行、課金については [Comfy Router API の使用](/ja/development/comfy-router/api) を、ヘッダーの動作については [ヘッダー](/ja/development/comfy-router/headers) を参照してください。
## エラーバケット
@@ -971,39 +969,39 @@ Router が受け付けたものの、完了できなかったリクエストに
## 事前のコスト見積もり
-`POST /v2/models/{provider}/{model}/estimate` は、ボディを実行せずにその価格を算出します。また、キュー中の送信(`POST /v2/models/{provider}/{model}/requests`)は、その `201` 応答で `estimate` と同じ [`RouterCostEstimate`](#routercostestimate) を返します。どちらも、Comfy がその実行に対して請求する料率表に基づいて価格付けされます。ただし、ベンダーが報告するコストで請求されるモデルは、ベンダーの公開価格表から `estimated` として算出されます。返される数値はすべて見積もりであり、最終的な請求額ではありません。ワークスペースの使用量および請求記録にある確定した請求額が最終的な金額です。自分のプロバイダーキーでの実行は Comfy からは請求されません(下記参照)。見積もりの展開中は、このルートは `403` と `error_type: not_enabled` を返し、送信レスポンスには `estimate` が含まれません。カタログには引き続き価格が掲載されていません。
+`POST /v2/models/{provider}/{model}/estimate` は、実行せずにリクエストボディの価格を算出します。キュー中の送信(`POST /v2/models/{provider}/{model}/requests`)は、その `201` で `estimate` と同じ [`RouterCostEstimate`](#routercostestimate) を返します。どちらも、Comfy がその実行の課金に用いるレートカードから価格が算出されます。ただし、ベンダーが報告するコストで課金されるモデルは例外で、その場合はベンダーが公開している価格表から `estimated` として算出されます。どちらが返す数値も見積もりであり、最終的な請求額ではありません。確定した請求額は、ワークスペースの使用状況および請求記録に記載される金額が最終です。自分のプロバイダーキーによる実行は Comfy の課金対象外です(以下を参照)。見積もりの提供を段階的に展開している間、このルートは `error_type: not_enabled` を伴う `403` を返し、送信のレスポンスには `estimate` が含まれません。カタログには引き続き価格は掲載されていません。
-金額より先に `source` を読んでください。数値の欠落は無料を意味しません。
+金額より先に `source` を確認してください。数値が不足していることは無料を意味しません。
-| `source` | 含まれるもの | 読み方 |
+| `source` | 含まれる内容 | 読み方 |
| --- | --- | --- |
-| `exact` | `amount`、`amount_cents`、`credits` | `pricing_as_of` の料率でこのボディに対して請求される額と等しい見積もりです。ワークスペースの使用量および請求記録にある確定した請求額が最終的な金額です。 |
-| `estimated` | `min_amount`、`max_amount` とその `_cents` 形式、`amount` は含まれない | プロバイダーが報告する数量に請求額が依存し、その数量の上下限がボディで決まる見積もりです。請求額は上下限の範囲内になると見込まれ、ワークスペースの使用量および請求記録にある確定した請求額が最終的な金額です。 |
-| `free` | `amount` は "0"、`amount_cents` と `credits` は `0` | 料率表がこのリクエストをゼロで価格付けするため、見積もりは `0` です。ワークスペースの使用量および請求記録にある確定した請求額が最終的な金額です。`0` と表示されるのは `free` の見積もりだけです。 |
-| `unknown` | `reason`、数値なし | 実行前に価格を提示できませんでした。その他の `source` 値は `unknown` として扱ってください。 |
+| `exact` | `amount`、`amount_cents`、`credits` | `pricing_as_of` のレートでこのボディに対する請求額と等しい見積もりです。確定した請求額は、ワークスペースの使用状況および請求記録に記載される金額が最終です。 |
+| `estimated` | `min_amount`、`max_amount` とその `_cents` 形式。`amount` は含まれません | 請求額がプロバイダーから報告される数量に依存し、その数量をボディが上下限で制約する見積もりです。請求額はその上下限の範囲内になると見込まれ、確定した請求額は、ワークスペースの使用状況および請求記録に記載される金額が最終です。 |
+| `free` | `amount` が "0"、`amount_cents` と `credits` が `0` | レートカードがこのリクエストをゼロと価格設定しているため、見積もりは `0` です。確定した請求額は、ワークスペースの使用状況および請求記録に記載される金額が最終です。`0` を示すのは `free` の見積もりだけです。 |
+| `unknown` | `reason`。数値は含まれません | 実行前に価格を示すことはできませんでした。その他の `source` 値はすべて `unknown` として扱ってください。 |
-`unknown` の見積もりの `reason` は次のいずれかです:
+`unknown` の見積もりにおける `reason` は次のいずれかです:
-- `not_quotable`: Router はこの呼び出しを実行前に価格付けできません。プロバイダーが報告する数量で請求され、その数量の上下限がボディで決まらないか、送信されたままのボディを価格付けできないためです。認識できない `reason` は `not_quotable` として扱ってください。
-- `unpriced_model`: 料率表がこのリクエストを価格付けしていません。
-- `byok`(キュー中の送信のみ): 実行は自分のプロバイダーキーを使用するため、Comfy は何も請求しません。
-- `pricing_unavailable`(キュー中の送信のみ): リクエストの受け付け時に料率表を読み取れませんでした。送信はそのまま受け付けられ、実行は通常どおり請求されます。
+- `not_quotable`: Router はこの呼び出しを実行前に価格算出できません。プロバイダーが報告する数量で課金され、その数量をボディが上下限で制約していないか、送信されたままのボディでは価格を算出できないためです。認識できない `reason` はすべて `not_quotable` として扱ってください。
+- `unpriced_model`: レートカードがこのリクエストの価格を設定していません。
+- `byok`(キュー中の送信のみ): 実行は自分のプロバイダーキーを使用するため、Comfy は何も課金しません。
+- `pricing_unavailable`(キュー中の送信のみ): リクエストを受け付けた時点でレートカードを読み取れませんでした。送信自体は受け付けられ、実行は通常どおり課金されます。
-Router がまだ実行前に価格付けできないモデルは、[事前見積もりのないモデル](/ja/development/comfy-router/limitations#事前見積もりのないモデル)に一覧されています。そこに載っていないモデルでも、特定のボディでは `unknown` を返すことがあるため、すべての見積もりで `source` を読んでください。
+Router がまだ実行前に価格を算出できないモデルは、[事前見積もりのないモデル](/ja/development/comfy-router/limitations#事前見積もりのないモデル)に一覧されています。そこに掲載されていないモデルでも、特定のボディに対しては `unknown` を返すことがあるため、すべての見積もりで `source` を確認してください。
-見積もりがフェイルクローズするのは次の場合です:
+見積もりがフェイルクローズする場合:
-- 数値に料率表が必要で、カードが読み込まれていないか古い場合、`/estimate` は推測ではなく `503` を返します。キュー中の送信は見積もりを理由に拒否されることはなく、代わりに `source: unknown` と `reason: pricing_unavailable` を含みます。実行前にまったく価格付けできない呼び出し(`not_quotable`)、または自分のプロバイダーキーでのキュー中の送信(`byok`)は、カードを読まずに応答されるため、その `200` はカードが新しいかどうかについては何も示しません。
-- `/estimate` はデフォルトの実行と同様に、モデル自身の入力スキーマに対してボディを検証します。そのため、モデルのスキーマに適合しないボディは、実行が返すのと同じ `422` を、同じ `detail[]` 形状で受け取ります。何も価格付けもディスパッチもされません。
-- キュー中の送信の冪等なリプレイ(`Idempotent-Replayed: true`)は `estimate` を含みません。元の見積もりが保存されていないためです。
+- 数値の算出にレートカードが必要で、カードが読み込まれていないか古い場合、`/estimate` は推測値ではなく `503` を返します。キュー中の送信が見積もりのために拒否されることはなく、代わりに `reason: pricing_unavailable` を伴う `source: unknown` が付与されます。実行前にまったく価格を算出できない呼び出し(`not_quotable`)や、自分のプロバイダーキーによるキュー中の送信(`byok`)は、カードを読まずに応答されるため、その `200` はカードが新しいかどうかを何も示しません。
+- `/estimate` はデフォルトの実行と同様に、モデル自身の入力スキーマに対してボディを検証するため、モデルのスキーマに適合しないボディは、実行が返すのと同じ `422` を、同じ `detail[]` 形状で受け取ります。価格算出もディスパッチも行われません。
+- キュー中の送信の冪等なリプレイ(`Idempotent-Replayed: true`)では、元の見積もりが保存されていないため `estimate` は含まれません。
-見積もりの限界。`200` の数値は、実行が受け付けられること、または正確にその金額が請求されることを約束するものではありません:
+見積もりの限界。`200` の数値は、実行が受け付けられることや、正確にその金額が課金されることを約束するものではありません:
-- `/estimate` は `strict_mode` や `reject_unknown_fields` を受け取らないため、モデルのネイティブな契約のみを検証します。`strict_mode=true` の実行が代替プロバイダー自身のスキーマで受け付けるボディが、ここでは `422` になることがあります。また、`reject_unknown_fields=true` の実行なら拒否する未宣言のトップレベルフィールドが、ここでは価格付けされます。Anthropic Messages モデルは例外です。そのスキーマは未宣言のフィールドを許容するため、`reject_unknown_fields=true` の実行でも何も拒否せず、見積もりは未宣言のトップレベルフィールド `tools`、`tool_choice`、`temperature`、`top_p`、`top_k`、`stop_sequences`、`metadata`、`thinking` および空の `mcp_servers` のみを価格付けします。その他の未宣言のトップレベルフィールドがあると、`reason: not_quotable` とともに `unknown` を返します。
-- `pricing_as_of` は料率表を取得した時刻、またはベンダーの公開価格表から取得した `estimated` の見積もりの場合はその価格表を読んだ日付です(どちらも読まれていない場合は、見積もりを返した時刻です)。これは価格の固定ではありません。実行は、レーティング時点で有効な料率で請求されます。
-- `/estimate` は `model_provider` が示すレグ、またはネイティブのプロバイダーを価格付けします。`fallback_provider` や `strict_mode` パラメータは受け取りません。フォールバックのリトライが別のプロバイダーで行われる同期実行は、そのプロバイダーの料率で請求され、見積もりはそのレグを価格付けしていません。実行のレスポンスの `X-Comfy-Router-Fallback-Provider` が、それが発生したことを示します。キュー中の送信にはフォールバックがないため、その `estimate` は実行されるレグを価格付けします。
-- `/estimate` とキュー中の送信の `estimate` は、`model_provider` レグの同じボディ、または兄弟オペレーションで実行されるボディについて、わずかに異なるドキュメントを価格付けすることがあります。送信の `estimate` は、実行が送信するドキュメントに基づいて価格付けされます。
-- `/estimate` は常にプラットフォームの請求額を算出します。自分のプロバイダーキーでの実行は Comfy から請求されませんが、`/estimate` はそれを検出せずに数値を返します。`reason: byok` を返すのはキュー中の送信だけです。- ドルは丸めていないセントから最大8桁の小数で表示され、課金対象の1セント未満の `amount` が `0` と表示されることはありません。`credits` は `round(amount × 211, 2)` であり、これは `X-Comfy-Credits-Used` が課金に適用するのと同じ変換です。そのため、ごく小さい非ゼロの価格では `credits` が `0` にラウンドされることがあります。これが重要となる場合は、`credits` ではなく `amount` または `amount_cents` で予算を立ててください。このヘッダーは引き続き、1回の実行に対する事後的な数値です。残高は Comfy プラットフォーム上にあります。
+- `/estimate` は `strict_mode` や `reject_unknown_fields` を受け取らないため、モデルのネイティブな契約のみを検査します。`strict_mode=true` の実行が代替プロバイダー自身のスキーマで受け付けるボディが、ここでは `422` になることがあり、`reject_unknown_fields=true` の実行なら拒否する未宣言のトップレベルフィールドが、ここでは価格算出されます。Anthropic Messages モデルは例外です。そのスキーマは未宣言のフィールドを許可するため、`reject_unknown_fields=true` の実行でも何も拒否せず、見積もりは未宣言のトップレベルフィールド `tools`、`tool_choice`、`temperature`、`top_p`、`top_k`、`stop_sequences`、`metadata`、`thinking` および空の `mcp_servers` のみを価格算出します。それ以外の未宣言のトップレベルフィールドがあると、`reason: not_quotable` を伴う `unknown` を返します。
+- `pricing_as_of` はレートカードを取得した時点です。ベンダーの公開価格表から取得した `estimated` の見積もりには、その価格表を読み取った日付が付きます。請求数量がベンダーの公開スケジュールから予測される `exact` または `estimated` の見積もりでは、そのスケジュールの読み取り日付がカードより古い場合、その日付が付きます。カードもスケジュールも読み取られなかった場合は、見積もりを返した時点になります。これは価格の固定ではありません。実行は、評価される時点で有効なレートで課金されます。
+- `/estimate` は `model_provider` が指定するレグ、またはネイティブのプロバイダーを見積もります。`fallback_provider` や `strict_mode` のパラメータは受け取りません。フォールバックのリトライが別のプロバイダーに到達した同期実行は、そのプロバイダーのレートで課金され、見積もりはそのレートを見積もっていません。実行のレスポンスにある `X-Comfy-Router-Fallback-Provider` がその発生を示します。キュー中の送信にはフォールバックがないため、その `estimate` は実行されるレグを見積もります。
+- `/estimate` とキュー中の送信の `estimate` は、`model_provider` のレグにおける同じボディや、兄弟オペレーションで実行されるボディについて、わずかに異なるドキュメントを価格算出することがあります。送信の `estimate` は、実行が送信するドキュメントに基づいて価格算出されます。
+- `/estimate` は常にプラットフォームの請求額を見積もります。自分のプロバイダーキーによる実行は Comfy の課金対象外ですが、`/estimate` はそれを検出せず、依然として数値を返します。`reason: byok` を返すのはキュー中の送信のみです。- ドルは、丸めていないセントから最大8桁の小数で表示され、課金対象の1セント未満の `amount` が `0` として表示されることはありません。`credits` は `round(amount × 211, 2)` で、`X-Comfy-Credits-Used` が課金に適用するのと同じ変換です。そのため、非常に小さい非ゼロの価格では `credits` が `0` に丸められることがあります。その点が重要な場合は、`credits` ではなく `amount` または `amount_cents` で予算を立ててください。このヘッダーは1回の実行における事後の数値であり、残高は Comfy プラットフォーム上にあります。
## 結果アセット
@@ -1014,9 +1012,9 @@ Router がまだ実行前に価格付けできないモデルは、[事前見積
| `bfl/*` | 完了したアセット、および結果に含まれている場合はドラフトキャッシュのアセット | 24 時間 |
| `byteplus/*` ビデオモデル (`seedance`、`dreamina-seedance`) | 完了したビデオ、および結果に含まれている場合はラストフレーム画像 | 24 時間 |
| `minimax/*` | 完了したビデオ | 12 時間 |
-| `xai/*` | 生成されたすべての画像、および完了したビデオ | 24 時間 |
+| `xai/*` | 生成済みのすべての画像、および完了したビデオ | 24 時間 |
-これらの有効期間は、URL を開いたときではなく、URL が署名されたときに開始されます。キャッシュされた URL や再利用された URL は残り時間が短い場合があります。再利用しても有効期間は更新されません。アセットは速やかにダウンロードしてください。コピーされるのは各行に記載されたアセットのみです。`byteplus/seedream-*` と `byteplus/seededit-*` の画像は BytePlus ビデオの行には含まれません。
+これらの有効期間は、URL を開いたときではなく、URL が署名されたときに開始されます。キャッシュされた URL や再利用された URL は残り時間が短い場合があります。再利用しても有効期間は更新されません。`Idempotency-Key` レコードは、それが保持する URL より長く存続する可能性があります。そのため、そのような URL の有効期限の 1 時間前になると、同じキーでの再試行は記録されたレスポンスではなく `409 invalid_input` で応答されます。ただし、返された時点ですでに有効期限がそこまで迫っていたレスポンスは、5 分間は再生可能なままです。アセットは速やかにダウンロードしてください。コピーされるのは各行に記載されたアセットのみです。`byteplus/seedream-*` と `byteplus/seededit-*` の画像は BytePlus ビデオの行には含まれません。
コピーを実行するのは、モデルのネイティブプロバイダーのみです。代替プロバイダーによって処理された実行、つまり `model_provider` が代替プロバイダーを指定している場合、またはネイティブ実行のフォールバック再試行が代替プロバイダーに到達した場合(`X-Comfy-Router-Fallback-Provider` で開示されます)は、そのプロバイダー自身の URL を返します。これらの URL はプロバイダーの有効期限に従い、コピーされません。`model_provider` の値 `default`、`comfy`、`comfyui` は代替プロバイダーを指定しないため、それらの実行はネイティブであり、上記と同様にコピーされます。フォールバック再試行がネイティブプロバイダーに戻った `model_provider` の実行も同様です。
@@ -1040,7 +1038,7 @@ Router がまだ実行前に価格付けできないモデルは、[事前見積
### RouterBilledWorkspace
-拒否された呼び出しが請求しようとしていたウォレットで、`RouterErrorResponse.billed_workspace` に含まれます。「どのウォレットが空なのか?」に答えるものです。呼び出し元の UI で現在選択済みのワークスペースとは限らず、チームメンバーが個人の認証情報を使っている場合は、資金のあるチームが開かれていてもここにはそのメンバーの個人ウォレットが示されます。`denied_reason` と一緒にのみ存在します。
+拒否された呼び出しが請求対象としていたウォレットで、`RouterErrorResponse.billed_workspace` に含まれます。「どのウォレットが空なのか?」に答えるものです。呼び出し元の UI が現在選択済みのワークスペースとは限らず、チームメンバーが個人の認証情報を使用している場合は、資金のあるチームが開かれていてもここにはそのメンバーの個人ウォレットが示されます。`denied_reason` と一緒にのみ存在します。
**フィールド**
@@ -1053,12 +1051,12 @@ Router がまだ実行前に価格付けできないモデルは、[事前見積
- 呼び出しがクラウドワークスペースではなく、呼び出し元のワークスペース以前の Metronome 顧客に請求する場合は `legacy`。その顧客にはワークスペース ID がありません。クラウドワークスペースの場合は存在しません。
+ 呼び出しがクラウドワークスペースではなく、呼び出し元のワークスペース導入以前の Metronome 顧客に請求する場合は `legacy`。その顧客にはワークスペース ID がありません。クラウドワークスペースの場合は存在しません。
### RouterChargesOnPolicyRejection
-コンテンツポリシーによる拒否がこのモデルで課金されるかどうか。不明な値は課金される可能性があるものとして扱ってください。
+コンテンツポリシーによる拒否が、このモデルで課金の対象になるかどうか。不明な値は課金される可能性があるものとして扱ってください。
型: `string`
@@ -1123,7 +1121,7 @@ Router がまだ実行前に価格付けできないモデルは、[事前見積
- この見積もりの価格設定に使用したレートカードを取得した日時。見積もりは価格ロックではありません。実行は、評価時点で有効な料金で請求され、この時点の料金ではありません。ベンダーの公開価格表から取得した `estimated` 見積もり(ベンダーが報告するコストで請求されるモデル)では、代わりにその価格表を読み取った日付を持ちます。請求数量をその価格表から予測し、その後レートカードで価格設定するもの(ベンダーが報告するクレジットで請求されるモデル)では、2 つの日付のうち古い方を持ちます。レートカードを読み取らなかった場合(`reason: pricing_unavailable`、`byok`、またはどのカードからも価格設定できない `not_quotable` の呼び出し)は、これは見積もりに回答した時点です。
+ この見積もりの価格設定に使用したレートカードを取得した日時。見積もりは価格ロックではありません。実行は、評価時点で有効な料金で請求され、この時点の料金ではありません。ベンダーの公開価格表から取得した `estimated` の見積もり(ベンダーが報告するコストで請求されるモデル)では、代わりにその価格表を読み取った日付を持ちます。請求数量をベンダーの公開スケジュールから予測し、その後レートカードで価格設定する見積もりは、`exact` の回答でも `estimated` の回答でも同様に、そのスケジュールの読み取り日付とカードの取得時刻のうち古い方を持ちます(ベンダーが報告するクレジットで請求されるモデルが `estimated` の場合に当たります)。レートカードを読み取らなかった場合(`reason: pricing_unavailable`、`byok`、またはどのカードからも価格設定できない `not_quotable` の呼び出し)は、これは見積もりに回答した時点です。
date-time
@@ -1161,13 +1159,13 @@ Router がまだ実行前に価格付けできないモデルは、[事前見積
- 拒否された呼び出しが請求するはずだったウォレットを、`RouterErrorResponse.billed_workspace` で示します。「どのウォレットが空なのか?」に答えるものであり、呼び出し元の UI が現在選択しているワークスペースとは限りません。資金のあるチームが開いていても、チームメンバーの個人クレデンシャルはここに個人ウォレットを示します。`denied_reason` と一緒にのみ存在します。
+ 拒否された呼び出しが請求するはずだったウォレットを、`RouterErrorResponse.billed_workspace` で示します。「どのウォレットが空なのか?」に答えるものであり、呼び出し元の UI が現在選択しているワークスペースとは限りません。資金のあるチームが開いていても、チームメンバーの個人クレデンシャルはここに個人ウォレットを示します。`denied_reason` と一緒にのみ存在します。
Type: [`RouterBilledWorkspace`](#routerbilledworkspace)
- 拒否されたリクエストがどのように認証されたかを示します。`personal_api_key`、`team_api_key`、`personal_session`、`team_session` のいずれかです。「もう一方のウォレットに請求するには、どのクレデンシャルに切り替えればよいか?」に答えます。これは権限ではなく、何も付与しません。`denied_reason` と一緒にのみ存在します。
+ 拒否されたリクエストがどのように認証されたかを示します。`personal_api_key`、`team_api_key`、`personal_session`、`team_session` のいずれかです。「もう一方のウォレットに請求するには、どのクレデンシャルに切り替えればよいか?」に答えます。これは権限ではなく、何も付与しません。`denied_reason` と一緒にのみ存在します。
### RouterErrorType {#routererrortype}
@@ -1212,7 +1210,7 @@ Router がまだ実行前に価格付けできないモデルは、[事前見積
`POST /v2/models/{provider}/{model}` で使用されるモデル ID。
-型: `string`。モデル ID(例: `anthropic/claude-opus-4-6`)、最大 193 文字。
+型: `string` -- モデル ID(例: `anthropic/claude-opus-4-6`)、最大 193 文字
### RouterModelInput
@@ -1310,7 +1308,7 @@ Router モデルカタログの 1 ページ分です。
`{provider}/{model}` 形式のモデル ID のうち、プロバイダー部分です。
-型: `string`。英数字スラッグ(例: `anthropic`)、最大 64 文字です。
+型: `string`。英数字のスラッグ(例: `anthropic`)、最大 64 文字です。
### RouterQueueCancelResponse
@@ -1334,11 +1332,11 @@ Router モデルカタログの 1 ページ分です。
このルートが実際に解決したリクエストを表す2つの結果について、キャンセル要求が見つけた内容を示します。どちらもHTTPステータスに反映されるため、クライアントはどちらを基準に分岐してもかまいません。
-型: `文字列`
+型: `string`
### RouterQueuePosition
-レスポンスが生成された時点で、このリクエストよりキュー内で先行しているリクエストの数。0 はこのリクエストが先頭であることを意味します。
+レスポンスが構成された瞬間に、このリクエストよりキュー内で先行しているリクエストの数。0 はこのリクエストが先頭であることを意味します。
型: `integer`、0 以上。
@@ -1356,7 +1354,7 @@ Router モデルカタログの 1 ページ分です。
### RouterQueueStatusFields
-`RouterQueueStatusResponse` のうち URL ブロックではない半分です。キュー中の 1 リクエストの識別子、その現在の状態、そしてその状態がターミナルで実行が成功しなかった場合には、その理由を示す粗い分類を持ちます。
+`RouterQueueStatusResponse` のうち URL ブロックではない半分です。キュー中の 1 リクエストの識別情報、その現在の状態、そしてその状態がターミナルで実行が成功しなかった場合には、その理由を示す粗い分類を持ちます。
**フィールド**
@@ -1432,7 +1430,7 @@ Router モデルカタログの 1 ページ分です。
### RouterQueueUrls
-キュー中の1つのリクエストの残りのライフサイクルを扱う3つのURLです。有効なハンドルを含むすべてのレスポンスで返されるため、クライアントがキューのURLを自分で組み立てることはありません。
+キュー中の1つのリクエストの残りのライフサイクルに対する3つのURLです。有効なハンドルを含むすべてのレスポンスで返されるため、クライアントがキューのURLを自分で組み立てることはありません。
**フィールド**
@@ -1492,7 +1490,7 @@ Router モデルカタログの 1 ページ分です。
### RouterValidationErrorInput
-プロバイダーが拒否された入力値を含める場合、その値です。
+プロバイダーがそれを含める場合の、拒否された入力値です。
### RouterValidationErrorResponse
@@ -1501,7 +1499,7 @@ Router モデルカタログの 1 ページ分です。
**フィールド**
- リクエストで見つかったすべての検証失敗。問題のあるフィールドごとに1エントリです。
+ リクエストで見つかったすべての検証失敗を、問題のあるフィールドごとに1エントリとして格納します。
型: [`RouterValidationErrorDetail`](#routervalidationerrordetail) の配列
diff --git a/ko/development/comfy-router/api.mdx b/ko/development/comfy-router/api.mdx
index dfff2eac06..ea11c63d78 100644
--- a/ko/development/comfy-router/api.mdx
+++ b/ko/development/comfy-router/api.mdx
@@ -2,7 +2,7 @@
title: "Comfy Router API 개요"
sidebarTitle: "개요"
description: "Comfy Router API의 작동 방식: 모델 ID당 하나의 라우트이며, 검색, 스키마, 대기 중인 요청, 오류, 결제에 대한 가이드를 제공합니다."
-translationSourceHash: dac7e853
+translationSourceHash: cb493feb
translationFrom: development/comfy-router/api.mdx
---
@@ -45,4 +45,5 @@ translationFrom: development/comfy-router/api.mdx
- [빠른 시작](/ko/development/comfy-router/quickstart): 설치, 호출, 이미지 저장.
- [모델](/ko/development/comfy-router/models): 카탈로그를 찾아보고 모델별 요청 예시를 확인합니다.
- [헤더](/ko/development/comfy-router/headers): 인증, 멱등성, 요청 ID, 재시도 간격 조정.
-- [API 레퍼런스](/ko/development/comfy-router/reference): 엔드포인트 파라미터, 스키마, 응답 코드.
\ No newline at end of file
+- [API 레퍼런스](/ko/development/comfy-router/reference): 엔드포인트 파라미터, 스키마, 응답 코드.
+- [실시간 음성](/ko/development/comfy-router/realtime): Grok Voice WebSocket 세션을 열고 초 단위로 과금됩니다.
\ No newline at end of file
diff --git a/ko/development/comfy-router/limitations.mdx b/ko/development/comfy-router/limitations.mdx
index 5fd22da5b6..967ebc4132 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: 235802c5
+translationSourceHash: b4d8209c
translationFrom: development/comfy-router/limitations.mdx
translationBlockHashes:
"_intro": 6b871cf3
@@ -14,7 +14,7 @@ translationBlockHashes:
"Requests are rate limited per caller": 249d4d51
"No progress while a call runs": 75d42d8d
"Comfy charges and usage": cf6e2050
- "Models without a pre-flight estimate": 495bdb2b
+ "Models without a pre-flight estimate": f6dfd921
"Router does not cover every partner operation": 786c0fb2
"Model outputs and stored assets": 06c737c1
"Next": be85b789
@@ -28,6 +28,7 @@ translationBlockHashes:
+
Router는 파트너 모델을 하나의 동기식 HTTP 호출로 실행하거나, 제출한 뒤 나중에 수집하는 대기 중 요청을 통해 실행합니다. 애플리케이션이 완료된 결과를 기다리거나 나중에 결과를 수집할 수 있고, 모델 자체의 입력 및 출력 필드를 처리할 수 있는 경우에 사용하십시오.
## Router가 지원하는 기능
@@ -116,21 +117,17 @@ Router는 아직 아래 모델에 대한 호출 비용을 실행 전에 안정
{/* BEGIN GENERATED: models without a pre-flight estimate. Do not hand-edit; regenerate with -update-quote-coverage-docs. */}
- **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`
-- **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`
+- **fal**: `fal/fal-seedance-2.0`, `fal/fal-seedance-2.5`
- **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`
-- **meshy**: `meshy/animations`, `meshy/meshy-6`, `meshy/meshy-7`, `meshy/meshy-7.1`, `meshy/remesh`, `meshy/rigging`
+- **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4`
+- **kling**: `kling/kling-image-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync`, `kling/videos-video-extend`
- **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`
- **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`
- **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/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 */}
diff --git a/ko/development/comfy-router/realtime.mdx b/ko/development/comfy-router/realtime.mdx
new file mode 100644
index 0000000000..4fc117411a
--- /dev/null
+++ b/ko/development/comfy-router/realtime.mdx
@@ -0,0 +1,223 @@
+---
+title: "Comfy Router 실시간 음성 세션"
+sidebarTitle: "실시간 음성"
+description: "Comfy Router를 통해 Grok Voice 실시간 WebSocket 세션을 엽니다. 엔드포인트, 인증, 초당 과금, 세션 제한, 그리고 받을 수 있는 오류와 종료 코드를 다룹니다."
+translationSourceHash: e4024a38
+translationFrom: development/comfy-router/realtime.mdx
+translationBlockHashes:
+ "_intro": a85f88e5
+ "Endpoint": 2ae36abf
+ "Authentication": 582120fe
+ "Connect": b61ae8c6
+ "Events": a3ac8c47
+ "Pricing": 25d35f6c
+ "Limits": 85e21dff
+ "Errors": 3085ba65
+ "Next": 3e8c1bd8
+---
+Comfy Router는 fal이 제공하는 xAI의 Grok Voice와 실시간 음성 대 음성 세션을 중계합니다. Comfy API 키를 사용해 Router에 WebSocket 하나를 엽니다. Router는 계정과 크레딧을 확인하고 업스트림에 세션을 연 뒤, 양방향으로 이벤트를 중계합니다. 비용은 세션 초 단위로 Comfy 크레딧에서 차감됩니다.
+
+## 엔드포인트
+
+```text
+wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime
+```
+
+요청은 WebSocket 업그레이드입니다(`Connection: Upgrade`와 `Upgrade: websocket`을 포함한 `GET`). 그 외의 요청은 `426`으로 거부됩니다.
+
+## 인증
+
+업그레이드 요청의 헤더에 Comfy API 키를 전송하세요. `X-API-Key: comfyui-...` 또는 `Authorization: Bearer comfyui-...` 형식을 사용할 수 있습니다. Router는 쿼리 문자열이나 WebSocket 하위 프로토콜에서 키를 읽지 않습니다.
+
+
+브라우저는 WebSocket에 헤더를 설정할 수 없으며, Comfy API 키는 절대 브라우저에 도달해서는 안 됩니다. 서버에서 세션을 열고 오디오를 브라우저로 직접 릴레이하세요.
+
+
+## 연결
+
+업그레이드가 성공하면 xAI가 Grok Voice용으로 문서화한 실시간 이벤트를 주고받습니다. 이 예제는 세션을 구성하고, 텍스트 턴을 하나 전송하며, 수신하는 각 이벤트 유형을 출력합니다.
+
+
+
+```python Python
+# pip install websockets msgpack
+import asyncio
+import os
+
+import msgpack
+import websockets
+
+URL = "wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime"
+
+
+async def send(ws, event):
+ await ws.send(msgpack.packb(event))
+
+
+async def main():
+ async with websockets.connect(
+ URL,
+ additional_headers={"X-API-Key": os.environ["COMFY_API_KEY"]},
+ ) as ws:
+ await send(ws, {
+ "type": "session.update",
+ "session": {
+ "voice": "eve",
+ "instructions": "You are a helpful assistant.",
+ "turn_detection": {"type": "server_vad"},
+ },
+ })
+ await send(ws, {
+ "type": "conversation.item.create",
+ "item": {
+ "type": "message",
+ "role": "user",
+ "content": [{"type": "input_text", "text": "Hello!"}],
+ },
+ })
+ await send(ws, {"type": "response.create"})
+
+ async for message in ws:
+ if isinstance(message, str):
+ continue # fal 자체의 x-fal-message 프레임
+ event = msgpack.unpackb(message)
+ print(event["type"])
+ if event["type"] == "response.done":
+ break
+
+
+asyncio.run(main())
+```
+
+```javascript Node.js
+// npm install ws @msgpack/msgpack
+import WebSocket from "ws";
+import { encode, decode } from "@msgpack/msgpack";
+
+const ws = new WebSocket(
+ "wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime",
+ { headers: { "X-API-Key": process.env.COMFY_API_KEY } },
+);
+
+ws.on("unexpected-response", (req, res) => {
+ // 업그레이드가 거부되었습니다. JSON 본문에 이유가 나와 있습니다.
+ let body = "";
+ res.on("data", (chunk) => (body += chunk));
+ res.on("end", () => console.error(res.statusCode, body));
+});
+
+const send = (event) => ws.send(encode(event));
+
+ws.on("open", () => {
+ send({
+ type: "session.update",
+ session: {
+ voice: "eve",
+ instructions: "You are a helpful assistant.",
+ turn_detection: { type: "server_vad" },
+ },
+ });
+ send({
+ type: "conversation.item.create",
+ item: {
+ type: "message",
+ role: "user",
+ content: [{ type: "input_text", text: "Hello!" }],
+ },
+ });
+ send({ type: "response.create" });
+});
+
+ws.on("message", (data, isBinary) => {
+ if (!isBinary) return; // fal 자체의 x-fal-message 프레임
+ const event = decode(data);
+ console.log(event.type);
+ if (event.type === "response.done") ws.close();
+});
+
+ws.on("close", (code) => console.log("closed", code));
+```
+
+
+
+작업이 끝나면 즉시 소켓을 닫으세요. 마지막 응답이 아니라 세션이 닫힐 때까지 요금이 청구됩니다.
+
+## 이벤트
+
+Router는 자체 이벤트 프로토콜을 정의하지 않습니다. 서버 이벤트는 fal이 보내는 그대로 전달되며, Router가 허용하는 클라이언트 이벤트도 변경 없이 전달됩니다. 이벤트 목록, 세션 필드, 음성, 오디오 형식은 다음 문서를 참고하세요.
+
+- [xAI Speech to Speech](https://docs.x.ai/developers/model-capabilities/audio/speech-to-speech) 및 xAI의 [realtime 이벤트 스키마](https://docs.x.ai/voice-realtime.ws.json)
+- fal의 [Grok Voice realtime 모델 페이지](https://fal.ai/models/xai/grok-voice/realtime) 및 [API 페이지](https://fal.ai/models/xai/grok-voice/realtime/api)
+
+예제에서처럼 각 클라이언트 이벤트를 하나의 msgpack 바이너리 메시지로 전송하세요. 이는 fal의 realtime 클라이언트가 사용하는 프레이밍 방식이며, 모델의 이벤트도 `session.created`로 시작하는 msgpack 바이너리 메시지로 같은 방식으로 돌아옵니다. fal은 `x-fal-message` 유형의 자체 JSON 텍스트 메시지(타이밍 정보)도 보내는데, 이는 건너뛰어도 됩니다. Router의 검사는 클라이언트 이벤트를 하나의 JSON 텍스트 메시지로도 허용하지만, 클라이언트에서 JSON을 테스트해 보지 않았다면 msgpack을 사용하세요.
+
+Router는 전달하기 전에 각 클라이언트 이벤트를 검사합니다.
+
+- **이벤트 유형:** `session.update`, `input_audio_buffer.append`, `input_audio_buffer.commit`, `input_audio_buffer.clear`, `conversation.item.create`, `conversation.item.delete`, `conversation.item.truncate`, `response.create`, `response.cancel`, 그리고 fal의 `x-fal-session.configure`.
+- **모델:** `session.update`의 `model`은 `grok-voice-latest`, `grok-voice-3.0`, `grok-voice-2.0` 중 하나여야 합니다.
+- **도구:** 클라이언트가 실행하는 function 도구는 허용됩니다. 서버 측 도구(웹 검색, X 검색, 파일 검색, MCP)는 거부됩니다.
+- **미디어:** 이미지 및 비디오 입력은 거부됩니다. 세션은 음성과 텍스트만 지원합니다.
+- **크기:** 클라이언트 메시지 하나는 최대 1 MiB입니다.
+
+거부된 이벤트는 전달되지 않으며, Router는 종료 코드 `1008`로 세션을 닫습니다.
+
+## 요금
+
+세션 요금은 **초당 $0.0011869**입니다(211크레딧 = $1 USD 기준으로 분당 약 $0.0712, 초당 0.2504크레딧, 분당 약 15.0크레딧). 세션이 열려 있는 동안 15초 단위로 청구되며, 마지막 남은 부분 구간은 초 단위로 올림하여 청구됩니다. 청구는 오디오가 흐르고 있는지 여부와 관계없이 업그레이드 시점부터 소켓이 닫힐 때까지 이루어집니다.
+
+## 제한
+
+| 제한 | 값 |
+| --- | --- |
+| 계정당 세션 | 한 번에 하나의 세션만 열 수 있습니다. 두 번째 세션을 열면 `429`와 함께 `router.realtime.session_already_live`가 반환됩니다. |
+| 세션 길이 | 최대 30분이며, 연결 시점에 보유 크레딧 잔액이 감당할 수 있는 시간을 초과할 수 없습니다. |
+| 세션 중 크레딧 | Router는 15초마다 잔액을 다시 확인하며, 잔액이 다음 1초를 감당할 수 없게 되면 세션을 종료합니다. |
+| 연결 속도 | 각 업그레이드 시도는 다른 Router 호출과 공유되는 [호출자별 요청 속도](/ko/development/comfy-router/limitations#요청은-호출자별로-속도-제한됩니다)에 포함됩니다. |
+
+세션이 시간 제한에 도달하거나 크레딧이 소진되면, 연결이 close frame 없이 끊길 수 있습니다(흔히 close code `1006`으로 표시됩니다). 크레딧을 충전한 이후에만 다시 연결하거나, 더 많은 시간이 필요하면 새 세션을 시작하세요.
+
+## 오류
+
+### 업그레이드 이전
+
+Router가 연결을 거부하면 프로토콜 전환 대신 HTTP 상태와 JSON 본문으로 응답합니다:
+
+```json
+{
+ "detail": "Insufficient credits to open a realtime session.",
+ "error_type": "insufficient_credits",
+ "code": "router.realtime.insufficient_credits"
+}
+```
+
+`code`를 기준으로 분기하세요. `detail`은 사람이 읽기 위한 값입니다.
+
+| 상태 | `code` | 원인 | 해결 방법 |
+| --- | --- | --- | --- |
+| `426` | `router.realtime.upgrade_required` | 요청이 WebSocket 업그레이드가 아니었습니다. | WebSocket 클라이언트로 연결하세요. |
+| `401` | `router.realtime.unauthorized` | API 키가 누락되었거나 유효하지 않습니다. | `X-API-Key` 또는 `Authorization: Bearer`에 유효한 키를 보내세요. |
+| `402` | `router.realtime.insufficient_credits` | 잔액으로 최소 1초의 세션도 감당할 수 없습니다. | 크레딧을 추가한 후 다시 연결하세요. |
+| `402` | `router.realtime.spend_denied` | 세션이 청구될 지갑에 자금이 없습니다. 본문의 `denied_reason`과 `billed_workspace`가 어느 지갑인지 알려줍니다. | 해당 워크스페이스에 크레딧을 추가한 후 다시 연결하세요. |
+| `403` | `router.realtime.provider_disabled` | 워크스페이스의 파트너 공급자 정책이 이 공급자를 허용하지 않습니다. | 워크스페이스 관리자에게 허용을 요청하세요. |
+| `404` | `router.realtime.model_not_allowed` | URL의 모델을 realtime에 사용할 수 없습니다. | URL을 확인하세요. |
+| `429` | `router.realtime.rate_limited` | 요청 속도를 초과했습니다. | `Retry-After`만큼 기다린 후 다시 시도하세요. |
+| `429` | `router.realtime.session_already_live` | 계정에 이미 다른 세션이 열려 있습니다. | 먼저 닫으세요. |
+| `429` | `router.realtime.concurrency_limit` | 동시 파트너 모델 호출이 너무 많습니다. | 동시 작업을 줄이고 다시 시도하세요. |
+| `502` | `router.realtime.upstream_refused`, `router.realtime.token_mint_failed` | 업스트림 공급자가 세션을 열지 못했습니다. | 백오프를 두고 다시 시도하세요. |
+| `503` | 기타 `router.realtime.*` 코드 | 실시간 세션을 일시적으로 사용할 수 없습니다. | 백오프를 두고 다시 시도하세요. |
+
+### 업그레이드 이후
+
+| 종료 코드 | 의미 | 해결 방법 |
+| --- | --- | --- |
+| `1008` | 클라이언트 이벤트가 거부되었습니다([이벤트](#이벤트) 참조). | 이벤트를 수정하세요. 세션은 종료됩니다. |
+| `1012` | Router가 재시작 중입니다. | 다시 연결하세요. 새 세션이 시작되며 새 업그레이드 시점부터 과금됩니다. |
+| `1006` (close 프레임 없음) | 세션이 시간 제한에 도달하거나 크레딧이 소진되었을 때 클라이언트가 흔히 보고하는 값입니다. 네트워크 끊김도 동일하게 보입니다. | 크레딧을 추가하거나 새 세션을 시작하세요. |
+
+그 외의 종료는 fal 또는 xAI에서 발생합니다. [이벤트](#이벤트) 아래에 링크된 해당 문서를 참조하세요.
+
+## 다음
+
+- [요금 청구](/ko/development/comfy-router/billing): Router가 요금을 청구하는 방식과 사용량을 대조하는 방법입니다.
+- [오류 및 재시도](/ko/development/comfy-router/errors): 다른 Router 호출이 반환하는 오류 버킷입니다.
+- [제한 사항](/ko/development/comfy-router/limitations): 요청 속도 및 기타 제한입니다.
diff --git a/zh/development/comfy-router/api.mdx b/zh/development/comfy-router/api.mdx
index 63a66aff1a..c9d3d5fce7 100644
--- a/zh/development/comfy-router/api.mdx
+++ b/zh/development/comfy-router/api.mdx
@@ -2,7 +2,7 @@
title: "Comfy Router API 概览"
sidebarTitle: "概览"
description: "Comfy Router API 的工作方式:每个模型 ID 对应一个路由,并提供关于发现模型、schema、排队请求、错误和计费的指南。"
-translationSourceHash: dac7e853
+translationSourceHash: cb493feb
translationFrom: development/comfy-router/api.mdx
---
@@ -45,4 +45,5 @@ translationFrom: development/comfy-router/api.mdx
- [快速开始](/zh/development/comfy-router/quickstart):安装、调用以及保存图像。
- [模型](/zh/development/comfy-router/models):浏览目录并查看各模型专属的请求示例。
- [请求头](/zh/development/comfy-router/headers):身份验证、幂等性、请求 ID 以及重试节奏。
-- [API 参考](/zh/development/comfy-router/reference):端点参数、schema 以及响应码。
\ No newline at end of file
+- [API 参考](/zh/development/comfy-router/reference):端点参数、schema 以及响应码。
+- [实时语音](/zh/development/comfy-router/realtime):开启 Grok Voice WebSocket 会话,按秒计费。
\ No newline at end of file
diff --git a/zh/development/comfy-router/limitations.mdx b/zh/development/comfy-router/limitations.mdx
index f580a19c68..72e4e5fa08 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: 235802c5
+translationSourceHash: b4d8209c
translationFrom: development/comfy-router/limitations.mdx
translationBlockHashes:
"_intro": 6b871cf3
@@ -14,7 +14,7 @@ translationBlockHashes:
"Requests are rate limited per caller": 249d4d51
"No progress while a call runs": 75d42d8d
"Comfy charges and usage": cf6e2050
- "Models without a pre-flight estimate": 495bdb2b
+ "Models without a pre-flight estimate": f6dfd921
"Router does not cover every partner operation": 786c0fb2
"Model outputs and stored assets": 06c737c1
"Next": be85b789
@@ -28,6 +28,7 @@ translationBlockHashes:
+
Router 通过一次同步 HTTP 调用运行合作伙伴模型,或通过一个已排队的请求运行:你提交请求,稍后再收集结果。当你的应用能够等待一个已完成的结果,或稍后收集结果,并且能够处理模型自身的输入和输出字段时,就使用它。
## Router 支持的功能
@@ -105,7 +106,7 @@ Router 只返回最终响应,不提供流式 token、服务器发送事件、
模型目录提供计费事实,包括 `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#运行前成本估算)。无法在运行前定价的模型列在[没有预检估算的模型](#无法预先估算的模型)中。
## 无法预先估算的模型
@@ -116,21 +117,17 @@ Router 目前还无法在运行前可靠地为对以下模型的调用定价,
{/* BEGIN GENERATED: models without a pre-flight estimate. Do not hand-edit; regenerate with -update-quote-coverage-docs. */}
- **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`
-- **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`
+- **fal**: `fal/fal-seedance-2.0`, `fal/fal-seedance-2.5`
- **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`
-- **meshy**: `meshy/animations`, `meshy/meshy-6`, `meshy/meshy-7`, `meshy/meshy-7.1`, `meshy/remesh`, `meshy/rigging`
+- **ideogram**: `ideogram/ideogram-v3`, `ideogram/ideogram-v4`
+- **kling**: `kling/kling-image-o1`, `kling/videos-avatar-image2video`, `kling/videos-lip-sync`, `kling/videos-video-extend`
- **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`
- **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`
- **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/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 */}
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 4ddd53b499..3d5e238a89 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,13 +2,13 @@
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: 9604ca27
+translationSourceHash: 70ec471f
translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx
translationBlockHashes:
"_intro": 54eac94b
"Quick start": ca074ca5
"Serving providers": 74eb2a7c
- "Schema": 6c5da06a
+ "Schema": 8c0478c9
"Examples": 641c458b
---
@@ -16,6 +16,7 @@ translationBlockHashes:
+
{/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/byteplus/dreamina-seedance-2-0-260128.json 生成。 */}
import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx";
@@ -197,29 +198,29 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-260128/reque
### 输入
- 已忽略。仅为兼容 BytePlus 的请求结构而接受,但在提交任务前会被移除,因此不会发送任何回调;请改为轮询任务状态接口获取结果。
+ 忽略。为兼容 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:音频的公开 URL(wav、mp3)。
+Base64:格式为 data:audio/\;base64,\
+资产 ID:格式为 asset://\
仅 Seedance 2.5。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。
-最终视频会复用 Draft 任务的提示词、输入资产、duration、ratio、seed、generate_audio 和 omni_reference_task_type;不要再次发送这些内容。resolution 默认为且仅支持 1080p。
+最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。resolution 默认为 1080p,且仅支持 1080p。
@@ -232,9 +233,9 @@ Base64:格式 data:audio/\;base64,\
用于图生视频生成的图像内容(当 type 为 "image_url" 时)
-图片 URL:确保图像 URL 可访问。
+图片网址:请确保图片网址可访问。
Base64 编码内容:格式必须为 data:image/\;base64,\
-资产 ID:格式 asset://\
+资产 ID:格式为 asset://\
@@ -243,7 +244,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`
@@ -262,14 +263,16 @@ Base64 编码内容:格式必须为 data:image/\;base64,\
示例:"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`
@@ -278,64 +281,64 @@ Comfy 侧的保护措施,并非 BytePlus 的限制。BytePlus 未公布文本
视频 URL 或资产 ID。
-视频 URL:视频的公开 URL(mp4, mov)。
-资产 ID:格式 asset://\
+视频 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 视频;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.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。
- 范围:`2` 到 `30`
+ 可能值:`-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15`
- 任务超时阈值(秒)。默认 172800(48h)。范围:[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 拒绝任何其他值以及省略该值的情况。它不在本 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 时 MUST 提供该参数,代理会以 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.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: 不返回已生成视频的最后一帧图像。
+ 是否返回已生成视频的尾帧图像。
+是:返回已生成视频的尾帧图像。将此参数设为是之后,你可以通过查询视频生成任务信息来获取尾帧图像。尾帧图像为 PNG 格式,像素宽度和高度与已生成的视频一致,且不含水印。使用此参数可以生成多个连续视频:将前一个已生成视频的尾帧用作下一个视频任务的首帧,从而快速生成多个连续视频。
+否:不返回已生成视频的尾帧图像。
@@ -345,9 +348,9 @@ false: 不返回已生成视频的最后一帧图像。
- 用于处理的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。
+ 处理所用的服务层级。Seedance 2.5、2.0 和 2.0 fast 不支持 flex(离线推理)。
- 可选值:`default`,`flex`
+ 可选值:`default`、`flex`
@@ -359,49 +362,49 @@ false: 不返回已生成视频的最后一帧图像。
### 输出
- 视频生成任务完成后的输出,其中包含输出视频的下载 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 自有字段。可为 null: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 只剩 1 小时有效期。无法执行重新托管时,该字段会保留 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` 的生命周期无关。
+ 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` 的生存期无关。
- Format: `date-time`
+ 格式:`date-time`
- BytePlus 自己的最后一帧下载 URL,会与重新托管的 `last_frame_url` 一起逐字节原样返回,条件与 `upstream_video_url` 相同:仅限已选择加入的工作区,仅限 Seedance 2.x,一旦 BytePlus 清除它就会缺失,并且在 `upstream_expires_at` 之前是持有者凭证。
+ 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 自己的重新托管操作消耗。
+ 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 小时清除它,并在某些模型上限制为 100 次下载。无论哪种情况,链接都会过期,因此请下载视频,而不是存储 URL。
+ 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并改写此字段,因此它通常是 Comfy 签名的 URL,有效期最长为 24 小时:生成时按 24 小时签名,并从 23 小时缓存记录中重放,因此稍后轮询可能拿到的 URL 只剩 1 小时有效期。无法执行重新托管时,该字段会保留 BytePlus 自有的 URL,BytePlus 会在任务结束 24 小时后清除该 URL,并在某些模型上将下载次数限制为 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 失败任务响应中识别策略系列,而不会覆盖传输失败。
@@ -413,25 +416,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`
@@ -441,7 +444,7 @@ false: 不返回已生成视频的最后一帧图像。
- 请求的 token 用量
+ 该请求的 token 用量
@@ -449,7 +452,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 e3b70a93fc..ecd12b9673 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,18 +2,19 @@
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: b02c6ed1
+translationSourceHash: 8036f4db
translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx
translationBlockHashes:
"_intro": e4deed0d
"Quick start": f5201dd4
- "Schema": e03c503a
+ "Schema": 90b60b2e
"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";
@@ -182,7 +183,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-fast-260128/
### 输入
- 会被忽略。为兼容 BytePlus 的请求结构而接受,但在任务提交之前会被移除,因此不会发送任何回调;请改为轮询任务状态路由来获取结果。
+ 已忽略。为兼容 BytePlus 的请求结构而接受此参数,但在提交任务前会将其移除,因此不会发送任何回调;请改为轮询任务状态路由以获取结果。
格式:`uri`
@@ -192,7 +193,7 @@ 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 支持仅音频输入。
@@ -203,12 +204,12 @@ Base64:格式为 data:audio/\;base64,\
- 仅 Seedance 2.5 适用。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。
-最终视频会复用 Draft 任务的提示词、输入资产、duration、ratio、seed、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。resolution 默认为且仅支持 1080p。
+ 仅 Seedance 2.5 支持。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。
+最终视频会复用 Draft 任务的 prompt、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type,请勿再次发送这些参数。resolution 默认为且仅支持 1080p。
- 在 `draft` 设置为 true 的情况下创建 Draft 视频时返回的任务 ID。
+ 创建 Draft 视频时 `draft` 设为 true 所返回的任务 ID。
@@ -218,42 +219,50 @@ Base64:格式为 data:audio/\;base64,\
用于图生视频生成的图像内容(当 type 为 "image_url" 时)
图片网址:请确保图片网址可访问。
-Base64 编码内容:格式必须为 data:image/\;base64,\
+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)
-
-示例:“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 自己的校验器应答。该上限设置得远高于真实流量,因此它从不对真实的提示词作出裁决:如果调用方需要更多,可以提高该值。
+文本提示词(必填):用中英文字符描述要生成的视频。
+
+参数(可选):在文本提示词后添加 --[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 自身的校验器作答。该值设得
+远高于真实流量,因此它永远不会判定真实提示词不合规。如果调用方
+需要更多,请提高此值。
输入内容的类型
- 可选值:`text`、`image_url`、`video_url`、`audio_url`、`draft_task`
+ 可能的值:`text`、`image_url`、`video_url`、`audio_url`、`draft_task`
@@ -267,62 +276,63 @@ Base64 编码内容:格式必须为 data:image/\;base64,\
- 仅 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.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。
- 范围:`2` 到 `30`
+ 可能的值:`-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15`
- 任务超时阈值,单位为秒。默认值为 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 拒绝任何其他值以及省略它的请求。它不在此 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),颜色精度高,适合后期制作;文件更大。
+ 仅 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.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 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用此参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。
-false: 不返回已生成视频的最后一帧图像。
+ 是否返回已生成视频的末帧图像。
+true:返回已生成视频的末帧图像。将此参数设置为 true 后,你可以通过调用查询视频生成任务信息来获取末帧图像。末帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用该参数可以生成多个连续视频:将前一个已生成视频的末帧作为下一个视频任务的首帧,从而快速生成多个连续视频。
+false:不返回已生成视频的末帧图像。
- 用于控制随机性的种子整数。范围:[-1, 2^32-1]。-1 使用随机种子。
+ 用于控制随机性的种子整数。范围:[-1, 2^32-1]。-1 表示使用随机种子。
范围:`-1` 到 `4294967295`
@@ -337,38 +347,38 @@ false: 不返回已生成视频的最后一帧图像。
已生成视频是否包含水印。
-根据 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,这也是它在请求到达提供商之前用于校验调用的同一份文档。
### 输出
- 视频生成任务完成后得到的输出,包含输出视频的下载 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,仅当请求设置了 `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` 的生存期无关。
+ 上游 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,与重新托管的 `last_frame_url` 并列逐字节返回,条件与 `upstream_video_url` 相同:仅限已选择加入的工作区、仅限 Seedance 2.x、BytePlus 清除后即缺失,并且在 `upstream_expires_at` 之前属于 bearer 凭证。
- BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 并排逐字节返回。仅当任务是由 Comfy 在服务端选择加入的工作区轮询的 Seedance 2.x 任务时才存在(没有请求参数);对其他所有情况都不存在,包括无法解析到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥),并且在生成 24 小时后 BytePlus 清除其 URL 后也不存在。它是一个预签名的对象存储 URL,因此是一种 bearer 凭证:任何持有它的人都能在它过期前下载视频,所以要像对待机密一样对待它。它在 `upstream_expires_at` 过期;在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次会被 Router 自身的重新托管消耗。
+ BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 并列逐字节返回。仅对由 Comfy 在服务器端选择加入的工作区所轮询的 Seedance 2.x 任务存在(没有请求参数);对其他所有情况都缺失,包括解析不到任何工作区的凭证(例如未绑定工作区的传统 API 密钥),并且在 BytePlus 于生成 24 小时后清除其 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 小时后清除它,并在某些模型上将其限制为 100 次下载。无论哪种方式链接都会过期,因此请下载视频,而不要存储 URL。
+ 输出视频的下载 URL。Router 会把视频重新托管到 Comfy 存储并改写该字段,因此它通常是一个 Comfy 签名的 URL,有效期最长 24 小时:签发时为 24 小时签名,并从 23 小时的缓存记录中重放,因此稍后轮询可能拿到的 URL 只剩一小时有效期。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除它,并在某些模型上限制为 100 次下载。两种情况链接都会过期,因此请下载视频,而不是保存 URL。
@@ -376,7 +386,7 @@ false: 不返回已生成视频的最后一帧图像。
- 已生成视频的时长,单位为秒。声明为 number 而非 integer,是因为 BytePlus 在这方面并不一致:已观察到视频任务返回整数秒,而 BytePlus 的其他同级接口会报告带小数的时长,因此客户端不能假定它是整数值。这是 BytePlus 自己的字段,在成功的视频任务上返回并原样转发。
+ 已生成视频的时长,单位为秒。声明为 number 而非 integer,因为 BytePlus 在这方面并不一致:已观察到视频任务返回整秒,而同级的 BytePlus 接口反馈的是带小数的时长,因此客户端不能假定它是整数值。这是 BytePlus 自己的字段,在成功的视频任务上返回并原样转发。
@@ -384,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 失败任务响应中识别策略系列,但不会覆盖传输层故障。
@@ -393,22 +403,23 @@ false: 不返回已生成视频的最后一帧图像。
视频生成任务的 ID
+视频生成任务的 ID
- 任务所使用的模型名称和版本
+ 任务使用的模型名称与版本
- 已生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回,Seedance 视频任务查询会在此处返回该字段。BytePlus 自有字段,原样转发。
+ 已生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回,Seedance 视频任务查询正是在此处返回它。这是 BytePlus 自有字段,原样透传。
- 已生成视频的分辨率,例如 `1080p`。BytePlus 自有字段,在成功的视频任务中返回并原样转发。
+ 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在成功的视频任务中返回,并原样透传。
- 任务实际使用的生成种子。BytePlus 自有字段,在成功的视频任务中返回并原样转发。
+ 任务实际使用的生成种子。这是 BytePlus 自有字段,在成功的视频任务中返回,并原样透传。
格式:`int64`
@@ -432,7 +443,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-mini/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx
index 6995497779..f0e5e96a3f 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,18 +2,19 @@
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: 28c5c053
+translationSourceHash: a1d75c67
translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx
translationBlockHashes:
"_intro": 45ff5bfd
"Quick start": b0374f7d
- "Schema": 3c26a330
+ "Schema": ebf1fc3a
"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";
@@ -182,9 +183,9 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-0-mini/request
### 输入
- 忽略。为兼容 BytePlus 请求结构而接受,但在提交任务前会被移除,因此永远不会发送回调;请改为轮询任务状态路由获取结果。
+ 已忽略。为兼容 BytePlus 的请求结构而接受该字段,但在提交任务前会将其移除,因此不会发送任何回调;请改为轮询任务状态路由来获取结果。
- 格式:`uri`
+ 格式: `uri`
@@ -192,23 +193,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:音频的公开 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;请勿再次发送它们。resolution 默认为且仅支持 1080p。
+最终视频会复用 Draft 任务的 prompt、输入资产、duration、ratio、seed、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。resolution 默认为且仅支持 1080p。
- 使用 `draft` 设置为 true 创建 Draft 视频时返回的任务 ID。
+ 将 `draft` 设为 true 创建 Draft 视频时返回的任务 ID。
@@ -217,50 +218,50 @@ Base64:格式为 data:audio/\;base64,\
用于图生视频生成的图像内容(当 type 为 "image_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`
+ 可能的值: `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"
+示例: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5"
-Comfy 侧护栏,不是 BytePlus 的限制。BytePlus 未发布
+这是 Comfy 侧的防护限制,而非 BytePlus 的约束。BytePlus 未公布
文本长度限制,并在测试中接受了 40,000 个字符(2026-09-17)。
-它按字符而不是字节计数,因此多字节提示词在传输时可能达到
-此大小的数倍。它限制的是这一个字段,而不是请求:
-`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`
+ 可能的值: `text`, `image_url`, `video_url`, `audio_url`, `draft_task`
@@ -269,39 +270,40 @@ Comfy Router(/v2/models/byteplus/\{model})是执行该限制的接口;
视频 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 天。
+ 仅 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.0、2.0 fast 和 2.0 mini:[4,15] 或 -1(自动)。
- 范围:`2` 到 `30`
+ 可能的值: `-1`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`
任务超时阈值,单位为秒。默认 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,省略该值时也会返回 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 时 MUST 提供该值:代理会拒绝任何其他值,也会拒绝缺失该值,并返回 400。它不在本 schema 的 `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),颜色精度高,适合后期制作;文件大小更大。
@@ -309,23 +311,23 @@ mov: 专业容器(H.264 High 4:4:4 Predictive/PCM,yuv444p),颜色精度
- 生成视频的宽高比。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 格式,其像素宽度和高度与已生成视频一致,且不包含水印。使用此参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。
-false: 不返回已生成视频的最后一帧图像。
+ 是否返回已生成视频的末帧图像。
+true: 返回已生成视频的末帧图像。将该参数设为 true 后,你可以通过调用查询视频生成任务信息接口来获取末帧图像。末帧图像为 PNG 格式,其像素宽度和高度与已生成的视频一致,且不含水印。使用该参数可以生成多个连续视频:将前一个已生成视频的末帧作为下一个视频任务的首帧,从而快速生成多个连续视频。
+false: 不返回已生成视频的末帧图像。
@@ -335,87 +337,86 @@ false: 不返回已生成视频的最后一帧图像。
- 用于处理的服务层级。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/dreamina-seedance-2-0-mini/openapi.json` 提供的 schema 生成,此文档也是它在请求到达提供商之前校验调用时所依据的同一文档。
+根据 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-0-mini/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 自己的。可为 null: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。
- 已生成视频的容器格式(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` 的生命周期无关。
+ 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,与重新托管的 `last_frame_url` 并排逐字节原样返回,条件与 `upstream_video_url` 相同:仅限已选择加入的工作区、仅限 Seedance 2.x、BytePlus 清除后即缺失,并且在 `upstream_expires_at` 之前是 bearer 凭据。
- BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 一起逐字节原样返回。仅当轮询 Seedance 2.x 任务的工作区已在服务器端由 Comfy 选择加入时才提供(没有请求参数);对其他所有情况均不提供,包括无法解析到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥),并且一旦 BytePlus 在生成 24 小时后清除其 URL,也会不再提供。它是预签名对象存储 URL,因此也是持有者凭证:任何持有它的人都能在过期前下载视频,所以请像对待机密一样对待它。它在 `upstream_expires_at` 过期;在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次会被 Router 自己的重新托管消耗。
+ 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 小时后清除该 URL,并在某些模型上将其限制为 100 次下载。无论哪种情况,链接都会过期,因此请下载视频,而不是保存 URL。
+ 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储上并改写此字段,因此它通常是 Comfy 签名的 URL,有效期最长 24 小时:签发时按 24 小时签名,并从 23 小时的备忘中重放,因此较晚的轮询可能返回只剩一小时有效期的 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。这是开放字符串,而非枚举:其他错误码用于描述验证与提供商失败。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
+视频生成任务的 ID
- 该任务使用的模型名称及版本
+ 任务所使用的模型名称和版本
- 已生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的兄弟字段返回,Seedance 视频任务查询即在此处返回该字段。这是 BytePlus 自有字段,原样透传。
+ 已生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级返回,Seedance 视频任务查询就是在这里返回它。这是 BytePlus 自有字段,原样转发。
- 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在成功的视频任务中返回,原样透传。
+ 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在成功的视频任务中返回,并原样转发。
- 该任务实际使用的生成种子。这是 BytePlus 自有字段,在成功的视频任务中返回,原样透传。
+ 任务实际使用的生成种子。这是 BytePlus 自有字段,在成功的视频任务中返回,并原样转发。
格式:`int64`
@@ -431,7 +432,7 @@ false: 不返回已生成视频的最后一帧图像。
- 本次请求的 token 用量
+ 请求的 token 用量
@@ -439,7 +440,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-5-260628/code.mdx b/zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx
index 6b83dea46c..ae6c628b46 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,19 +2,20 @@
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: 07fd9c64
+translationSourceHash: 3606fb83
translationFrom: development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx
translationBlockHashes:
"_intro": 4b5f4cec
"Quick start": a2bb8c28
"Serving providers": 197dd61a
- "Schema": 0a76af44
+ "Schema": d2c28a84
"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";
@@ -195,7 +196,7 @@ curl https://api.comfy.org/v2/models/byteplus/dreamina-seedance-2-5-260628/reque
### 输入
- 已忽略。为兼容 BytePlus 的请求形状而接受,但在提交任务之前就会被移除,因此永远不会发送回调;请改为轮询任务状态路由来获取结果。
+ 已忽略。为兼容 BytePlus 请求结构而接受,但在提交任务之前会被移除,因此永远不会发送回调;请改为轮询任务状态路由以获取结果。
格式:`uri`
@@ -205,41 +206,41 @@ 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:音频的公开 URL(wav、mp3)。
+ 音频网址、Base64 编码或资产 ID。
+音频网址:音频的公开网址(wav、mp3)。
Base64:格式为 data:audio/\;base64,\
资产 ID:格式为 asset://\
- 仅 Seedance 2.5。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。
-最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。分辨率默认为且仅支持 1080p。
+ 仅 Seedance 2.5。要作为最终视频渲染的 Draft 任务。它必须是唯一的内容项。
+最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。resolution 默认且仅支持 1080p。
- 使用 `draft` 设为 true 创建 Draft 视频时返回的任务 ID。
+ 创建 Draft 视频时,若 `draft` 设置为 true,返回的任务 ID。
-
+
用于图生视频生成的图像内容(当 type 为 "image_url" 时)
-图片网址:请确保图片网址可访问。
-Base64 编码内容:格式必须为 data:image/\;base64,\
+图片网址:确保该图片网址可访问。
+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`
@@ -247,27 +248,20 @@ 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 未公布
-文本长度限制,并且在测试中接受了 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 自己的校验器给出响应。将其设置得远高于真实流量,以确保它绝不会对真实提示词作出判定;如果调用方需要更多,可以提高该值。
@@ -277,24 +271,24 @@ 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:视频的公开 URL(mp4、mov)。
+ 视频网址或资产 ID。
+视频网址:视频的公开网址(mp4、mov)。
资产 ID:格式为 asset://\
- 仅 Seedance 2.5。生成 480p 的 Draft 视频;分辨率必须为 480p。
-在 `draft_task` 内容项中传入返回的任务 ID,以渲染最终的 1080p 视频。Draft 任务 ID 有效期为 7 天。
+ 仅 Seedance 2.5。生成 480p 的 Draft 视频;resolution 必须为 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(自动)。
- 范围:`2` 到 `30`
+ 可能的值:`-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15`、`16`、`17`、`18`、`19`、`20`、`21`、`22`、`23`、`24`、`25`、`26`、`27`、`28`、`29`、`30`
@@ -305,39 +299,40 @@ Base64 编码内容:格式必须为 data:image/\;base64,\
由 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。它不在本 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。输出视频的容器格式。
+ 仅 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: 不返回已生成视频的最后一帧图像。
@@ -348,47 +343,47 @@ 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-5-260628/openapi.json` 提供的 schema 生成,该 schema 也是它在请求到达提供商之前用于校验调用的同一文档。
+根据 Router 在 `GET /v2/models/byteplus/dreamina-seedance-2-5-260628/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` 都会被重新托管到 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。
- 当 BytePlus 将其嵌套在 `content` 内时,表示已生成视频的容器格式(mp4 或 mov)。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` 的生命周期无关。
+ 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`
+ 格式: `date-time`
- BytePlus 自己的最后一帧下载 URL,与重新托管的 `last_frame_url` 并列逐字节返回,适用条件与 `upstream_video_url` 相同:仅限已选择加入的工作区,仅限 Seedance 2.x,BytePlus 清除后即不存在,并且在 `upstream_expires_at` 之前是一种 bearer 凭证。
+ 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 密钥),并且在 BytePlus 于生成 24 小时后清除其 URL 后缺失。它是预签名的对象存储 URL,因此是一种 bearer 凭证:任何持有它的人都可以在它过期前下载视频,所以请像对待机密一样对待它。它会在 `upstream_expires_at` 过期,在 Seedance 2.5 上 BytePlus 将其限制为最多 100 次下载,其中一次会被 Router 自己的重新托管消耗。
+ 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 小时后清除该 URL,并在某些模型上将下载次数限制为 100 次。无论哪种方式,链接都会过期,因此请下载视频,而不是存储 URL。
+ 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写此字段,因此它通常是 Comfy 签名的 URL,最长有效 24 小时:签发时按 24 小时签名,并从 23 小时的缓存记录中重放,因此稍后轮询返回的 URL 可能只剩一小时有效期。当无法执行重新托管时,此字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务结束 24 小时后清除该 URL,并在某些模型上将其限制为 100 次下载。无论哪种情况,链接都会过期,因此请下载视频,而不要存储 URL。
@@ -396,39 +391,35 @@ false: 不返回已生成视频的最后一帧图像。
- 已生成视频的时长,单位为秒。声明为数字而非整数,因为 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 失败任务响应中识别策略类错误码,但不会覆盖传输层失败。
报错信息
-
- 视频生成任务的 ID
-
-
-
- 任务所使用的模型名称与版本
+
+ 该任务所使用的模型名称与版本
- 已生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回。Seedance 视频任务查询正是在此位置返回该字段。该字段为 BytePlus 自有字段,原样透传。
+ 已生成视频的容器格式(mp4 或 mov),在顶层返回,与 `content` 同级,Seedance 视频任务查询就是在这里返回该字段的。这是 BytePlus 自有字段,原样转发。
- 已生成视频的分辨率,例如 `1080p`。该字段为 BytePlus 自有字段,在成功的视频任务中返回,并原样透传。
+ 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在成功的视频任务上返回,并原样转发。
- 该任务实际使用的生成种子。该字段为 BytePlus 自有字段,在成功的视频任务中返回,并原样透传。
+ 该任务实际使用的生成种子。这是 BytePlus 自有字段,在成功的视频任务上返回,并原样转发。
格式:`int64`
@@ -436,7 +427,7 @@ false: 不返回已生成视频的最后一帧图像。
任务的状态
- 可能的值:`queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired`
+ 可能取值:`queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired`
@@ -444,7 +435,7 @@ false: 不返回已生成视频的最后一帧图像。
- 本次请求的 token 用量
+ 请求的 token 用量
@@ -452,7 +443,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 13ad884815..ea237df923 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,18 +2,19 @@
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: 450bbe6e
+translationSourceHash: 642f85ab
translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx
translationBlockHashes:
"_intro": e1a3501d
"Quick start": c762675f
- "Schema": fc979e05
+ "Schema": b57b84de
"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";
@@ -182,17 +183,17 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528/requests/$
### 输入
- 已忽略。为兼容 BytePlus 的请求结构而接受该字段,但在任务提交前会将其移除,因此永远不会发送回调;请改为轮询任务状态路由获取结果。
+ 忽略。为兼容 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 支持纯音频输入。
@@ -203,8 +204,8 @@ 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;请勿再次发送这些内容。分辨率默认为 1080p,且仅支持 1080p。
@@ -217,7 +218,7 @@ Base64:格式为 data:audio/\;base64,\
用于图生视频生成的图像内容(当 type 为 "image_url" 时)
-图片 URL:请确保图片 URL 可访问。
+图片 URL:确保图片 URL 可访问。
Base64 编码内容:格式必须为 data:image/\;base64,\
资产 ID:格式为 asset://\
@@ -225,37 +226,36 @@ Base64 编码内容:格式必须为 data:image/\;base64,\
内容项的角色/位置。
对于图像: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)
+参数(可选):在文本提示词后添加 --[参数] 来控制视频规格:
+- --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 自己的校验器作答。将其设置得远高于实际流量,使其绝不会对
+真实提示词进行裁决;如果调用方需要更多,请提高该值。
@@ -275,58 +275,59 @@ Comfy Router(/v2/models/byteplus/\{model})是执行该限制的接口;
- 仅 Seedance 2.5 支持。生成 480p 的 Draft 视频;分辨率必须为 480p。
-将返回的任务 ID 传入 `draft_task` 内容项以渲染最终的 1080p 视频。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 1.0 pro 和 1.0 pro fast:[2,12]。
- 范围:`2` 至 `30`
+ 可能的值:`2`、`3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`
任务超时阈值,单位为秒。默认 172800(48 小时)。范围:[3600, 259200]。
- 范围:`3600` 至 `259200`
+ 范围:`3600` 到 `259200`
- Seedance 2.5、2.0、2.0 fast、2.0 mini 和 1.5 pro 支持。生成的视频是否包含与画面同步的音频。
-是:模型输出带同步音频的视频。
-否:模型输出无声视频。在支持该功能的模型上,生成的音轨会由提供商与视频分开进行内容审核;若音频未通过审核,会被报告为 `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 调用时 MUST 提供该字段,代理会以 400 拒绝任何其他取值以及缺省该字段的请求。它 NOT 在本 Schema 的 `required` 列表中,因为 Comfy Router 会从 /v2/models/byteplus/\{model} 的 `{model}` 路径段填充它,因此 Router 调用方会省略该字段。
+ The ID of the model to call. Supported models: 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 时 MUST 提供该值 — 代理会拒绝其他任何值,缺省时也会以 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.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:不返回已生成视频的尾帧图像。
@@ -336,70 +337,70 @@ 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-250528/openapi.json` 提供的 Schema,与它在请求到达提供商之前用于校验调用的文档相同。
+根据 Router 在 `GET /v2/models/byteplus/seedance-1-0-pro-250528/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 小时。该 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。
- 生成视频的容器格式(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` 的生命周期无关。
+ 上游 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,与重新托管的 `last_frame_url` 一并逐字节返回,条件与 `upstream_video_url` 相同:仅限已选择加入的工作区、仅限 Seedance 2.x、BytePlus 清除后即缺失,且在 `upstream_expires_at` 之前一直是一种 bearer 凭证。
- BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 并列按原样返回。仅当任务由 Comfy 在服务器端已选择加入的工作区轮询 Seedance 2.x 任务时才提供(没有请求参数);对其他所有情况均缺失,包括解析不到任何工作区的凭证(例如未绑定到工作区的传统 API 密钥),并且在 BytePlus 于生成 24 小时后清除其 URL 后缺失。它是预签名的对象存储 URL,因此属于持有者凭证:任何持有它的人都可以在过期前下载视频,因此请将其视为机密。它在 `upstream_expires_at` 过期;在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次会被 Router 自身的重新托管消耗。
+ BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 一并逐字节返回。仅在由服务器端已选择加入的工作区轮询的 Seedance 2.x 任务中出现(没有请求参数);其他情况一律不出现,包括解析不到任何工作区的凭证(例如未绑定工作区的传统 API 密钥),以及 BytePlus 在生成 24 小时后清除其 URL 之后的情况。它是预签名对象存储 URL,因此是一种 bearer 凭证:任何持有它的人都能在过期前下载该视频,所以请像对待机密一样对待它。它在 `upstream_expires_at` 过期;在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次会被 Router 自身的重新托管消耗。
- 输出视频的下载 URL。Router 将视频重新托管到 Comfy 存储并重写此字段,因此它通常是一个 Comfy 签名的 URL,有效期最长 24 小时。该 URL 在签发时按 24 小时签名,并从 23 小时的备忘中重放,因此之后的轮询返回的 URL 可能仅剩一小时有效期。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,而 BytePlus 会在任务完成 24 小时后清除该 URL,并在某些模型上将其限制为 100 次下载。无论哪种情况,链接都会过期,因此请下载视频,而不要存储 URL。
+ 输出视频的下载 URL。Router 会将视频重新托管到 Comfy 存储并重写该字段,因此它通常是有效期最长 24 小时的 Comfy 签名 URL:签发时按 24 小时签名,并从 23 小时的缓存记录中重放,因此稍后轮询可能返回剩余有效期仅一小时的 URL。当无法执行重新托管时,该字段改为保留 BytePlus 自己的 URL,BytePlus 会在任务结束 24 小时后清除它,并在某些模型上限制为 100 次下载。无论哪种方式,链接都会过期,因此请下载视频,而不是保存 URL。
- 任务创建的时间。该值为 UNIX 时间戳,单位为秒。
+ 任务创建的时间。该值是一个 UNIX 时间戳,单位为秒。
- 生成视频的时长,单位为秒。声明为数字而非整数,是因为 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 失败任务响应中识别策略系列,而不会覆盖传输层故障。
报错信息
-
+
视频生成任务的 ID
@@ -408,21 +409,21 @@ false: 不返回已生成视频的最后一帧图像。
- 生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回,Seedance 视频任务查询正是在此处返回该字段。这是 BytePlus 的自有字段,原样转发。
+ 生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回,Seedance 视频任务查询即在此处返回该字段。这是 BytePlus 自身的字段,原样透传。
- 生成视频的分辨率,例如 `1080p`。这是 BytePlus 的自有字段,在成功的视频任务中返回,并原样转发。
+ 生成视频的分辨率,例如 `1080p`。这是 BytePlus 自身的字段,在成功的视频任务中返回,原样透传。
- 该任务实际使用的生成种子。这是 BytePlus 的自有字段,在成功的视频任务中返回,并原样转发。
+ 该任务实际使用的生成种子。这是 BytePlus 自身的字段,在成功的视频任务中返回,原样透传。
格式:`int64`
- 任务的状态
+ 任务状态
可能的值:`queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired`
@@ -440,7 +441,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 573d9a16e9..d23ffbcfab 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,18 +2,19 @@
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: 43683424
+translationSourceHash: 61dd0135
translationFrom: development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx
translationBlockHashes:
"_intro": 451ffa4b
"Quick start": ec2a21ac
- "Schema": a882b2d8
+ "Schema": dd74b012
"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";
@@ -182,33 +183,33 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-fast-251015/reque
### 输入
- 已忽略。为兼容 BytePlus 请求结构而接受此字段,但会在提交任务前将其移除,因此永远不会发送回调;请改为轮询任务状态接口获取结果。
+ 已忽略。此字段仅为兼容 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 张图像或 1 个视频;Seedance 2.5 支持仅音频输入。
- 音频 URL、Base64 编码或资产 ID。
-音频 URL:音频的公开 URL(wav、mp3)。
-Base64:格式 data:audio/\;base64,\
-资产 ID:格式 asset://\
+ 音频网址、Base64 编码或资产 ID。
+音频网址:音频的公开网址(wav、mp3)。
+Base64:格式为 data:audio/\;base64,\
+资产 ID:格式为 asset://\
- 仅限 Seedance 2.5。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。
-最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。resolution 默认为 1080p,且仅支持 1080p。
+ 仅 Seedance 2.5 支持。要渲染为最终视频的草稿任务。它必须是唯一的内容项。
+最终视频会复用草稿任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些参数。分辨率默认为且仅支持 1080p。
- 将 `draft` 设置为 true 创建 Draft 视频时返回的任务 ID。
+ 创建草稿视频时将 `draft` 设为 true 后返回的任务 ID。
@@ -219,41 +220,41 @@ Base64:格式 data:audio/\;base64,\
用于图生视频生成的图像内容(当 type 为 "image_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`
+ 可选值:`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 未公布文本长度上限,并且在测试中(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`
@@ -261,130 +262,131 @@ Comfy 侧的防护限制,并非 BytePlus 的约束。BytePlus 未公布文本
- 视频 URL 或资产 ID。
-视频 URL:视频的公开 URL(mp4、mov)。
-资产 ID:格式 asset://\
+ 视频网址或资产 ID。
+视频网址:视频的公开网址(mp4、mov)。
+资产 ID:格式为 asset://\
- 仅限 Seedance 2.5。生成 480p 的 Draft 视频;分辨率必须为 480p。
-将返回的任务 ID 传入 `draft_task` 内容项,以渲染最终的 1080p 视频。Draft 任务 ID 的有效期为 7 天。
+ 仅 Seedance 2.5 支持。生成 480p 的草稿视频;分辨率必须为 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 1.0 pro 和 1.0 pro fast:[2,12]。
- 范围:`2` 到 `30`
+ 可选值:`2`、`3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`
任务超时阈值,单位为秒。默认 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 的最终渲染会从其草稿任务继承 `generate_audio`,因此请改为用 `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 拒绝任何其他值以及省略该值的情况。它不在本 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.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`
+ Possible values: `480p`, `720p`, `1080p`, `4k`
是否返回已生成视频的最后一帧图像。
-true: 返回已生成视频的最后一帧图像。将此参数设置为 true 后,可以通过调用“查询视频生成任务信息”来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不含水印。使用此参数可以生成多个连续视频:将前一个已生成视频的最后一帧用作下一个视频任务的首帧,从而快速生成多个连续视频。
+true: 返回已生成视频的最后一帧图像。将该参数设置为 true 后,你可以通过调用查询视频生成任务信息来获取最后一帧图像。最后一帧图像为 PNG 格式,其像素宽度和高度与已生成视频一致,且不含水印。使用该参数可以生成多个连续的视频: 上一个已生成视频的最后一帧将用作下一个视频任务的首帧,从而快速生成多个连续的视频。
false: 不返回已生成视频的最后一帧图像。
- 用于控制随机性的种子整数。范围:[-1, 2^32-1]。-1 使用随机种子。
+ 用于控制随机性的种子整数。范围: [-1, 2^32-1]。-1 表示使用随机种子。
- 范围:`-1` 到 `4294967295`
+ Range: `-1` 到 `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-fast-251015/openapi.json` 提供的 schema 生成,该文档也是 Router 在请求到达提供商之前校验调用时所依据的同一文档。
+由 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。
+ 视频生成任务完成后得到的输出,包含输出视频的下载链接,以及(当 BytePlus 返回时)其最后一帧的下载链接。`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。
+ 生成视频最后一帧的下载链接,当请求设置了 `return_last_frame` 时返回。不要从这个 URL 推断图像格式:BytePlus 在请求侧将最后一帧记录为 PNG,Router 则原样重新托管它收到的字节,并根据上游的 Content-Type 或内容嗅探来确定其类型,而 `image/jpeg` 只是两者都失败时的最后兜底。Router 会将最后一帧重新托管到 Comfy 存储上并重写此字段,因此它通常是一个有效期最长 24 小时的 Comfy 签名 URL。该 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` 的生命周期无关。
+ 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 自己的最后一帧下载链接,与重新托管的 `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 自身的重新托管消耗。
+ BytePlus 自己的输出视频下载链接,与重新托管的 `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 小时的缓存记录中重放,因此稍后轮询返回的 URL 可能只剩一小时有效期。当无法执行重新托管时,该字段会保留 BytePlus 自己的 URL,BytePlus 会在任务完成 24 小时后清除它,并在某些模型上限制为 100 次下载。无论哪种方式,链接都会过期,因此请下载视频,而不是保存 URL。
+ 输出视频的下载链接。Router 会将视频重新托管到 Comfy 存储上并重写此字段,因此它通常是一个有效期最长 24 小时的 Comfy 签名 URL。该 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 失败任务响应中识别策略系列,而不会覆盖传输层失败。
@@ -396,19 +398,19 @@ false: 不返回已生成视频的最后一帧图像。
- 该任务所使用的模型的名称和版本
+ 该任务所使用的模型名称和版本
- 已生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回,Seedance 视频任务查询正是在此位置返回该字段。BytePlus 自有字段,原样透传。
+ 已生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的兄弟字段返回,Seedance 视频任务查询正是从此处返回该字段。这是 BytePlus 自有字段,原样转发。
- 已生成视频的分辨率,例如 `1080p`。BytePlus 自有字段,在成功的视频任务中返回,原样透传。
+ 已生成视频的分辨率,例如 `1080p`。这是 BytePlus 自有字段,在成功的视频任务中返回,并原样转发。
- 该任务实际使用的生成种子。BytePlus 自有字段,在成功的视频任务中返回,原样透传。
+ 该任务实际使用的生成种子。这是 BytePlus 自有字段,在成功的视频任务中返回,并原样转发。
格式:`int64`
@@ -424,7 +426,7 @@ false: 不返回已生成视频的最后一帧图像。
- 本次请求的 token 用量
+ 该请求的 token 用量
@@ -432,7 +434,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 42cabe70ab..bb0aa1e515 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,18 +2,19 @@
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: 1d016721
+translationSourceHash: 2263b4cf
translationFrom: development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx
translationBlockHashes:
"_intro": 5f93a1f1
"Quick start": 71aafccf
- "Schema": 35f3b5dc
+ "Schema": f4d67fb6
"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";
@@ -179,36 +180,36 @@ curl https://api.comfy.org/v2/models/byteplus/seedance-1-5-pro-251215/requests/$
## Schema
-### 输入
+### Input
- 已忽略。为兼容 BytePlus 请求结构而接受,但在任务提交前会被移除,因此永远不会发送回调;请改为轮询任务状态路由以获取结果。
+ 已忽略。为了兼容 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 张图像或 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。要作为最终视频渲染的草稿任务。它必须是唯一的内容项。
-最终视频会复用草稿任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;请勿再次发送这些内容。resolution 默认为 1080p,且仅支持 1080p。
+ 仅 Seedance 2.5。要渲染为最终视频的 Draft 任务。它必须是唯一的内容项。
+最终视频会复用 Draft 任务的提示词、输入资产、时长、比例、种子、generate_audio 和 omni_reference_task_type;不要再次发送这些字段。分辨率默认为且仅支持 1080p。
- 当 `draft` 设置为 true 创建草稿视频时返回的任务 ID。
+ 使用 `draft` 设置为 true 创建 Draft 视频时返回的任务 ID。
@@ -217,9 +218,9 @@ Base64:格式为 data:audio/\;base64,\
用于图生视频生成的图像内容(当 type 为 "image_url" 时)
-图片网址:请确保图片网址可访问。
+图片网址:确保图片网址可访问。
Base64 编码内容:格式必须为 data:image/\;base64,\
-资产 ID:格式为 asset://\
+资产 ID:格式 asset://\
@@ -232,25 +233,22 @@ 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` 是数组,而整个文档由单次请求的正文限制来约束。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 自己的验证器作出响应。该值设置得远高于真实流量,因此它永远不会裁决真实提示词;如果调用方需要更多,可以调高它。
@@ -266,54 +264,55 @@ Base64 编码内容:格式必须为 data:image/\;base64,\
视频 URL 或资产 ID。
视频 URL:视频的公开 URL(mp4、mov)。
-资产 ID:格式为 asset://\
+资产 ID:格式 asset://\
- 仅 Seedance 2.5。生成 480p 草稿视频;分辨率必须为 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 1.5 pro:[4,12] 或 -1(自动)。
- 范围:`2` 至 `30`
+ 可能的值:`-1`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`
- 任务超时阈值,以秒为单位。默认 172800(48h)。范围:[3600, 259200]。
+ 任务超时阈值(秒)。默认 172800(48h)。范围:[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。
+在支持此功能的模型上,生成的音频轨道会由提供商与视频分开进行内容检查;如果音频被拒绝,会报告为 `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),颜色精度高,适合后期制作;文件大小更大。
+ 仅 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.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`
@@ -321,98 +320,98 @@ Seedance 2.5 首帧 / 首尾帧生成:输出会遵循首帧的宽高比,因
是否返回已生成视频的最后一帧图像。
-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`
- 已生成视频是否包含水印。
+ 已生成的视频是否包含水印。
-根据 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,当请求设置了 `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` 的生命周期无关。
+ 上游 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,按与 `upstream_video_url` 相同的条件,与重新托管的 `last_frame_url` 一同逐字节返回:仅限已选择加入的工作区,仅限 Seedance 2.x,BytePlus 清除后即不再出现,并且在 `upstream_expires_at` 之前都是 bearer 凭据。
- BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 并列逐字节返回。仅对由 Comfy 在服务器端已选择加入的工作区轮询的 Seedance 2.x 任务出现(没有请求参数);对其他所有情况均不出现,包括解析不到任何工作区的凭证(例如未限定到某个工作区的传统 API 密钥);并且在 BytePlus 于生成 24 小时后清除其 URL 后也不出现。它是预签名的对象存储 URL,因此也是持有者凭证:任何持有它的人都能在过期前下载视频,所以请像对待机密一样对待它。它在 `upstream_expires_at` 过期;在 Seedance 2.5 上,BytePlus 将其限制为 100 次下载,其中一次会被 Router 自身的重新托管消耗。
+ BytePlus 自己的输出视频下载 URL,与重新托管的 `video_url` 一同逐字节返回。仅适用于由 Comfy 在服务器端选择加入的工作区所轮询的 Seedance 2.x 任务(没有请求参数);对其他所有情况均缺失,包括无法解析到任何工作区的凭据(例如未限定到某个工作区的传统 API 密钥),并且在 BytePlus 于生成 24 小时后清除其 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 小时后清除该 URL,并在某些模型上将其限制为 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 失败任务响应中识别策略系列,而不会覆盖传输层失败。
报错信息
-
- The ID of the video generation task
+
+ 视频生成任务的 ID
- 任务所使用的模型名称和版本
+ 该任务所使用的模型名称和版本
- 生成视频的容器格式(mp4 或 mov),在顶层作为 `content` 的同级字段返回,Seedance 视频任务查询就是在这里返回该字段。BytePlus 自有字段,原样转发。
+ 生成视频的容器格式(mp4 或 mov),会在顶层作为 `content` 的兄弟字段返回,Seedance 视频任务查询正是在此处返回该字段。这是 BytePlus 自身的字段,原样转发。
- 生成视频的分辨率,例如 `1080p`。BytePlus 自有字段,在成功的视频任务中返回并原样转发。
+ 生成视频的分辨率,例如 `1080p`。这是 BytePlus 自身的字段,在成功的视频任务中返回,并原样转发。
- 任务实际使用的生成种子。BytePlus 自有字段,在成功的视频任务中返回并原样转发。
+ 该任务实际使用的生成种子。这是 BytePlus 自身的字段,在成功的视频任务中返回,并原样转发。
格式:`int64`
@@ -420,7 +419,7 @@ false: 不返回已生成视频的最后一帧图像。
任务的状态
- 可能的值:`queued`, `running`, `cancelled`, `succeeded`, `failed`, `expired`
+ 可能的值:`queued`、`running`、`cancelled`、`succeeded`、`failed`、`expired`
@@ -428,7 +427,7 @@ false: 不返回已生成视频的最后一帧图像。
- 请求的 token 使用量
+ 该请求的 token 用量
diff --git a/zh/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx b/zh/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx
index 05ce84cd96..4578986433 100644
--- a/zh/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx
+++ b/zh/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx
@@ -2,18 +2,19 @@
title: "通过 Comfy Router 使用 Kling 3.0 Turbo"
description: "通过 Comfy Router 调用 kling/kling-3.0-turbo:endpoint、请求结构以及 Router 返回的响应。"
sidebarTitle: "Kling 3.0 Turbo"
-translationSourceHash: 301a1ee1
+translationSourceHash: d09b3876
translationFrom: development/comfy-router/models/kling/kling-3-0-turbo/code.mdx
translationBlockHashes:
"_intro": 5a8c5f4b
"Quick start": a2145573
"Serving providers": 7ec93d4f
- "Schema": 1f5f61c1
- "Examples": 0a9a8bbe
+ "Schema": 992b8da2
+ "Examples": 5ce1484a
---
+
{/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/kling/kling-3.0-turbo.json 生成。 */}
import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx";
@@ -181,13 +182,13 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID
视频宽高比
- 可选值: `16:9`, `9:16`, `1:1`
+ 可选值:`16:9`、`9:16`、`1:1`
- 视频长度,以秒为单位
+ 视频时长,单位为秒
- 可选值: `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`
+ 可选值:`3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15`
@@ -195,11 +196,11 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID
- 任务结果回调通知 URL。当任务状态发生变化时,服务器会发送通知。
+ 用于接收任务结果回调通知的链接。任务状态变化时,服务器会发出通知。此项被忽略:comfy-api 在转发前会丢弃该字段,由 Comfy Router 代为轮询。
- 自定义任务 ID。不会覆盖系统生成的任务 ID,但可用于查询。在单个用户账号内必须唯一。
+ 自定义任务 ID。不会覆盖系统生成的任务 ID,但可用于查询。在单个用户账号内必须唯一。此项被忽略:comfy-api 在转发前会丢弃该字段,由 Comfy Router 代为轮询。
@@ -207,7 +208,7 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID
- true 表示生成带水印的结果,false 表示不生成。默认 false。
+ true 表示生成带水印的结果,false 表示不生成。默认为 false。
@@ -219,24 +220,24 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID
- 已生成画面的宽高比(width:height)。取值为 "16:9"、"9:16" 或 "1:1" 之一。默认 "16:9"。
+ 生成画面的宽高比(宽度:高度)。取值为 "16:9"、"9:16" 或 "1:1"。默认为 "16:9"。
- 可选值: `16:9`, `9:16`, `1:1`
+ 可选值:`16:9`、`9:16`、`1:1`
- 视频长度,以秒为单位。支持的取值为 3 到 15。默认 5。
+ 视频时长,单位为秒。支持的值为 3 到 15。默认为 5。
- 范围: `3` 到 `15`
+ 范围:`3` 到 `15`
- 已生成视频的清晰度。取值为 "720p" 或 "1080p" 之一。默认 "720p"。
+ 生成视频的清晰度。取值为 "720p" 或 "1080p"。默认为 "720p"。
- 可选值: `720p`, `1080p`
+ 可选值:`720p`、`1080p`
-由 Router 在 `GET /v2/models/kling/kling-3.0-turbo/openapi.json` 提供的 schema 生成,与它在请求到达提供商之前用于校验调用的文档相同。
+本文档根据 Router 在 `GET /v2/models/kling/kling-3.0-turbo/openapi.json` 提供的 schema 生成,请求到达提供商之前,Router 会依据同一份文档校验调用。
### 输出
@@ -245,7 +246,7 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID
- 匹配该查询的任务。
+ 与查询匹配的任务。
@@ -253,25 +254,37 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID
- 消耗金额,精确到小数点后两位。
+ 消费金额,精确到两位小数。
+
+
+
+ 扣款所使用的现金账户(仅当 charge_type 为 "cash" 时出现),例如 "balance"。部分任务会返回该字段,其他任务可能省略。
- 消耗账户类型。"cash" 表示余额,"unit" 表示资源包。
+ 消费账户类型。"cash" 表示余额,"unit" 表示资源包。
+
+
+
+ `amount` 和 `list_price` 的 ISO 4217 货币代码,例如 "USD"。部分任务会返回该字段,其他任务可能省略。
+
+
+
+ 任务在任何折扣前的标价,以十进制字符串表示。部分任务会返回该字段,其他任务可能省略。
- 可消耗资源包类型(仅在 charge_type 为 "unit" 时存在)。取值为 "video"、"image" 或 "audio" 之一。
+ 可消耗资源包类型(仅当 charge_type 为 "unit" 时出现)。取值为 "video"、"image" 或 "audio" 之一。
- 任务创建时间。Unix 时间戳,以毫秒为单位。
+ 任务创建时间。Unix 时间戳,单位为毫秒。
- 格式: `int64`
+ 格式:`int64`
- 此任务的自定义任务 ID(如果有)。
+ 此任务的自定义任务 ID(如有)。
@@ -283,27 +296,27 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID
- 任务已生成的输出。
+ 该任务的已生成输出。
- 已生成视频的时长,以秒为单位。
+ 已生成视频的时长,单位为秒。
- 分组标记,仅对已分组的图像存在。
+ 分组标记,仅对分组图像存在。
- 由系统生成的输出 ID。
+ 系统生成的输出 ID。
- 已生成 MP3 音频的时长,以秒为单位。
+ 已生成 MP3 音频的时长,单位为秒。
- 已生成音频的 MP3 URL(防盗链保护)。
+ 已生成音频的 MP3 URL(防盗链)。
@@ -311,7 +324,7 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID
- 素材来源。"kling" 表示官方库;数字为创作者 ID。
+ 素材来源。"kling" 表示官方素材库;数字为创作者 ID。
@@ -323,19 +336,19 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID
- 已生成结果的 URL(防盗链保护)。30 天后清除。
+ 已生成结果的 URL(防盗链)。30 天后清除。
- 带水印结果的 URL(防盗链保护)。
+ 带水印结果的 URL(防盗链)。
- 已生成 WAV 音频的时长,以秒为单位。
+ 已生成 WAV 音频的时长,单位为秒。
- 已生成音频的 WAV URL(防盗链保护)。
+ 已生成音频的 WAV URL(防盗链)。
@@ -343,9 +356,9 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID
- 任务更新时间。Unix 时间戳,以毫秒为单位。
+ 任务更新时间。Unix 时间戳,单位为毫秒。
- 格式: `int64`
+ 格式:`int64`
@@ -353,7 +366,7 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID
- 由系统生成的请求 ID。
+ 系统生成的请求 ID。
## 示例
@@ -386,7 +399,7 @@ curl https://api.comfy.org/v2/models/kling/kling-3.0-turbo/requests/$REQUEST_ID
"duration": "5",
"id": "kling-v2-output-2b1a0f9e8d7c",
"type": "video",
- "url": "https://example.invalid/kling/kling-3.0-turbo/generated.mp4"
+ "url": "https://example.invalid/kling/v2/generated.mp4"
}
],
"status": "succeeded",
diff --git a/zh/development/comfy-router/models/kling/kling-image-o1/code.mdx b/zh/development/comfy-router/models/kling/kling-image-o1/code.mdx
index e3731aac5b..63e62c7123 100644
--- a/zh/development/comfy-router/models/kling/kling-image-o1/code.mdx
+++ b/zh/development/comfy-router/models/kling/kling-image-o1/code.mdx
@@ -2,16 +2,17 @@
title: "使用 Comfy Router 调用 Kling Image O1"
description: "通过 Comfy Router 调用 kling/kling-image-o1:端点、请求结构以及 Router 返回的响应。"
sidebarTitle: "Kling Image O1"
-translationSourceHash: cf053382
+translationSourceHash: ca32c929
translationFrom: development/comfy-router/models/kling/kling-image-o1/code.mdx
translationBlockHashes:
"_intro": 513c65df
"Quick start": 6256a30d
- "Schema": d18a5393
+ "Schema": 60d9f6fd
"Examples": 826db173
---
+
{/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/kling/kling-image-o1.json 生成。 */}
import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx";
@@ -166,7 +167,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \
- 此任务结果的回调通知地址。若已配置,任务状态发生变化时服务器会主动通知。
+ 此任务结果的回调通知地址。若已配置,任务状态发生变化时服务器会主动通知。此字段会被忽略:comfy-api 在转发前会丢弃该字段,由 Comfy Router 代为轮询。
格式:`uri`
@@ -182,7 +183,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \
- 自定义任务 ID。在单个用户账户内必须唯一。
+ 自定义任务 ID。在单个用户账户内必须唯一。此字段会被忽略:comfy-api 在转发前会丢弃该字段,由 Comfy Router 代为轮询。
@@ -204,7 +205,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \
- 文本提示词,可包含正面和负面描述。不得超过 2,500 个字符。Omni 模型可以通过带有元素和图像的 Prompt 实现多种能力。使用 \<\<\<>>> 格式指定图像,例如 \<\<\>>。
+ 文本提示词,可包含正面和负面描述。不得超过 2,500 个字符。Omni 模型可以通过结合元素和图像的提示词实现多种能力。使用 \<\<\<>>> 格式指定图像,例如 \<\<\>>。
@@ -214,7 +215,7 @@ curl https://api.comfy.org/v2/models/kling/kling-image-o1/requests/$REQUEST_ID \
- 控制生成单张图像还是组图。
+ 控制生成单张图像还是组图。kling-image-o1 不支持 series(当省略 model_name 时,v1 代理使用的也是该值);此类请求会以 HTTP 400 拒绝。
可选值:`single`、`series`
diff --git a/zh/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx b/zh/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx
index 711df496fd..39bdb8e979 100644
--- a/zh/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx
+++ b/zh/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx
@@ -2,16 +2,17 @@
title: "将 Kling V2.5 Turbo 与 Comfy Router 搭配使用"
description: "通过 Comfy Router 调用 kling/kling-v2-5-turbo:端点、请求结构以及 Router 返回的响应。"
sidebarTitle: "Kling V2.5 Turbo"
-translationSourceHash: 1a5ec6e5
+translationSourceHash: 1671e7b6
translationFrom: development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx
translationBlockHashes:
"_intro": 2495a4d3
"Quick start": dc63b3ac
- "Schema": 68d50e72
+ "Schema": 3bcb036e
"Examples": 8623c725
---
+
{/* GENERATED FILE. Generated from router-schemas/kling/kling-v2-5-turbo.json by `pnpm code-pages:gen`. */}
import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx";
@@ -166,7 +167,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID
- 回调通知地址
+ 回调通知地址。忽略:comfy-api 会在转发前丢弃此字段;Comfy Router 会代为轮询。
格式:`uri`
@@ -182,71 +183,71 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID
控制相机沿水平轴(x 轴)的运动。负值表示向左,正值表示向右。
- 范围:`-10` 到 `10`
+ 范围:`-10` 至 `10`
- 控制相机在竖直平面内的旋转(x 轴)。负值表示向下旋转,正值表示向上旋转。
+ 控制相机在竖直平面(x 轴)的旋转。负值表示向下旋转,正值表示向上旋转。
- 范围:`-10` 到 `10`
+ 范围:`-10` 至 `10`
- 控制相机的翻滚量(z 轴)。负值表示逆时针,正值表示顺时针。
+ 控制相机的滚动量(z 轴)。负值表示逆时针,正值表示顺时针。
- 范围:`-10` 到 `10`
+ 范围:`-10` 至 `10`
- 控制相机在水平平面内的旋转(y 轴)。负值表示向左旋转,正值表示向右旋转。
+ 控制相机在水平平面(y 轴)的旋转。负值表示向左旋转,正值表示向右旋转。
- 范围:`-10` 到 `10`
+ 范围:`-10` 至 `10`
控制相机沿竖直轴(y 轴)的运动。负值表示向下,正值表示向上。
- 范围:`-10` 到 `10`
+ 范围:`-10` 至 `10`
- 控制相机焦距的变化。负值表示视野变窄,正值表示视野变宽。
+ 控制相机焦距的变化。负值表示视野更窄,正值表示视野更宽。
- 范围:`-10` 到 `10`
+ 范围:`-10` 至 `10`
- 预设的相机运动类型。simple:可自定义的相机运动。down_back:相机下降并向后移动。forward_up:相机向前移动并向上倾斜。right_turn_forward:向右旋转并向前移动。left_turn_forward:向左旋转并向前移动。
+ 预定义的相机运动类型。simple:可自定义的相机运动。down_back:相机下降并向后移动。forward_up:相机向前移动并向上倾斜。right_turn_forward:向右旋转并向前移动。left_turn_forward:向左旋转并向前移动。
可选值:`simple`、`down_back`、`forward_up`、`right_turn_forward`、`left_turn_forward`
- 视频生成的灵活性。该值越高,模型的灵活度越低,与用户提示词的相关性越强。
+ 视频生成的灵活度。值越高,模型的灵活度越低,与用户提示词的相关性越强。
- 范围:`0` 到 `1`
+ 范围:`0` 至 `1`
格式:`float`
- 视频时长(秒)
+ 视频长度(秒)
可选值:`3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15`
- 自定义任务 ID
+ 自定义任务 ID。忽略:comfy-api 会在转发前丢弃此字段;Comfy Router 会代为轮询。
- 视频生成模式。std:标准模式,更具性价比。pro:专业模式,可生成时长更长、质量更高的视频。
+ 视频生成模式。std:标准模式,性价比高。pro:专业模式,可生成时长更长但质量更高的视频。
可选值:`std`、`pro`
- 模型名。使用 Comfy Router 时可省略或发送 null;模型由请求路径选择。如提供名称,则必须与该路径一致。
+ 模型名。使用 Comfy Router 时,请省略该字段或发送 null;模型由请求路径选择。提供的名称必须与该路径匹配。
@@ -254,15 +255,15 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID
- 该分镜的时长(秒)。不得超过任务总时长,且不得小于 1。所有分镜时长之和等于任务总时长。
+ 此分镜的时长(秒)。不得超过任务总时长,且不得小于 1。所有分镜时长之和等于任务总时长。
- 分镜序号
+ 镜头序号
- 该分镜的提示词。最大长度 512 个字符。
+ 此分镜的提示词。最大长度为 512 个字符。
@@ -270,31 +271,31 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID
- 负面文本提示词。推荐直接在正面提示词中通过否定语句来补充负面提示信息。
+ 负面文本提示词。推荐直接在正向提示词中通过否定句补充负面提示信息。
- 正面文本提示词。使用 \<\<\>> 指定与 voice_list 参数顺序对应的声音。单个任务最多可引用 2 个音色。指定音色时,sound 参数值必须为 on。
+ 正向文本提示词。使用 \<\<\>> 指定与 voice_list 参数顺序匹配的声音。一个任务最多可引用 2 个音色。指定音色时,sound 参数的值必须为 on。
- 分镜方式。当 multi_shot 参数设为 true 时必填。
+ 分镜方法。当 multi_shot 参数设置为 true 时必填。
可选值:`customize`、`intelligence`
- 生成视频时是否同时生成声音。仅 V2.6 及后续版本的模型支持该参数。
+ 生成视频时是否同时生成声音。仅 V2.6 及后续版本的模型支持此参数。
可选值:`on`、`off`
- 生成视频时引用的音色列表。最多支持 2 个音色;在 `prompt` 中按列表顺序以 \<\<\>> 和 \<\<\>> 引用。需要将 `sound` 设为 "on",且仅 V2.6 及之后版本的模型支持;在更早的模型上,或 `sound` 保持默认值 "off" 时,音色不会生效。
+ 生成视频时引用的声音列表。最多支持 2 个声音;请按列表顺序在 `prompt` 中使用 \<\<\>> 和 \<\<\>> 引用它们。需要将 `sound` 设置为 "on",只有 V2.6 及后续版本的模型支持该设置;在较早的模型上,或将 `sound` 保持为其默认值 "off" 时,声音不会被应用。
- 通过音色定制 API 返回的音色 ID,或系统预置音色 ID。
+ 通过声音定制 API 返回的声音 ID,或系统预设的声音 ID。
@@ -302,15 +303,15 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID
- true 表示生成水印,false 表示不生成。
+ true 表示生成水印,false 表示不生成水印。
-本页面内容根据 Router 在 `GET /v2/models/kling/kling-v2-5-turbo/openapi.json` 提供的 schema 生成,这也是请求到达提供商之前用于校验调用的同一份文档。
+该内容基于 Router 在 `GET /v2/models/kling/kling-v2-5-turbo/openapi.json` 提供的 schema 生成,这份文档与 Router 在请求到达提供商之前用于校验调用的文档相同。
### 输出
- 错误码
+ 错误代码
@@ -318,11 +319,11 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID
- 任务创建时间,Unix 时间戳,单位为毫秒
+ 任务创建时间,Unix 时间戳(毫秒)
- 任务的扣减单位
+ 任务的扣减单位数
@@ -360,7 +361,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID
- 带水印的已生成视频 URL,防盗链格式
+ 已生成视频(带水印,防盗链格式)的 URL
格式:`uri`
@@ -376,7 +377,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-5-turbo/requests/$REQUEST_ID
- 任务更新时间,Unix 时间戳,单位为毫秒
+ 任务更新时间,Unix 时间戳(毫秒)
diff --git a/zh/development/comfy-router/models/kling/kling-v2-6/code.mdx b/zh/development/comfy-router/models/kling/kling-v2-6/code.mdx
index ccfd89e64f..327c445a0f 100644
--- a/zh/development/comfy-router/models/kling/kling-v2-6/code.mdx
+++ b/zh/development/comfy-router/models/kling/kling-v2-6/code.mdx
@@ -2,16 +2,17 @@
title: "通过 Comfy Router 使用 Kling V2.6"
description: "通过 Comfy Router 调用 kling/kling-v2-6:端点、请求形状以及 Router 返回的响应。"
sidebarTitle: "Kling V2.6"
-translationSourceHash: 1e64e957
+translationSourceHash: c445a7bd
translationFrom: development/comfy-router/models/kling/kling-v2-6/code.mdx
translationBlockHashes:
"_intro": 04868509
"Quick start": 48a3d970
- "Schema": 9d23ff94
+ "Schema": a61a551f
"Examples": 8623c725
---
+
{/* GENERATED FILE. Generated from router-schemas/kling/kling-v2-6.json by `pnpm code-pages:gen`. */}
import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx";
@@ -160,13 +161,13 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \
### 输入
- 视频宽高比例
+ 视频比例
- 可能的值:`16:9`、`9:16`、`1:1`
+ 可选值:`16:9`、`9:16`、`1:1`
- 回调通知地址
+ 回调通知地址。忽略:comfy-api 在转发前会丢弃该字段;Comfy Router 会代为轮询。
格式:`uri`
@@ -186,13 +187,13 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \
- 控制相机在垂直平面内的旋转(x 轴)。负值表示向下旋转,正值表示向上旋转。
+ 控制相机在竖直平面内的旋转(x 轴)。负值表示向下旋转,正值表示向上旋转。
范围:`-10` 到 `10`
- 控制相机的滚动幅度(z 轴)。负值表示逆时针,正值表示顺时针。
+ 控制相机的滚动量(z 轴)。负值表示逆时针,正值表示顺时针。
范围:`-10` 到 `10`
@@ -218,11 +219,11 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \
预定义的相机运动类型。simple:可自定义的相机运动。down_back:相机下降并向后移动。forward_up:相机向前移动并向上倾斜。right_turn_forward:向右旋转并向前移动。left_turn_forward:向左旋转并向前移动。
- 可能的值:`simple`、`down_back`、`forward_up`、`right_turn_forward`、`left_turn_forward`
+ 可选值:`simple`、`down_back`、`forward_up`、`right_turn_forward`、`left_turn_forward`
- 视频生成的灵活度。该值越高,模型的灵活度越低,与用户提示词的相关性越强。
+ 视频生成中的灵活性。值越高,模型的灵活度越低,与用户提示词的相关性越强。
范围:`0` 到 `1`
@@ -232,25 +233,25 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \
视频时长,单位为秒
- 可能的值:`3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15`
+ 可选值:`3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15`
- 自定义任务 ID
+ 自定义任务 ID。忽略:comfy-api 在转发前会丢弃该字段;Comfy Router 会代为轮询。
- 视频生成模式。std:标准模式,性价比高。pro:专业模式,生成的视频时长更长,输出质量更高。
+ 视频生成模式。std:标准模式,性价比高。pro:专业模式,生成时长更长、输出质量更高的视频。
- 可能的值:`std`、`pro`
+ 可选值:`std`、`pro`
- 模型名。使用 Comfy Router 时请省略该参数或传入 null;模型由请求路径决定。若提供了名称,则必须与该路径一致。
+ 模型名。使用 Comfy Router 时可省略或发送 null;模型由请求路径决定。若提供名称,则必须与该路径匹配。
- 每个分镜的信息,例如提示词和时长。最多支持 6 个分镜,最少 1 个。当 multi_shot 为 true 且 shot_type 为 customize 时必填。
+ 关于每个分镜的信息,例如提示词和时长。最多支持 6 个分镜,最少 1 个。当 multi_shot 为 true 且 shot_type 为 customize 时必填。
@@ -258,11 +259,11 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \
- 分镜序号
+ 镜头序号
- 该分镜的提示词。最大长度为 512 个字符。
+ 该分镜的提示词。最大长度 512 个字符。
@@ -274,38 +275,38 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \
- 正向文本提示词。使用 \<\<\>> 指定与 voice_list 参数顺序匹配的声音。一个任务最多可引用 2 个音色。指定音色时,sound 参数值必须为 on。
+ 正向文本提示词。使用 \<\<\>> 指定音色,需与 voice_list 参数的顺序匹配。一个任务最多可引用 2 个音色。指定音色时,sound 参数值必须为 on。
- 分镜方式。当 multi_shot 参数设为 true 时必填。
+ 分镜方法。当 multi_shot 参数设为 true 时必填。
- 可能的值:`customize`、`intelligence`
+ 可选值:`customize`、`intelligence`
生成视频时是否同时生成声音。仅 V2.6 及后续版本的模型支持该参数。
- 可能的值:`on`、`off`
+ 可选值:`on`、`off`
- 生成视频时引用的音色列表。最多支持 2 个音色;在 `prompt` 中按列表顺序以 \<\<\>> 和 \<\<\>> 引用。需要将 `sound` 设为 "on",且仅 V2.6 及之后版本的模型支持;在更早的模型上,或 `sound` 保持默认值 "off" 时,音色不会生效。
+ 生成视频时引用的音色列表。最多支持 2 个音色;在 `prompt` 中按列表顺序使用 \<\<\>> 和 \<\<\>> 引用它们。需要将 `sound` 设为 "on",仅 V2.6 及后续版本的模型支持该设置;在较早的模型上,或将 `sound` 保留为默认的 "off" 时,音色不会被应用。
- 通过音色定制 API 返回的音色 ID,或系统预置音色 ID。
+ 通过音色定制 API 返回的音色 ID,或系统预设的音色 ID。
- 是否同时生成带水印的结果。当前不支持自定义水印。
+ 是否同时生成带水印的结果。目前不支持自定义水印。
- true 表示生成水印,false 表示不生成。
+ 是表示生成水印,否表示不生成。
-根据 Router 在 `GET /v2/models/kling/kling-v2-6/openapi.json` 提供的 schema 生成,该文档与请求到达提供商之前 Router 用于校验调用的文档相同。
+该内容根据 Router 在 `GET /v2/models/kling/kling-v2-6/openapi.json` 提供的 schema 生成,这也是它在请求到达提供商之前校验调用时所依据的同一份文档。
### 输出
@@ -322,7 +323,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \
- 任务的扣减单位
+ 任务的扣减单位数
@@ -346,11 +347,11 @@ curl https://api.comfy.org/v2/models/kling/kling-v2-6/requests/$REQUEST_ID \
- 视频总时长(秒)
+ 视频总时长,单位为秒
- 已生成的视频 ID
+ 已生成视频的 ID
diff --git a/zh/development/comfy-router/models/kling/kling-v3-omni/code.mdx b/zh/development/comfy-router/models/kling/kling-v3-omni/code.mdx
index 9bbff5063b..1b3275f3e0 100644
--- a/zh/development/comfy-router/models/kling/kling-v3-omni/code.mdx
+++ b/zh/development/comfy-router/models/kling/kling-v3-omni/code.mdx
@@ -2,16 +2,17 @@
title: "通过 Comfy Router 使用 Kling V3 Omni"
description: "通过 Comfy Router 调用 kling/kling-v3-omni:端点、请求结构以及 Router 返回的响应。"
sidebarTitle: "Kling V3 Omni"
-translationSourceHash: 226ee8a6
+translationSourceHash: 29d1799c
translationFrom: development/comfy-router/models/kling/kling-v3-omni/code.mdx
translationBlockHashes:
"_intro": 98827333
"Quick start": 3a226de2
- "Schema": f9b37353
+ "Schema": 68bd0500
"Examples": 6c2642d6
---
+
{/* GENERATED FILE. Generated from router-schemas/kling/kling-v3-omni.json by `pnpm code-pages:gen`. */}
import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx";
@@ -160,21 +161,21 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \
### 输入
- 生成视频画面的宽高比(宽度:高度)。当未使用首帧参考或视频编辑功能时,此参数必填。
+ 生成视频画面的宽高比(宽度:高度)。未使用首帧参考或视频编辑功能时,此参数必填。
- 可选值:`16:9`、`9:16`、`1:1`
+ 可能的值:`16:9`、`9:16`、`1:1`
- 本任务结果的回调通知地址。若配置此项,任务状态发生变化时服务器将主动通知。
+ 本任务结果的回调通知地址。配置后,任务状态发生变化时服务器会主动通知。忽略:comfy-api 在转发前会丢弃此字段,Comfy Router 会代您轮询。
格式:`uri`
- 视频时长,单位为秒。使用视频编辑功能时(refer_type: base),输出时长与输入视频相同,此参数无效。
+ 视频时长,单位为秒。使用视频编辑功能(refer_type: base)时,输出时长与输入视频一致,此参数无效。
- 可选值:`3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15`
+ 可能的值:`3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15`
@@ -188,31 +189,31 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \
- 自定义任务 ID。在单个用户账号内必须唯一。
+ 自定义任务 ID。在单个用户账户内必须唯一。忽略:comfy-api 在转发前会丢弃此字段,Comfy Router 会代您轮询。
- 参考图像列表。可包含元素、场景、风格等参考图像,也可用作首帧或结束帧来生成视频。
+ 参考图像列表。可包含元素、场景、风格等参考图像,也可用作首帧或尾帧来生成视频。
- 图像 Base64 编码或图片网址(确保可访问)。支持的格式包括 .jpg/.jpeg/.png。文件大小不能超过 10MB。宽度和高度尺寸不得小于 300px,宽高比在 1:2.5 ~ 2.5:1 之间。
+ 图像 Base64 编码或图片网址(确保可访问)。支持的格式包括 .jpg/.jpeg/.png。文件大小不得超过 10MB。宽度和高度不得小于 300px,宽高比在 1:2.5 ~ 2.5:1 之间。
- 该图像是首帧还是结束帧。first_frame 为首帧,end_frame 为结束帧。目前不支持仅使用结束帧。
+ 图像位于首帧还是尾帧。first_frame 表示首帧,end_frame 表示尾帧。目前不支持仅提供尾帧。
- 可选值:`first_frame`、`end_frame`
+ 可能的值:`first_frame`、`end_frame`
视频生成模式。std:标准模式,生成 720P 视频,性价比高。pro:专业模式,生成 1080P 视频,视频输出质量更高。
- 可选值:`pro`、`std`
+ 可能的值:`pro`、`std`
- 模型名。使用 Comfy Router 时可省略或发送 null,模型由请求路径选择。若提供名称,则必须与该路径一致。
+ 模型名。使用 Comfy Router 时可省略或发送 null;模型由请求路径选择。提供的名称必须与该路径一致。
@@ -220,55 +221,55 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \
- 该分镜的时长,单位为秒。不得超过任务总时长,且不得小于 1。所有分镜时长之和等于任务总时长。
+ 此分镜的时长,单位为秒。不得超过任务总时长,且不得小于 1。所有分镜时长之和等于任务总时长。
- 镜头序号
+ 分镜序号
- 该分镜的提示词。最大长度 512 个字符。
+ 此分镜的提示词。最大长度为 512 个字符。
- 是否生成多镜头视频。为 true 时,prompt 参数无效。为 false 时,shot_type 和 multi_prompt 参数无效。
+ 是否生成多分镜视频。为 true 时,prompt 参数无效。为 false 时,shot_type 和 multi_prompt 参数无效。
- 文本提示词,可包含正面和负面描述。不得超过 2,500 个字符。可通过 \<\<\<>>> 格式指定元素、图像或视频,例如 \<\>、\<\<\>>、\<\<\>>。
+ 文本提示词,可包含正面和负面描述。不得超过 2,500 个字符。可按 \<\<\<>>> 格式指定元素、图像或视频,例如 \<\>、\<\<\>>、\<\<\>>。
分镜方式。当 multi_shot 参数设置为 true 时必填。
- 可选值:`customize`、`intelligence`
+ 可能的值:`customize`、`intelligence`
生成视频时是否同时生成声音。
- 可选值:`on`、`off`
+ 可能的值:`on`、`off`
- 参考视频列表。可用作功能参考视频,也可用作待编辑的视频,默认为待编辑的视频。
+ 参考视频列表。可用作特征参考视频,也可用作待编辑视频,默认为待编辑视频。
是否保留视频原始声音。yes 表示保留,no 表示不保留。
- 可选值:`yes`、`no`
+ 可能的值:`yes`、`no`
- 参考视频类型。feature 为功能参考视频,base 为待编辑的视频。
+ 参考视频类型。feature 为特征参考视频,base 为待编辑视频。
- 可选值:`feature`、`base`
+ 可能的值:`feature`、`base`
- 上传视频的网址。仅支持 .mp4/.mov 格式。时长在 3-10 秒之间。分辨率必须在 720px 到 2160px 之间。支持 24-60 fps 的帧率。只能上传 1 个视频,且大小不超过 200MB。
+ 上传视频的网址。仅支持 .mp4/.mov 格式。时长在 3-10 秒之间。分辨率必须在 720px 到 2160px 之间。支持 24-60 fps 的帧率。仅可上传 1 个视频,大小不超过 200MB。
@@ -279,7 +280,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \
true 表示生成水印,false 表示不生成。
-由 Router 在 `GET /v2/models/kling/kling-v3-omni/openapi.json` 提供的 schema 生成,该文档与请求到达提供商之前用于校验调用的文档相同。
+本页内容根据 Router 在 `GET /v2/models/kling/kling-v3-omni/openapi.json` 提供的 schema 生成,该文档也是请求到达提供商之前用于校验调用的同一份文档。
### 输出
@@ -296,7 +297,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \
- 任务的扣费单位数
+ 任务的扣减单位数
@@ -320,23 +321,23 @@ curl https://api.comfy.org/v2/models/kling/kling-v3-omni/requests/$REQUEST_ID \
- 视频总时长(秒)
+ 视频总时长,单位为秒
- 已生成的视频 ID
+ 已生成视频的 ID
已生成视频的 URL
- 格式:`uri`
+ Format: `uri`
- 已生成的带水印视频 URL,防盗链格式
+ 已生成视频带水印的 URL,防盗链格式
- 格式:`uri`
+ Format: `uri`
diff --git a/zh/development/comfy-router/models/kling/kling-v3/code.mdx b/zh/development/comfy-router/models/kling/kling-v3/code.mdx
index 614cc72b20..de9a587900 100644
--- a/zh/development/comfy-router/models/kling/kling-v3/code.mdx
+++ b/zh/development/comfy-router/models/kling/kling-v3/code.mdx
@@ -2,17 +2,18 @@
title: "通过 Comfy Router 使用 Kling V3"
description: "通过 Comfy Router 调用 kling/kling-v3:端点、请求形状以及 Router 返回的响应。"
sidebarTitle: "Kling V3"
-translationSourceHash: ecfa3f9b
+translationSourceHash: e07d4035
translationFrom: development/comfy-router/models/kling/kling-v3/code.mdx
translationBlockHashes:
"_intro": 74a12e0f
"Quick start": 09c0a41a
"Serving providers": a8b20c72
- "Schema": 77550c0a
+ "Schema": 8e8b04e6
"Examples": 8623c725
---
+
{/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/kling/kling-v3.json 生成。 */}
import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx";
@@ -177,7 +178,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \
- 回调通知地址
+ 回调通知地址。此字段会被忽略:comfy-api 在转发前会丢弃此字段;Comfy Router 会代你轮询。
格式:`uri`
@@ -197,19 +198,19 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \
- 控制相机在竖直平面内的旋转(x 轴)。负值表示向下旋转,正值表示向上旋转。
+ 控制相机在竖直平面(x 轴)内的旋转。负值表示向下旋转,正值表示向上旋转。
范围:`-10` 到 `10`
- 控制相机的横滚量(z 轴)。负值表示逆时针,正值表示顺时针。
+ 控制相机的滚转量(z 轴)。负值表示逆时针,正值表示顺时针。
范围:`-10` 到 `10`
- 控制相机在水平平面内的旋转(y 轴)。负值表示向左旋转,正值表示向右旋转。
+ 控制相机在水平平面(y 轴)内的旋转。负值表示向左旋转,正值表示向右旋转。
范围:`-10` 到 `10`
@@ -221,19 +222,19 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \
- 控制相机焦距的变化。负值表示视野变窄,正值表示视野变宽。
+ 控制相机焦距的变化。负值表示视野更窄,正值表示视野更宽。
范围:`-10` 到 `10`
- 预设的相机运动类型。simple:可自定义的相机运动。down_back:相机下降并向后移动。forward_up:相机向前移动并向上倾斜。right_turn_forward:向右旋转并向前移动。left_turn_forward:向左旋转并向前移动。
+ 预定义的相机运动类型。simple:可自定义的相机运动。down_back:相机下降并向后移动。forward_up:相机向前移动并向上倾斜。right_turn_forward:向右旋转并向前移动。left_turn_forward:向左旋转并向前移动。
可选值:`simple`、`down_back`、`forward_up`、`right_turn_forward`、`left_turn_forward`
- 视频生成的灵活度。值越高,模型的灵活度越低,与用户提示词的相关性越强。
+ 视频生成中的灵活性。该值越高,模型的灵活程度越低,与用户提示词的相关性越强。
范围:`0` 到 `1`
@@ -247,17 +248,17 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \
- 自定义任务 ID
+ 自定义任务 ID。此字段会被忽略:comfy-api 在转发前会丢弃此字段;Comfy Router 会代你轮询。
- 视频生成模式。std:标准模式,性价比高。pro:专业模式,可生成时长更长、质量更高的视频。
+ 视频生成模式。std:标准模式,具有成本效益。pro:专业模式,生成时长更长但质量更高的视频输出。
可选值:`std`、`pro`
- 模型名。使用 Comfy Router 时可省略或传 null,模型由请求路径决定。如果提供名称,必须与该路径一致。
+ 模型名。使用 Comfy Router 时请省略此字段或发送 null;模型由请求路径选择。提供的名称必须与该路径匹配。
@@ -265,47 +266,47 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \
- 该分镜的时长,单位为秒。不得超过任务总时长,且不得小于 1。所有分镜时长之和等于任务总时长。
+ 此分镜的时长,单位为秒。不得超过任务总时长,且不得小于 1。所有分镜时长之和等于任务总时长。
- 镜头序号
+ 分镜序号
- 该分镜的提示词。最大长度 512 个字符。
+ 此分镜的提示词。最大长度为 512 个字符。
- 是否生成多镜头视频。为 true 时,prompt 参数无效。为 false 时,shot_type 和 multi_prompt 参数无效。
+ 是否生成多镜头视频。当为 true 时,prompt 参数无效。当为 false 时,shot_type 和 multi_prompt 参数无效。
- 负面文本提示词。建议直接在正向提示词中通过否定句来补充负面提示信息。
+ 负面文本提示词。推荐直接在正面提示词中通过否定句补充负面提示词信息。
- 正向文本提示词。使用 \<\<\>> 指定与 voice_list 参数顺序相匹配的声音。一个任务最多可引用 2 种音色。指定音色时,sound 参数的值必须为 on。
+ 正面文本提示词。使用 \<\<\>> 指定与 voice_list 参数顺序匹配的声音。一个任务最多可以引用 2 个音色。指定音色时,sound 参数值必须为 on。
- 分镜方式。当 multi_shot 参数设置为 true 时必填。
+ 分镜方法。当 multi_shot 参数设置为 true 时必填。
可选值:`customize`、`intelligence`
- 生成视频时是否同时生成声音。仅 V2.6 及之后版本的模型支持该参数。
+ 生成视频时是否同时生成声音。仅 V2.6 及后续版本的模型支持此参数。
可选值:`on`、`off`
- 生成视频时引用的音色列表。最多支持 2 个音色;在 `prompt` 中按列表顺序以 \<\<\>> 和 \<\<\>> 引用。需要将 `sound` 设为 "on",且仅 V2.6 及之后版本的模型支持;在更早的模型上,或 `sound` 保持默认值 "off" 时,音色不会生效。
+ 生成视频时引用的声音列表。最多支持 2 个声音;在 `prompt` 中按列表顺序使用 \<\<\>> 和 \<\<\>> 引用它们。要求将 `sound` 设置为 "on",仅 V2.6 及后续版本的模型支持该设置;在较早的模型上,或将 `sound` 保留为其默认值 "off" 时,声音不会被应用。
- 通过音色定制 API 返回的音色 ID,或系统预置音色 ID。
+ 通过声音自定义 API 返回的声音 ID,或系统预设的声音 ID。
@@ -316,7 +317,7 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \
true 表示生成水印,false 表示不生成。
-由 Router 在 `GET /v2/models/kling/kling-v3/openapi.json` 提供的 schema 生成,这也是它在请求到达提供商之前用于校验调用的同一份文档。
+本文档根据 Router 在 `GET /v2/models/kling/kling-v3/openapi.json` 提供的 schema 生成,这也是请求到达提供商之前用于校验调用的同一份文档。
### 输出
@@ -357,11 +358,11 @@ curl https://api.comfy.org/v2/models/kling/kling-v3/requests/$REQUEST_ID \
- 视频总时长(秒)
+ 视频总时长,单位为秒
- 已生成视频 ID
+ 已生成视频的 ID
diff --git a/zh/development/comfy-router/models/kling/kling-video-o1/code.mdx b/zh/development/comfy-router/models/kling/kling-video-o1/code.mdx
index 1fd6d2c0a4..6425b141a5 100644
--- a/zh/development/comfy-router/models/kling/kling-video-o1/code.mdx
+++ b/zh/development/comfy-router/models/kling/kling-video-o1/code.mdx
@@ -2,16 +2,17 @@
title: "将 Kling Video O1 与 Comfy Router 配合使用"
description: "通过 Comfy Router 调用 kling/kling-video-o1:endpoint、请求结构以及 Router 返回的响应。"
sidebarTitle: "Kling Video O1"
-translationSourceHash: 3c228231
+translationSourceHash: 892ccf77
translationFrom: development/comfy-router/models/kling/kling-video-o1/code.mdx
translationBlockHashes:
"_intro": a36df86f
"Quick start": 2dd48300
- "Schema": 6f4cf55b
+ "Schema": f693e2ef
"Examples": 6c2642d6
---
+
{/* GENERATED FILE. Generated from router-schemas/kling/kling-video-o1.json by `pnpm code-pages:gen`. */}
import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx";
@@ -160,21 +161,21 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \
### 输入
- 生成视频画面的宽高比例(宽:高)。未使用首帧参考或视频编辑功能时必填。
+ 生成视频画面的宽高比(宽度:高度)。当未使用首帧参考或视频编辑功能时必填。
- 可选值:`16:9`、`9:16`、`1:1`
+ 可能的值:`16:9`、`9:16`、`1:1`
- 本任务结果的回调通知地址。若已配置,任务状态发生变化时服务器会主动通知。
+ 本任务结果的回调通知地址。配置后,任务状态变化时服务器会主动通知。该项被忽略:comfy-api 会在转发前丢弃此字段;Comfy Router 会代替你轮询。
格式:`uri`
- 视频时长,单位为秒。使用视频编辑功能(refer_type: base)时,输出时长与输入视频相同,此参数无效。
+ 视频时长,单位为秒。使用视频编辑功能时(refer_type: base),输出时长与输入视频一致,此参数无效。
- 可选值:`3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15`
+ 可能的值:`3`、`4`、`5`、`6`、`7`、`8`、`9`、`10`、`11`、`12`、`13`、`14`、`15`
@@ -188,31 +189,31 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \
- 自定义任务 ID。在单个用户账号内必须唯一。
+ 自定义任务 ID。必须在单个用户账号内唯一。该项被忽略:comfy-api 会在转发前丢弃此字段;Comfy Router 会代替你轮询。
- 参考图像列表。可包含元素、场景、风格等参考图像,也可用作首帧或结束帧来生成视频。
+ 参考图像列表。可包含元素、场景、风格等参考图像,也可用作首帧或尾帧来生成视频。
- 图像的 Base64 编码或图片网址(请确保可访问)。支持的格式包括 .jpg/.jpeg/.png。文件大小不能超过 10MB。宽度和高度尺寸不得小于 300px,宽高比介于 1:2.5 ~ 2.5:1 之间。
+ 图像的 Base64 编码或图片网址(确保可访问)。支持的格式包括 .jpg/.jpeg/.png。文件大小不能超过 10MB。宽度和高度尺寸不得小于 300px,宽高比需在 1:2.5 ~ 2.5:1 之间。
- 图像是首帧还是结束帧。first_frame 为首帧,end_frame 为结束帧。目前不支持仅使用结束帧。
+ 该图像用作首帧还是尾帧。first_frame 为首帧,end_frame 为尾帧。目前不支持仅提供尾帧。
- 可选值:`first_frame`、`end_frame`
+ 可能的值:`first_frame`、`end_frame`
视频生成模式。std:标准模式,生成 720P 视频,性价比高。pro:专业模式,生成 1080P 视频,视频输出质量更高。
- 可选值:`pro`、`std`
+ 可能的值:`pro`、`std`
- 模型名。使用 Comfy Router 时可省略或传 null;模型由请求路径选择。若提供名称,则必须与该路径一致。
+ 模型名。使用 Comfy Router 时可省略或传 null;模型由请求路径决定。若提供名称,则必须与该路径一致。
@@ -220,7 +221,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \
- 本分镜的时长,单位为秒。不得超过任务总时长,且不得小于 1。所有分镜时长之和等于任务总时长。
+ 该分镜的时长,单位为秒。不得超过任务总时长,且不得小于 1。所有分镜时长之和等于任务总时长。
@@ -228,7 +229,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \
- 本分镜的提示词。最大长度为 512 个字符。
+ 该分镜的提示词。最大长度 512 个字符。
@@ -236,39 +237,39 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \
- 文本提示词,可包含正面和负面描述。不得超过 2,500 个字符。可以按 \<\<\<>>> 的格式指定元素、图像或视频,例如 \<\>、\<\<\>>、\<\<\>>。
+ 文本提示词,可包含正面和负面描述。不得超过 2,500 个字符。可按 \<\<\<>>> 格式指定元素、图像或视频,例如 \<\>、\<\<\>>、\<\<\>>。
- 分镜方式。multi_shot 参数设为 true 时必填。
+ 分镜方式。当 multi_shot 参数设为 true 时必填。
- 可选值:`customize`、`intelligence`
+ 可能的值:`customize`、`intelligence`
生成视频时是否同时生成声音。
- 可选值:`on`、`off`
+ 可能的值:`on`、`off`
- 参考视频列表。可用作功能参考视频或待编辑视频,默认为待编辑视频。
+ 参考视频列表。可用作功能参考视频,或用作待编辑视频,默认为待编辑视频。
- 是否保留视频的原始声音。yes 表示保留,no 表示不保留。
+ 是否保留视频原始声音。yes 表示保留,no 表示不保留。
- 可选值:`yes`、`no`
+ 可能的值:`yes`、`no`
- 参考视频类型。feature 为特征参考视频,base 为待编辑视频。
+ 参考视频类型。feature 为功能参考视频,base 为待编辑视频。
- 可选值:`feature`、`base`
+ 可能的值:`feature`、`base`
- 上传视频的 URL。仅支持 .mp4/.mov 格式。时长在 3-10 秒之间。分辨率必须在 720px 至 2160px 之间。支持 24-60 fps 的帧率。仅可上传 1 个视频,大小不超过 200MB。
+ 上传视频的网址。仅支持 .mp4/.mov 格式。时长在 3-10 秒之间。分辨率必须在 720px 到 2160px 之间。支持 24-60 fps 的帧率。只能上传 1 个视频,大小不超过 200MB。
@@ -279,12 +280,12 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \
true 表示生成水印,false 表示不生成。
-根据 Router 在 `GET /v2/models/kling/kling-video-o1/openapi.json` 提供的 schema 生成,与请求到达提供商之前用于校验调用的文档相同。
+根据 Router 在 `GET /v2/models/kling/kling-video-o1/openapi.json` 提供的 schema 生成,该文档也是它在请求到达提供商之前校验调用所使用的同一份文档。
### 输出
- 错误码
+ 错误代码
@@ -292,11 +293,11 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \
- 任务创建时间,Unix 时间戳,单位为毫秒
+ 任务创建时间,Unix 时间戳(毫秒)
- 任务扣除的单位数
+ 任务的扣减单位数
@@ -330,13 +331,13 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \
已生成视频的 URL
- 格式:`uri`
+ Format: `uri`
- 带水印的已生成视频的 URL,防盗链格式
+ 带水印的已生成视频 URL,防盗链格式
- 格式:`uri`
+ Format: `uri`
@@ -350,7 +351,7 @@ curl https://api.comfy.org/v2/models/kling/kling-video-o1/requests/$REQUEST_ID \
- 任务更新时间,Unix 时间戳,单位为毫秒
+ 任务更新时间,Unix 时间戳(毫秒)
diff --git a/zh/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx b/zh/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx
index f59763d31c..e39add7cbf 100644
--- a/zh/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx
+++ b/zh/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx
@@ -2,16 +2,17 @@
title: "配合 Comfy Router 使用 Videos Avatar Image 2video"
description: "通过 Comfy Router 调用 kling/videos-avatar-image2video:端点、请求结构以及 Router 返回的响应。"
sidebarTitle: "Videos Avatar Image 2video"
-translationSourceHash: 444b1395
+translationSourceHash: 5181e917
translationFrom: development/comfy-router/models/kling/videos-avatar-image2video/code.mdx
translationBlockHashes:
"_intro": baca1542
"Quick start": 5605d33f
- "Schema": eeb06fe1
+ "Schema": 073bf8b2
"Examples": ce6803dd
---
+
{/* GENERATED FILE. Generated from router-schemas/kling/videos-avatar-image2video.json by `pnpm code-pages:gen`. */}
import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx";
@@ -164,13 +165,13 @@ curl https://api.comfy.org/v2/models/kling/videos-avatar-image2video/requests/$R
- 本任务结果的回调通知地址。
+ 本任务结果的回调通知地址。此字段会被忽略:comfy-api 在转发前会丢弃该字段;Comfy Router 会代你轮询。
格式:`uri`
- 自定义任务 ID。在单个用户账户内必须唯一。
+ 自定义任务 ID。在单个用户账户内必须唯一。此字段会被忽略:comfy-api 在转发前会丢弃该字段;Comfy Router 会代你轮询。
@@ -216,7 +217,7 @@ curl https://api.comfy.org/v2/models/kling/videos-avatar-image2video/requests/$R
- 任务的扣费单元
+ 任务的扣费单位
diff --git a/zh/development/comfy-router/models/kling/videos-lip-sync/code.mdx b/zh/development/comfy-router/models/kling/videos-lip-sync/code.mdx
index de571505d6..c67e2e655f 100644
--- a/zh/development/comfy-router/models/kling/videos-lip-sync/code.mdx
+++ b/zh/development/comfy-router/models/kling/videos-lip-sync/code.mdx
@@ -2,16 +2,17 @@
title: "通过 Comfy Router 使用视频唇形同步"
description: "通过 Comfy Router 调用 kling/videos-lip-sync:端点、请求结构以及 Router 返回的响应。"
sidebarTitle: "视频唇形同步"
-translationSourceHash: ddd2a405
+translationSourceHash: 6103bea9
translationFrom: development/comfy-router/models/kling/videos-lip-sync/code.mdx
translationBlockHashes:
"_intro": 0477697a
"Quick start": e13a4628
- "Schema": 90571e9f
+ "Schema": 4fb7c777
"Examples": d1dd6ed8
---
+
{/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/kling/videos-lip-sync.json 生成。 */}
import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx";
@@ -176,7 +177,7 @@ curl https://api.comfy.org/v2/models/kling/videos-lip-sync/requests/$REQUEST_ID
### 输入
- 回调通知地址。任务状态发生变化时,服务器会发出通知。
+ 回调通知地址。任务状态发生变化时,服务器会发出通知。此项会被忽略:comfy-api 在转发之前会丢弃该字段,由 Comfy Router 代你轮询。
格式:`uri`
@@ -246,7 +247,7 @@ curl https://api.comfy.org/v2/models/kling/videos-lip-sync/requests/$REQUEST_ID
- 任务创建时间,Unix 时间戳(毫秒)
+ 任务创建时间
@@ -300,7 +301,7 @@ curl https://api.comfy.org/v2/models/kling/videos-lip-sync/requests/$REQUEST_ID
- 任务更新时间,Unix 时间戳(毫秒)
+ 任务更新时间
diff --git a/zh/development/comfy-router/models/runway/gen4-image/code.mdx b/zh/development/comfy-router/models/runway/gen4-image/code.mdx
index 4c11d24ba8..eb940c8368 100644
--- a/zh/development/comfy-router/models/runway/gen4-image/code.mdx
+++ b/zh/development/comfy-router/models/runway/gen4-image/code.mdx
@@ -2,16 +2,17 @@
title: "通过 Comfy Router 使用 Gen 4 Image"
description: "通过 Comfy Router 调用 runway/gen4_image:端点、请求结构以及 Router 返回的响应。"
sidebarTitle: "Gen 4 Image"
-translationSourceHash: c5792f5c
+translationSourceHash: 51dc9815
translationFrom: development/comfy-router/models/runway/gen4-image/code.mdx
translationBlockHashes:
"_intro": f3b89ce9
"Quick start": 82a202eb
- "Schema": d889abf3
+ "Schema": 1160ec6d
"Examples": 291dbf54
---
+
{/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/runway/gen4_image.json 生成。 */}
import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx";
@@ -168,7 +169,7 @@ curl https://api.comfy.org/v2/models/runway/gen4_image/requests/$REQUEST_ID \
- 包含编码图像的 HTTPS URL 或 data URI
+ 包含编码图像的 HTTPS URL、Runway 上传 URI(runway://)或 data URI
由 Router 在 `GET /v2/models/runway/gen4_image/openapi.json` 提供的 schema 生成,这也是请求到达提供商之前它用于校验调用的同一份文档。
diff --git a/zh/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx b/zh/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx
index e5f33d3207..c4299fc5a3 100644
--- a/zh/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx
+++ b/zh/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx
@@ -2,16 +2,17 @@
title: "将 Grok Imagine Image 2.0 与 Comfy Router 配合使用"
description: "通过 Comfy Router 调用 xai/grok-imagine-image-2.0:端点、请求结构以及 Router 返回的响应。"
sidebarTitle: "Grok Imagine Image 2.0"
-translationSourceHash: 83fe91a1
+translationSourceHash: e062dc40
translationFrom: development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx
translationBlockHashes:
"_intro": 614e2e15
"Quick start": ff9945c8
- "Schema": faf9e081
+ "Schema": cb29dfae
"Examples": 3222291b
---
+
{/* GENERATED FILE. 由 `pnpm code-pages:gen` 从 router-schemas/xai/grok-imagine-image-2.0.json 生成。 */}
import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx";
@@ -172,9 +173,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-2.0/requests/$REQUES
- 输出图像的质量。对于 grok-imagine-image-2.0,此项用于选择价格档位(low/medium;medium 为默认值);其他模型目前会忽略此项。
+ 输出图像的质量。对于 grok-imagine-image-2.0,此项用于选择价格档位:low、medium 或 auto(省略时为 xAI 的默认值;auto 在生成时使用 low,在编辑时使用 medium)。其他模型会忽略此项。
- 可选值:`low`、`medium`、`high`
+ 可选值:`low`、`medium`、`high`、`auto`
@@ -184,7 +185,7 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-2.0/requests/$REQUES
- 返回图像时使用的响应格式。可以是 url 或 b64_json。Comfy 会在出站请求中将其强制转换为 `url`:无论是在 Comfy Router 的调度(`POST /v2/models/xai/{model}`)中,还是在此 `/proxy/` 路由上都是如此,因为图像结果无论采用哪种格式都以重新托管的 URL 提供。enum 内的值会被接受并忽略;发送 `url` 或 `b64_json`,或省略该字段,结果都一样。enum 之外的值(不包括下文所述两处各自识别的 UNSET 写法)在两处都不会被强制转换,而是会被拒绝,区别仅在于拒绝的形式:此 `/proxy/` 路由在入口处返回 `400`,而 `POST /v2/models/xai/{model}` 的 Router 调度会在任何合作伙伴调用之前,返回此处所公布 enum 对应的字段级 `422`。两处对 UNSET 的判定不同:在此 `/proxy/` 路由上,省略字段、显式传入 `null` 和 `""` 都表示未设置,并像任何被接受的值一样被强制转换;Router 调度严格按公布的 enum 执行,因此 `null` 和 `""` 与其他非成员一样被视为非成员,要在该处保持未设置,请省略该字段。
+ 返回图像时使用的响应格式。可以是 url 或 b64_json。Comfy 会在出站请求中将其强制转换为 `url`:在 Comfy Router 的调度(`POST /v2/models/xai/{model}`)中如此,在此 `/proxy/` 路由上也是如此,因为图像结果无论采用哪种格式都以重新托管的 URL 提供。因此,enum 内的值会被接受并忽略;发送 `url` 或 `b64_json`,或省略该字段,结果都一样。enum 之外的值(不包括下文所述两处各自识别的 UNSET 写法)在两处都会被拒绝,而不是被强制转换,区别仅在于拒绝的形式:此 `/proxy/` 路由在入口处返回 `400`,而 `POST /v2/models/xai/{model}` 的 Router 调度会在任何合作伙伴调用之前,返回此处所公布 enum 对应的字段级 `422`。两处对 UNSET 的判定不同。在此 `/proxy/` 路由上,省略字段、显式传入 `null` 和 `""` 都表示未设置,并像任何被接受的值一样被强制转换。Router 调度严格按公布的 enum 执行,因此 `null` 和 `""` 与其他非成员一样被视为非成员:要在该处保持未设置,请省略该字段。
可选值:`url`、`b64_json`
diff --git a/zh/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx b/zh/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx
index f2ce00dd3e..d237f1b93a 100644
--- a/zh/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx
+++ b/zh/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx
@@ -2,16 +2,17 @@
title: "配合 Comfy Router 使用 Grok Imagine Image Pro"
description: "通过 Comfy Router 调用 xai/grok-imagine-image-pro:端点、请求形状以及 Router 返回的响应。"
sidebarTitle: "Grok Imagine Image Pro"
-translationSourceHash: 7932bb72
+translationSourceHash: 773b1560
translationFrom: development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx
translationBlockHashes:
"_intro": 97d341e4
"Quick start": 3a4bd585
- "Schema": 5d56d158
+ "Schema": 805c771c
"Examples": 3222291b
---
+
{/* 已生成文件。由 `pnpm code-pages:gen` 从 router-schemas/xai/grok-imagine-image-pro.json 生成。 */}
import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx";
@@ -172,9 +173,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-pro/requests/$REQUES
- 输出图像的质量。对于 grok-imagine-image-2.0,此项用于选择价格档位(low/medium;默认为 medium);其他模型目前会忽略该项。
+ 输出图像的质量。对于 grok-imagine-image-2.0,此项用于选择价格档位:low、medium 或 auto(省略时为 xAI 的默认值;auto 在生成时使用 low,在编辑时使用 medium)。其他模型会忽略该项。
- 可选值:`low`、`medium`、`high`
+ 可选值:`low`、`medium`、`high`、`auto`
@@ -184,7 +185,7 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-pro/requests/$REQUES
- 返回图像的响应格式。可以是 url 或 b64_json。Comfy 会在对外请求中将其强制转换为 `url`,无论是 Comfy Router 的分发(`POST /v2/models/xai/{model}`)还是此 `/proxy/` 路由,都是如此,因为无论哪种情况,图像结果都以重新托管的 URL 形式提供。enum 内的值会被接受并忽略;发送 `url` 或 `b64_json`,或省略该字段,结果都一样。enum 之外的值(不包括下文所述两处各自识别的 UNSET 写法)在两处都不会被强制转换,而是会被拒绝,区别仅在于拒绝的形式:此 `/proxy/` 路由在入口处返回 `400`,而 `POST /v2/models/xai/{model}` 的 Router 调度会在任何合作伙伴调用之前,返回此处所公布 enum 对应的字段级 `422`。两处对 UNSET 的判定不同:在此 `/proxy/` 路由上,省略字段、显式传入 `null` 和 `""` 都表示未设置,并像任何被接受的值一样被强制转换;Router 调度严格按公布的 enum 执行,因此 `null` 和 `""` 与其他非成员一样被视为非成员,要在该处保持未设置,请省略该字段。
+ 返回图像的响应格式。可以是 url 或 b64_json。Comfy 会在对外请求中将其强制转换为 `url`,无论是 Comfy Router 的分发(`POST /v2/models/xai/{model}`)还是此 `/proxy/` 路由,都是如此,因为无论哪种情况,图像结果都以重新托管的 URL 形式提供。因此,位于该 enum 内的值会被接受并忽略;发送 `url` 或 `b64_json`,或省略该字段,结果都一样。位于该 enum 之外的值(不包括下文所述两处各自识别的 UNSET 写法)在两处都不会被强制转换,而是会被拒绝,区别仅在于拒绝的形式:此 `/proxy/` 路由在入口处返回 `400`,而 `POST /v2/models/xai/{model}` 的 Router 调度会在任何合作伙伴调用发起之前,返回此处所公布 enum 对应的字段级 `422`。两处对 UNSET 的判定不同:在此 `/proxy/` 路由上,省略字段、显式传入 `null` 和 `""` 都表示未设置,并像任何被接受的值一样被强制转换;Router 调度严格按公布的 enum 执行,因此 `null` 和 `""` 与其他非成员一样被视为非成员,要在该处保持未设置,请省略该字段。
可选值:`url`、`b64_json`
diff --git a/zh/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx b/zh/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx
index 11a69c5911..2e2915a1a8 100644
--- a/zh/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx
+++ b/zh/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx
@@ -2,16 +2,17 @@
title: "配合 Comfy Router 使用 Grok Imagine Image Quality"
description: "通过 Comfy Router 调用 xai/grok-imagine-image-quality:端点、请求结构与 Router 返回的响应。"
sidebarTitle: "Grok Imagine Image Quality"
-translationSourceHash: 923968d2
+translationSourceHash: 9f6e16d5
translationFrom: development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx
translationBlockHashes:
"_intro": 72081c22
"Quick start": 799275b8
- "Schema": e0fcef44
+ "Schema": e2c96ff6
"Examples": 3222291b
---
+
{/* GENERATED FILE. Generated from router-schemas/xai/grok-imagine-image-quality.json by `pnpm code-pages:gen`. */}
import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx";
@@ -172,9 +173,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-quality/requests/$RE
- 输出图像的质量。对于 grok-imagine-image-2.0,此参数用于选择价格档位(low/medium;默认 medium);其他模型目前会忽略该项。
+ 输出图像的质量。对于 grok-imagine-image-2.0,此参数用于选择价格档位:low、medium 或 auto(省略时采用 xAI 的默认值;auto 在生成时使用 low,在编辑时使用 medium)。其他模型会忽略该项。
- 可选值:`low`、`medium`、`high`
+ 可选值:`low`、`medium`、`high`、`auto`
@@ -184,7 +185,7 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image-quality/requests/$RE
- 返回图像所用的响应格式。可以是 url 或 b64_json。Comfy 在向外发出的请求中会将其强制转换为 `url`:无论是 Comfy Router 的调度(`POST /v2/models/xai/{model}`),还是此 `/proxy/` 路由,都是如此,因为图像结果无论如何都以重新托管的 URL 形式提供。enum 内的值会被接受并忽略;发送 `url` 或 `b64_json`,或省略该字段,结果都一样。enum 之外的值(不包括下文所述两处各自识别的 UNSET 写法)在两处都不会被强制转换,而是会被拒绝,区别仅在于拒绝的形式:此 `/proxy/` 路由在入口处返回 `400`,而 `POST /v2/models/xai/{model}` 的 Router 调度会在任何合作伙伴调用之前,返回此处所公布 enum 对应的字段级 `422`。两处对 UNSET 的判定不同:在此 `/proxy/` 路由上,省略字段、显式传入 `null` 和 `""` 都表示未设置,并像任何被接受的值一样被强制转换;Router 调度严格按公布的 enum 执行,因此 `null` 和 `""` 与其他非成员一样被视为非成员,要在该处保持未设置,请省略该字段。
+ 返回图像所用的响应格式。可以是 url 或 b64_json。Comfy 在向外发出的请求中会将其强制转换为 `url`:无论是 Comfy Router 的调度(`POST /v2/models/xai/{model}`),还是此 `/proxy/` 路由,都是如此,因为图像结果无论如何都以重新托管的 URL 形式提供。因此,enum 内的值会被接受并忽略;发送 `url` 或 `b64_json`,或省略该字段,结果都一样。enum 之外的值(不包括下文所述两处各自识别的 UNSET 写法)在两处都会被拒绝,而不是被强制转换,区别仅在于拒绝的形式:此 `/proxy/` 路由在入口处返回 `400`,而 `POST /v2/models/xai/{model}` 的 Router 调度会在任何合作伙伴调用之前,返回此处所公布 enum 对应的字段级 `422`。两处对 UNSET 的判定不同:在此 `/proxy/` 路由上,省略字段、显式传入 `null` 和 `""` 都表示未设置,并像任何被接受的值一样被强制转换;Router 调度严格按公布的 enum 执行,因此 `null` 和 `""` 与其他非成员一样被视为非成员,要在该处保持未设置,请省略该字段。
可选值:`url`、`b64_json`
diff --git a/zh/development/comfy-router/models/xai/grok-imagine-image/code.mdx b/zh/development/comfy-router/models/xai/grok-imagine-image/code.mdx
index 50889fad9d..20106b0edc 100644
--- a/zh/development/comfy-router/models/xai/grok-imagine-image/code.mdx
+++ b/zh/development/comfy-router/models/xai/grok-imagine-image/code.mdx
@@ -2,16 +2,17 @@
title: "使用 Grok Imagine Image 与 Comfy Router"
description: "通过 Comfy Router 调用 xai/grok-imagine-image:端点、请求结构以及 Router 返回的响应。"
sidebarTitle: "Grok Imagine Image"
-translationSourceHash: 9cfb938a
+translationSourceHash: 2e5c55ad
translationFrom: development/comfy-router/models/xai/grok-imagine-image/code.mdx
translationBlockHashes:
"_intro": a2e97c88
"Quick start": a5495331
- "Schema": 1d17b83a
+ "Schema": 171da7d5
"Examples": 3222291b
---
+
{/* GENERATED FILE. Generated from router-schemas/xai/grok-imagine-image.json by `pnpm code-pages:gen`. */}
import RouterCodeFooter from "/snippets/zh/comfy-router/model-code-footer.mdx";
@@ -172,9 +173,9 @@ curl https://api.comfy.org/v2/models/xai/grok-imagine-image/requests/$REQUEST_ID
- 输出图像的质量。对于 grok-imagine-image-2.0,此参数用于选择价格档位(low/medium;默认为 medium);其他模型目前会忽略该参数。
+ 输出图像的质量。对于 grok-imagine-image-2.0,此参数用于选择价格档位:low、medium 或 auto(省略时使用 xAI 的默认值;auto 在生成时使用 low,在编辑时使用 medium)。其他模型会忽略该参数。
- 可能的值:`low`, `medium`, `high`
+ 可能的值:`low`, `medium`, `high`, `auto`
diff --git a/zh/development/comfy-router/realtime.mdx b/zh/development/comfy-router/realtime.mdx
new file mode 100644
index 0000000000..7a0e407358
--- /dev/null
+++ b/zh/development/comfy-router/realtime.mdx
@@ -0,0 +1,223 @@
+---
+title: "Comfy Router 实时语音会话"
+sidebarTitle: "实时语音"
+description: "通过 Comfy Router 打开 Grok Voice 实时 WebSocket 会话:端点、身份验证、按秒计费、会话限制,以及可能遇到的错误和关闭码。"
+translationSourceHash: e4024a38
+translationFrom: development/comfy-router/realtime.mdx
+translationBlockHashes:
+ "_intro": a85f88e5
+ "Endpoint": 2ae36abf
+ "Authentication": 582120fe
+ "Connect": b61ae8c6
+ "Events": a3ac8c47
+ "Pricing": 25d35f6c
+ "Limits": 85e21dff
+ "Errors": 3085ba65
+ "Next": 3e8c1bd8
+---
+Comfy Router 通过 fal 提供的 xAI Grok Voice 中转实时语音到语音会话。你只需使用自己的 Comfy API 密钥,与 Router 建立一个 WebSocket 连接。Router 会校验你的账户和积分,在上游开启会话,然后在两个方向上中转事件。会话费用按秒从你的 Comfy 积分中扣除。
+
+## 端点
+
+```text
+wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime
+```
+
+该请求属于 WebSocket 升级请求(`GET`,并带有 `Connection: Upgrade` 和 `Upgrade: websocket`)。其他任何请求都会被拒绝,并返回 `426`。
+
+## 身份验证
+
+在升级请求的请求头中发送你的 Comfy API 密钥,可以使用 `X-API-Key: comfyui-...` 或 `Authorization: Bearer comfyui-...`。Router 不会从查询字符串或 WebSocket 子协议中读取密钥。
+
+
+浏览器无法为 WebSocket 设置请求头,而且 Comfy API 密钥绝不能传到浏览器。请从服务器打开会话,并自行将音频转发到浏览器。
+
+
+## 连接
+
+升级成功后,即可收发 xAI 为 Grok Voice 文档中记录的实时事件。下面的示例会配置会话、发送一轮文本对话,并打印它收到的每个事件类型。
+
+
+
+```python Python
+# pip install websockets msgpack
+import asyncio
+import os
+
+import msgpack
+import websockets
+
+URL = "wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime"
+
+
+async def send(ws, event):
+ await ws.send(msgpack.packb(event))
+
+
+async def main():
+ async with websockets.connect(
+ URL,
+ additional_headers={"X-API-Key": os.environ["COMFY_API_KEY"]},
+ ) as ws:
+ await send(ws, {
+ "type": "session.update",
+ "session": {
+ "voice": "eve",
+ "instructions": "You are a helpful assistant.",
+ "turn_detection": {"type": "server_vad"},
+ },
+ })
+ await send(ws, {
+ "type": "conversation.item.create",
+ "item": {
+ "type": "message",
+ "role": "user",
+ "content": [{"type": "input_text", "text": "Hello!"}],
+ },
+ })
+ await send(ws, {"type": "response.create"})
+
+ async for message in ws:
+ if isinstance(message, str):
+ continue # fal 自己的 x-fal-message 帧
+ event = msgpack.unpackb(message)
+ print(event["type"])
+ if event["type"] == "response.done":
+ break
+
+
+asyncio.run(main())
+```
+
+```javascript Node.js
+// npm install ws @msgpack/msgpack
+import WebSocket from "ws";
+import { encode, decode } from "@msgpack/msgpack";
+
+const ws = new WebSocket(
+ "wss://api.comfy.org/v2/realtime/fal/xai/grok-voice/realtime",
+ { headers: { "X-API-Key": process.env.COMFY_API_KEY } },
+);
+
+ws.on("unexpected-response", (req, res) => {
+ // 升级被拒绝。JSON 响应体会说明原因。
+ let body = "";
+ res.on("data", (chunk) => (body += chunk));
+ res.on("end", () => console.error(res.statusCode, body));
+});
+
+const send = (event) => ws.send(encode(event));
+
+ws.on("open", () => {
+ send({
+ type: "session.update",
+ session: {
+ voice: "eve",
+ instructions: "You are a helpful assistant.",
+ turn_detection: { type: "server_vad" },
+ },
+ });
+ send({
+ type: "conversation.item.create",
+ item: {
+ type: "message",
+ role: "user",
+ content: [{ type: "input_text", text: "Hello!" }],
+ },
+ });
+ send({ type: "response.create" });
+});
+
+ws.on("message", (data, isBinary) => {
+ if (!isBinary) return; // fal 自己的 x-fal-message 帧
+ const event = decode(data);
+ console.log(event.type);
+ if (event.type === "response.done") ws.close();
+});
+
+ws.on("close", (code) => console.log("closed", code));
+```
+
+
+
+完成后请立即关闭 socket。计费会持续到会话关闭为止,而不是到最后一个响应结束。
+
+## 事件
+
+Router 不定义自己的事件协议。服务器事件会完全按照 fal 发送的原样抵达你这边,Router 接受的客户端事件也会被原样转发。关于事件列表、会话字段、音色和音频格式,请参阅:
+
+- [xAI Speech to Speech](https://docs.x.ai/developers/model-capabilities/audio/speech-to-speech) 以及 xAI 的 [realtime 事件 schema](https://docs.x.ai/voice-realtime.ws.json)
+- fal 的 [Grok Voice realtime 模型页面](https://fal.ai/models/xai/grok-voice/realtime)及其 [API 页面](https://fal.ai/models/xai/grok-voice/realtime/api)
+
+请像示例中那样,把每个客户端事件作为单条 msgpack 二进制消息发送。这是 fal 的 realtime 客户端所用的封装方式,模型的事件也会以同样的方式返回,即从 `session.created` 开始的 msgpack 二进制消息。fal 还会发送自己的 JSON 文本消息,类型为 `x-fal-message`(计时信息);你可以跳过它们。Router 的检查也接受把客户端事件作为单条 JSON 文本消息发送,但除非你已用你的客户端测试过 JSON,否则请使用 msgpack。
+
+Router 在转发每个客户端事件之前都会进行检查:
+
+- **事件类型:**`session.update`、`input_audio_buffer.append`、`input_audio_buffer.commit`、`input_audio_buffer.clear`、`conversation.item.create`、`conversation.item.delete`、`conversation.item.truncate`、`response.create`、`response.cancel`,以及 fal 的 `x-fal-session.configure`。
+- **模型:**`session.update` 中的 `model` 必须是 `grok-voice-latest`、`grok-voice-3.0` 或 `grok-voice-2.0`。
+- **工具:**由你的客户端执行的函数工具是允许的。服务器端工具(搜索、X 搜索、文件搜索和 MCP)会被拒绝。
+- **媒体:**图像和视频输入会被拒绝。会话仅支持语音和文本。
+- **大小:**单条客户端消息最大为 1 MiB。
+
+被拒绝的事件不会被转发,并且 Router 会以关闭码 `1008` 关闭会话。
+
+## 定价
+
+一次会话的费用为**每秒 $0.0011869**(约每分钟 $0.0712,或每秒 0.2504 积分、约每分钟 15.0 积分,按 211 积分 = 1 美元计算)。会话开启期间按 15 秒的增量计费,最后不足 15 秒的部分按秒计费并向上取整。计费从升级开始,直到 socket 关闭为止,无论音频是否在传输。
+
+## 限制
+
+| 限制 | 值 |
+| --- | --- |
+| 每账户会话数 | 同一时间只能有一个打开的会话。打开第二个会话会返回 `429`,错误码为 `router.realtime.session_already_live`。 |
+| 会话时长 | 最长 30 分钟,且绝不会超过连接时您的积分余额所能覆盖的时长。 |
+| 会话期间的积分 | Router 每 15 秒重新检查一次您的余额,当余额不足以覆盖下一秒时便结束会话。 |
+| 连接速率 | 每次升级尝试都计入您的[按调用方计算的请求速率](/zh/development/comfy-router/limitations#请求按调用方进行速率限制),并与其他 Router 调用共享该速率。 |
+
+当会话达到时间上限或积分已用完时,连接可能会在没有关闭帧的情况下关闭(通常表现为关闭码 `1006`)。请仅在上限充值之后重新连接,或者如果需要更长时间,请开启新会话。
+
+## 错误
+
+### 升级之前
+
+如果 Router 拒绝连接,它不会切换协议,而是返回 HTTP 状态码和 JSON 响应体:
+
+```json
+{
+ "detail": "Insufficient credits to open a realtime session.",
+ "error_type": "insufficient_credits",
+ "code": "router.realtime.insufficient_credits"
+}
+```
+
+请根据 `code` 进行判断;`detail` 供人阅读。
+
+| 状态 | `code` | 原因 | 处理方法 |
+| --- | --- | --- | --- |
+| `426` | `router.realtime.upgrade_required` | 该请求不是 WebSocket 升级请求。 | 使用 WebSocket 客户端连接。 |
+| `401` | `router.realtime.unauthorized` | API 密钥缺失或无效。 | 在 `X-API-Key` 或 `Authorization: Bearer` 中发送有效的密钥。 |
+| `402` | `router.realtime.insufficient_credits` | 你的余额不足以支付至少一秒的会话。 | 添加积分,然后重新连接。 |
+| `402` | `router.realtime.spend_denied` | 会话将要计费的钱包没有可用资金。响应体中的 `denied_reason` 和 `billed_workspace` 会指明是哪个钱包。 | 向该工作区添加积分,然后重新连接。 |
+| `403` | `router.realtime.provider_disabled` | 你的工作区的合作伙伴提供商策略不允许此提供商。 | 请工作区管理员允许该提供商。 |
+| `404` | `router.realtime.model_not_allowed` | URL 中的模型不可用于实时会话。 | 检查 URL。 |
+| `429` | `router.realtime.rate_limited` | 你已超出请求速率。 | 等待 `Retry-After`,然后重试。 |
+| `429` | `router.realtime.session_already_live` | 你的账号已打开另一个会话。 | 请先关闭它。 |
+| `429` | `router.realtime.concurrency_limit` | 合作伙伴模型的并发调用过多。 | 减少并发工作,然后重试。 |
+| `502` | `router.realtime.upstream_refused`、`router.realtime.token_mint_failed` | 上游提供商未能打开会话。 | 使用退避策略重试。 |
+| `503` | 任何其他 `router.realtime.*` 代码 | 实时会话暂时不可用。 | 使用退避策略重试。 |
+
+### 升级之后
+
+| 关闭代码 | 含义 | 处理方法 |
+| --- | --- | --- |
+| `1008` | 某个客户端事件被拒绝(参见[事件](#事件))。 | 修复该事件。会话已结束。 |
+| `1012` | Router 正在重启。 | 重新连接。将启动新会话,并从新的升级开始计费。 |
+| `1006`(无关闭帧) | 通常是会话达到时间限制或积分已用完时客户端报告的结果。网络中断看起来也一样。 | 添加积分或启动新会话。 |
+
+任何其他关闭代码都来自 fal 或 xAI。请参阅[事件](#事件)中链接的文档。
+
+## 下一步
+
+- [计费](/zh/development/comfy-router/billing):Router 如何计费,以及如何核对用量。
+- [错误与重试](/zh/development/comfy-router/errors):其他 Router 调用返回的错误分类。
+- [限制](/zh/development/comfy-router/limitations):请求速率及其他限制。
diff --git a/zh/development/comfy-router/reference.mdx b/zh/development/comfy-router/reference.mdx
index 51f1a1ee9a..e13aa73ea2 100644
--- a/zh/development/comfy-router/reference.mdx
+++ b/zh/development/comfy-router/reference.mdx
@@ -2,15 +2,15 @@
title: "Comfy Router API 参考"
description: "每个 Comfy Router 端点、参数、响应体和错误分类,均由 Comfy API 契约生成。"
sidebarTitle: "API 参考"
-translationSourceHash: a6f99965
+translationSourceHash: 194f763d
translationFrom: development/comfy-router/reference.mdx
translationBlockHashes:
"_intro": 3f6e5d23
- "Endpoints": 222fd740
+ "Endpoints": e0879d3c
"Error buckets": 02a09cb4
"Response headers": 403c8bf5
- "Pre-flight cost estimates": 5952af3f
- "Result assets": 18fe6dad
+ "Pre-flight cost estimates": f0ba96a1
+ "Result assets": 5936427c
"Per-model input and output schemas": 61c6bde8
"Schemas": 984bd216
---
@@ -28,6 +28,7 @@ translationBlockHashes:
+
{/*
生成的文件:请勿手动编辑。
@@ -51,67 +52,67 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭
**列出 Comfy Router 可以运行的模型。**
-列出可用的模型 ID 和计费信息。当 `has_more` 为 `true` 时,使用 `next_cursor`。
+列出可用的模型 ID 与计费信息。当 `has_more` 为 true 时,使用 `next_cursor` 继续获取。
**参数**
- 不透明的分页游标。
+ 不透明分页游标。
- 类型:[`RouterPageCursor`](#routerpagecursor) -- 作为 `next_cursor` 返回的不透明游标,1–512 个字符
+ 类型:[`RouterPageCursor`](#routerpagecursor)。以 `next_cursor` 返回的不透明游标,长度为 1–512 个字符
每页返回的模型数量。
- 最多 100,默认值:20
+ 最大 100,默认值:20
- 调用方从先前的 `200` 响应中持有的 `ETag`。
+ 调用方从之前的 `200` 响应中持有的 `ETag`。
**响应**
- OK - 模型目录中的一页。
+ OK。模型目录的一页数据。
- 响应体:[`RouterModelListResponse`](#routermodellistresponse) -- 响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control`
+ 响应体:[`RouterModelListResponse`](#routermodellistresponse)。响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control`
- Not Modified - 自调用方在 `If-None-Match` 中发送的 `ETag` 以来,该页面没有变化。
+ Not Modified。自调用方在 `If-None-Match` 中发送的 `ETag` 以来,该页数据未发生变化。
响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control`
- 请求无效。请检查错误类型和请求体。
+ 请求无效。请检查错误类型与请求体。
- 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
- 凭据缺失或无效。
+ 凭证缺失或无效。
- 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
该调用方或模型不允许发起此请求。
- 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
Router 暂时不可用。请退避后重试。
- 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 响应体:[`RouterErrorResponse`](#routererrorresponse)。响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
### `GET /v2/models/{provider}/{model}`
-**按规范模型 ID 读取单个合作伙伴模型的产品目录条目。**
+**通过规范模型 ID 读取一个合作伙伴模型的目录条目。**
无需列出完整目录即可读取单个模型的详情。
@@ -120,29 +121,29 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭
规范 `{provider}/{model}` 模型 ID 中的提供商部分。
- 类型:[`RouterProviderSegment`](#routerprovidersegment) —— 字母数字标识符,例如 `anthropic`,最多 64 个字符
+ 类型:[`RouterProviderSegment`](#routerprovidersegment),字母数字短标识,例如 `anthropic`,最多 64 个字符
规范 `{provider}/{model}` 模型 ID 中的模型部分。
- 类型:[`RouterModelSegment`](#routermodelsegment) —— 字母数字标识符,例如 `claude-opus-4-6`,最多 128 个字符
+ 类型:[`RouterModelSegment`](#routermodelsegment),字母数字短标识,例如 `claude-opus-4-6`,最多 128 个字符
- 调用方从之前的 `200` 响应中持有的 `ETag`。
+ 调用方从先前的 `200` 响应中持有的 `ETag`。
**响应**
- OK —— 该模型的产品目录条目。
+ OK:该模型的目录条目。
- 响应体:[`RouterModelDetail`](#routermodeldetail) —— 响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control`
+ 正文:[`RouterModelDetail`](#routermodeldetail);响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control`
- Not Modified —— 自调用方在 `If-None-Match` 中发送的 `ETag` 对应版本以来,该条目未发生更改。
+ 未修改:自调用方在 `If-None-Match` 中发送的 `ETag` 以来,该条目未发生变化。
响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control`
@@ -150,107 +151,105 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭
凭据缺失或无效。
- 响应体:[`RouterErrorResponse`](#routererrorresponse) —— 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 正文:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
- 该调用方或该模型无权执行此请求。
+ 该调用方或模型不允许此请求。
- 响应体:[`RouterErrorResponse`](#routererrorresponse) —— 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 正文:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
未找到该模型 ID。
- 响应体:[`RouterErrorResponse`](#routererrorresponse) —— 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 正文:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
- Router 暂时不可用。请退避重试。
+ Router 暂时不可用。请使用退避策略重试。
- 响应体:[`RouterErrorResponse`](#routererrorresponse) —— 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 正文:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
### `POST /v2/models/{provider}/{model}`
-**按规范模型 ID 同步运行合作伙伴模型。**
+**通过规范模型 ID 同步运行合作伙伴模型。**
-运行模型,并在同一个响应中收到其已完成的结果。
+运行模型,并在同一响应中接收其已完成的结果。
**参数**
- 规范 `{provider}/{model}` 模型 ID 中表示提供商的部分。
+ 规范 `{provider}/{model}` 模型 ID 中的提供商部分。
- 类型:[`RouterProviderSegment`](#routerprovidersegment) -- 字母数字 slug,例如 `anthropic`,最长 64 个字符
+ 类型:[`RouterProviderSegment`](#routerprovidersegment),字母数字 slug,例如 `anthropic`,最多 64 个字符
- 规范 `{provider}/{model}` 模型 ID 中表示模型的部分。
+ 规范 `{provider}/{model}` 模型 ID 中的模型部分。
- 类型:[`RouterModelSegment`](#routermodelsegment) -- 字母数字 slug,例如 `claude-opus-4-6`,最长 128 个字符
+ 类型:[`RouterModelSegment`](#routermodelsegment),字母数字 slug,例如 `claude-opus-4-6`,最多 128 个字符
- 由调用方生成的密钥,使重试一次逻辑调用变得安全。
+ 调用方生成的密钥,使重试同一逻辑调用变得安全。
1–255 个字符
- 选择另一个提供商来服务此模型,而不是其当前默认提供商;`fal`、`wavespeed`、`runware` 和 `higgsfield` 是备选提供商,`GET /v2/models/{provider}/{model}` 会报告某个模型支持其中哪些。它的各种拒绝按固定顺序检查,靠前的拒绝无论靠后的拒绝是否成立都会生效:无法识别的值(根本不是已注册的提供商)会被拒绝并返回 `400`;随后,若请求体选择了 multipart 操作(编辑)而指定了备选提供商,则会被拒绝并返回 `409`,其 `detail` 以“this request's `image` selects the edit operation”开头,但仅当该提供商针对此模型的转换器无法服务该操作时才会如此,若某条 leg 的转换器确实携带该媒体,则会正常继续;接下来,若请求解析出了自带密钥(bring-your-own-key)凭据,则任何备选提供商都会被拒绝并返回 `409`,其 `detail` 以 `this request resolved a BYOK credential` 开头(见该响应),无论该提供商是否服务此模型;再接下来是该具名提供商自身的准入检查:当该提供商未为你开启时,会拒绝并返回 `403` 与 `error_type: not_enabled`,当无法评估该检查时,会拒绝并返回 `503` 与 `error_type: service_unavailable`;只有通过以上全部四项之后,真实提供商若对此模型没有 leg,才会被拒绝并返回 `400` 与 `error_type: invalid_input`,与无法识别的值得到相同的应答。在自带密钥请求上、在请求体选择 multipart 操作的请求上以及在 `strict_mode=true` 下,`fallback_provider` 是不生效,而不是被拒绝。
+ 选择一个替代提供商来为此模型提供服务,而非其当前默认提供商;`fal`、`wavespeed`、`runware` 和 `higgsfield` 是替代提供商,`GET /v2/models/{provider}/{model}` 会报告给定模型支持它们中的哪些。其拒绝按固定顺序检查,较早的检查无论较晚的检查是否会触发都会作出答复:无法识别的值(完全不是已注册的提供商)会被拒绝并返回 `400`;然后,在主体选择 multipart 操作(编辑)的请求上,替代提供商会被拒绝并返回 `409`,`detail` 以 "this request's `image` selects the edit operation" 开头,但仅当该提供商针对此模型的转换器无法提供该操作时;转换器确实携带媒体的分支会正常进行;然后,在解析了自带密钥(BYOK)凭据的请求上,任何替代提供商都会被拒绝并返回 `409`,`detail` 以 `this request resolved a BYOK credential` 开头(见该响应),无论该提供商是否为此模型提供服务;然后是命名提供商自身的门控,当该提供商未为你启用时,会拒绝并返回 `403`,`error_type: not_enabled`,当无法评估门控时,会拒绝并返回 `503`,`error_type: service_unavailable`;只有在通过全部四项检查之后,真正没有此模型分支的提供商才会被拒绝并返回 `400`,`error_type: invalid_input`,与无法识别的值得到相同的答复。在自带密钥请求、主体选择 multipart 操作的请求以及 `strict_mode=true` 下,`fallback_provider` 不起作用,而非被拒绝。
- 只有与 `model_provider` 一起使用时才有意义。
+ 仅与 `model_provider` 一起使用时才有意义。
- 默认值:否
+ 默认值:False
- 控制当首次尝试因归因于 Router 或所尝试提供商的原因而失败时,Router 是否针对该模型的另一个已注册提供商重试此调用。省略该参数,或使用除 `false` 之外的任何值,都会保持回退开启;`false` 会将其关闭。成功回退的响应会带有 `X-Comfy-Router-Fallback-Provider`。在解析出了自带密钥凭据的请求上,无论此参数说什么,回退都不可用:根本不会进行该尝试,首次失败会原样返回给你,这属于不生效,而不是被拒绝:这里不会产生任何 `409`。出于同样的原因,在请求体选择 multipart 操作的请求上以及在 `strict_mode=true` 下也是如此:每一种情况都会把调用绑定到一个无法在另一个提供商上忠实重放的提供商,因此回退只是被跳过,而不是被拒绝。只有显式指定 `model_provider` 才会被以该 `409` 拒绝,而且与这种无条件跳过不同,其 multipart 的 `409` 仅适用于转换器无法服务该操作的 leg。
+ 控制当首次尝试因可归属于 Router 或所尝试提供商的原因而失败时,Router 是否针对该模型的其他已注册提供商重试此调用。省略,或任何非 `false` 的值,都会保持回退开启;`false` 会将其关闭。成功的回退响应会带有 `X-Comfy-Router-Fallback-Provider`。在解析了自带密钥凭据的请求上,无论此参数说什么,回退都不可用:不会进行该尝试,首次失败会原样到达你这里,这是不起作用的,而非被拒绝:这里不会产生 `409`。出于同样的原因,在主体选择 multipart 操作的请求以及 `strict_mode=true` 下也是如此:每一种都将调用绑定到单个提供商,无法在另一个提供商上忠实重放,因此回退会被直接跳过,而非被拒绝。只有显式的 `model_provider` 会被拒绝并返回该 `409`,而且不同于这种无条件跳过,其 multipart `409` 仅适用于转换器无法提供该操作的分支。
- 选择拒绝此模型输入 schema 未声明的顶层请求体字段,而不是接受它;嵌套字段不会被检查,对于 schema 允许未声明字段或没有编写 schema 的模型,以及在以 `strict_mode=true` 发送的已执行提交上,都不会拒绝任何内容。
+ 选择拒绝此模型输入 schema 未声明的顶层请求体字段,而不是接受它;不检查嵌套字段,对于其 schema 允许未声明字段或没有已编写 schema 的模型,或者对于使用 `strict_mode=true` 发送的已执行提交,都不会拒绝任何内容。
- 默认值:否
+ 默认值:False
**请求体**
`application/json` -- [`RouterModelInput`](#routermodelinput)(必填)
-合作伙伴模型的原生 JSON 输入。不带 `model_provider` 时,请求会在模型的默认提供商上执行原生分发,此请求体就是模型自身的原生 schema,原样转发(此时 `strict_mode` 没有意义,也不会带来任何改变)。当 `model_provider` 选择备选提供商且 `strict_mode=false`(默认值)时,请求体会在发送之前被转换为该提供商的真实 schema:任何无法精确表达的原生字段都会被丢弃,并通过响应的 `X-Comfy-Router-Dropped-Params` 头予以披露,绝不会静默丢弃。当 `model_provider` 选择备选提供商且 `strict_mode=true` 时不执行任何转换:请求体必须已经是该备选提供商自身的真实 schema,而不是此模型的原生 schema(参见 `strict_mode`),并会原样转发。请求体自身的字段还会选择 Router 在支持多种操作的模型上运行哪种操作:对于可编辑的图像模型,包含一张输入图像会将其从文生图切换为图生图(编辑)操作,该操作可能按自己的费率计费;对于 Seedance 视频模型,`content[].role` 选择操作(首帧图像选择图生视频,参考图像或参考片段选择参考生视频)。在原生分发下,Seedance 的计费依据 `content` 中的媒体类型而非角色:任何包含视频输入的请求按视频转视频计费,否则包含任何图像的请求按图生视频计费,否则按文生视频计费;例外是来自 `draft_task` 项的最终渲染,按其所渲染 Draft 的操作计费;某些模型对文生视频和图生视频收取相同费率。当 `model_provider` 选择备选提供商时,每种带条件的操作可能会按该提供商自己的费率计费。
-
-**响应**
+合作伙伴模型的原生 JSON 输入。不带 `model_provider` 时,请求会在模型的默认提供商上运行原生分发,此主体就是模型自身的原生 schema,原样转发(`strict_mode` 在那里没有意义,不会改变任何东西)。当 `model_provider` 选择一个替代提供商且 `strict_mode=false`(默认值)时,主体在发送之前会转换为该提供商的真实 schema:任何无法精确表达的原生字段都会被丢弃,并通过响应的 `X-Comfy-Router-Dropped-Params` 标头披露,绝不会静默丢弃。当 `model_provider` 选择一个替代提供商且 `strict_mode=true` 时,不会运行任何转换:主体必须已经是该替代提供商自身的真实 schema,而不是此模型的原生 schema(参见 `strict_mode`),并会原样转发。主体自身的字段还会选择 Router 在支持多种操作的模型上运行哪种操作:对于可编辑的图像模型,包含输入图像会将其从文生图切换为图生图(编辑)操作,该操作可能会按其自身的费率计费;对于 Seedance 视频模型,`content[].role` 选择操作(首帧图像选择图生视频,参考图像或视频片段选择参考生视频)。在原生分发下,Seedance 计费遵循 `content` 中的媒体类型,而不是角色:任何带有视频输入的请求按视频转视频计费,否则任何带有图像的请求按图生视频计费,否则按文生视频计费,除了来自 `draft_task` 项的最终渲染按其渲染的 Draft 的操作计费;某些模型对文生视频和图生视频收取相同费率。当 `model_provider` 选择一个替代提供商时,每个带条件的操作可能会按该提供商自身的费率计费。
-
- OK - 不带 `model_provider`,或带 `model_provider` 且 `strict_mode=false`(默认值,在可能时转换回本模型的原生契约,转换失败时回退到备用提供商自己的原始响应,会记录日志,绝不静默)时,形状是本模型自己的原生输出;当 `strict_mode=true` 时,则原样返回备用提供商的响应。对于由合作伙伴直接以字节形式返回生成结果的模型,响应体就是这些字节,使用合作伙伴自己的 `Content-Type` 而不是 `application/json`;请根据响应的 `Content-Type` 分支处理,不要假定它是一个 JSON 文档。
+**响应**
+ 正常:未提供 `model_provider`,或提供了 `model_provider` 且 `strict_mode=false`(默认值;在可能时转换回该模型的原生契约,转换失败时回退到备用提供商自己的原始响应,此过程会记录日志,绝不静默处理),响应形状为该模型自身的原生输出;当 `strict_mode=true` 时,则是原样返回的备用提供商的响应。对于合作伙伴直接以字节形式应答生成结果的模型,响应体就是这些字节,使用合作伙伴自己的 `Content-Type` 而非 `application/json`;请根据响应的 `Content-Type` 分支处理,不要假定其为 JSON 文档。
响应体:[`RouterModelOutput`](#routermodeloutput) 或原始字节(`*/*`) -- 响应头:`X-Comfy-Request-Id`、`X-Content-Type-Options`、`X-Comfy-Router-Fallback-Provider`、`X-Comfy-Router-Provider`、`X-Comfy-Router-Dropped-Params`、`X-Comfy-Credits-Used`、`Idempotent-Replayed`、`X-Committed-Spend-Limit`、`X-Committed-Spend-Current`、`X-Committed-Spend-Remaining`
- 请求无效。请检查错误类型和请求体。
+ 无效请求。请检查错误类型和请求体。
响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`X-Comfy-Upstream-Status`、`X-Comfy-Upstream-Detail`、`X-Comfy-Refusal-Subject`、`X-Comfy-Credits-Used`、`Idempotent-Replayed`
- 凭据缺失或无效。
+ 凭证缺失或无效。
响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
- Router 请求级别的失败:请求从未到达模型,或者因模型自身未反馈的原因而失败。
+ Router 请求级失败:请求从未到达模型,或因模型自身未反馈的原因而失败。
响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
- 该调用方或模型不允许执行此请求。
+ 该调用方或该模型不允许执行此请求。
响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
@@ -262,9 +261,9 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭
- 检查 `X-Comfy-Error-Type`:`concurrency_limit_exceeded` 表示原始调用仍在运行,因此请等待 `Retry-After` 并复用同一个 key;`invalid_input` 则要求使用新的 key。此路由上有两种 `invalid_input` 冲突与 key 完全无关,任何新 key 都无法消除:当请求体选择的是该提供商针对此模型的转换器无法处理的多部分操作(编辑)时,用 `model_provider` 指定备用提供商会遭到拒绝,其 `detail` 以 "this request's `image` selects the edit operation" 开头;之后还会检查另一种情况:请求已经为路径中的提供商解析出自带密钥(BYOK)凭据,其 `detail` 以 `this request resolved a BYOK credential` 开头。请去掉 `model_provider`,或在发送请求时不带 BYOK 凭据,并且(针对多部分的情况)不带编辑操作。
+ 请检查 `X-Comfy-Error-Type`:`concurrency_limit_exceeded` 表示原始调用仍在运行,因此请等待 `Retry-After` 并复用同一个 key;`invalid_input` 则需要使用新的 key。此路由上的两种 `invalid_input` 冲突与 key 完全无关,更换新 key 也无法消除其中任何一种:当请求体选择一个 multipart 操作(一次编辑),而该提供商针对此模型的转换器无法处理该操作时,指定备用提供商的 `model_provider` 会被拒绝,其 `detail` 以 "this request's `image` selects the edit operation" 开头;以及在此之后检查的另一种情况:当请求已经为路径中的提供商解析出一个自带密钥(BYOK)凭证时,其 `detail` 以 `this request resolved a BYOK credential` 开头。请去掉 `model_provider`,或在不携带 BYOK 凭证的情况下发送请求,并且(对于 multipart 的情况)不包含编辑操作。
- 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(当 `concurrency_limit_exceeded` 时)
+ 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(当出现 `concurrency_limit_exceeded` 时)
@@ -274,64 +273,64 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭
- 请求的内容依据模型 schema 被拒绝。
+ 请求的内容未通过模型 schema 的校验。
响应体:[`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Idempotent-Replayed`
- 检查 `X-Comfy-Error-Type`:`concurrency_limit_exceeded` 表示应减少在途调用;`rate_limited` 表示应等待额度窗口。
+ 请检查 `X-Comfy-Error-Type`:`concurrency_limit_exceeded` 表示应减少在途调用数;`rate_limited` 表示需等待额度窗口。
响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`X-Committed-Spend-Limit`、`X-Committed-Spend-Current`、`X-Committed-Spend-Remaining`、`X-Model-Concurrency-Limit`、`X-Model-Concurrency-Current`、`X-Model-Concurrency-Remaining`
- 提供商自己的响应无法转换为结果(`provider_error`)。
+ 提供商的响应无法被转换为结果(`provider_error`)。
响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`X-Comfy-Upstream-Status`
- Router 暂时不可用。请退避后重试。
+ Router 暂时不可用。请使用退避策略重试。
响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(仅容量拒绝时)
- 请求超过了截止期限。重试前请检查错误类型。
+ 请求超过了截止时间。重试前请检查错误类型。
响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`X-Comfy-Upstream-Status`、`Retry-After`
### `POST /v2/models/{provider}/{model}/estimate`
-**在运行模型调用之前先为它定价,而无需实际运行。**
+**在真正运行之前预估一次模型调用的价格,而无需运行它。**
-返回一个以美元计的预检估算,表示用此模型运行该请求体将产生的费用,其定价依据与实际运行计费所依据的同一份费率卡(若某模型按其供应商上报的成本计费,则改为依据供应商公布的价格表来估算)。这是估算值,而非最终费用:你实际支付的是工作区用量与账单记录中结算后的费用。请求体会先按模型的输入 schema 进行校验,校验方式与默认运行(未设置 `strict_mode`,也未设置 `reject_unknown_fields`)相同,因此未通过模型 schema 的请求体在此处和在运行时都会得到相同的 `422`;不会向任何提供商派发请求,也不会产生任何扣费。该结果并非价格锁定:它按 `pricing_as_of` 时点生效的费率计价,而一次运行则按计费时生效的费率收费。在该功能逐步推出的期间,此路由会返回 `403`,并带有 `error_type: not_enabled`。
+返回预检估算,单位为美元,说明在此模型上运行该请求体将产生多少费用;其定价依据与运行计费相同的费率表(对于按供应商所报告成本计费的模型,则改为根据供应商公布的价格表进行估算)。这是估算值,并非最终费用:你实际支付的是工作区使用情况和账单记录中的结算费用。请求体会先按模型的输入 schema 进行校验,校验方式与默认运行(不启用 `strict_mode`,也不启用 `reject_unknown_fields`)相同,因此未能通过模型 schema 的请求体在此处与在运行路由上一样会返回 `422`;不会向提供商派发任何内容,也不会产生任何费用。该结果不构成价格锁定:它按 `pricing_as_of` 时生效的费率计价,而运行则按计费评级时生效的费率收费。在该功能逐步推出期间,此路由会返回 `403`,并带有 `error_type: not_enabled`;对于 Router 尚无法运行的模型,会返回同样的 `403`,但带有运行路由自己的 `detail`,因此请阅读 `detail` 来区分两者。
**参数**
- 规范 `{provider}/{model}` 模型 ID 中的小写提供商段,即被运行模型所属的合作伙伴。
+ 规范 `{provider}/{model}` 模型 ID 中的小写提供商段,即正在运行其模型的合作伙伴。
- 类型:[`RouterProviderSegment`](#routerprovidersegment) -- 字母数字 slug,例如 `anthropic`,最长 64 个字符
+ 类型:[`RouterProviderSegment`](#routerprovidersegment):字母数字短标识,例如 `anthropic`,最长 64 个字符
- 规范 `{provider}/{model}` 模型 ID 中的小写模型段,即在该提供商内要运行的模型。
+ 规范 `{provider}/{model}` 模型 ID 中的小写模型段,即该提供商下要运行的模型。
- 类型:[`RouterModelSegment`](#routermodelsegment) -- 字母数字 slug,例如 `claude-opus-4-6`,最长 128 个字符
+ 类型:[`RouterModelSegment`](#routermodelsegment):字母数字短标识,例如 `claude-opus-4-6`,最长 128 个字符
- 选择用于提供此模型的备用提供商,以替代其当前的默认提供商。
+ 选择一个备用提供商来提供此模型,而不是使用其当前默认提供商。
**请求体**
-`application/json` -- [`RouterModelInput`](#routermodelinput)(必填)
+`application/json`: [`RouterModelInput`](#routermodelinput)(必填)
-合作伙伴模型的原生 JSON 输入,与此模型的同步路由所接受的请求体完全相同。它会按模型自身的输入 schema 进行校验,与默认运行的校验方式一致(此路由不接受 `strict_mode` 或 `reject_unknown_fields`),并由其自身的字段(输出数量、输入图像所选择的操作)决定计价内容。
+合作伙伴模型的原生 JSON 输入,与同步路由为此模型接受的请求体相同。它会按模型自身的输入 schema 进行校验,校验方式与默认运行相同(此路由不接受 `strict_mode` 或 `reject_unknown_fields`),而请求体自身的字段(输出数量、输入图像所选的操作)决定对哪些内容计价。
**响应**
@@ -354,7 +353,7 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭
- 此调用方或此模型不允许该请求。
+ 此调用方或模型不允许该请求。
响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
@@ -372,51 +371,51 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭
- 估算请求的请求体未通过模型的 schema 校验,或指定的模型与路径中的模型不一致。
+ 估算请求体未通过模型 schema 的校验,或者指定的模型与路径中的模型不同。
响应体:[`RouterValidationErrorResponse`](#routervalidationerrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
- Router 暂时不可用。请以退避方式重试。
+ Router 暂时不可用。请退避重试。
- 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(仅限容量拒绝时)
+ 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(仅容量拒绝时)
### `GET /v2/models/{provider}/{model}/openapi.json`
-**以 OpenAPI 文档形式读取单个合作伙伴模型的输入和输出 Schema。**
+**以 OpenAPI 文档的形式读取一个合作伙伴模型的输入和输出 schema。**
-以独立的 OpenAPI 文档形式读取单个模型的输入和输出 Schema。
+以独立的 OpenAPI 文档形式读取一个模型的输入和输出 schema。
**参数**
规范 `{provider}/{model}` 模型 ID 中的提供商部分。
- 类型:[`RouterProviderSegment`](#routerprovidersegment),字母数字短标识,例如 `anthropic`,最多 64 个字符
+ 类型:[`RouterProviderSegment`](#routerprovidersegment):字母数字 slug,例如 `anthropic`,最多 64 个字符
规范 `{provider}/{model}` 模型 ID 中的模型部分。
- 类型:[`RouterModelSegment`](#routermodelsegment),字母数字短标识,例如 `claude-opus-4-6`,最多 128 个字符
+ 类型:[`RouterModelSegment`](#routermodelsegment):字母数字 slug,例如 `claude-opus-4-6`,最多 128 个字符
- 调用方此前从 `200` 响应中获取的 `ETag`。
+ 调用方从先前的 `200` 响应中持有的 `ETag`。
**响应**
- OK - 该模型的输入和输出 Schema,以独立的 OpenAPI 文档形式呈现。
+ OK:该模型的输入和输出 schema,作为独立的 OpenAPI 文档。
- 响应体:[`RouterModelInputSchemaDocument`](#routermodelinputschemadocument) - 响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control`
+ 正文:[`RouterModelInputSchemaDocument`](#routermodelinputschemadocument);响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control`
- Not Modified - 自调用方在 `If-None-Match` 中发送的 `ETag` 以来,文档未发生变化。
+ 未修改:自调用方在 `If-None-Match` 中发送的 `ETag` 以来,文档未发生变化。
响应头:`X-Comfy-Request-Id`、`ETag`、`Cache-Control`
@@ -424,165 +423,164 @@ Comfy API 密钥也可以作为 Bearer token 发送。当同时提供两个凭
凭据缺失或无效。
- 响应体:[`RouterErrorResponse`](#routererrorresponse) - 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 正文:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
- 该调用方或该模型不允许发起此请求。
+ 不允许此调用方或模型发起该请求。
- 响应体:[`RouterErrorResponse`](#routererrorresponse) - 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 正文:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
未找到该模型 ID。
- 响应体:[`RouterErrorResponse`](#routererrorresponse) - 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 正文:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
Router 无法完成该请求。
- 响应体:[`RouterErrorResponse`](#routererrorresponse) - 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 正文:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
Router 暂时不可用。请使用退避策略重试。
- 响应体:[`RouterErrorResponse`](#routererrorresponse) - 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 正文:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
### `POST /v2/models/{provider}/{model}/requests`
-**将合作伙伴模型运行任务提交到队列并立即返回。**
+**将合作伙伴模型运行提交到队列并立即返回。**
-Comfy Router 的队列投递模式。请求体与该模型的 `POST /v2/models/{provider}/{model}` 所接受的合作伙伴原生 JSON 输入相同:同一请求体形状、同一套按模型定义的 schema、两种投递模式,但此路由不会保持连接来等待结果。它会接纳该运行任务,返回 `201` 和一个句柄,调用方随后通过下文所述的三个读取操作获取结果。
+Comfy Router 的队列投递模式。请求体与该模型通过 `POST /v2/models/{provider}/{model}` 接受的合作伙伴原生 JSON 输入相同,即一种请求体形状、一套按模型的 schema、两种投递模式,但此路由不会为等待结果而保持连接。它接纳该次运行,用 `201` 和一个句柄作答,调用方随后通过下面三个读取接口获取结果。
**参数**
- 规范 `{provider}/{model}` 模型 ID 中的小写提供商段,即运行其模型的合作伙伴。
+ 规范 `{provider}/{model}` 模型 ID 中的小写提供商段,即正在运行其模型的合作伙伴。
- 类型:[`RouterProviderSegment`](#routerprovidersegment):字母数字 slug,例如 `anthropic`,最多 64 个字符
+ 类型:[`RouterProviderSegment`](#routerprovidersegment),字母数字短标识,例如 `anthropic`,最多 64 个字符
- 规范 `{provider}/{model}` 模型 ID 中的小写模型段,即在该提供商内要运行的模型。
+ 规范 `{provider}/{model}` 模型 ID 中的小写模型段,即要在该提供商内运行的模型。
- 类型:[`RouterModelSegment`](#routermodelsegment):字母数字 slug,例如 `claude-opus-4-6`,最多 128 个字符
+ 类型:[`RouterModelSegment`](#routermodelsegment),字母数字短标识,例如 `claude-opus-4-6`,最多 128 个字符
- 选择用于服务此模型的备用提供商,而不是其当前默认提供商。
+ 选择一个替代提供商来服务该模型,而不是使用其当前的默认提供商。
仅在与 `model_provider` 一起使用时才有意义。
- 默认值:False
+ 默认:False
- 调用方生成的键,可确保重试同一次逻辑调用是安全的。
+ 由调用方生成的键,使重试同一次逻辑调用是安全的。
1–255 个字符
- 选择拒绝此模型输入 schema 未声明的顶层请求体字段,而不是接受该字段;不会检查嵌套字段,并且对于其 schema 允许未声明字段或没有已编写 schema 的模型,或者对于使用 `strict_mode=true` 发送的队列提交,不会拒绝任何字段。
+ 选择拒绝该模型输入 schema 未声明的顶层请求体字段,而不是接受它;不会检查嵌套字段,并且对于 schema 允许未声明字段或没有编写 schema 的模型,以及使用 `strict_mode=true` 发送的队列提交,都不会拒绝任何字段。
- 默认值:False
+ 默认:False
**请求体**
-`application/json`:[`RouterModelInput`](#routermodelinput)(必填)
+`application/json`,[`RouterModelInput`](#routermodelinput)(必填)
-合作伙伴模型的原生 JSON 输入,与同步路由为此模型接受的请求体相同,并且它决定所执行的操作,也按相同方式计费:请求体自身的字段决定 Router 在支持多种操作的模型上运行哪种操作(输入图像会将可编辑图像模型切换为图生图,这可能按单独费率计费;Seedance 的首帧图像会选择图生视频,而参考图像或视频片段会选择参考生视频)。在原生调度时,Seedance 请求按 `content` 中的媒体种类计费,而不是按角色计费:任何视频输入都按视频转视频计费,否则任何图像都按图生视频计费,再否则按文生视频计费;例外是,来自 `draft_task` 项的最终渲染按其渲染的 Draft 对应的操作计费,某些模型对文生视频和图生视频收取相同费率;当 `model_provider` 选择备用提供商时,每种带条件的操作可能会按该提供商自身的费率计费。相同的提供商选择约定在调度时同样适用:未提供 `model_provider`,或提供 `model_provider` 且 `strict_mode=false`(默认值)时,请求体是模型的原生文档,并会在接纳运行任务之前依据模型自身的输入 schema 进行验证,因此模型会拒绝的请求体会在此处返回 `422`,而不是变成一个几分钟后才失败的排队请求;非严格模式下的备用提供商请求体还会在调度时转换为该提供商实际的 schema。使用 `strict_mode=true` 时,请求体必须已经是备用提供商自身的 schema,并会原样转发:跳过原生 schema 验证,与同步路由完全一致(参见 `model_provider` 和 `strict_mode`)。
+合作伙伴模型的原生 JSON 输入,与此模型在同步路由上接受的请求体完全相同,它同时决定所执行的操作,并按相同方式计费:请求体自身的字段决定 Router 在支持多种操作的模型上运行哪种操作(输入图像会把可编辑图像模型切换为图生图,这可能按单独的费率计费;Seedance 的首帧图像会选择图生视频,而参考图像或参考视频片段会选择参考生视频)。在原生调度下,Seedance 请求按 `content` 中的媒体类型计费,而不是按角色计费:任何视频输入都按视频转视频计费,否则任何图像按图生视频计费,再否则按文生视频计费;例外是,由 `draft_task` 项生成的最终渲染按其所渲染 Draft 的操作计费;某些模型对文生视频和图生视频收取相同费率;当 `model_provider` 选择了替代提供商时,每个带条件的操作都可能按该提供商自己的费率计费。同一套提供商选择约定也适用于调度:在没有 `model_provider`,或提供了 `model_provider` 且 `strict_mode=false`(默认值)时,请求体就是模型的原生文档,并在接纳该次运行之前根据模型自身的输入 schema 进行验证,因此模型会拒绝的请求体在这里会得到 `422`,而不是变成一个几分钟后才失败的队列请求;非严格模式下使用替代提供商的请求体还会在调度时被转换为该提供商真正的 schema。当 `strict_mode=true` 时,请求体必须已经是替代提供商自己的 schema,并会被原样转发:原生 schema 的验证会被跳过,与同步路由完全一致(参见 `model_provider` 和 `strict_mode`)。
**响应**
- 已创建:运行任务已获准进入队列。
+ 已创建:该次运行已被接纳到队列。
- 响应体:[`RouterQueueSubmitResponse`](#routerqueuesubmitresponse):响应头:`X-Comfy-Request-Id`、`Idempotent-Replayed`
+ 响应体:[`RouterQueueSubmitResponse`](#routerqueuesubmitresponse),响应头:`X-Comfy-Request-Id`、`Idempotent-Replayed`
- 凭证缺失或无效。
+ 凭据缺失或无效。
- 响应体:[`RouterErrorResponse`](#routererrorresponse):响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 响应体:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
请求无效。请检查错误类型和请求体。
- 响应体:[`RouterErrorResponse`](#routererrorresponse):响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 响应体:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
请求体过大。
- 响应体:[`RouterErrorResponse`](#routererrorresponse):响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 响应体:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
- Router 请求级失败:请求从未到达模型,或由于模型自身未反馈的原因而失败。
+ Router 请求级失败:请求从未到达模型,或失败原因模型本身并未反馈。
- 响应体:[`RouterErrorResponse`](#routererrorresponse):响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 响应体:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
- 此调用方或模型不允许该请求。对于合作伙伴直接以字节形式返回生成结果的模型,目前尚不能排队,并会以 `not_enabled` 拒绝;请改为在同步路由上运行。
+ 该调用方或该模型不允许此请求。如果某个模型的合作伙伴直接以字节返回生成结果,则该模型目前无法进入队列,会以 `not_enabled` 拒绝;请改用同步路由运行它。
- 响应体:[`RouterErrorResponse`](#routererrorresponse):响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 响应体:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
- 未找到模型 ID。
+ 未找到该模型 ID。
- 响应体:[`RouterErrorResponse`](#routererrorresponse):响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 响应体:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
-
- Check `X-Comfy-Error-Type`:`concurrency_limit_exceeded` 表示原始调用仍在运行,因此请等待 `Retry-After` 并复用同一个 key;`invalid_input` 则需要使用新 key。此路由上的两个 `invalid_input` 冲突与 key 完全无关,且任何新 key 都无法消除其中任何一个:当请求正文选择该提供商针对此模型的转换器无法处理的多部分操作(编辑)时,指定备用提供商的 `model_provider` 会被拒绝,其 `detail` 以 "this request's `image` selects the edit operation" 开头;之后还会检查另一种情况,即当请求已经为路径中的提供商解析出自带密钥(BYOK)凭证时,其 `detail` 以 `this request resolved a BYOK credential` 开头。请去掉 `model_provider`,或在发送请求时不带 BYOK 凭证,并且(对于多部分情形)不带编辑操作。
+检查 `X-Comfy-Error-Type`:`concurrency_limit_exceeded` 表示原始调用仍在运行,因此请等待 `Retry-After` 指定的时间并复用同一个键;`invalid_input` 则需要使用新的键。此路由上的两种 `invalid_input` 冲突都与该键无关,且任何新的键都无法消除其中任何一种:当请求体选择的是该提供商针对此模型的转换器无法处理的 multipart 操作(编辑)时,用 `model_provider` 指定替代提供商会被拒绝,其 `detail` 以 "this request's `image` selects the edit operation" 开头;而在之后检查的另一种情况是,请求已为路径中的提供商解析出自带密钥(BYOK)凭据,其 `detail` 以 `this request resolved a BYOK credential` 开头。请去掉 `model_provider`,或不携带 BYOK 凭据发送请求,并且(针对 multipart 的情况)不携带编辑操作。
- 正文:[`RouterErrorResponse`](#routererrorresponse)。头部:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(当 `concurrency_limit_exceeded` 时)
+ 请求体:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(当出现 `concurrency_limit_exceeded` 时)
- 请求内容未通过模型的 schema 校验。
+ 请求内容未通过模型 schema 的校验。
- 正文:[`RouterValidationErrorResponse`](#routervalidationerrorresponse)。头部:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Idempotent-Replayed`
+ 请求体:[`RouterValidationErrorResponse`](#routervalidationerrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Idempotent-Replayed`
- 检查 `X-Comfy-Error-Type`:`queue_backlog_full` 表示你持有的未完成排队请求已达到允许的上限,因此请在其中一个完成后再次提交;`rate_limited` 表示需要等待配额窗口。
+ 检查 `X-Comfy-Error-Type`:`queue_backlog_full` 表示你持有的未完成排队请求数已达到允许的上限,因此请等其中一个完成后再提交;`rate_limited` 表示需要等待配额窗口结束。
- 正文:[`RouterErrorResponse`](#routererrorresponse)。头部:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 请求体:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
- Router 暂时不可用。请使用退避策略重试。
+ Router 暂时不可用。请使用退避方式重试。
- 正文:[`RouterErrorResponse`](#routererrorresponse)。头部:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(仅容量拒绝时)
+ 请求体:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`、`Retry-After`(仅容量拒绝时)
### `GET /v2/models/{provider}/{model}/requests/{request_id}`
**收集一个已提交请求的结果。**
-收集端点。对于已成功完成的请求,它返回合作伙伴模型自身的原生输出,与同步路由的 `200` 针对同一模型和同一输入返回的内容逐字节相同,因此两种交付模式产生同一种结果形状,调用方无需第二个解析器即可在两者之间切换。
+收集端点。对于已成功完成的请求,它返回合作伙伴模型自身的原生输出,与同步路由的 `200` 对同一模型和同一输入所承载的内容逐字节一致,因此两种交付模式产生同一种结果形状,调用方无需第二个解析器即可在两者之间切换。
**参数**
- 规范 `{provider}/{model}` 模型 ID 的小写提供商段,即正在运行其模型的合作伙伴。
+ 规范 `{provider}/{model}` 模型 ID 中的小写提供商段,即正在运行其模型的合作伙伴。
类型:[`RouterProviderSegment`](#routerprovidersegment),字母数字 slug,例如 `anthropic`,最多 64 个字符
- 规范 `{provider}/{model}` 模型 ID 的小写模型段,即在该提供商内运行的模型。
+ 规范 `{provider}/{model}` 模型 ID 中的小写模型段,即在该提供商内运行的模型。
类型:[`RouterModelSegment`](#routermodelsegment),字母数字 slug,例如 `claude-opus-4-6`,最多 128 个字符
@@ -596,7 +594,7 @@ Comfy Router 的队列投递模式。请求体与该模型的 `POST /v2/models/{
**响应**
- OK:为产生了结果的请求存储的结果。该请求已成功完成,或是同时带有记录扣费和存储结果的终端请求。它按合作伙伴自己的媒体类型原样返回,与同步路由的 `200` 返回它的方式完全一致,并遵循提交时接受的相同提供商选择约定:未提供 `model_provider`,或提供 `model_provider` 且 `strict_mode=false`(默认值,在可能时转换回此模型的原生约定,转换失败时回退到备用提供商自己的原始响应,并记录日志,绝不静默),形状为此模型自身的原生输出;使用 `strict_mode=true` 时,则是备用提供商的响应原样返回。对于合作伙伴直接以字节返回生成结果的模型,响应体是这些字节,使用合作伙伴自己的 `Content-Type` 而非 `application/json`;请根据响应的 `Content-Type` 进行分支,不要假定它是 JSON 文档。
+ OK:对于产生了结果的请求,返回为其存储的结果;这类请求可以是成功完成的请求,也可以是同时带有已记录扣费和已存储结果的终端请求。结果以合作伙伴自身的媒体类型原样返回,与同步路由的 `200` 返回该结果时完全一致,并遵循提交时接受的相同提供商选择约定:未提供 `model_provider`,或提供 `model_provider` 且 `strict_mode=false`(默认值,在可能时转换回该模型的原生约定;转换失败时回退到备用提供商自身的原始响应,并记录日志,绝不静默处理)时,形状为该模型自身的原生输出;当 `strict_mode=true` 时,则为原样返回的备用提供商响应。对于合作伙伴直接以字节形式返回生成结果的模型,响应体是这些字节,使用合作伙伴自身的 `Content-Type`,而不是 `application/json`;请根据响应的 `Content-Type` 进行分支判断,不要假定响应是 JSON 文档。
响应体:[`RouterModelOutput`](#routermodeloutput) 或原始字节(`*/*`);响应头:`X-Comfy-Request-Id`、`X-Content-Type-Options`、`X-Comfy-Credits-Used`
@@ -608,7 +606,7 @@ Comfy Router 的队列投递模式。请求体与该模型的 `POST /v2/models/{
- 缺失或无效的凭据。
+ 凭据缺失或无效。
响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
@@ -626,7 +624,7 @@ Comfy Router 的队列投递模式。请求体与该模型的 `POST /v2/models/{
- Router 请求级失败:请求从未到达模型,或由于模型本身未报告的原因而失败。
+ Router 请求级失败:请求从未到达模型,或由于模型自身未反馈的原因而失败。
响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
@@ -638,7 +636,7 @@ Comfy Router 的队列投递模式。请求体与该模型的 `POST /v2/models/{
- 请求处于与操作冲突的状态。请检查错误类型。
+ 请求处于与该操作冲突的状态。请检查错误类型。
响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
@@ -650,7 +648,7 @@ Comfy Router 的队列投递模式。请求体与该模型的 `POST /v2/models/{
- Router 请求级失败:请求从未到达模型,或由于模型本身未报告的原因而失败。
+ Router 请求级失败:请求从未到达模型,或由于模型自身未反馈的原因而失败。
响应体:[`RouterErrorResponse`](#routererrorresponse);响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
@@ -659,7 +657,7 @@ Comfy Router 的队列投递模式。请求体与该模型的 `POST /v2/models/{
**请求取消一个已提交的请求。**
-请求 Comfy 停止一个尚未完成的请求。这是一项请求,而不是保证,`202` 正说明了这一点:`CANCELLATION_REQUESTED` 表示该请求已被接受,并不表示运行已经停止。已经发送给合作伙伴的运行仍可能完成;而合作伙伴完成的生成会被计费,无论是否有人获取结果。因此,需要了解实际结果的调用方应随后读取状态端点,在状态端点中,已生效的取消会显示为 `COMPLETED`,并像其他所有终端结果一样带有 `error_type`。
+请求 Comfy 停止一个尚未完成的请求。这只是一个请求,而不是保证,`202` 正是这个意思:`CANCELLATION_REQUESTED` 表示该请求已被接受,而不是运行已经停止。已经在合作伙伴处开始执行的运行仍可能完成,而完成的合作伙伴生成会被计费,无论是否有人收取结果,因此,需要了解实际发生了什么的调用方随后应读取状态端点,在那里,生效的取消是 `COMPLETED`,并像其他任何终端结果一样携带 `error_type`。
**参数**
@@ -670,13 +668,13 @@ Comfy Router 的队列投递模式。请求体与该模型的 `POST /v2/models/{
- 规范 `{provider}/{model}` 模型 ID 中的小写模型段,即要在该提供商内运行的模型。
+ 规范 `{provider}/{model}` 模型 ID 中的小写模型段,即该提供商内要运行的模型。
类型:[`RouterModelSegment`](#routermodelsegment),字母数字 slug,例如 `claude-opus-4-6`,最多 128 个字符
- 要处理的排队请求,即提交操作在响应正文中返回的 `request_id`。
+ 要处理的排队请求,即提交时在响应体中返回的 `request_id`。
类型:[`RouterQueueRequestId`](#routerqueuerequestid),`pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`,uuid,最多 36 个字符
@@ -686,122 +684,122 @@ Comfy Router 的队列投递模式。请求体与该模型的 `POST /v2/models/{
已接受:`CANCELLATION_REQUESTED`。
- 正文:[`RouterQueueCancelResponse`](#routerqueuecancelresponse),响应头:`X-Comfy-Request-Id`
+ 响应体:[`RouterQueueCancelResponse`](#routerqueuecancelresponse),响应头:`X-Comfy-Request-Id`
冲突:`ALREADY_COMPLETED`。
- 正文:[`RouterQueueCancelResponse`](#routerqueuecancelresponse),响应头:`X-Comfy-Request-Id`
+ 响应体:[`RouterQueueCancelResponse`](#routerqueuecancelresponse),响应头:`X-Comfy-Request-Id`
- 无效请求。请检查错误类型和请求正文。
+ 无效请求。请检查错误类型和请求体。
- 正文:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 响应体:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
- 凭据缺失或无效。
+ 缺少或无效的凭证。
- 正文:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 响应体:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
- 该调用方或模型不允许此请求。
+ 该调用方或模型不允许执行此请求。
- 正文:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 响应体:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
未找到该模型 ID。
- 正文:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 响应体:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
- Router 暂时不可用。请使用退避策略重试。
+ Router 暂时不可用。请使用退避重试。
- 正文:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 响应体:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
- Router 请求级失败:请求从未到达模型,或由于模型本身未反馈的原因而失败。
+ Router 请求级失败:请求从未到达模型,或因模型本身未反馈的原因而失败。
- 正文:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 响应体:[`RouterErrorResponse`](#routererrorresponse),响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
### `GET /v2/models/{provider}/{model}/requests/{request_id}/status`
-**读取一个已提交请求的队列状态。**
+**读取单个已提交请求的队列状态。**
-轮询端点。它返回的是请求当前的状态,而非结果,因此客户端可以持续观察一次长时间生成,而无须在每次轮询时都传输其输出。当此端点返回 `COMPLETED` 时,再从下方的读取接口一次性获取结果。
+轮询端点。它返回请求的当前状态,而从不返回结果,因此客户端可以持续观察长时间生成的进度,而无需在每次轮询时传输输出。当此端点返回 `COMPLETED` 时,再从下方的读取中一次性获取结果。
**参数**
- 规范 `{provider}/{model}` 模型 ID 中的小写提供商标识段,即正在运行其模型的合作伙伴。
+ 规范 `{provider}/{model}` 模型 ID 中的小写提供商段,即实际运行其模型的合作伙伴。
- 类型:[`RouterProviderSegment`](#routerprovidersegment)。字母数字标识,例如 `anthropic`,最多 64 个字符
+ 类型:[`RouterProviderSegment`](#routerprovidersegment) -- 字母数字 slug,例如 `anthropic`,最多 64 个字符
- 规范 `{provider}/{model}` 模型 ID 中的小写模型标识段,即在该提供商下要运行的模型。
+ 规范 `{provider}/{model}` 模型 ID 中的小写模型段,即在该提供商下要运行的模型。
- 类型:[`RouterModelSegment`](#routermodelsegment)。字母数字标识,例如 `claude-opus-4-6`,最多 128 个字符
+ 类型:[`RouterModelSegment`](#routermodelsegment) -- 字母数字 slug,例如 `claude-opus-4-6`,最多 128 个字符
- 要查询的排队请求,即提交时在响应体中返回的 `request_id`。
+ 要查询的排队请求,即提交时响应体中返回的 `request_id`。
- 类型:[`RouterQueueRequestId`](#routerqueuerequestid)。`pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`,uuid,最多 36 个字符
+ 类型:[`RouterQueueRequestId`](#routerqueuerequestid) -- `pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$`,uuid,最多 36 个字符
**响应**
- OK,请求当前的队列状态。
+ OK - 请求当前的队列状态。
- 正文:[`RouterQueueStatusResponse`](#routerqueuestatusresponse)。请求头:`X-Comfy-Request-Id`、`Retry-After`、`X-Comfy-Credits-Used`、`X-Comfy-Estimated-Duration-Seconds`、`X-Comfy-Estimated-Duration-P90-Seconds`、`X-Comfy-Estimate-Source`
+ 响应体:[`RouterQueueStatusResponse`](#routerqueuestatusresponse) -- 响应头:`X-Comfy-Request-Id`、`Retry-After`、`X-Comfy-Credits-Used`、`X-Comfy-Estimated-Duration-Seconds`、`X-Comfy-Estimated-Duration-P90-Seconds`、`X-Comfy-Estimate-Source`
- 凭据缺失或无效。
+ 凭证缺失或无效。
- 正文:[`RouterErrorResponse`](#routererrorresponse)。请求头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
- 该调用方或模型无权执行此请求。
+ 该请求不允许由此调用方或模型执行。
- 正文:[`RouterErrorResponse`](#routererrorresponse)。请求头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
未找到该模型 ID。
- 正文:[`RouterErrorResponse`](#routererrorresponse)。请求头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
- Router 请求级失败:请求从未到达模型,或因模型自身未反馈的原因而失败。
+ Router 请求级失败:请求从未到达模型,或因模型本身未反馈的原因而失败。
- 正文:[`RouterErrorResponse`](#routererrorresponse)。请求头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
- Router 暂时不可用。请以退避方式重试。
+ Router 暂时不可用。请退避后重试。
- 正文:[`RouterErrorResponse`](#routererrorresponse)。请求头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
- Router 请求级失败:请求从未到达模型,或因模型自身未反馈的原因而失败。
+ Router 请求级失败:请求从未到达模型,或因模型本身未反馈的原因而失败。
- 正文:[`RouterErrorResponse`](#routererrorresponse)。请求头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
+ 响应体:[`RouterErrorResponse`](#routererrorresponse) -- 响应头:`X-Comfy-Error-Type`、`X-Comfy-Request-Id`
-此处的描述较为简短。有关模型选择、验证、重试和计费,请参阅[使用 Comfy Router API](/zh/development/comfy-router/api);有关请求头行为,请参阅[请求头](/zh/development/comfy-router/headers)。
+此处描述较为简短。关于模型选择、验证、重试和计费,请参阅[使用 Comfy Router API](/zh/development/comfy-router/api);关于响应头行为,请参阅[响应头](/zh/development/comfy-router/headers)。
## 错误分类桶
@@ -967,41 +965,41 @@ Router 错误的机器可读类别,同时也会在 `X-Comfy-Error-Type` 响应
调用方仍可启动的昂贵模型调用数;在 `429` 时为 `0`。
-## 预检成本估算
+## 运行前成本估算
-`POST /v2/models/{provider}/{model}/estimate` 会在不实际运行的情况下为一个请求体定价,而排队提交(`POST /v2/models/{provider}/{model}/requests`)会在其 `201` 响应中返回与 `estimate` 相同的 [`RouterCostEstimate`](#routercostestimate)。两者都依据 Comfy 对该次运行计费所采用的费率卡定价,唯一的例外是按供应商上报成本计费的模型,其价格取自供应商公布的价格表,标记为 `estimated`。返回的每个数字都是估算值,而非最终费用:最终以你工作区用量与账单记录中的结算费用为准。使用自有提供商密钥的运行不由 Comfy 计费(见下文)。在估算功能逐步推出期间,该路由会返回 `403`,并带有 `error_type: not_enabled`,且提交响应会省略 `estimate`。模型目录中仍然不包含价格。
+`POST /v2/models/{provider}/{model}/estimate` 会在不运行的情况下为一个请求体定价,而排队提交(`POST /v2/models/{provider}/{model}/requests`)会在其 `201` 响应中返回与 `estimate` 相同的 [`RouterCostEstimate`](#routercostestimate)。二者都依据 Comfy 为该次运行计费时所使用的费率卡定价,例外是按供应商报告的成本计费的模型,此类模型依据供应商公布的价格表给出 `estimated`。两者返回的任何数字都是估算值,而不是最终费用:以你工作区的用量和账单记录中的结算费用为准。使用你自己的提供商密钥的运行不由 Comfy 计费(见下文)。在估算功能逐步推出期间,该路由会返回 `403` 并附带 `error_type: not_enabled`,而提交响应会省略 `estimate`。目录中仍然不包含任何价格。
-在关注任何金额之前,请先读取 `source`。缺失的数值绝不意味着免费。
+在查看任何金额之前先读取 `source`。缺失的数字绝不意味着免费。
-| `source` | 携带内容 | 如何解读 |
+| `source` | 携带的字段 | 如何解读 |
| --- | --- | --- |
-| `exact` | `amount`、`amount_cents`、`credits` | 一个估算值,等于该请求体按 `pricing_as_of` 中所列费率应收取的费用;最终以你工作区用量与账单记录中的结算费用为准。 |
-| `estimated` | `min_amount`、`max_amount` 及其 `_cents` 形式,不含 `amount` | 一个估算值,其费用取决于提供商回传的某个数量,而请求体为该数量给出了边界;预期费用落在该边界之间,最终以你工作区用量与账单记录中的结算费用为准。 |
-| `free` | `amount` "0",`amount_cents` 与 `credits` 为 `0` | 费率卡将该请求定价为零,因此估算值为 `0`;最终以你工作区用量与账单记录中的结算费用为准。只有 `free` 报价才读作 `0`。 |
-| `unknown` | `reason`,不含任何数值 | 运行前无法给出价格。将任何其他 `source` 值都视为 `unknown`。 |
+| `exact` | `amount`、`amount_cents`、`credits` | 等于按 `pricing_as_of` 中的费率对该请求体计费的估算值;以你工作区的用量和账单记录中的结算费用为准。 |
+| `estimated` | `min_amount`、`max_amount` 及其 `_cents` 形式,没有 `amount` | 费用取决于供应商回报的某个量的估算值,而请求体为其设定了边界;预期费用落在该边界之内,以你工作区的用量和账单记录中的结算费用为准。 |
+| `free` | `amount` 为 "0",`amount_cents` 和 `credits` 为 `0` | 费率卡将此次请求定价为零,因此估算值为 `0`;以你工作区的用量和账单记录中的结算费用为准。只有 `free` 的报价才会显示 `0`。 |
+| `unknown` | `reason`,没有数字 | 在运行之前无法给出价格。任何其他 `source` 值都视为 `unknown`。 |
-`unknown` 估算的 `reason` 为以下之一:
+`unknown` 估算值的 `reason` 为以下之一:
-- `not_quotable`:Router 无法在运行前为这次调用定价,因为它按提供商回传、而请求体未加限定的数量计费,或者请求体无法按其发送的内容定价。将任何无法识别的 `reason` 都视为 `not_quotable`。
-- `unpriced_model`:费率卡未对该请求定价。
-- `byok`(仅排队提交):该次运行使用你自己的提供商密钥,因此 Comfy 不为其计费。
-- `pricing_unavailable`(仅排队提交):请求被接受时无法读取费率卡。提交仍会被接受,运行照常计费。
+- `not_quotable`:路由器无法在运行前为此调用定价,因为它的计费基于供应商回报的某个量,而请求体并未为其设定边界;或者无法对按原样发送的请求体定价。任何无法识别的 `reason` 都视为 `not_quotable`。
+- `unpriced_model`:费率卡没有为此请求定价。
+- `byok`(仅排队提交):该次运行使用你自己的提供商密钥,因此 Comfy 不为其收取任何费用。
+- `pricing_unavailable`(仅排队提交):在请求被接纳时无法读取费率卡。提交仍会被接受,运行也照常计费。
-Router 尚无法在运行前定价的模型列在[没有预检估算的模型](/zh/development/comfy-router/limitations#无法预先估算的模型)中。未列在该处的模型针对特定请求体仍可能返回 `unknown`,因此请对每个估算都读取 `source`。
+路由器目前还无法在运行前定价的模型列在[无法在运行前估算的模型](/zh/development/comfy-router/limitations#无法预先估算的模型)中。未列在该处的模型针对某个特定请求体仍可能返回 `unknown`,因此请对每个估算值都读取 `source`。
-估算采用失败关闭(fail closed)的情形:
+估算的失败关闭行为如下:
-- 当某个数值需要费率卡,而费率卡未加载或已过期时,`/estimate` 会返回 `503`,而不是给出猜测。排队提交绝不会因为其估算而被拒绝;它会携带 `source: unknown` 和 `reason: pricing_unavailable`。完全无法在运行前定价的调用(`not_quotable`),或使用自有提供商密钥的排队提交(`byok`),会在不读取费率卡的情况下作答,因此那个 `200` 并不说明费率卡是否最新。
-- `/estimate` 会像默认运行那样,按模型自身的输入 schema 校验请求体,因此不符合模型 schema 的请求体会得到与该次运行相同的 `422`,以及相同的 `detail[]` 形状。此时不会定价,也不会派发。
-- 排队提交的幂等重放(`Idempotent-Replayed: true`)会省略 `estimate`,因为原始报价未被存储。
+- 当某个数字需要费率卡,而卡片未加载或已过期时,`/estimate` 会返回 `503`,而不是给出猜测。排队提交绝不会因为其估算而被拒绝;它会改为携带 `source: unknown` 和 `reason: pricing_unavailable`。完全无法在运行前定价的调用(`not_quotable`),或使用你自己的提供商密钥的排队提交(`byok`),会在不读取费率卡的情况下得到响应,因此该 `200` 并不能说明卡片是否为最新。
+- `/estimate` 会像默认运行那样,依据模型自身的输入 schema 校验请求体,因此不符合模型 schema 的请求体会得到与运行相同的 `422`,`detail[]` 形状也相同。不会进行任何定价或派发。
+- 排队提交的幂等重放(`Idempotent-Replayed: true`)会省略 `estimate`,因为原始报价不会被存储。
-估算的局限。一个 `200` 的数字并不代表该次运行一定会被接受,也不代表一定按该金额收费:
+估算的局限。`200` 返回的数字并不承诺该次运行会被接受,也不承诺会正好按此金额计费:
-- `/estimate` 不接受 `strict_mode` 或 `reject_unknown_fields`,因此只校验模型的原生约定:一个在 `strict_mode=true` 运行中按备用提供商自身 schema 可以接受的请求体,在这里可能得到 `422`;而某个未声明的顶层字段,在 `reject_unknown_fields=true` 的运行中会被拒绝,在这里却会被定价。Anthropic Messages 模型是例外:其 schema 允许未声明字段,因此 `reject_unknown_fields=true` 的运行不会拒绝任何字段,而估算只会为未声明的顶层字段 `tools`、`tool_choice`、`temperature`、`top_p`、`top_k`、`stop_sequences`、`metadata`、`thinking` 以及空的 `mcp_servers` 定价。任何其他未声明的顶层字段都会使其返回 `unknown`,并带有 `reason: not_quotable`。
-- `pricing_as_of` 是费率卡的获取时间;对于取自供应商公布价格表的 `estimated` 报价,它是读取该价格表的日期(两者都未读取时,则为估算作答的时间)。它不是价格锁定:运行按其被计费评级时生效的费率收费。
-- `/estimate` 为 `model_provider` 指定的分支报价,或为原生提供商报价。它不接受 `fallback_provider` 或 `strict_mode` 参数。同步运行的回退重试落到另一个提供商时,按该提供商的费率计费,而该费率并非估算所报的费率;运行响应上的 `X-Comfy-Router-Fallback-Provider` 表明发生了这种情况。排队提交没有回退,因此其 `estimate` 报的就是实际运行的分支。
-- 对于 `model_provider` 分支上的同一请求体,或对于在同级操作(sibling operation)上运行的请求体,`/estimate` 与排队提交的 `estimate` 可能为略有差异的文档定价。提交的 `estimate` 是按运行实际发送的文档定价的。
-- `/estimate` 始终报出平台费用。使用自有提供商密钥的运行不由 Comfy 计费,但 `/estimate` 不会检测这一点,仍会返回一个数值;只有排队提交才会返回 `reason: byok`。- 美元金额由未舍入的美分渲染,最多保留 8 位小数,可计费的不足 1 美分的 `amount` 绝不会显示为 `0`。`credits` 为 `round(amount × 211, 2)`,这与 `X-Comfy-Credits-Used` 对一次收费所采用的换算相同,因此对于极小的非零价格,`credits` 可能舍入为 `0`;在这一点很重要时,请按 `amount` 或 `amount_cents` 编制预算,而不是按 `credits`。该响应头仍是某次运行结束后的事后数值;余额保存在 Comfy 平台上。
+- `/estimate` 不接受 `strict_mode` 或 `reject_unknown_fields`,因此它只检查模型的原生契约:某个请求体在 `strict_mode=true` 的运行中按备用提供商自身的 schema 可以通过,在这里却可能得到 `422`;而 `reject_unknown_fields=true` 的运行会拒绝的未声明顶层字段,在这里却会被定价。Anthropic Messages 模型是例外:其 schema 允许未声明字段,因此 `reject_unknown_fields=true` 的运行不会拒绝任何字段,估算只会为未声明的顶层字段 `tools`、`tool_choice`、`temperature`、`top_p`、`top_k`、`stop_sequences`、`metadata`、`thinking` 以及空的 `mcp_servers` 定价。任何其他未声明的顶层字段都会使其返回 `unknown` 和 `reason: not_quotable`。
+- `pricing_as_of` 是费率卡被获取的时间。取自供应商公布价格表的 `estimated` 报价会携带该价格表被读取的日期。计费数量依据供应商公布的费率表预测的 `exact` 或 `estimated` 报价,在该费率表的读取日期早于费率卡时,会携带该读取日期。既未读取费率卡也未读取费率表时,它是估算值被返回的时间。它不是价格锁定:运行会按其被计价时生效的费率计费。
+- `/estimate` 为 `model_provider` 指定的那一段(或原生提供商)报价。它不接受 `fallback_provider` 或 `strict_mode` 参数。同步运行的兜底重试如果落到另一个提供商,就会按该提供商的费率计费,而估算并未对此报价;运行响应中的 `X-Comfy-Router-Fallback-Provider` 会说明发生了这种情况。排队提交没有兜底,因此其 `estimate` 报价的就是实际运行的那一段。
+- 对于 `model_provider` 段上的同一个请求体,或对于在同级操作上运行的请求体,`/estimate` 与排队提交的 `estimate` 可能对略有差异的文档定价。提交的 `estimate` 是按运行实际发送的文档定价的。
+- `/estimate` 始终按平台费用报价。使用你自己的提供商密钥的运行不由 Comfy 计费,但 `/estimate` 不会检测到这一点,仍会返回一个数字;只有排队提交才会返回 `reason: byok`。- 美元金额由未舍入的美分换算渲染而来,最多保留 8 位小数,可计费的、不足一美分的 `amount` 绝不会显示为 `0`。`credits` 为 `round(amount × 211, 2)`,与 `X-Comfy-Credits-Used` 对一次扣费所采用的换算相同,因此当价格极小而并非为零时,`credits` 可能舍入为 `0`;在这种情况下,请以 `amount` 或 `amount_cents` 做预算,而不是 `credits`。该响应头仍是某次运行结束后的事后数值;余额保存在 Comfy 平台上。
## 结果资产
@@ -1014,7 +1012,7 @@ Router 尚无法在运行前定价的模型列在[没有预检估算的模型](/
| `minimax/*` | 已完成视频 | 12 小时 |
| `xai/*` | 每一张已生成的图像,以及已完成视频 | 24 小时 |
-这些有效期从 URL 签名时开始计算,而不是从你打开它时开始。缓存或重放的 URL 可能剩余时间更少;重放不会为其续期。请及时下载资产。只有每一行中列出的资产会被复制:`byteplus/seedream-*` 和 `byteplus/seededit-*` 图像不在 BytePlus 视频行的覆盖范围内。
+这些有效期从 URL 签名时开始计算,而不是从你打开它时开始。缓存或重放的 URL 可能剩余时间更少;重放不会为其续期。`Idempotency-Key` 记录的存在时间可能长于它所保存的 URL,因此从这类 URL 过期前一小时起,使用相同键的重试会得到 `409 invalid_input`,而不是已记录下来的响应;而在被返回时就已经如此接近过期的响应,仍可在 5 分钟内重放。请及时下载资产。只有每一行中列出的资产会被复制:`byteplus/seedream-*` 和 `byteplus/seededit-*` 图像不在 BytePlus 视频行的覆盖范围内。
复制只由模型的原生提供商执行。由替代提供商提供服务的运行(`model_provider` 指定了某个替代提供商,或原生运行的回退重试落到了替代提供商上,并通过 `X-Comfy-Router-Fallback-Provider` 披露)会返回该提供商自己的 URL,这些 URL 遵循提供商的过期时间,不会被复制。`model_provider` 取值 `default`、`comfy` 和 `comfyui` 时不指定替代提供商,因此这些运行属于原生运行并按上述方式复制;`model_provider` 运行的回退重试落回原生提供商时也同样如此。