MOSS Image API
OpenMOSS MOSS Image — um modelo de texto para imagem com pesos abertos, feito para prompts longos e detalhados, com texto em chinês e inglês renderizado com nitidez dentro da imagem, saída em 1K, 1.5K ou 2K, 15 proporções de tela de 1:3 a 3:1 e uma variante com LoRA que aceita até três LoRAs personalizadas.
Este guia da API MOSS Image cobre os dois endpoints ativos na WaveSpeedAI, text-to-image e text-to-image-lora, com os níveis 1K, 1.5K e 2K, as proporções de tela, os formatos de saída e as entradas de LoRA. O playground, os exemplos, os preços e as amostras de API abaixo usam os endpoints ativos do MOSS Image.
/filters:quality(82)/examples/87f92188828c699eee25291d0c9eb320/6850341a-b54e-44db-a1c4-9194a5a22c8a-019c45b211a1.webp)
Visão geral
Sobre o MOSS Image API
O que o MOSS Image faz, como ele se encaixa na linha de modelos da OpenMOSS e por que as equipes o escolhem.
MOSS Image é um modelo de geração e edição de imagens da OpenMOSS, disponível pela API REST da WaveSpeedAI. OpenMOSS MOSS Image — um modelo de texto para imagem com pesos abertos, feito para prompts longos e detalhados, com texto em chinês e inglês renderizado com nitidez dentro da imagem, saída em 1K, 1.5K ou 2K, 15 proporções de tela de 1:3 a 3:1 e uma variante com LoRA que aceita até três LoRAs personalizadas.
Este guia da API MOSS Image cobre os dois endpoints ativos na WaveSpeedAI, text-to-image e text-to-image-lora, com os níveis 1K, 1.5K e 2K, as proporções de tela, os formatos de saída e as entradas de LoRA. O playground, os exemplos, os preços e as amostras de API abaixo usam os endpoints ativos do MOSS Image.
A família MOSS Image na WaveSpeedAI traz 2 endpoints REST cobrindo o fluxo de Text-To-Image. Cada variante tem seu próprio preço, parâmetros e exemplos de resultado — escolha a que combina com sua modalidade de entrada e suas restrições de produção, ou chame várias com a mesma chave de API para montar pipelines de várias etapas.
Execute o MOSS Image com a mesma chave de API, a mesma conta de cobrança e os mesmos limites de taxa que você usa nos outros mais de 1.000 modelos de IA da WaveSpeedAI. Sem configuração separada por fornecedor, sem SDKs por provedor, sem limites de taxa por fornecedor — uma única integração cobre tudo, de texto para imagem e texto para vídeo até síntese de áudio, geração 3D, ampliação e edição.
Especificações
Recursos e status de lançamento do MOSS Image API
Os detalhes específicos do modelo que desenvolvedores procuram antes de escolher uma API: disponibilidade, duração esperada do resultado, suporte a referências e a alternativa ativa atual.
Disponibilidade
Disponível agora
O MOSS Image está ativo no catálogo da WaveSpeedAI como dois endpoints no mesmo fluxo de predictions REST: text-to-image e text-to-image-lora.
Níveis de resolução
1K, 1.5K, 2K
O parâmetro resolution define o tamanho total da saída: 1k é cerca de 1 megapixel, 1.5k cerca de 2,4 megapixels e 2k cerca de 4 megapixels. A proporção de tela define então o formato.
Proporções de tela
15 proporções
De 1:3 e 3:1, passando por 1:1, 4:5, 3:2, 16:9 e 9:16, até o alto 9:21 e o largo 21:9, para que um único endpoint cubra pôsteres, banners, telas de celular e posts quadrados.
Texto em imagens
Chinês e inglês
O prompt aceita descrições longas e detalhadas, e o modelo renderiza texto em chinês e inglês dentro da imagem.
LoRA
Até 3
O endpoint text-to-image-lora aceita uma lista de até três LoRAs, cada uma com um caminho e uma escala de 0 a 4.
Formatos de saída
JPEG, PNG, WebP
JPEG é o padrão; PNG e WebP estão disponíveis pelo parâmetro output_format.
Endpoints
Todos os endpoints da API de MOSS Image
2 endpoints de MOSS Image disponíveis agora na WaveSpeedAI — escolha a variante que combina com seu fluxo de trabalho.
/filters:quality(82)/media/images/c97fd47a-ac26-4b5b-8ee1-b1680c2438eb.webp)
Moss Image Text To Image Lora
MOSS Image Text-to-Image LoRA generates images from long text prompts with up to 3 custom LoRAs, with sharp Chinese and English text rendering, 1K, 1.5K or 2K output and flexible aspect ratios. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/8f17d71a-c9c5-44a2-9043-e997f7328f2e.webp)
Moss Image Text To Image
MOSS Image Text-to-Image generates images from long text prompts, with sharp Chinese and English text rendering, 1K, 1.5K or 2K output and flexible aspect ratios. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Exemplos
Veja o MOSS Image em ação
Resultados reais gerados pela API do MOSS Image. Passe o mouse sobre qualquer vídeo para pré-visualizar e clique para abrir o visualizador em tamanho real.
Como usar
Como usar a API do MOSS Image
Quatro passos do cadastro até uma geração concluída. Exemplos completos em Python, Node.js e cURL estão na seção de API abaixo.
- 01
Obtenha uma chave de API
Crie uma conta na WaveSpeedAI e copie sua chave de API no painel. Contas novas recebem créditos iniciais grátis — o suficiente para usar o playground algumas dezenas de vezes antes de a cobrança começar.
- 02
Envie uma predição
Faça POST da sua entrada em JSON para https://api.wavespeed.ai/api/v3/wavespeed-ai/moss-image/text-to-image. O endpoint devolve um id de predição imediatamente — as gerações são assíncronas, então você não mantém uma conexão aberta durante a inferência.
- 03
Consulte até concluir
Faça GET em https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. Retorne os resultados quando o status for completed; pare com erro em failed, cancelled, timeout ou deleted; continue consultando em qualquer outro status.
- 04
Leia a URL do resultado
Quando o status for "completed", leia a URL em data.outputs[0]. A URL aponta para a mídia gerada na CDN da WaveSpeedAI — imagem, vídeo, áudio ou arquivo 3D, conforme a variante do MOSS Image que você chamou.
Casos de uso
O que você pode criar com o MOSS Image
Fluxos de trabalho comuns para os quais desenvolvedores e criadores usam a API do MOSS Image.
Prompts longos e detalhados
wavespeed-ai/moss-image/text-to-image foi feito para prompts que descrevem uma cena inteira em detalhes: assunto, cenário, iluminação, composição e estilo em um único parágrafo.
Pôsteres e capas com texto em chinês ou inglês
O modelo renderiza texto em chinês e inglês dentro da imagem, o que serve para pôsteres, capas de livros e álbuns, mockups de letreiros e cards de redes sociais em que as palavras fazem parte da imagem.
Estilos e personagens personalizados com LoRA
wavespeed-ai/moss-image/text-to-image-lora aplica até três LoRAs ao mesmo tempo, cada uma com sua própria escala, para um estilo da casa, um personagem recorrente ou o visual de um produto.
Imagens grandes para impressão e telas
O nível 2k produz cerca de 4 megapixels em uma única passada, e o nível 1.5k fica entre ele e o 1k, para uma imagem maior com custo menor.
Execuções repetíveis com seed
Defina a seed para repetir um resultado enquanto muda apenas o prompt ou a escala da LoRA, e deixe em -1 para obter uma nova variação a cada vez.
Dicas
Dicas de prompt para o MOSS Image
Conselhos práticos para obter melhores resultados com o MOSS Image — extraídos dos padrões que funcionam em modelos de imagem em pipelines de produção.
- 01
Escreva a cena inteira em um parágrafo
O MOSS Image lida bem com prompts longos. Descreva o assunto, o cenário, a iluminação, a composição e o estilo em um parágrafo, em vez de uma lista de palavras-chave.
- 02
Coloque as palavras exatas entre aspas
Para texto dentro da imagem, coloque entre aspas as palavras desejadas e diga onde elas ficam, como um título no topo ou uma linha pequena sob o logo. Chinês e inglês são renderizados.
- 03
Escolha o nível antes da proporção
Use 1k para explorar, 1.5k para a maioria das entregas e 2k para impressões grandes, e depois escolha a proporção de tela. O nível define o total de pixels e a proporção define o formato.
- 04
Ajuste as LoRAs com a escala
No endpoint text-to-image-lora, comece cada LoRA na escala 1 e ajuste em pequenos passos; com várias LoRAs, reduza um pouco cada escala para que elas não briguem entre si.
Preços
Preços da API de MOSS Image
O preço é por resultado. O valor final varia conforme os parâmetros definidos no playground de cada variante (resolução, duração, quantidade de resultados, referências).
| Endpoint | Tipo | Preço inicial |
|---|---|---|
| wavespeed-ai/ | text-to-image | $0.025 |
| wavespeed-ai/ | text-to-image | $0.02 |
API
Chame a API de MOSS Image
Crie uma chave de API em wavespeed.ai/accesskey e envie uma predição via REST. O playground gera exemplos prontos para colar para qualquer combinação de entradas.
POSThttps://api.wavespeed.ai/api/v3/wavespeed-ai/moss-image/text-to-image
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/moss-image/text-to-image" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-d '{
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "1:1",
"resolution": "1k",
"output_format": "jpeg"
}')
TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
-H "Authorization: Bearer $WAVESPEED_API_KEY")
RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
case "$STATUS" in
completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
*) sleep 2 ;;
esac
doneconst submitUrl = "https://api.wavespeed.ai/api/v3/wavespeed-ai/moss-image/text-to-image";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
async function requestJson(url, options = {}) {
const response = await fetch(url, options);
if (!response.ok) throw new Error(await response.text());
return response.json();
}
// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "1:1",
"resolution": "1k",
"output_format": "jpeg"
}),
});
const task = body.data ?? body;
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;
// 2. Poll until the prediction finishes.
while (true) {
const resultBody = await requestJson(resultUrl, {
headers: { "Authorization": `Bearer ${apiKey}` },
});
const result = resultBody.data ?? resultBody;
if (result.status === "completed") {
console.log(result.outputs);
break;
}
if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
await new Promise(resolve => setTimeout(resolve, 2000));
}import json
import os
import time
from urllib.request import Request, urlopen
api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"prompt": "A cinematic shot of a city at sunset, soft golden light",
"aspect_ratio": "1:1",
"resolution": "1k",
"output_format": "jpeg"
}
def request_json(url, data=None):
request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
with urlopen(request) as response:
return json.load(response)
# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/wavespeed-ai/moss-image/text-to-image", json.dumps(payload).encode())
task = body.get("data", body)
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"
# 2. Poll until the prediction finishes.
while True:
result_body = request_json(result_url)
result = result_body.get("data", result_body)
status = result.get("status")
if status == "completed":
print(result.get("outputs", []))
break
if status in {"failed", "cancelled", "timeout", "deleted"}:
raise RuntimeError(result)
time.sleep(2)Comparar
MOSS Image vs alternativas
Quando escolher o MOSS Image em vez de modelos semelhantes na WaveSpeedAI.
MOSS Image vs Qwen-Image
O Qwen-Image também suporta texto em chinês e inglês e acrescenta edição de imagem, edição de várias imagens e um sistema de ângulo de câmera na sua família. O MOSS Image é apenas texto para imagem, com uma variante LoRA e os níveis 1.5K e 2K.
MOSS Image vs FLUX.2 [klein]
O FLUX.2 [klein] traz modelos de geração e edição de 4B e 9B com suporte a LoRA. O MOSS Image foca em prompts longos e na renderização de texto em chinês e inglês, com endpoints de geração e LoRA, mas sem endpoint de edição.
MOSS Image vs Seedream 5
O Seedream 5 Pro acrescenta edição interativa de precisão, separação de camadas e fusão de várias imagens. O MOSS Image não edita imagens existentes; ele gera a partir de um prompt e de LoRAs opcionais.
FAQ
MOSS Image API — Perguntas frequentes
Preços, licença, integração — perguntas comuns sobre executar o MOSS Image na WaveSpeedAI.
O que é o MOSS Image?
O MOSS Image é um modelo de texto para imagem com pesos abertos da OpenMOSS. Na WaveSpeedAI, ele roda atrás de uma API REST como dois endpoints: text-to-image e text-to-image-lora.
O MOSS Image edita imagens ou aceita uma imagem de referência?
Não. Os endpoints ativos geram imagens a partir de um prompt de texto, e o endpoint LoRA acrescenta até três LoRAs. Para edição, use um modelo de edição como o Seedream 5 ou o Qwen-Image.
Como uso LoRAs com o MOSS Image?
Envie o parâmetro loras ao endpoint text-to-image-lora: uma lista de até três itens, cada um com o caminho da LoRA (uma URL) e uma escala entre 0 e 4.
Quais resoluções e proporções de tela o MOSS Image suporta?
Três níveis de resolução (1k, 1.5k, 2k, cerca de 1, 2,4 e 4 megapixels) e 15 proporções de tela de 1:3 a 3:1, incluindo 9:16, 16:9, 9:21 e 21:9.
O que é a API do MOSS Image?
MOSS Image é um modelo de geração de imagens da OpenMOSS disponibilizado como API REST na WaveSpeedAI. OpenMOSS MOSS Image — um modelo de texto para imagem com pesos abertos, feito para prompts longos e detalhados, com texto em chinês e inglês renderizado com nitidez dentro da imagem, saída em 1K, 1.5K ou 2K, 15 proporções de tela de 1:3 a 3:1 e uma variante com LoRA que aceita até três LoRAs personalizadas. Você pode chamá-lo por código ou testá-lo no playground indicado acima.
Como chamo a API do MOSS Image?
Crie uma conta na WaveSpeedAI, copie sua chave de API em /accesskey e faça POST para https://api.wavespeed.ai/api/v3/wavespeed-ai/moss-image/text-to-image com sua entrada em JSON. O endpoint devolve um id de predição. Consulte o endpoint de resultado a cada 2 segundos, aproximadamente, aumente o intervalo em tarefas longas e pare em qualquer status final. Exemplos prontos para produção em Python / Node.js / cURL estão acima.
Quanto custa a API do MOSS Image?
O MOSS Image começa em $0.02 por execução. O custo exato varia conforme os parâmetros definidos (resolução, duração, quantidade de resultados, referências). A prévia de custo ao vivo ao lado do botão Gerar no playground mostra o preço exato da sua entrada atual.
Quais variantes do MOSS Image estão disponíveis?
A WaveSpeedAI hospeda 2 endpoints de MOSS Image ativos: wavespeed-ai/moss-image/text-to-image-lora, wavespeed-ai/moss-image/text-to-image. Cada variante tem sua própria página de playground e seu preço.
Posso usar os resultados do MOSS Image comercialmente?
Os direitos de uso comercial seguem a licença do modelo da OpenMOSS. A maioria dos modelos da OpenMOSS permite o uso comercial dos resultados; veja o resumo da licença na página do playground de cada modelo e os Termos de Serviço da WaveSpeedAI para as condições da plataforma.
Por que usar o MOSS Image na WaveSpeedAI em vez de ir direto à fonte?
Uma chave de API e uma conta de cobrança para o MOSS Image E mais de 1.000 outros modelos de IA de outros provedores. Sem configuração de SDK por fornecedor, sem limites de taxa separados, sem reescrever o código de integração a cada fornecedor. Os preços costumam ser iguais ou menores que os da API direta da OpenMOSS.
Provedor
Sobre a OpenMOSS
A equipe por trás do MOSS Image e de toda a linha de modelos da OpenMOSS na WaveSpeedAI.
A OpenMOSS é a equipe open source por trás da família de modelos MOSS. O MOSS Image é lançado com pesos abertos sob a licença Apache-2.0 e gera imagens a partir de prompts longos, com renderização de texto em chinês e inglês, saída de até 2K e suporte a LoRA. A WaveSpeedAI o hospeda atrás de uma API REST, com um endpoint text-to-image e um text-to-image-lora.
Comece a criar com o MOSS Image na WaveSpeedAI
Créditos iniciais grátis no cadastro. Uma chave de API para mais de 1.000 modelos de IA da OpenMOSS e de todos os outros provedores.
/filters:quality(82)/examples/4548754d1cbb6e8d56379b58596214b7/89caa298-c8be-41db-ae63-b17e780fe154-b85c474690f4.webp)
/filters:quality(82)/examples/d12b5fb5c170478e4f83c29174fd589d/6b96a4a4-6f86-4486-8638-daf2116802f0-fd6de2aa232b.webp)
/filters:quality(82)/examples/c0361ea4b3a99a8ea038eb097ee35890/49b13827-adb8-4ad1-bc8d-3d7f41dfc319-831071ad8641.webp)
/filters:quality(82)/examples/9b7f93a3ce5599956b7cc672404c2c94/c2dfda45-0c03-47ed-a6c0-23910da910b1-89ad0a2b88dc.webp)