Перейти до вмісту

Mage API · Модель зображень

HiDream API

Швидка й універсальна, із негативними промптами

POST https://api.mage.space/v1/hidream/generate

Коротко

HiDream API запускає HiDream через Mage за адресою POST https://api.mage.space/v1/hidream/generate. Запит із типовими налаштуваннями коштує 20 Gems (близько $0.02), без підписки. HiDream не підтримує згадування @handle.

  • ЗображенняРезультат
  • 1Варіант
  • 20Gems за зображення, типово
  • $0.02Приблизно, у USD

Огляд

Що вміє HiDream API

Швидка універсальна модель для створення зображень із тексту, з негативним промптом. Чудово підходить для повсякденних промптів, фотореалістичних чи ілюстрованих.

Швидка універсальна модель зображень із негативним промптом, фотореалістична чи ілюстрована.

Вона генерує лише за промптом.

Швидкий старт

Виклик HiDream API

Задайте MAGE_API_KEY, надішліть запит на /hidream/generate й опитуйте status_url, доки запит не завершиться.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/hidream/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": "hidream-fast"
}' | 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('hidream', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'hidream-fast',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("hidream", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "hidream-fast",
})

print(request["result"]["url"])

Моделі

Значення model_id для HiDream

Передайте model_id, щоб вибрати варіант. Запит без нього використовує варіант за замовчуванням.

model_idНазваЗа замовчуванням
hidream-fastHiDreamТак

Параметри

Параметри HiDream

Допустимі значення для всіх варіантів; окремий варіант може пропонувати менше. Параметри кожного варіанта наведено в документації.

ПолеЗначення
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21

Більше моделей для зображень

Інші API для генерації зображень на Mage

  • Зображення · від 20 Gems

    Krea 2 API

    Розкішна естетика за лічені секунди

  • Зображення · від 135 Gems

    Mango API

    Наша флагманська лінійка моделей для зображень

  • Зображення · від 51 Gems

    Nano Banana 2 API

    Чіткий, читабельний текст, до 4K

  • Зображення · від 15 Gems

    API SDXL Plus

    SDXL з виправленими обличчями та руками

  • Зображення · від 10 Gems

    Stable Diffusion v1.5 API

    Класика за помірну ціну

  • Зображення · від 10 Gems

    Stable Diffusion v3.5 Large API

    Stable Diffusion, що найкраще слухається промпту

Поширені запитання

Поширені запитання

Скільки коштує HiDream API?
Запит до HiDream із типовими налаштуваннями (HiDream) коштує 20 Gems, приблизно $0.02. Інша роздільна здатність, тривалість і варіанти змінюють ціну; точну суму списання вказано у відповіді. Невдала генерація відшкодовується, а та, яку блокує політика вмісту Mage, — ні.
Який endpoint у HiDream API?
POST https://api.mage.space/v1/hidream/generate із заголовком Authorization: Bearer, що містить ваш API-ключ Mage. Відповідь містить status_url, за яким опитують результат.
Які моделі HiDream можна викликати?
hidream-fast. Типова — HiDream.
Чи підтримує HiDream референсні зображення або персонажів?
HiDream не приймає на вхід зображення, відео чи аудіо. HiDream не підтримує згадування @handle.
Чи можна користуватися HiDream у Claude або ChatGPT?
Так. Підключіть MCP-сервер Mage до Claude, ChatGPT, Claude Code, Grok або Cursor і просто назвіть HiDream. Асистент прочитає параметри моделі через get_model і назве ціну до генерації.
Як довго зберігаються результати HiDream?
Результати та вхідні дані зберігаються 30 днів. Завантажте все, що хочете залишити, у власне сховище.

Створюй з Mage

Один акаунт, один баланс Gems, усі моделі. Плати лише за те, що генеруєш.