Primeiros passos com a API e endpoints
Os endpoints cobrem geração, consulta, conta, modelos e ferramentas de imagem. Todas as respostas são em JSON.
| Método | Caminho | Descrição |
|---|---|---|
POST | /v1/images/generations | Gera uma ou mais imagens |
POST | /v1/images/tools/{tool} | Edita uma imagem: remover fundo, ampliar, expandir ou apagar |
GET | /v1/jobs/{id} | Consulta uma geração anterior |
GET | /v1/account | Plano, saldo de créditos e limites |
GET | /v1/models | Lista os modelos e ferramentas disponíveis |
Gerar uma imagem
curl https://multigen.fdmultimedia.workers.dev/v1/images/generations \
-H "X-API-Key: $MULTIGEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "a matte black ceramic mug on a marble counter, soft daylight",
"n": 1,
"size": "2K"
}'Resposta:
{
"id": "job_9f83c2a1",
"status": "succeeded",
"model": "multigen-image-1",
"credits_used": 5,
"credits_remaining": 937,
"images": [ { "url": "https://…/output.png" } ]
}Parâmetros
| Campo | Padrão | Observações |
|---|---|---|
prompt | — | Obrigatório, até 4000 caracteres |
n | 1 | 1–4 imagens |
size | 2K | 2K ou 4K (4K cobra 2×) |
image_urls | [] | Até 6 URLs https públicas de referência |
Observação
As URLs das imagens são assinadas e expiram em 1 hora — baixe e guarde os arquivos se precisar deles por mais tempo.