ToAPIs
    InícioToAPIs
    Geração de imagensGPT Image 2.6, Gemini, FLUX…Geração de vídeoSeedance, Veo, Kling, Sora…Chat e escritaGPT-5.6, Claude, DeepSeek…Voz e músicaLocuções, TTS, áudio
    NovidadeSeedance 2.5
    PreçosDocumentação da APIMCP
    BlogAlternativas
    EntrarComece grátis
    Todos os modelosPreçosDocumentação da APIMCPBlogAlternativas
    EntrarComece grátis

    Idioma

    Esc
    • Seedance 2.5Geração de vídeo
    • GPT Image 2Geração de imagens
    • GPT Image 2.6Geração de imagens
    • GPT Image 2.5Geração de imagens
    • Veo 3.1 FastGeração de vídeo
    • Kling 3.0 TurboGeração de vídeo
    • Kling V4 FlashGeração de vídeo
    • Grok Video 1.5Geração de vídeo
    • Nano Banana 2Geração de imagens
    • Seedream 5.5Geração de imagens
    • FLUXGeração de imagens
    • Sora 2Geração de vídeo
    • Todos os modelos de imagemCategoria
    • Todos os modelos de vídeoCategoria
    • GPT-5.6 SolChat e código
    • Claude Opus 4.8Chat e código
    • Claude Opus 4.7Chat e código
    • DeepSeek V4 ProDeepSeek · Texto
    • Gemini Omni 1.1 FlashGoogle · Multimodal

    suno: guia completo (Markdown) | ToAPIs

    Voltar ao guia do modelo

    Guia de modelos de API do suno

    Resumo

    • suno suporta Text-to-Video, Image-to-Video, R2V e Video Edit em um único fluxo.
    • Use esta página de guia do modelo para validar parâmetros com exemplos mínimos de requisição e resposta.
    • Estabilize primeiro os prompts aqui e depois passe para a integração com a API de produção.

    Capacidades principais

    • Testes unificados de vários modos:Alterne entre Text-to-Video, Image-to-Video, R2V e Video Edit em um mesmo lugar.
    • Validação centrada em parâmetros:Itere rapidamente sobre prompts, durações e referências antes do rollout em produção.
    • Passagem pronta para produção:Uma estrutura mínima de requisição e resposta ajuda a mover configurações estáveis para fluxos de API.

    Quando usar

    • Quando precisar de iteração rápida entre vários modos de geração.
    • Quando precisar validar parâmetros e tratamento de erros antes da integração.

    Quando não usar

    • Para produção assíncrona em lote em larga escala, use diretamente o pipeline da API do servidor.
    • Para requisitos rígidos de autenticação e auditoria, priorize a orquestração no backend.

    Comportamento em execução

    • Esta página de guia do modelo é otimizada para interação e ensaio de parâmetros.
    • O painel de saída demonstra a estrutura de resultado da tarefa como orientação de integração.

    Requisição mínima

    {
      "model": "suno",
      "mode": "text-to-video",
      "input": {
        "prompt": "A cinematic city sunrise with soft fog and moving traffic.",
        "duration": 5
      }
    }
    

    Resposta mínima

    {
      "task_id": "task_xxxxxxxx",
      "model": "suno",
      "mode": "text-to-video",
      "status": "queued",
      "created_at": "2026-04-15T00:00:00.000Z"
    }
    

    Parâmetros principais

    ParâmetroTipoObrigatórioPadrãoIntervaloDescrição
    modelstringSimsuno-Identificador do modelo. Use o valor fixo suno.
    promptstringSim--Instrução principal que descreve o sujeito, a ação, a cena e o estilo.
    aspect_ratiostringNão16:916:99:16
    durationintegerNão6510
    resolutionstringNão720P720PResolução da saída. Padrão 720P; aceita 720P.

    Erros comuns

    HTTPCodeCondição de acionamentoAção corretivaPolítica de nova tentativa
    400invalid_request_errorO payload da requisição não inclui campos obrigatórios ou tem tipos de campo inválidos.Valide model, mode e o esquema de input antes de enviar.Tente novamente apenas após corrigir o payload; evite novas tentativas cegas.
    401authentication_errorO cabeçalho Authorization está ausente ou a chave de API é inválida.Verifique o formato do token Bearer e o escopo da chave de API.Tente novamente após corrigir a autenticação; rotacione a chave se as falhas se repetirem.
    429rate_limit_exceededA frequência de requisições, a concorrência ou a cota atual acionam o limite do provedor.Aplique primeiro um recuo exponencial e depois revise o ritmo de requisições, a concorrência e o uso da cota.Use backoff exponencial (por exemplo, 1s/2s/4s) com jitter; se persistir, reduza a pressão de envio.
    500internal_errorErro transitório do provedor ou falha interna de processamento.Registre o request id e acione o fluxo de novas tentativas.Tente novamente 2 a 3 vezes com intervalos curtos; escale se o problema persistir.

    FAQ

    1. Quando devo usar o suno?
      Use-o para validar conceitos de vídeo rapidamente, comparar o comportamento dos modos e convergir prompts antes do rollout da API.
    2. Como escolho entre Text-to-Video e Image-to-Video?
      Use Text-to-Video quando tiver apenas instruções; use Image-to-Video quando já tiver quadros-chave ou composição.
    3. Qual é a diferença entre R2V e Video Edit?
      R2V foca em geração guiada por referências, enquanto Video Edit foca em modificar recursos de vídeo existentes.
    4. Erro no modelo de imagem ou vídeo: invalid apitype: -1
      Isso geralmente indica que a requisição foi enviada para o endpoint errado. Modelos de imagem e vídeo normalmente não usam o endpoint de chat. Em vez disso, envie a requisição HTTP de tarefa conforme a documentação e consulte o endpoint de status da tarefa para obter o resultado. Verifique primeiro o código real da requisição, a URL e o payload.
    5. Uma tarefa de imagem ou vídeo falhou, mas o usuário ainda foi cobrado
      Peça primeiro ao usuário o log da tarefa ou uma captura de tela e verifique se aparece consumo de tokens de entrada ou saída. Se houver registro de tokens, provavelmente a requisição foi enviada por um endpoint de chat em vez do fluxo de mídia correto. Modelos de imagem e vídeo normalmente funcionam como APIs HTTP de tarefas assíncronas: envie a tarefa primeiro e depois consulte pelo task id conforme a documentação.

    APIs relacionadas

    • Suno API