API Pixverse PixVerse 5.5 transition | Preços e documentação

pixverse/pixverse/v5.5/transition

Transforme imagens inicial e final obrigatórias em um vídeo de transição controlável, com áudio opcional e ajustes precisos.

Índice

1. Introdução

Use a API RunComfy para executar pixverse/pixverse/v5.5/transition. Para entradas e saídas aceitas, consulte o esquema.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/pixverse/pixverse/v5.5/transition \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Scene slowly transition, a cat jump to the cake",
    "first_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7255/media-files/input-1-1.png",
    "end_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7255/media-files/input-1-2.png"
  }'

2. Autenticação

Defina a variável de ambiente YOUR_API_TOKEN com sua chave de API (gerenciamento no Perfil) e inclua em cada solicitação um token Bearer no cabeçalho Authorization : Authorization: Bearer $YOUR_API_TOKEN.

3. Referência da API

Enviar uma solicitação

Envie um trabalho de geração assíncrono e receba imediatamente um request_id e URLs para status, resultados e cancelamento.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/pixverse/pixverse/v5.5/transition \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Scene slowly transition, a cat jump to the cake",
    "first_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7255/media-files/input-1-1.png",
    "end_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7255/media-files/input-1-2.png"
  }'

Status da solicitação

Obtém o estado atual de um request_id ("in_queue", "in_progress", "completed" ou "cancelled").

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

Obter resultados

Obtém as saídas finais e metadados do request_id; se o trabalho não estiver concluído, a resposta retorna o estado atual para continuar o polling.

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

Cancelar solicitação

Cancela um trabalho na fila por request_id; trabalhos em andamento não podem ser cancelados.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. Arquivos de entrada

Arquivo hospedado (URL)

Forneça uma URL HTTPS publicamente acessível. O host deve permitir buscas no servidor (sem login/cookies), sem limite de taxa agressivo ou bloqueio de bots. Recomendado: imagens ≤ 50 MB (~4K), vídeos ≤ 100 MB (~2–5 min em 720p). Para ativos privados, URLs estáveis ou pré-assinadas.

5. Esquema

Esquema de entrada

{
  "type": "object",
  "title": "Esquema de entrada",
  "required": [
    "prompt",
    "first_image_url",
    "end_image_url"
  ],
  "properties": {
    "prompt": {
      "title": "Prompt",
      "description": "Instruções de texto obrigatórias que descrevem a transição, o movimento e os elementos a serem preservados.",
      "type": "string",
      "default": "Scene slowly transition, a cat jump to the cake"
    },
    "first_image_url": {
      "title": "Imagem inicial",
      "description": "URL da imagem necessária usada como primeiro quadro.",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7255/media-files/input-1-1.png"
    },
    "end_image_url": {
      "title": "Imagem final",
      "description": "URL da imagem necessária usada como último quadro.",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7255/media-files/input-1-2.png"
    },
    "aspect_ratio": {
      "title": "Proporção (L:A)",
      "description": "Proporção do vídeo. Os valores exatos são `16:9`, `4:3`, `1:1`, `3:4` e `9:16`.",
      "type": "string",
      "enum": [
        "16:9",
        "4:3",
        "1:1",
        "3:4",
        "9:16"
      ],
      "default": "16:9"
    },
    "resolution": {
      "title": "Resolução",
      "description": "Resolução de vídeo. Os valores exatos são `360p`, `540p`, `720p` e `1080p`.",
      "type": "string",
      "enum": [
        "360p",
        "540p",
        "720p",
        "1080p"
      ],
      "default": "720p"
    },
    "duration": {
      "title": "Duração",
      "description": "Duração do vídeo em segundos. Os valores exatos são 5, 8 e 10; `1080p` está limitado a 5 ou 8 segundos.",
      "type": "integer",
      "enum": [
        5,
        8,
        10
      ],
      "default": 5
    },
    "negative_prompt": {
      "title": "Prompt negativo",
      "description": "Texto opcional que descreve elementos ou artefatos a serem evitados.",
      "type": "string",
      "default": ""
    },
    "style": {
      "title": "Estilo",
      "description": "Predefinição de estilo. Os valores exatos são `anime`, `3d_animation`, `clay`, `comic` e `cyberpunk`.",
      "type": "string",
      "enum": [
        "anime",
        "3d_animation",
        "clay",
        "comic",
        "cyberpunk"
      ],
      "default": "anime"
    },
    "seed": {
      "title": "Seed",
      "description": "Semente inteira usada para comparações repetíveis.",
      "type": "integer",
      "default": 0
    },
    "generate_audio_switch": {
      "title": "Gerar áudio",
      "description": "Permite a geração de BGM, efeitos sonoros ou diálogos.",
      "type": "boolean",
      "default": false
    },
    "thinking_type": {
      "title": "Otimização do prompt",
      "description": "Modo de otimização de prompt: `enabled`, `disabled` ou `auto`.",
      "type": "string",
      "enum": [
        "enabled",
        "disabled",
        "auto"
      ],
      "default": "auto"
    }
  }
}

Esquema de saída

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "URL de imagem única"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "URL de vídeo único"
      },
      "images": {
        "type": "array",
        "description": "várias URLs de imagem",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "várias URLs de vídeo",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}

RunComfy

RunComfy é a principal ComfyUI plataforma, oferecendo ComfyUI online ambiente e serviços, juntamente com fluxos de trabalho do ComfyUI apresentando visuais impressionantes. RunComfy também oferece AI Models, permitindo que artistas utilizem as mais recentes ferramentas de AI para criar arte incrível.

