Como usar seu acesso ao Muse

Você recebeu um convite. Com ele, entra na sua própria conta do Muse uma única vez e ganha uma chave de API para usar o Muse em aplicativos e programas compatíveis com a OpenAI.

O que você vai receber

URL base… — o endereço da API. Só o domínio muda de um serviço para outro.
Chave de APIm2a_u_… — sua “senha” de acesso. Pessoal: ela usa a sua conta Muse e a sua cota.
AtençãoA chave aparece uma única vez, no fim do passo 1. Copie e guarde num lugar seguro (gerenciador de senhas ou bloco de notas privado).

1. Conectar sua conta (faça só uma vez)

1
Abra o link do convite O link que você recebeu tem este formato: https://…/connect?invite=inv_…
Ele vale por tempo limitado e só pode ser usado uma vez.
2
Clique em “Abrir login” Se quiser, escreva seu nome no campo opcional. Aparece uma janela com o site do Muse dentro da página. Ela é um navegador seguro rodando no servidor; é normal ter um pequeno atraso.
3
Entre na sua conta do Muse Clique no campo “Número de celular ou e-mail” e digite como faria no site oficial. Se a Meta pedir código por SMS/e-mail, confirmação de identidade ou 2FA, faça ali mesmo.
  • No computador: clique no campo e digite normalmente.
  • No celular: toque no campo; se o teclado não abrir, use a caixa “Digitar/colar texto” abaixo da tela e clique em Enviar texto. O botão Enter confirma.
Sua senha está seguraEla é digitada direto no muse.ai e não é gravada por este serviço. O servidor guarda apenas a sessão da sua conta (cookies), para poder usar o Muse por você.
4
Copie a URL base e a chave Quando o login terminar, a página detecta sozinha e mostra uma tela Conta conectada ✔ com a URL base e a chave de API. Use os botões Copiar. Pronto: pode fechar a página.
Deu erro ou travou?Se a conexão cair antes de terminar, recarregue a página do convite; ele só é consumido quando o login conclui. Se expirar (10 minutos), peça um novo convite.

2. Usar a chave em aplicativos

Em qualquer programa que aceite um “endpoint compatível com OpenAI” (clientes de chat, plugins de editor, ferramentas de automação), preencha três campos:

CampoO que colocar
Base URL / API URL…
API Keym2a_u_… (a sua chave)
Modelomuse-spark (texto e código), muse-image (imagens) ou muse-video (vídeos)
DicaNomes comuns como gpt-4o também funcionam: são convertidos automaticamente para o modelo certo do Muse.

3. Exemplos prontos

Troque SUA_CHAVE pela sua chave. O endereço já vem preenchido.

curl BASE/chat/completions \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"model":"muse-spark","messages":[{"role":"user","content":"Explique o que é uma API em duas frases."}]}'

Para resposta “digitando”, adicione "stream": true ao JSON.

curl BASE/images/generations \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"um gato astronauta, estilo ilustração","size":"1:1","response_format":"url"}'

A resposta traz o link da imagem em data[0].url. Demora de 10 a 30 segundos. Proporções aceitas: 1:1, 16:9, 9:16, 4:3, 3:4.

Passo 1 — criar a tarefa (vídeo é assíncrono):

curl BASE/videos \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"um gatinho andando na grama","duration":5,"size":"16:9"}'

Passo 2 — consultar até ficar pronto (use o id devolvido; costuma levar 1 a 2 minutos):

curl BASE/videos/ID_DA_TAREFA \
  -H "Authorization: Bearer SUA_CHAVE"

Quando status for completed, o link do vídeo está em url.

from openai import OpenAI

client = OpenAI(base_url="BASE", api_key="SUA_CHAVE")

r = client.chat.completions.create(
    model="muse-spark",
    messages=[{"role": "user", "content": "Escreva um quicksort em Python"}],
)
print(r.choices[0].message.content)

# imagem
img = client.images.generate(model="muse-image", prompt="um cachorro astronauta")
print(img.data[0].url)

