W skrócie
HiDream API uruchamia HiDream przez Mage pod adresem POST https://api.mage.space/v1/hidream/generate. Zapytanie z ustawieniami domyślnymi kosztuje 20 Gems (około 0,02 $), bez subskrypcji. HiDream nie obsługuje wzmianek @handle.
Obraz
Wynik
1
Wariant
20
Gems za obraz, domyślnie
$0.02
Około, w USD
Przegląd
Co potrafi HiDream API
Szybki, uniwersalny model tekst na obraz z promptem negatywnym. Świetnie sprawdza się przy codziennych promptach, zarówno fotorealistycznych, jak i ilustrowanych.
Szybki, uniwersalny model obrazów z promptem negatywnym, fotorealistyczny lub ilustrowany.
Generuje wyłącznie na podstawie promptu.
Szybki start
Jak wywołać HiDream API
Ustaw MAGE_API_KEY, wyślij zapytanie na /hidream/generate i sprawdzaj status_url, aż zapytanie zostanie zrealizowane.
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"])Modele
Wartości model_id dla HiDream
Wyślij model_id, aby wybrać wariant. Zapytanie bez niego użyje wariantu domyślnego.
| model_id | Nazwa | Domyślny |
|---|---|---|
| hidream-fast | HiDream | Tak |
Opcje
Parametry HiDream
Dozwolone wartości dla wszystkich wariantów; dany wariant może oferować mniej. Opcje dla poszczególnych wariantów znajdziesz w dokumentacji.
| Pole | Wartości |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
Więcej modeli obrazów
Inne API do generowania obrazów w Mage
Obraz · od 20 Gems
Krea 2 API
Zachwycająca estetyka w kilka sekund
Obraz · od 135 Gems
Mango API
Nasza flagowa rodzina modeli obrazu
Obraz · od 68 Gems
Nano Banana 2 API
Wyraźny, czytelny tekst, do 4K
Obraz · od 15 Gems
API SDXL Plus
SDXL z poprawionymi twarzami i dłońmi
Obraz · od 10 Gems
Stable Diffusion v1.5 API
Klasyk w przystępnej cenie
Obraz · od 10 Gems
Stable Diffusion v3.5 Large API
Stable Diffusion, który najlepiej słucha poleceń
FAQ
Najczęściej zadawane pytania
Ile kosztuje HiDream API?
Zapytanie do HiDream z ustawieniami domyślnymi (HiDream) kosztuje 20 Gems, czyli około 0,02 $. Inne rozdzielczości, czasy trwania i warianty zmieniają cenę, a dokładną opłatę podaje odpowiedź. Za nieudaną generację zwracamy koszt, ale nie za taką, którą zablokuje polityka treści Mage.
Jaki jest endpoint HiDream API?
POST https://api.mage.space/v1/hidream/generate z nagłówkiem Authorization: Bearer zawierającym Twój klucz API Mage. Odpowiedź zawiera status_url, który sprawdzasz, aby pobrać wynik.
Które modele HiDream mogę wywołać?
hidream-fast. Domyślny to HiDream.
Czy HiDream obsługuje obrazy referencyjne lub postacie?
HiDream nie przyjmuje obrazów, wideo ani dźwięku jako danych wejściowych. HiDream nie obsługuje wzmianek @handle.
Czy mogę używać HiDream z poziomu Claude lub ChatGPT?
Tak. Połącz serwer Mage MCP z Claude, ChatGPT, Claude Code, Grok lub Cursor i poproś o HiDream po nazwie. Asystent sprawdzi opcje modelu przez get_model i poda cenę przed generowaniem.
Jak długo przechowywane są wyniki HiDream?
Wyniki i dane wejściowe są przechowywane przez 30 dni. Wszystko, co chcesz zachować, pobierz na własny dysk.
Zacznij tworzyć z Mage
Jedno konto, jedno saldo Gems, wszystkie modele. Płacisz tylko za to, co wygenerujesz.