Главное
Chroma API запускает Chroma через Mage: POST https://api.mage.space/v1/chroma/generate. Запрос с настройками по умолчанию стоит 35 Gems (около $0,035), без подписки. Упоминания @handle в Chroma не поддерживаются.
Изображение
Результат
1
Вариант
35
Gems за изображение по умолчанию
$0.035
Примерно, в USD
Обзор
Что умеет Chroma API
Универсальная модель изображений с открытыми весами на архитектуре Flux. Генерация по тексту, а шаги и guidance под вашим контролем.
Универсальная модель изображений с открытыми весами на архитектуре Flux.
Генерирует только по промпту.
Быстрый старт
Вызов Chroma API
Задайте MAGE_API_KEY, отправьте запрос на /chroma/generate и опрашивайте status_url, пока запрос не завершится.
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"])Модели
Значения model_id для Chroma
Передайте model_id, чтобы выбрать вариант. Запрос без него использует вариант по умолчанию.
| model_id | Название | По умолчанию |
|---|---|---|
| chroma-v1-hd | Chroma | Да |
Параметры
Параметры Chroma
Допустимые значения для всех вариантов; у отдельного варианта их может быть меньше. Параметры каждого варианта перечислены в документации.
| Поле | Значения |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
Другие модели изображений
Другие API для генерации изображений на Mage
Изображения · от 40 Gems
Flux 2 API
Длинные промпты и правки по нескольким референсам
Изображения · от 9 Gems
GPT Image 2 API
Точные промпты и читаемый текст
Изображение · от 75 Gems
Grok Image API
Grok Imagine, три уровня качества
Изображения · от 37 Gems
Guava API
Фотореализм, неотличимый от настоящего снимка
Изображение · от 20 Gems
HiDream API
Быстрая и универсальная, с негативными промптами
Изображение · от 20 Gems
Krea 2 API
Потрясающая эстетика за секунды
FAQ
Частые вопросы
Сколько стоит Chroma API?
Запрос Chroma с настройками по умолчанию (Chroma) стоит 35 Gems, около $0,035. Другие разрешения, длительность и варианты меняют цену; точная сумма указана в ответе. Если генерация не удалась, Gems возвращаются; если её заблокировала политика контента Mage — нет.
Какой эндпоинт у Chroma API?
POST https://api.mage.space/v1/chroma/generate с заголовком Authorization: Bearer и вашим API-ключом Mage. В ответе придёт status_url — опрашивайте его, чтобы получить результат.
Какие модели Chroma можно вызывать?
chroma-v1-hd. По умолчанию используется Chroma.
Поддерживает ли Chroma референсные изображения или персонажей?
Chroma не принимает на вход изображения, видео и аудио. Упоминания @handle в Chroma не поддерживаются.
Можно ли использовать Chroma в Claude или ChatGPT?
Да. Подключите MCP-сервер Mage к Claude, ChatGPT, Claude Code, Grok или Cursor и просто назовите Chroma. Ассистент узнает доступные параметры через get_model и назовёт цену до генерации.
Как долго хранятся результаты Chroma?
Результаты и входные файлы хранятся 30 дней. Всё, что нужно сохранить, скачайте в своё хранилище.
Начните создавать с Mage
Один аккаунт, один баланс Gems, все модели. Платите только за то, что генерируете.