Instale com pip install openai.

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "BASE", apiKey: "SUA_CHAVE" });

const r = await client.chat.completions.create({
  model: "muse-spark",
  messages: [{ role: "user", content: "Olá!" }],
});
console.log(r.choices[0].message.content);

Instale com npm install openai.

4. Gerenciar sua conta

Na página do convite, role até Minha conta, cole sua chave e clique em Ver. Lá você pode:

Abrir “Minha conta”

Adicionar mais contas Muse (se o seu convite permitir)

Alguns convites permitem conectar mais de uma conta Muse na mesma chave. Você pode adicionar quando quiser, sem pedir outro convite:

  1. Na página do convite, em Minha conta, cole a sua chave e clique em Ver.
  2. Clique em + Adicionar outra conta (1 de N) e entre com a outra conta do Muse, do mesmo jeito do passo 3.
  3. Pronto: a chave continua a mesma. O sistema passa a revezar entre as suas contas e troca sozinho quando uma falha ou atinge o limite.

O limite aparece em “Minha conta” (por exemplo, 2 de 3 contas). Para adicionar além do limite, remova uma conta ou peça ao administrador para aumentar.

A sessão do Muse expiraO login dura cerca de 2 dias e o servidor tenta renová-lo sozinho. Se a Meta derrubar a sessão, as chamadas passam a dar erro e você precisa reconectar: peça um novo convite a quem administra o serviço.

5. Dúvidas frequentes

Quem paga o uso? Qual é a cota?

O uso consome a cota da sua própria conta do Muse (plano gratuito ou o que você tiver). Este serviço não adiciona custo, mas também não aumenta sua cota. Vídeos gastam bem mais que texto e imagem.

Posso usar mais de uma conta Muse com a mesma chave?

Sim, se o seu convite permitir (o limite aparece em “Minha conta”). Você adiciona as contas quando quiser e o sistema faz o rodízio entre elas. Cada conta usa a própria cota, então o total de uso disponível aumenta.

O que acontece quando uma conta atinge o limite de uso?

A conta sai do rodízio por algumas horas e o sistema usa automaticamente as suas outras contas. Em “Minha conta” ela aparece como limite de uso atingido — volta às HH:MM. Passado esse tempo, ela volta sozinha ao rodízio. Se todas as suas contas estiverem sem cota, a API responde com erro 429 e informa quando a primeira volta a ser tentada.

Posso compartilhar minha chave com outras pessoas?

Não recomendamos: quem tiver a chave usa a sua conta e a sua cota. Cada pessoa deve pedir o próprio convite.

Dá para usar com agentes que usam ferramentas (tool calls)?

Não. O Muse é um agente com personalidade própria, e não suporta “chamada de ferramentas”. Conversa, código, explicações, tradução, resumos, imagens e vídeos funcionam normalmente. Se o app enviar o campo tools, ele é ignorado.

Aparece “Chave de API inválida” (401)

A chave foi digitada errada, foi trocada em “Gerar nova chave”, ou sua conta foi removida/desativada. Confira se ela começa com m2a_u_ e se não há espaço sobrando.

Aparece “Sua conta Muse está desativada ou desconectada” (403)

Sua conta foi desativada por quem administra, ou você a desconectou. Peça um novo convite para reconectar.

As respostas demoram ou dão erro de tempo esgotado

O Muse é um site controlado por um navegador no servidor, então há fila quando várias pessoas usam ao mesmo tempo. Tente de novo em instantes. Para vídeo, use a consulta (GET /videos/ID) em vez de esperar a resposta direta.

Minha senha e meus dados estão seguros?

A senha é digitada direto no muse.ai e não é gravada. O servidor guarda só a sessão da conta (cookies) e um resumo criptográfico (hash) da sua chave. Você pode apagar tudo a qualquer momento em “Minha conta → Desconectar”.

Isso é oficial? Existe algum risco?

Não é oficial: usar o Muse por uma API como esta não é previsto nos termos da Meta, e a conta pode ser limitada ou bloqueada. Use por sua conta e risco; considere uma conta que você possa perder.