MuAPI Media

Visão Geral

Use a API assíncrona unificada da MuAPI para geração de imagens e vídeos quando um fluxo de trabalho precisa de escolha de modelo sem uma integração separada para cada provedor. O catálogo e o esquema de entrada de cada modelo são autoritativos; esta habilidade não adivinha campos, não empacota um SDK, nem esconde uma solicitação de geração faturável. Para uma visão geral da capacidade, veja a API de vídeo IA da MuAPI.

Quando Usar Esta Habilidade

• Use quando o usuário pedir explicitamente para gerar uma imagem ou vídeo com MuAPI.
• Use quando um fluxo de trabalho de mídia existente precisar de uma API assíncrona hospedada e puder enviar uma solicitação HTTPS autorizada.
• Use quando o usuário precisar comparar ou alternar entre modelos de mídia atuais sem alterar o fluxo de trabalho de envio e consulta circundante.
• Não use esta habilidade para chat de texto ou para um provedor cujo esquema atual não foi buscado e verificado.

Pré-requisitos

1. Confirme que o usuário está autorizado a enviar o prompt e qualquer mídia de referência para um serviço de terceiros.
2. Explique que a geração pode ser faturável e obtenha aprovação imediatamente antes da solicitação de geração.
3. Exija MUAPI_API_KEY no ambiente. Nunca peça ao usuário para colar isso no chat, arquivos de origem, histórico de comandos ou logs.
4. Confirme o tipo de mídia solicitado, o local de saída e se o usuário deseja uma única geração ou um lote explicitamente aprovado.

Contrato da API

As solicitações de geração e previsão usam:

x-api-key: $MUAPI_API_KEY
Content-Type: application/json

O catálogo retorna um nome de modelo, categoria, endpoint e outros metadados. O valor do endpoint já inclui /api/v1/; anexe-o a https://api.muapi.ai sem adicionar um segundo prefixo de versão. Os campos de entrada e saída do modelo variam, portanto, leia o esquema do modelo selecionado imediatamente antes de preparar uma solicitação.

Como Funciona

1. Descobrir e validar um modelo

Use um diretório temporário para arquivos de resposta e mantenha as credenciais fora de qualquer arquivo. A consulta do catálogo é somente leitura:

workdir=$(mktemp -d "${TMPDIR:-/tmp}/muapi-media.XXXXXX")

curl --fail --silent --show-error \
  --header "Accept: application/json" \
  "https://api.muapi.ai/api/v1/models" \
  --output "$workdir/models.json"

jq -r '
  .models[]
  | select(((.category // "") | ascii_downcase | test("image|video|audio|3d")))
  | [.name, .category, .endpoint]
  | @tsv
' "$workdir/models.json"

Selecione um modelo do catálogo atual e, em seguida, busque seu esquema detalhado. Não copie um payload de um modelo diferente apenas porque os nomes parecem semelhantes:

export MUAPI_MODEL="<model name from the catalog>"

curl --fail --silent --show-error \
  --header "Accept: application/json" \
  "https://api.muapi.ai/api/v1/models/${MUAPI_MODEL}" \
  --output "$workdir/model.json"

jq '.input_schema.schemas.input_data' "$workdir/model.json"

Verifique os campos obrigatórios, tipos, valores de enumeração, limites de tamanho e o esquema de saída. Se o modelo exigir uma entrada de imagem ou vídeo, use o campo documentado exato e um URL de entrada HTTPS autorizado; não invente um contrato de upload.

2. Preparar uma solicitação revisada

Defina a chave apenas no ambiente e pare antes da submissão se ela estiver ausente:

test -n "${MUAPI_API_KEY:-}" || {
  echo "Set MUAPI_API_KEY before generation." >&2
  exit 1
}

export MUAPI_PROMPT="A small paper boat crossing a calm pond at sunrise, steady camera"

# Add only fields confirmed by model.json. This example uses a prompt field;
# many models also require duration, resolution, aspect ratio, or an input URL.
jq -n \
  --arg prompt "$MUAPI_PROMPT" \
  '{prompt: $prompt}' \
  > "$workdir/request.json"

Revise o modelo, os parâmetros solicitados, o destino e o custo estimado com o usuário. Não coloque MUAPI_API_KEY em request.json.

3. Enviar exatamente uma vez

Resolva o endpoint do catálogo e faça um POST. Não tente automaticamente reenviar um POST de geração após um timeout: a tarefa original pode ter sido aceita.

model_endpoint=$(jq -er --arg name "$MUAPI_MODEL" '
  .models[]
  | select(.name == $name)
  | .endpoint
  | select(type == "string" and startswith("/api/v1/"))

…