Generar
Rutas: ${CLAUDE_SKILL_DIR} es la carpeta que contiene este SKILL.md, y ${CLAUDE_SKILL_DIR}/../.. es la carpeta del editor (el .claude/ de este repositorio) dos niveles arriba.
Cada pregunta al usuario va en el cuadro de preguntas: usa la herramienta AskUserQuestion (2-4 opciones, la recomendada primero). Solo en un agente sin esa herramienta, haz preguntas numeradas en texto.
G="${CLAUDE_SKILL_DIR}/../../lib/ai_editor/gen/gen.py". Ejecútalo con python3 (py en Windows). Cada modelo, sus entradas y límites están en gen.py models (de lib/ai_editor/gen/models.json); nunca adivines un id de modelo o un parámetro. Datos de la API y lo que no está verificado: references/higgsfield-api.md.
Reglas
- El dinero se gasta solo después de un sí a ese precio. Siempre haz
estimateprimero, pregunta con el monto en dólares que imprimió (su líneaASK:), y ejecutasubmit --confirm <id de estimación>solo después de que el usuario haya dicho que sí. Un nuevo precio (la estimación tiene más de 30 minutos, osubmitdice que el precio cambió) es una nueva pregunta. - El metraje del usuario sale de su computadora solo con consentimiento. Un clip o un fotograma de su video se sube a Higgsfield en
submit. Dilo en la misma pregunta que el precio. - Nunca pidas la clave en el chat. Sin clave: diles que ejecuten
python3 "$G" setkeyen su propia terminal (pide el id y secreto de la clave desde console.higgsfield.ai, unidos comoid:secret, y oculta lo que escriben). profile.jsongen_budget_usdlimita el gasto mensual;submitlo rechaza si se supera. Di cuánto queda y detente.- Los resultados fallidos y
nsfwno se cobran. Dilo si uno falla y ofrece cambiar el prompt.
Pasos
- Qué y dónde. De las palabras del usuario y la edición (
edits/<nombre>/): el tipo (transferencia de movimiento, b-roll a partir de palabras, una imagen animada, una imagen fija para tarjeta), el momento que cubre (segundos en la línea de tiempo, desde la transcripción enwords.json), y para transferencia de movimiento el tramo de su video (4 s o más; el modelo conserva como máximo 30 s). Elige el modelo conpython3 "$G" models --kind <tipo>. - El prompt. Escríbelo tú mismo a partir de la línea que se está diciendo: el sujeto, el escenario, la cámara, la luz, en menos de 40 palabras. El b-roll coincide con el formato del video (una edición vertical obtiene una toma con sensación vertical). La transferencia de movimiento toma 1-8 imágenes de referencia (
--image, archivos o URLs): el aspecto sobre el que poner los movimientos. - Cótizalo.
python3 "$G" estimate edits/<nombre> --model <id> --prompt "<prompt>" [--video raw.mp4 --from 12.0 --to 18.0] \ [--image ref.png] [--param duration=5] --at <segundos en línea de tiempo>generated/inputs/, cotiza la solicitud sin subir nada, e imprime el id de estimación,usd,credits,over_budgety una líneaASK:. - Pregunta. Un cuadro de pregunta: la línea
ASK:como pregunta (precio, modelo y qué se sube), opciones "Sí, generarlo (Recomendado)" / "Cambiar el prompt" / "No". Si está por encima del presupuesto: dilo y detente. - Envía solo si hay un sí:
python3 "$G" submit edits/<nombre> --confirm <id de estimación>. Sube las entradas, vuelve a cotizar con ellas, envía e imprime el id del trabajo. - Espera en segundo plano (las generaciones toman minutos):
python3 "$G" wait edits/<nombre> <trabajo>. Sondea con retroceso exponencial, descarga el resultado enedits/<nombre>/generated/, lo analiza y lo agrega a la pista Generated de la línea de tiempo en--atcomo un cambio de Claude (a través deproject.py apply; sin el documento del proyecto aún, escribegenerated/<trabajo>.ops.jsony lo imprime).status/listmuestran el progreso;cancelfunciona solo mientras aún está en cola. - Entrega. Di qué se agregó, dónde y cuánto costó. El usuario mueve, recorta o elimina el clip en la línea de tiempo como cualquier otro. Una corrección sobre cómo deberían verse las generaciones va a
taste.
Si un comando se detiene
| mensaje | haz |
|---|---|
No Higgsfield key | pídeles que ejecuten python3 "$G" setkey en su propia terminal, luego continúa |
needs at least 4 s | amplía --from/--to, o elige un modelo de texto o imagen |
over this month's generation budget | diles cuánto queda; pueden aumentar gen_budget_usd |
the price is $X, not $Y | pregunta de nuevo con el nuevo precio, luego submit --confirm con el nuevo id que imprimió |
Maximum number of concurrent requests | el cliente ya reintentó; espera a que termine un trabajo en ejecución, luego envía |
ended failed / ended nsfw | no se cobra; ofrece un prompt cambiado (nueva estimación y pregunta) |
Archivos
lib/ai_editor/gen/gen.py: los comandos anteriores,demoautoverificación (un Higgsfield falso, sin red).lib/ai_editor/gen/higgsfield.py: el cliente de la API.base.py: la interfaz del proveedor y el catálogo.lib/ai_editor/gen/jobs.py:edits/<nombre>/generated/jobs.jsony el gasto del mes.references/higgsfield-api.md: la API tal como está documentada, con fuentes.