Generate
Caminhos: ${CLAUDE_SKILL_DIR} significa a pasta que contém este SKILL.md, e ${CLAUDE_SKILL_DIR}/../.. a pasta do editor (.claude/ deste repositório) dois níveis acima.
Toda pergunta ao usuário vai na caixa de perguntas: use a ferramenta AskUserQuestion (2 a 4 opções, a recomendada primeiro). Somente em um agente sem essa ferramenta, faça perguntas numeradas em texto.
G="${CLAUDE_SKILL_DIR}/../../lib/ai_editor/gen/gen.py". Execute com python3 (py no Windows). Cada
modelo, suas entradas e limites estão em gen.py models (de lib/ai_editor/gen/models.json); nunca adivinhe um ID
de modelo ou um parâmetro. Fatos da API e o que não foi verificado: references/higgsfield-api.md.
Regras
- Dinheiro é gasto somente após um sim para aquele preço. Sempre
estimateprimeiro, pergunte com o valor em dólares que ele imprimiu (sua linhaASK:), e executesubmit --confirm <id da estimativa>somente depois que o usuário escolheu sim. Um novo preço (a estimativa tem mais de 30 minutos, ousubmitdiz que o preço mudou) é uma nova pergunta. - O material do usuário sai do computador dele somente com consentimento. Um clipe ou um frame do vídeo dele é
enviado para o Higgsfield no
submit. Diga isso na mesma pergunta que o preço. - Nunca peça a chave no chat. Sem chave: diga para executarem
python3 "$G" setkeyno próprio terminal (pede o id e o segredo da chave de console.higgsfield.ai, unidos comoid:secret, e esconde o que digitam). profile.jsongen_budget_usdlimita o gasto mensal;submitrecusa se ultrapassar. Informe quanto resta e pare.- Resultados com falha e
nsfwnão são cobrados. Diga isso se um falhar e ofereça para alterar o prompt.
Passos
- O quê e onde. A partir das palavras do usuário e da edição (
edits/<nome>/): o tipo (transferência de movimento, b-roll a partir de palavras, animação de uma imagem estática, imagem estática para cartão), o momento que cobre (segundos na linha do tempo, a partir da transcrição emwords.json), e para transferência de movimento o trecho do vídeo deles (4 s ou mais; o modelo mantém no máximo 30 s). Escolha o modelo compython3 "$G" models --kind <tipo>. - O prompt. Escreva você mesmo a partir da linha sendo dita: o sujeito, o cenário, a câmera, a luz,
em menos de 40 palavras. O b-roll combina com o formato do vídeo (uma edição vertical recebe um take de sensação
vertical). A transferência de movimento leva de 1 a 8 imagens de referência (
--image, arquivos ou URLs): o visual sobre o qual colocar os movimentos. - Preço.
python3 "$G" estimate edits/<nome> --model <id> --prompt "<prompt>" [--video raw.mp4 --from 12.0 --to 18.0] \ [--image ref.png] [--param duration=5] --at <segundos da linha do tempo>generated/inputs/, precifica a requisição sem enviar nada, e imprime o id da estimativa,usd,credits,over_budgete uma linhaASK:. - Pergunte. Uma caixa de pergunta: a linha
ASK:como pergunta (preço, modelo e o que será enviado), opções "Sim, gerar (Recomendado)" / "Alterar o prompt" / "Não". Acima do orçamento: diga isso e pare. - Submeta somente com o sim:
python3 "$G" submit edits/<nome> --confirm <id da estimativa>. Ele envia as entradas, recalcula o preço com elas, submete e imprime o id do trabalho. - Aguarde em segundo plano (as gerações levam minutos):
python3 "$G" wait edits/<nome> <trabalho>. Ele consulta com backoff, baixa o resultado paraedits/<nome>/generated/, o analisa e adiciona à faixa Generated da linha do tempo em--atcomo uma alteração do Claude (através deproject.py apply; sem o documento do projeto ainda, escrevegenerated/<trabalho>.ops.jsone imprime).status/listmostram o progresso;cancelfunciona apenas enquanto ainda está na fila. - Passe o bastão. Diga o que foi adicionado, onde e quanto custou. O usuário move, corta ou exclui na
linha do tempo como qualquer clipe. Uma correção sobre como as gerações devem ficar vai para
taste.
Se um comando parar
| mensagem | o que fazer |
|---|---|
No Higgsfield key | peça para executar python3 "$G" setkey no próprio terminal, depois continue |
needs at least 4 s | amplie --from/--to, ou escolha um modelo de texto ou imagem |
over this month's generation budget | informe quanto resta; eles podem aumentar gen_budget_usd |
the price is $X, not $Y | pergunte novamente com o novo preço, depois submit --confirm o novo id impresso |
Maximum number of concurrent requests | o cliente já tentou novamente; aguarde um trabalho em execução, depois submeta |
ended failed / ended nsfw | não cobrado; ofereça um prompt alterado (nova estimativa e pergunta) |
Arquivos
lib/ai_editor/gen/gen.py: os comandos acima,demoautoteste (um Higgsfield falso, sem rede).lib/ai_editor/gen/higgsfield.py: o cliente da API.base.py: a interface do provedor e o catálogo.lib/ai_editor/gen/jobs.py:edits/<nome>/generated/jobs.jsone o gasto do mês.references/higgsfield-api.md: a API conforme documentada, com fontes.