POST /images/generations

Gere imagens conforme os limites de saída do modelo selecionado. A Base URL é https://api.modelrush.ai/v1.

Campos: model, prompt. Consulte os campos e limites de cada modelo em GET /models → operations.input_schema. Z-Image usa width/height e n=1; Z-Image Pro também aceita prompt_extend. Outros modelos podem usar size, quality, output_format, watermark ou thinking_mode. Envie Authorization: Bearer $MODELRUSH_API_KEY nas rotas autenticadas e Content-Type: application/json nos corpos JSON.

Campos: Modelos assíncronos: HTTP 202 com id e poll_url; consulte GET /predictions/:id até succeeded ou failed e leia outputs. Modelos síncronos: id, generation_request_id, model, modelrush_region, data. Guarde os identificadores de requisição ou de geração devolvidos. As saídas geradas e suas referências de arquivo no provedor são removidas do banco de dados do ModelRush 24 horas após a conclusão da requisição; baixe o que você precisar manter.

Entradas inválidas devolvem uma resposta 4xx com um erro estruturado. Um 403 com adult_attestation_required, portrait_rights_attestation_required ou person_rights_confirmation_required precisa ser resolvido pela pessoa titular da conta e nunca deve ser repetido automaticamente. Repita os 429 conforme o Retry-After; repita as falhas 5xx apenas com uma política de backoff limitada.

Abra a página do modelo para consultar parâmetros e preços atuais. As quatro páginas Wan 3 incluem uma seção de API abaixo do Playground. GET /v1/models fornece esquemas e acesso permitido à chave; GET /api/model-pricing retorna preços públicos sem autenticação; com uma chave API Bearer válida, retorna os preços aplicáveis à conta.

Solicitações de imagem do ModelRush podem retornar HTTP 202, id e poll_url. Consulte essa URL com a mesma chave; GET /v1/predictions/:id termina com succeeded e outputs. Z-Image Pro Spicy aceita width e height de 256 a 2560 (padrão 1024), n = 1 e prompt_extend = false por padrão. Z-Image Spicy também gera uma imagem por solicitação. Não copie os limites de tamanho ou quantidade de outro modelo.