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

    Resposta rápida

    • 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.

    Parâmetros principais

    • model | string | obrigatório | suno | - | Identificador do modelo. Use o valor fixo `suno`.
    • prompt | string | obrigatório | - | - | Instrução principal que descreve o sujeito, a ação, a cena e o estilo.
    • aspect_ratio | string | opcional | 16:9 | 16:9 | 9:16 | 1:1 | Proporção do vídeo. Padrão `16:9`; aceita `16:9 | 9:16 | 1:1`.
    • duration | integer | opcional | 6 | 5 | 10 | 15 | 20 | Duração da saída em segundos. Padrão `6`; aceita `5 | 10 | 15 | 20`.
    • resolution | string | opcional | 720P | 720P | Resolução da saída. Padrão `720P`; aceita `720P`.

    Erros comuns

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

    Guia de modelo

    suno

    suno é fornecido pela Unknown com capacidades de Audio. Preço de referência atual: 10 créditos /request. Esta página ajuda a entender o posicionamento, os parâmetros e os casos de uso prontos para produção antes da integração.

    Fornecedor

    Unknown

    Modalidades

    Audio

    Preço

    10 créditos /request

    Atualizado

    2026-11-22

    Abrir no PlaygroundDocumentação

    ID do modelo

    suno

    Visão geral do modelo

    Resposta rápida

    • 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.

    Recursos do modelo suno

    Seção principal

    Recursos principais e valor prático para sua engenharia

    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.

    Como usar a API do suno

    1. Preencha o prompt e os parâmetros principais.
    2. Execute, inspecione a estrutura de saída e depois itere.
    3. Mova a configuração estável para a API de produção.

    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:9 | 9:16 | 1:1Proporção do vídeo. Padrão `16:9`; aceita `16:9 | 9:16 | 1:1`.
    durationintegerNão65 | 10 | 15 | 20Duração da saída em segundos. Padrão `6`; aceita `5 | 10 | 15 | 20`.
    resolutionstringNão720P720PResolução da saída. Padrão `720P`; aceita `720P`.

    Erros comuns

    400 invalid_request_error

    Gatilho: O payload da requisição não inclui campos obrigatórios ou tem tipos de campo inválidos.

    Correção: Valide model, mode e o esquema de input antes de enviar.

    Nova tentativa: Tente novamente apenas após corrigir o payload; evite novas tentativas cegas.

    401 authentication_error

    Gatilho: O cabeçalho Authorization está ausente ou a chave de API é inválida.

    Correção: Verifique o formato do token Bearer e o escopo da chave de API.

    Nova tentativa: Tente novamente após corrigir a autenticação; rotacione a chave se as falhas se repetirem.

    429 rate_limit_exceeded

    Gatilho: A frequência de requisições, a concorrência ou a cota atual acionam o limite do provedor.

    Correção: Aplique primeiro um recuo exponencial e depois revise o ritmo de requisições, a concorrência e o uso da cota.

    Nova tentativa: Use backoff exponencial (por exemplo, 1s/2s/4s) com jitter; se persistir, reduza a pressão de envio.

    500 internal_error

    Gatilho: Erro transitório do provedor ou falha interna de processamento.

    Correção: Registre o request id e acione o fluxo de novas tentativas.

    Nova tentativa: Tente novamente 2 a 3 vezes com intervalos curtos; escale se o problema persistir.

    FAQ

    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.

    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.

    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.

    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.

    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.

    Pronto para unificar o acesso aos seus modelos de IA?

    Comece grátis, use a página de modelos para pré-selecionar modelos e a de preços para confirmar o custo e a estratégia de roteamento padrão

    Começar grátisVer preços
    ToAPIs
    InícioToAPIs
    Gateway empresarial de API de IA. Acesse GPT-5, Claude, Gemini e mais de 200 modelos por uma única API unificada.

    Modelos populares

    • Seedance 2.5 API
    • Seedance 2.0 API
    • Veo 3.1 Fast API
    • Kling 3.0 Turbo API
    Mostrar maisMostrar menos
    • GPT Image 2 API
    • Claude Opus 4.8 API
    • Nano Banana 2 API
    • Seedance 2 Mini API
    • Todos os modelos

    Categorias de API

    • API de imagem com IA
    • API de vídeo com IA
    • API de texto para vídeo
    • API de imagem para vídeo
    Mostrar maisMostrar menos
    • API de edição de imagens com IA
    • API de LLM e raciocínio
    • Todas as ferramentas de API →

    Alternativas

    Alternativas
    • Alternativa ao Kie.ai
    • Alternativa ao Fal.ai
    • Alternativa ao OpenRouter
    • Alternativa ao Replicate
    • Alternativa ao Wavespeed AI
    • Todas as comparações →

    Guias em destaque

    Guias em destaque
    • Preços do Seedance 2.0 e 2.5
    • Guia da API Seedance mais barata
    • Guia de integração do MiniMax H3
    • Chave de API gratuita do Seedance 2
    • Início rápido da API Seedance 2
    • Todos os artigos técnicos →

    Desenvolvedores e plataforma

    Desenvolvedores e plataforma
    • Documentação da API
    • MCP
    • Preços
    • Playground de modelos
    • LLMs.txt
    • Falar com o suporte
    • Diretório de guias de modelos
    Entidade operadora:
    鯨樞智能科技有限公司
    JINGSHU INTELLIGENT LIMITED
    Sede social:
    ROOM 5042, 5/F, YAU LEE CENTRE, NO.45, HOI YUEN ROAD, KWUN TONG, KOWLOON, HONG KONG
    PrivacidadeTermosUso aceitávelExclusão de dadosRetenção de dadosSubprocessadores e regiõesCobrança e reembolsosPolítica de CookiesMapa do siteSobre

    © 2026 ToAPIs. Todos os direitos reservados.