1. Introdução

Use a API RunComfy para executar pixverse/pixverse/v5.5/transition. Para entradas e saídas aceitas, consulte o esquema.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/pixverse/pixverse/v5.5/transition \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Scene slowly transition, a cat jump to the cake",
    "first_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7255/media-files/input-1-1.png",
    "end_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7255/media-files/input-1-2.png"
  }'

3. Referência da API

Enviar uma solicitação

Envie um trabalho de geração assíncrono e receba imediatamente um request_id e URLs para status, resultados e cancelamento.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/pixverse/pixverse/v5.5/transition \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Scene slowly transition, a cat jump to the cake",
    "first_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7255/media-files/input-1-1.png",
    "end_image_url": "https://playgrounds-storage-public.runcomfy.net/tools/7255/media-files/input-1-2.png"
  }'

Status da solicitação

Obtém o estado atual de um request_id ("in_queue", "in_progress", "completed" ou "cancelled").

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

Obter resultados

Obtém as saídas finais e metadados do request_id; se o trabalho não estiver concluído, a resposta retorna o estado atual para continuar o polling.

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

Cancelar solicitação

Cancela um trabalho na fila por request_id; trabalhos em andamento não podem ser cancelados.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. Arquivos de entrada

Arquivo hospedado (URL)

5. Esquema

Esquema de entrada

{
  "type": "object",
  "title": "Esquema de entrada",
  "required": [
    "prompt",
    "first_image_url",
    "end_image_url"
  ],
  "properties": {
    "prompt": {
      "title": "Prompt",
      "description": "Instruções de texto obrigatórias que descrevem a transição, o movimento e os elementos a serem preservados.",
      "type": "string",
      "default": "Scene slowly transition, a cat jump to the cake"
    },
    "first_image_url": {
      "title": "Imagem inicial",
      "description": "URL da imagem necessária usada como primeiro quadro.",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7255/media-files/input-1-1.png"
    },
    "end_image_url": {
      "title": "Imagem final",
      "description": "URL da imagem necessária usada como último quadro.",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7255/media-files/input-1-2.png"
    },
    "aspect_ratio": {
      "title": "Proporção (L:A)",
      "description": "Proporção do vídeo. Os valores exatos são `16:9`, `4:3`, `1:1`, `3:4` e `9:16`.",
      "type": "string",
      "enum": [
        "16:9",
        "4:3",
        "1:1",
        "3:4",
        "9:16"
      ],
      "default": "16:9"
    },
    "resolution": {
      "title": "Resolução",
      "description": "Resolução de vídeo. Os valores exatos são `360p`, `540p`, `720p` e `1080p`.",
      "type": "string",
      "enum": [
        "360p",
        "540p",
        "720p",
        "1080p"
      ],
      "default": "720p"
    },
    "duration": {
      "title": "Duração",
      "description": "Duração do vídeo em segundos. Os valores exatos são 5, 8 e 10; `1080p` está limitado a 5 ou 8 segundos.",
      "type": "integer",
      "enum": [
        5,
        8,
        10
      ],
      "default": 5
    },
    "negative_prompt": {
      "title": "Prompt negativo",
      "description": "Texto opcional que descreve elementos ou artefatos a serem evitados.",
      "type": "string",
      "default": ""
    },
    "style": {
      "title": "Estilo",
      "description": "Predefinição de estilo. Os valores exatos são `anime`, `3d_animation`, `clay`, `comic` e `cyberpunk`.",
      "type": "string",
      "enum": [
        "anime",
        "3d_animation",
        "clay",
        "comic",
        "cyberpunk"
      ],
      "default": "anime"
    },
    "seed": {
      "title": "Seed",
      "description": "Semente inteira usada para comparações repetíveis.",
      "type": "integer",
      "default": 0
    },
    "generate_audio_switch": {
      "title": "Gerar áudio",
      "description": "Permite a geração de BGM, efeitos sonoros ou diálogos.",
      "type": "boolean",
      "default": false
    },
    "thinking_type": {
      "title": "Otimização do prompt",
      "description": "Modo de otimização de prompt: `enabled`, `disabled` ou `auto`.",
      "type": "string",
      "enum": [
        "enabled",
        "disabled",
        "auto"
      ],
      "default": "auto"
    }
  }
}

Esquema de saída

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "URL de imagem única"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "URL de vídeo único"
      },
      "images": {
        "type": "array",
        "description": "várias URLs de imagem",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "várias URLs de vídeo",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}

PixVerse 5.5 Transition: transição em vídeo entre duas imagens | RunComfy

Transforme imagens inicial e final obrigatórias em um vídeo de transição controlável, com áudio opcional e ajustes precisos.

Índice

1. Introdução

2. Autenticação

3. Referência da API

Enviar uma solicitação

Status da solicitação

Obter resultados

Cancelar solicitação

4. Arquivos de entrada

Arquivo hospedado (URL)

5. Esquema

Esquema de entrada

Esquema de saída

PixVerse 5.5 Transition: transição em vídeo entre duas imagens | RunComfy

Transforme imagens inicial e final obrigatórias em um vídeo de transição controlável, com áudio opcional e ajustes precisos.

Índice

1. Introdução

2. Autenticação

3. Referência da API

Enviar uma solicitação

Status da solicitação

Obter resultados

Cancelar solicitação

4. Arquivos de entrada

Arquivo hospedado (URL)

5. Esquema

Esquema de entrada

Esquema de saída