Resumo rápido
A API do Chroma executa o Chroma pelo Mage em POST https://api.mage.space/v1/chroma/generate. Uma solicitação com as configurações padrão custa 35 Gems (cerca de US$ 0,035), sem assinatura. O Chroma não aceita menções com @handle.
Imagem
Saída
1
Variante
35
Gems por imagem, padrão
$0.035
Aproximadamente, em USD
Visão geral
O que a API do Chroma faz
Um modelo de imagem geral de pesos abertos na arquitetura Flux. Texto para imagem, com passos e guidance sob seu controle.
Um modelo de imagem de uso geral e pesos abertos na arquitetura Flux.
Ele gera apenas a partir do prompt.
Início rápido
Chame a API do Chroma
Defina MAGE_API_KEY, envie para /chroma/generate e consulte o status_url até a solicitação ser concluída.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/chroma/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "chroma-v1-hd"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('chroma', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'chroma-v1-hd',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("chroma", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "chroma-v1-hd",
})
print(request["result"]["url"])Modelos
Valores de model_id do Chroma
Envie model_id para escolher uma variante. Uma solicitação sem ele usa a padrão.
| model_id | Nome | Padrão |
|---|---|---|
| chroma-v1-hd | Chroma | Sim |
Opções
Parâmetros do Chroma
Valores permitidos em todas as variantes; uma variante pode oferecer menos. A documentação lista as opções de cada variante.
| Campo | Valores |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
Mais modelos de imagem
Outras APIs de geração de imagens no Mage
Imagem · a partir de 40 Gems
API do Flux 2
Prompts longos e edições com várias referências
Imagem · a partir de 9 Gems
API do GPT Image 2
Prompts precisos e texto legível
Imagem · a partir de 75 Gems
API do Grok Image
Grok Imagine, em três níveis de qualidade
Imagem · a partir de 37 Gems
API do Guava
Fotorrealismo que parece uma fotografia de verdade
Imagem · a partir de 20 Gems
API do HiDream
Rápido e versátil, com prompts negativos
Imagem · a partir de 20 Gems
API do Krea 2
Estética deslumbrante em segundos
Perguntas frequentes
Perguntas frequentes
Quanto custa a API do Chroma?
Uma requisição do Chroma nas configurações padrão (Chroma) custa 35 Gems, cerca de US$ 0,035. Outras resoluções, durações e variantes alteram o preço; a resposta informa o valor exato. Uma geração que falha é reembolsada; uma bloqueada pela política de conteúdo do Mage não é.
Qual é o endpoint da API do Chroma?
POST https://api.mage.space/v1/chroma/generate com um cabeçalho Authorization: Bearer contendo sua chave de API do Mage. A resposta inclui uma status_url para consultar o resultado.
Quais modelos do Chroma posso chamar?
chroma-v1-hd. O padrão é Chroma.
O Chroma aceita imagens de referência ou personagens?
O Chroma não aceita entradas de imagem, vídeo ou áudio. O Chroma não aceita menções com @handle.
Posso usar o Chroma pelo Claude ou pelo ChatGPT?
Sim. Conecte o servidor MCP do Mage ao Claude, ChatGPT, Claude Code, Grok ou Cursor e peça o Chroma pelo nome. Seu assistente consulta as opções com get_model e informa o preço antes de gerar.
Por quanto tempo os resultados do Chroma ficam salvos?
Resultados e entradas ficam salvos por 30 dias. Baixe o que quiser guardar para o seu próprio armazenamento.
Comece a criar com o Mage
Uma conta, um saldo de Gems, todos os modelos. Pague apenas pelo que você gerar.