API de otimização de prompts Seedance
Transforme uma ideia em um prompt para Seedance 2.5.
API de otimização de prompts Seedance
Serviço de texto independente do APIMaster, sem criar tarefas de vídeo. Baseia-se no guia público da Volcengine; não é uma API oficial Seedance e não redistribui o Skill oficial.
POST https://apimaster.ai/v1/video/prompt-optimize
Use uma API Key do APIMaster. model seleciona o modelo de texto cobrado, com rota disponível e permissão na Key. target_model seleciona o modelo de vídeo; apenas seedance-2.5 é aceito. Substitua o modelo de texto do exemplo se necessário.
Início rápido
curl --fail-with-body -sS "https://apimaster.ai/v1/video/prompt-optimize" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.1-flash-lite",
"target_model": "seedance-2.5",
"prompt": "A cat watches raindrops on a window, then turns toward the camera.",
"language": "pt",
"task": "generate",
"duration": 5
}'
Parâmetros
| JSON | |
|---|---|
model |
Obrigatório: ID do modelo de texto pago para otimização. |
prompt |
Obrigatório: 1–12000 caracteres. Preserve rótulos de referência e falas. |
target_model |
Opcional: padrão e único valor aceito é seedance-2.5. |
language |
Opcional: idioma de saída, como pt ou en; omitido, acompanha a entrada. Máximo 64 bytes. |
task |
Opcional: generate (padrão), edit ou extend. |
duration |
Opcional: inteiro 4–30 ou -1. Em edição, omita ou use -1. Apenas contexto de planejamento, sem definir parâmetros de geração. |
references |
Opcional: até 50 descrições com label único (1–64 caracteres) e description (1–2000). Não baixa nem analisa mídia. |
Resposta
JSON padrão Chat Completions: resultado em choices[0].message.content, uso em usage. Sem ID de tarefa de vídeo. Se finish_reason não for stop, especialmente length, confira se o resultado está completo.
{
"object": "chat.completion",
"model": "gemini-3.1-flash-lite",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "A cat sits beside a rain-covered window, watching the drops slide down the glass. It slowly turns its head toward the camera."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 600,
"completion_tokens": 50,
"total_tokens": 650
}
}
Descrições de referências
{
"model": "gemini-3.1-flash-lite",
"prompt": "Use @Image1 for the person and @Video1 for the camera movement.",
"language": "pt",
"references": [
{
"label": "@Image1",
"description": "Person appearance only; ignore the background."
},
{
"label": "@Video1",
"description": "Slow camera push-in only; ignore the people."
}
]
}
Erros e cobrança
400 JSON, tipos, campos ou valores inválidos; 401 Key inválida; 403 sem permissão; 413 mais de 64 KiB; 415 não é JSON; 429 limite de requisições. Erros do provedor mantêm o formato e status do serviço de texto.
Aplicam-se preços por token e grupo, saldo, registros e liquidação de falhas do modelo de texto. Instruções do sistema e descrições contam como entrada. Não há cobrança de vídeo aqui; a geração posterior é cobrada separadamente.
Gerar vídeo após revisar
Passe o resultado completo como prompt na geração. Envie mídia, duração e proporção separadamente. Os rótulos devem corresponder à ordem e função das mídias. Sem inspecionar mídia, não há garantia de identidade, legendas exatas ou tempo por quadro.
Limites
Somente texto sem streaming. Campos desconhecidos no nível raiz, incluindo stream, messages, webhook e URLs de mídia, são rejeitados. Não inclua chaves secretas.
