Vídeo e música

# Guarde o ID do pedido: o suporte utiliza-o para localizar o seu pedido.
# Crie a tarefa uma única vez; o ciclo abaixo apenas consulta o seu estado.
curl --fail-with-body --max-time 120 -D video-create-headers-v1.txt \
  https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"grok-imagine-video-1.5","prompt":"um lago tranquilo","seconds":"8","size":"1280x720"}' \
  -o video-create-v1.json || exit 1
VIDEO_ID=$(jq -er '.id // .request_id' video-create-v1.json) || exit 1
VIDEO_STATUS=""
# Este ciclo consulta apenas a tarefa original. Nunca volta a enviar o pedido de criação.
for ATTEMPT in $(seq 1 60); do
  curl --fail-with-body --max-time 30 \
    "https://api.ailoot.ai/v1/videos/$VIDEO_ID" \
    -H "Authorization: Bearer $AILOOT_API_KEY" \
    -o video-status-v1.json || exit 1
  VIDEO_STATUS=$(jq -r '.status // empty' video-status-v1.json)
  # result_pending_check: true (o estado mantém-se in_progress): o resultado está a ser verificado. Pare; nunca volte a criar a tarefa.
  if jq -e '.result_pending_check == true' video-status-v1.json >/dev/null; then
    cat video-status-v1.json
    echo "The result is being checked. Do not create the job again: check GET /v1/videos/$VIDEO_ID later or contact support with the Request ID." >&2
    exit 1
  fi
  case "$VIDEO_STATUS" in
    done|completed) break ;;
    queued|in_progress|pending|processing) sleep 5 ;;
    # failed ou qualquer outro estado: apresente-o e pare. Nunca volte a criar a tarefa.
    *) cat video-status-v1.json; exit 1 ;;
  esac
done
case "$VIDEO_STATUS" in
  done|completed) ;;
  *) echo "The job is not finished yet (status: ${VIDEO_STATUS:-none}). Check it later: GET /v1/videos/$VIDEO_ID" >&2; exit 1 ;;
esac
curl --fail-with-body --max-time 120 -L --max-redirs 3 \
  "https://api.ailoot.ai/v1/videos/$VIDEO_ID/content" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o video-v1.mp4
# Após um timeout na criação, consulte o ID do pedido no histórico de utilização antes de voltar a executar este script.

curl https://api.ailoot.ai/v1/music/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "google/lyria", "prompt": "Piano e violoncelo tranquilos, sem voz"}' 

// O identificador da tarefa está no campo id ou request_id
{ "id": "…", … }

// O formato depende do modelo: utilize o identificador
// da resposta de criação sem o alterar.

Autorização

• Authorizationheaderobrigatório

  Chave no formato Bearer sk-…. Também são aceites os cabeçalhos x-api-key ou x-goog-api-key.

Vídeo: corpo do pedido

• modelstringobrigatório

  Modelo de vídeo: google/omni-1.1-flash, grok-imagine-video, happyhorse-1.1-t2v, MiniMax-Hailuo-2.3, grok-imagine-video-1.5, happyhorse-1.1-r2v, grok-imagine-video-1.5-preview, happyhorse-1.1-i2v.

• promptstringobrigatório

  Descrição do vídeo.

• duration / secondsinteger / stringopcional

  Depende da família: Grok 1–15 segundos, MiniMax 6/10 a 768P ou 6 a 1080P, HappyHorse 3–15; Google Omni 4/6/8/10. Não utilize um campo de uma família noutra.

• resolution / sizestringopcional

  Grok: 480p/720p/1080p (1080p em video-1.5), ou size 1280x720/720x1280/1920x1080/1080x1920. MiniMax: 768P/1080P. HappyHorse: 480P/720P/1080P. Google Omni: 360p/720p.

• image / first_frame_image / image_urlsstring / arrayopcional

  Os campos das imagens de origem dependem da família e do modo. MiniMax Fast exige first_frame_image. HappyHorse t2v — sem images, i2v — exatamente uma imagem sem ratio, r2v — 1–9 imagens.

A resposta contém o identificador da tarefa (campo id ou request_id). Utilize-o tal como é, sem o interpretar: o formato depende do modelo. Estado e ficheiro concluído:

Os mesmos endereços também funcionam com o prefixo /v1/videos/generations/{id}. O estado de uma tarefa concluída e os campos da resposta dependem do modelo — consulte o campo de estado e obtenha o ficheiro através de /content.

Criação → estado → transferência

Guarde a resposta de criação e o respetivo Request ID. Em MiniMax/HappyHorse, a conclusão é indicada por status: completed; a resposta contém content_url, data[] e usage. Em Grok — status: done com video.url. O Google Omni devolve 202 queued, seguido de in_progress com Retry-After, completed ou partial/content_revoked. Não interprete qualquer 200 como um vídeo concluído. Se a resposta de estado contiver result_pending_check: true (status e, ao mesmo tempo, in_progress), o resultado está a ser verificado. Não volte a criar a tarefa — consulte-a mais tarde através de GET /v1/videos/{id} ou contacte o suporte com o Request ID.

/content pode devolver o MP4 diretamente ou redirecionar para um ficheiro com ligação assinada. Se a resposta contiver vários resultados em data[], guarde cada um: todos os resultados entregues são cobrados. Não é possível cancelar ou eliminar uma tarefa de vídeo através da API. Eliminar o ficheiro concluído impede o acesso ao mesmo, mas não cancela a geração.

A cobrança é por segundos de vídeo concluído na resolução escolhida ou por vídeo, conforme indicado no catálogo. O custo total é reservado na criação da tarefa.

Música

• modelstringobrigatório

  google/lyria, google/lyria-3-clip-preview.

• promptstringobrigatório

  Descrição da faixa: género, instrumentos, ambiente.

Na resposta, data[] — ligações para os clips concluídos. Um único pedido pode devolver vários clips; cada clip entregue é cobrado.